lspprcpath

The lspprcpath command displays a list of existing remote mirror and copy path definitions.

Read syntax diagramSkip visual syntax diagramlspprcpath  -dev  storage_image_ID  -s  -l  Source_LSS_ID   ...   "-"

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.
This parameter accepts ranges and individual LSS IDs. You might specify fully qualified LSS IDs, including the storage image ID, or a shortened version if the -dev parameter is specified. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE.
You must separate multiple LSS IDs with spaces.
The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example: 00
Example of multiple source LSS IDs: 00 01 02

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.
The port ID component is four hexadecimal characters in the format EEAP, where EE is a port enclosure number (00 - 3F), A is the adapter number (0 - F), and P is the port number (0 - F). The number is prefixed with the letter I.
Attached Port
The fully qualified unique Port ID for the attached secondary storage system.
The port ID component is four hexadecimal characters in the format 0xEEAP, where EE is a port enclosure number (00 - 3F), A is the adapter number (0 - F), and P is the port number (0 - F). The number is prefixed with the letter I.
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.