lspprc

The lspprc command displays a list of remote mirror and copy (formerly PPRC) volume relationships for a storage image, and status information for each remote mirror and copy volume relationship in the list.

Read syntax diagramSkip visual syntax diagram
>>-lspprc--+-------------------------+-------------------------->
           '- -dev--storage_image_ID-'   

>--+-------------------------------+---------------------------->
   '- -remotedev--storage_image_ID-'   

>--+-----------------------------------+--+-----+--------------->
   '- -state--+-copy-pending---------+-'  +- -s-+   
              +-full-duplex----------+    '- -l-'   
              +-suspended------------+              
              +-target-copy-pending--+              
              +-target-full-duplex---+              
              +-target-suspended-----+              
              +-not-remote-copy-pair-+              
              +-invalid-state--------+              
              '-volume-inaccessible--'              

>--+-SourceVolumeID:TargetVolumeID--+-------+-+----------------><
   |                                '-. . .-' |   
   '-" - "------------------------------------'   

Parameters

-dev storage_image_ID
(Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes.
Example: IBM.1750-68FA120
-remotedev storage_image_ID
(Optional most times, however required as noted). Specifies the target volume storage image ID, which consists of manufacturer, machine type, and serial number.
Note: The -remotedev parameter is required when volume pairs are specified and the -dev parameter is specified as well.
Example: IBM.1750-68FA150
-state copy-pending | full-duplex | suspended | target-copy-pending | target-full-duplex | target-suspended | not-remote-copy-pair | invalid-state | volume-inaccessible
(Optional). Identifies the state of the remote mirror and copy relationship that you want to view.
copy-pending
Specifies that you want to view remote mirror and copy relationships that have copy processing that is pending. A Global Copy relationship is always copy-pending.
full-duplex
Specifies that you want to view remote mirror and copy relationships that are full duplex.
suspended
Specifies that you want to view remote mirror and copy relationships that are suspended. The Reason attribute might indicate why the relationship is suspended.
target-copy-pending
Specifies that you want to view remote mirror and copy relationships where the target volume has copy processing that is pending. In this state, the source volume is unknown or cannot be queried.
target-full-duplex
Specifies that you want to view remote mirror and copy relationships where the target volume is full duplex. In this state, the source volume is unknown or cannot be queried.
target-suspended
Specifies that you want to view remote mirror and copy relationships where the target volume is suspended. In this state, the source volume is unknown or cannot be queried. The Reason attribute might indicate why the relationship is suspended.
not-remote-copy-pair
Specifies that you want to view remote mirror and copy relationships that are not a remote copy pair.
invalid-state
Specifies that you want to view remote mirror and copy relationships that do not meet requirements for being valid. The report that is generated with this query only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of invalid-state. All the other information columns are displayed with a null (-) value.
volume-inaccessible
Specifies that you want to view remote mirror and copy relationships where the volume cannot be viewed, generally this means that the volume is fenced. The report that is generated with this query only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of volume-inaccessible. All the other information columns are displayed with a null (-) value.
-s
(Optional). Displays the remote mirror and copy volume pair IDs. You cannot use the -l and the -s parameters together.
-l
(Optional). Displays the default output and the target read enabled, source cascade, target cascade, and suspended attributes. You cannot use the -l and the -s parameters together.
SourceVolumeID:TargetVolumeID . . . |
(Required) Displays the remote mirror and copy relationships for the source and target volume pairs with the specified IDs.
This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces.
A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no spaces. The first volume ID is the source volume. The second volume ID is the target volume.
You can enter remote mirror and copy pair IDs, a range of remote mirror and copy pair IDs, single volume IDs, or a range of volume IDs. You cannot enter a combination of remote mirror and copy pair IDs and volume IDs.
The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E (for 1750) , and ZZ is the volume number (00 - FF).
If you specify the dash (-), this parameter information is automatically supplied.
Example of a shortened version: 0100:0100
Example of multiple IDs: 0100:0100 0200:0200 0300:0300
Note: A query of target volume IDs is directed to the storage image that is identified by the -dev parameter or embedded in the fully qualified single volume IDs.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output report that is associated with the lspprc command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Invoking the lspprc command
dscli>lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100
0101:0101  
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 
DS: IBM.2107-75FA120
ID State Reason Type

Out
Of
Sync
Tracks

Tgt
Read

Src
Cascade

IBM.2107-
75FA120
/0100:
IBM.2107-
75FA150
/0100

Full-
Duplex

-

Metro
Mirror

0 Enabled Disabled

IBM.2107-
75FA120
/0101:
IBM.2107-
75FA150
/0101

Full-
Duplex

-

Metro
Mirror

0 Enabled Disabled

Tgt
Cascade

Date
Sus
pended

Source
LSS

Timeout
(secs)

Crit
Mode

First
Pass
Status

GMIR
CG

PPRC
CG

Enabled - 01 120 Disabled False Disabled Enabled
Enabled - 02 120 Disabled False Enabled Disabled

Report field descriptions

ID
Specifies the source and target volume IDs of a remote mirror and copy volume relationship.
State
Displays the current remote mirror and copy volume relationship state. One of the following values is displayed:
Copy Pending
Indicates that the relationship is copy pending. A Global Copy (Extended Distance) relationship is always copy pending.
Full Duplex
Indicates that the relationship is full duplex.
Suspended
Indicates that the relationship is suspended. The Reason attribute might indicate why the relationship is suspended.
Target Copy Pending
Indicates that the source volume is unknown or cannot be queried and the target state is copy pending.
Target Full Duplex
Indicates that the source volume is unknown or cannot be queried and the target state is full duplex.
Target Suspended
Indicates that the source volume is unknown or cannot be queried and the target state is suspended.
Not Part of Remote Copy Pair
Indicates that the relationship is not a remote copy pair.
Invalid State
Indicates that the listed remote mirror and copy volume relationships do not meet the requirements for being valid.
Note: The report that is generated with the invalid-state designation only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of invalid-state. All the other information columns are displayed with a null (-) value.
Volume Inaccessible
Indicates that the volume could not be queried. Generally, this indicates that the volume is fenced.
Note: The report that is generated with the Volume Inaccessible designation only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of Volume Inaccessible. All the other information columns are displayed with a null (-) value.
Reason
Indicates why the Remote Mirror and Copy volume relationship is suspended. The following values can be displayed:
Unknown
Specifies that the volume is suspended but the reason for the suspension is not specifically defined within the system
Not in PPRC Relationship
Specifies that the designated volume is not part of a Remote Mirror and Copy pair.
Host Source
Specifies that the Remote Mirror and Copy processing on the volume was suspended by the primary host. The host command might have specified an immediate suspension or that the volume be suspended when it entered a full duplex state.
Host Target
Specifies that Remote Mirror and Copy processing was suspended on the secondary volume. Updates to primary volumes and out-of-sync tracks are still being processed.
Update Target
Specifies that Remote Mirror and Copy processing was suspended on a secondary volume by the primary control unit update secondary device status command.
Internal Conditions Both
Specifies that Remote Mirror and Copy processing was suspended on a volume by either the primary control unit or the secondary control unit because of internal conditions.
Simplex Target
Specifies that Remote Mirror and Copy processing was suspended on a volume when the secondary control unit sent a state change interrupt to the primary control unit indicating a transition to a simplex state.
Internal Conditions Target
Specifies that Remote Mirror and Copy processing was suspended on a secondary volume when the primary control unit was notified that the secondary volume became suspended due to internal conditions.
Power
Specifies that Remote Mirror and Copy processing was suspended on a volume when the primary or secondary control unit was shut down or restarted.
Notes:
  1. The paths to the secondary controller might not be available if the power to the primary controller was shut down. If only the secondary control unit was shut down, it might be possible for the paths to be restored depending on the path status. Use the following process to determine whether your Remote Mirror and Copy processing can be restored on the affected volumes:
    1. Issue the lspprc command and use the generated report to determine the path status.
    2. Issue the mkpprc command if the paths are still in tact. This process resynchronizes the volume pairs.
    3. Continue with your processing.
  2. If the above process cannot be performed, you must remove the pair relationships on the affected volumes and start your Remote Mirror and Copy processing from the beginning on the affected volumes.
Freeze
Specifies that Remote Mirror and Copy processing was suspended on a volume pair because the host issued a Freeze PPRC Group order.
Volume Not Configured
Specifies that Remote Mirror and Copy processing was suspended on a volume because the volume is not part of a copy pair relationship.
Type
Indicates that the remote copy and mirror volume relationship is a Metro Mirror (synchronous) relationship, a Global Copy (extended distance) relationship, or the relationship type is unknown.
Out Of Sync Tracks
Indicates the number of tracks that are not synchronized for this FlashCopy relationship. The maximum value is dependent on the source volume size.
Notes:
  1. If you issue the lspprc command to view the out of sync value for a volume pair (for example, 0000:0001) on a 2105, there is no observable decrease in the value from when you issue the query to the end of the process.
  2. If you issue the lspprc command to view the out of sync value for a single volume (for example, 0000) on a 2105, there is an observable decrease in the value but only at 10 second intervals. If you issue the lspprc command and reissue it again before the 10 seconds has expired, there is no observable change in the value.
  3. If you issue the lspprc command to view the out of sync value for a volume pair or a single volume on a 1750, there is an observable decrease in the value but only at 10 second intervals.
Tgt Read
Indicates that Read IO operations to the target volume are allowed.
Src Cascade
Indicates that the source volume of this relationship is enabled to also be a target volume of a different relationship.
Tgt Cascade
Indicates that the target volume of this relationship is enabled so that it is also a source volume for a different relationship.
Date Suspended
Indicates the date when this relationship was last suspended. The value can be displayed as a null (-).
SourceLSS
Indicates the consistency group LSS ID that is associated with the source volume of this PPRC volume relationship.
Timeout (secs)
Indicates the consistency group Long Busy Timeout setting for the LSS ID that is associated with the source volume of this PPRC volume relationship. The timeout value is either the default value of 120 seconds, or a user-specified value of 1 to 600 000 seconds.
Crit Mode
Indicates whether the remote copy and mirror primary volume represents a critical volume.
First Pass Status
Indicates the first pass Global Copy state of the source volume. The data is valid only when you query the primary box and the queried pair is a Global Copy pair.
GMIR CG
Indicates if the remote mirror and copy consistency group is enabled, disabled or not available.
Notes:
  1. This value is displayed when you designate the use of the -l parameter and when the primary volume is being queried.
  2. This value is not reported for model 2105. If a model 2105 is being queried, the value displayed for this field is N/A (not available).
PPRC CG
Indicates if the volume is in consistent asynchronous remote mirror and copy mode or is not available. The values that can be displayed are enabled, disabled, or not available.
Notes:
  1. This value is displayed when you designate the use of the -l parameter.
  2. This value is not reported for model 2105. If a model 2105 is using being queried, the value displayed for this field is N/A (not available).
Related reference
mkesconpprcpath
mkpprcpath
rmpprcpath
lspprcpath
lsavailpprcport
mkpprc
failoverpprc
failbackpprc
rmpprc
freezepprc
pausepprc
resumepprc
unfreezepprc
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.