lsavailpprcport

The lsavailpprcport command displays a list of ESCON or fibre-channel I/O ports that can be defined as remote mirror and copy (formerly PPRC) paths. The DS6000™ supports only fibre-channel ports. The Enterprise Storage Server (2105 machine type) supports ESCON ports.


>>-lsavailpprcport--+-------------------------+----------------->
                    '- -dev--storage_image_ID-'   

>-- -remotewwnn--wwnn--+-----+---------------------------------->
                       +- -s-+   
                       '- -l-'   

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

>--+-Source_LSS_ID:Target_LSS_ID-+-----------------------------><
   '- ---------------------------'

Parameters

-dev storage_image_ID

(Optional). Specifies the source volume storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source logical subsystem.

Example: IBM.1750-68FA120

-remotewwnn wwnn

(Required). Specifies the worldwide node name (WWNN). The format is a 16-hexadecimal ID.

Note: You want to use the WWNN that is associated with the remote storage image. Run the lssi or showsi command to obtain this number. If you use the WWNN that is associated with the primary storage unit, this command fails.

WWNN example: 12341234000A000F

-s

(Optional). Displays the local port ID. You cannot use the -l and the -s parameters together.

-l

(Optional). Displays all fields. You cannot use the -l and the -s parameters together.

-remotedev storage_image_ID

(Required or Optional). Specifies the remote storage unit that contains the I/O ports that are queried by the Source_LSS_ID:Target_LSS_ID parameter. The remotedev ID consists of the value for the manufacturer, machine type, and serial number.

Required - This parameter is required when querying ESCON I/O ports unless a fully qualified target logical subsystem ID is specified.

Optional - This parameter is optional if you are querying fibre channel I/O ports.

Note: If specified the format of this entry might be checked for correctness even though the value is not used.

Example: IBM.1750-68FA120

Source_LSS_ID:Target_LSS_ID | -

(Required). Queries I/O ports that are available for a remote mirror and copy path relationship for the source and target LSSs. This parameter accepts fully qualified LSS IDs, which includes the storage image ID or shortened version without the storage image ID, if the -dev parameter is specified.

A remote mirror and copy path LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a remote mirror and copy path relationship. The two LSS IDs must be separated with a colon and no spaces. The first LSS ID is the source LSS. The second LSS ID is the target LSS.

The fully qualified LSS ID format is storage_image_ID/xx, where 'xx' is a hexadecimal number in the range 00 - 1F (1750 only). For example, IBM.1750-68FA120/01:IBM.1750-68FA150/01

If you do not use the -dev and -remotedev parameters, the fully qualified source_LSS_ID:target_LSS_ID value must be placed after the -remotewwnn value in your command line. For example, your command line would look like the following:

dscli>lsavailpprcport –l –remotewwnn 12341234000A000F 
IBM.1750-68FA120/01:IBM.1750-68FA150/01

If you specify the dash (-), this parameter information is automatically supplied.

Example pair: 00:00

Example of multiple pairs: 00:00 01:01 02: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 that is associated with the lsavailpprcport 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 lsavailpprcport command

dscli>lsavailpprcport –l –dev IBM.2107-75FA120
 –remotewwnn 12341234000A000F 01:01

The resulting output

ESCON port information displays for the 2105 machine type.

Local port	Attached port	Type	Switch ID	Switch port
I0100	I0200	FCP	N/A	N/A
I0150	I0620	ESCON	N/A	N/A
I0200	N/A	ESCON Switch	IBM.111.2222. 75113AB	I10
I0250	N/A	ESCON Switch	IBM.111.2222. 75113AB	I20

Report field descriptions

Local port

Specifies the fully qualified unique Port ID on the local storage unit. FCP and ESCON port IDs are displayed as follows:

FCP port ID: 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 FCP port ID number is prefixed with the letter I.
ESCON port ID: Four hexadecimal characters in the format 0xEEAP, where ‘EE’ is a port enclosure number (04 - 07), ‘A’ is the adapter number (0 - 3), and ‘P’ is the port number (0 - 1). The ESCON port ID number is prefixed with the letter I.

Note: When you specify the -s parameter, the local port information is the only information displayed on the report.

Attached port

Specifies the fully qualified unique Port ID on the attached storage unit. FCP and ESCON port ID numbers are displayed in the format that is described for Local port. However, if there is an ESCON Switch value, the value displayed in this column is N/A (not applicable).

Type

Specifies the connection type. FCP is the only applicable value for a 2107 or 1750 machine type. For a 2105 machine type, you can have a value of ESCON or ESCON Switch.

Switch ID

Specifies the Switch ID for ESCON Switch connections.

Note: For FCP and direct ESCON, the displayed value in this field is N/A (not applicable).

Switch port

Specifies the Port ID on the Switch device that is connected to the attached ESS. The Switch port ID component is two hexadecimal characters in the format 0xPP, where ‘PP’ is a port number (00 - ff). The number is prefixed with the letter I.

Note: For FCP and direct ESCON, the value of this field is N/A (not applicable).