lspprcpath
The lspprcpath command displays a list of existing remote mirror and copy path definitions.
Parameters
- -dev storage_image_ID
- (Optional) The storage image ID, which consists of values for the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source LSS, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
- -s
- (Optional) Displays the default output of the report but does not include the Failed Reason column. You cannot use the -l and the -s parameters together.
- -l
- (Optional) Displays the default output and the Failed Reason and PPRC CG descriptions. You cannot use the -l and the -s parameters together.
- Source_LSS_ID ... | -
- (Required) The Remote Mirror and Copy paths that are defined for the specified source LSS IDs be displayed.
Example: Displaying a list of existing remote mirror and copy path definitions
dscli> lspprcpath -dev IBM.2107-75FA120 -l 10
Output
Src | Tgt | State | SS |
---|---|---|---|
IBM.2107-75FA120/10
|
IBM.2107-75FA150/10
|
Failed
|
0010 |
IBM.2107-75FA120/10
|
IBM.2107-75FA150/11
|
Success
|
0011 |
IBM.2107-75FA120/10
|
IBM.2107-75FA150/12
|
Degraded
|
0012 |
IBM.2107-75FA120/10
|
IBM.2107-75FA150/13
|
Invalid
|
0013 |
Port |
Attached
Port |
Tgt
WWNN |
Failed
Reason |
PPRC CG |
---|---|---|---|---|
IBM.2107-75FA120/I0100
|
IBM.2107-75FA150/I0100
|
3007ACF
3012399E0 |
Configuration
Error |
Disabled |
IBM.2107-75FA120/I0100
|
IBM.2107-75FA150/I0100
|
3007ACF-
3012399E0 |
- | Enabled |
IBM.2107-75FA120/I0100
|
IBM.2107-75FA150/I0100
|
3007ACF-
3012399E0 |
Path Degraded
Due to High Failure Rate |
Disabled |
IBM.2107-75FA120/I0100
|
IBM.2107-75FA150/I0100
|
3007ACF-
3012399E0 |
- | Enabled |
Output definitions
- Src
- The fully qualified logical subsystem ID. Use the -fullid parameter to display fully qualified IDs, which include the storage image ID.
- Tgt
- The fully qualified remote mirror and copy ID for the path target LSS. Use the -fullid parameter to display fully qualified IDs, which include the storage image ID.
- State
- The current remote mirror and copy path state. One of the following values can be displayed:
- Failed
- The path is not established and has failed. When this is the state value, see the Failed Reason column for an explanation.
- Success
- The path is established and it is operating normally. When this is the state value, the Failed Reason column displays a " - " value.
- Invalid
- The path is in an unknown state. When this is the state value, the Failed Reason column displays a " - " value.
- Degraded
- The path is established, but with degraded performance. When this is the state value, see the Failed Reason column for an explanation.
- SS
- The subsystem identifier (SSID) of the target LSS.
- Port
- The fully qualified unique Port ID for the source storage system.
- Attached Port
- The fully qualified unique Port ID for the attached secondary storage system.
- Tgt WWNN
- The worldwide node name of the remote storage image.
- Failed Reason
- The reason for the path state. You must issue the lspprcpath command with the
-l parameter to see the values displayed in this field. If the State field has
a value of Invalid or Success, a
" -
" value is displayed in this field. When the State field displays a value of Failed, one of
the following values is displayed:
- Configuration Error
- A path has failed for one of the following reasons:
- The specification of the SA ID does not match the installed ESCON adapter cards in the primary controller.
- For ESCON paths, the secondary control unit destination address is zero and an ESCON Director (switch) was found in the path.
- For ESCON paths, the secondary control unit destination address is nonzero and an ESCON Director does not exist in the path. That is, the path is a direct connection.
Delete the original entry and resubmit the mkpprcpath command.
- Down
- An FCP path has failed because of a communication or hardware failure.
- Primary Login Exceeded
- The maximum number of log ins for each source FCP path has been exceeded.
- Retry Exceeded
- The maximum number of times that the storage system tried to reestablish FCP paths has been exceeded.
- Secondary Login Exceeded
- The maximum number of log ins for each FCP path to the secondary LSS has been exceeded. The FCP target is unavailable.
- Secondary Unavailable
- An FCP path to the secondary LSS is unavailable.
- Primary No Resources
- No resources are available at the source site for the logical paths to be established.
- Retry
- The number of attempts to reestablish path connection.
- Secondary Mismatch
- A mismatch that involves the secondary control unit sequence number or the LSS.
- Secondary No Resources
- Resources are not available at the secondary LSS to establish logical paths.
- Secondary LSS Mismatch
- A mismatch of the secondary control unit LSS ID or a failure of the I/O that collects secondary information for validation.
- Timeout
- A timeout has occurred. No reason is available.
- Not Properly Configured
- The primary Fibre Channel adapter is not configured properly, or it is not loaded with the correct version of microcode.
- Secondary Not PPRC Capable
- The Fibre Channel path from secondary adapter is not capable of processing a remote mirror and
copy path. This can occur from one of the following reasons:
- The secondary adapter is not configured properly, or it is not loaded with the correct version of microcode.
- The secondary adapter is already a target of 32 different storage systems.
- ESCON Channel Direction
- The primary control unit port or link cannot be converted to channel mode because a logical path is already established on the port or link. The establish path operations are not automatically retried within the control unit.
- ESCON Initialization Failed
- Indicates that initialization for the ESCON protocol has failed.
- ESCON Link Offline
- The ESCON link is offline. This is caused by the lack of light detection coming from a host, peer, or switch.
- Path Degraded Due to High Failure Rate
- Indicates that a Fibre Channel path is established; however, because of the high failure rate, the path is degraded.
- Path Removed Due to High Failure Rate
- The Fibre Channel path link has been removed because the path has experienced a high failure rate.
- System Reserved Path
- The system has reserved resources for a remote mirror and copy path, for example, after a failoverpprc or a freezepprc command is used. The resources can be used later, such as for the failbackpprc command. In most cases, no action is required. If it is known that a system reserved path is not required, it can be removed with the rmpprcpath command only after there are no remote mirror and copy pairs remaining between the LSSs.
- PPRC CG
- Displays the status of the PPRC consistency group. You must issue the
lspprcpath command with the -l parameter to see the values
displayed in this field. One of the following values can be displayed:
- Enabled
- The remote mirror and copy consistency group is enabled.
- Disabled
- The remote mirror and copy consistency group is disabled.