lspprcpath

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

Read syntax diagramSkip visual syntax diagram
>>-lspprcpath--+-------------------------+--+-----+------------->
               '- -dev--storage_image_ID-'  +- -s-+   
                                            '- -l-'   

>--+-Source_LSS_ID--+-------+-+--------------------------------><
   |                '-. . .-' |   
   '-" - "--------------------'   

Parameters

-dev storage_image_ID
(Optional) Specifies the storage image ID, which consists of values for the manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source LSS ID.
Example: IBM.1750-68FA120
-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 descriptions. You cannot use the -l and the -s parameters together.
Source_LSS_ID . . . | -
(Required) Specifies that the Remote Mirror and Copy paths that are defined for the specified source LSS IDs be displayed.
This parameter accepts either a fully qualified LSS ID, 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 logical subsystem (LSS) hexadecimal number 00 - 1F (for 1750).
You must separate multiple LSS IDs with spaces.
If you specify the dash (-), this parameter information is automatically supplied.
Example: 00
Example of multiple source LSS IDs: 00 01 02

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 when the -l parameter is used with the lspprcpath command. 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 lspprcpath command
dscli>lspprcpath -dev  IBM.2107-75FA120 -l 10 
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
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

Success

0012

IBM.2107
-75FA120
/10

IBM.2107
-75FA150
/13

Invalid

0013
Port

Attached
Port

Tgt
WWNN

Failed
Reason

IBM.2107
-75FA120
/I0100

IBM.2107
-75FA150
/I0100

3007ACF
3012399E0

Configur
ation
Error

IBM.2107
-75FA120
/I0100

IBM.2107
-75FA150
/I0100

3007ACF-
3012399E0

-

IBM.2107
-75FA120
/I0100

IBM.2107
-75FA150
/I0100

3007ACF-
3012399E0

-

IBM.2107
-75FA120
/I0100

IBM.2107
-75FA150
/I0100

3007ACF-
3012399E0

-

Report field definitions

Src
Specifies the fully qualified logical subsystem ID.
Tgt
Specifies the fully qualified remote mirror and copy ID for the path target LSS.
State
Displays the current remote mirror and copy path state. One of the following values can be displayed:
Failed
The transaction failed for one of the specified reasons. See the Failed Reason column for an explanation.
Success
The transaction was a success. When this is the State value, the Failed Reason code displays a null (-) value.
Invalid
The transaction was not valid. When this is the State value, the Failed Reason code displays a null (-) value.
SS
Specifies the subsystem identifier (SSID) of the target LSS.
Port
Specifies the fully qualified unique Port ID for the source storage unit.
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
Specifies the fully qualified unique Port ID for the attached secondary storage unit.
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
Specifies the worldwide node name of the remote storage image.
Failed Reason
Specifies the reason for a failed transaction. 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 null (-) 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 unit 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
Specifies the number of attempts to reestablish path connection.
Secondary mismatch
Specifies that there is a mismatch that involves the secondary control unit sequence number or the LSS.
Secondary no resources
Specifies that resources are not available at the secondary LSS to establish logical paths.
Secondary LSS mismatch
Specifies that there is a mismatch of the secondary control unit LSS ID or a failure of the I/O that collects secondary information for validation.
Timeout
Specifies that a timeout has occurred. No reason is available.
Not properly configured
Specifies that the primary fibre channel adapter is not configured properly, or it is not loaded with the correct version of microcode.
Secondary not PPRC capable
Specifies that 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 units.
ESCON channel direction
Specifies that 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
Specifies that initialization for the ESCON protocol has failed.
ESCON link offline
Specifies that 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
Indicates that the fibre channel path link has been removed because the path has experienced a high failure rate.
Related reference
mkesconpprcpath
mkpprcpath
rmpprcpath
lsavailpprcport
mkpprc
failoverpprc
failbackpprc
rmpprc
lspprc
freezepprc
pausepprc
resumepprc
unfreezepprc
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.