mkpprcpath

The mkpprcpath command establishes or replaces a remote mirror and copy (formerly PPRC) path between source and target logical subsystems (LSSs) over a fibre-channel connection. This is the only supported connectivity for machine types 2107 and 1750. Paths can be established between the following machine types: 2105:2105, 2107:2107, 2107:1750, 2107:2105, 1750:1750, 1750:2105.

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

>--+-------------------------------+-- -remotewwnn--wwnn-------->
   '- -remotedev--storage_image_ID-'                       

>-- -srclss--source_LSS_ID--+----------------+------------------>
                            '- -srcss--SS_ID-'   

>-- -tgtlss--target_LSS_ID--+----------------+------------------>
                            '- -tgtss--SS_ID-'   

>--+--------------+--------------------------------------------->
   '- -consistgrp-'   

>--+-source_port_ID:target_port_ID--+-------+-+----------------><
   |                                '-. . .-' |   
   '-" - "------------------------------------'   

Parameters

-dev storage_image_ID
(Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified source port ID.
-remotedev  storage_image_ID
(Optional) Specifies the ID of the secondary storage image, which includes manufacturer, machine type, and serial number. If specified, the format of this entry might be checked for correctness although the value is not used
Example: IBM.1750-68FA150
 -remotewwnn wwnn
(Required) Specifies the worldwide node name of the secondary storage image. The format is a 16-hexadecimal ID.
Note: Ensure that you use the worldwide node name that is associated with the secondary storage unit. Run the lssi or showsi command to obtain this number.
Example: 12341234000A000F
-srclss source_LSS_ID
(Required) Specifies the source logical subsystem ID. Use a fully qualified LSS ID, which includes the storage image ID, or use a shortened version without the storage image ID, if the -dev parameter is used. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range (1750) 00 - 1F.
Example of a shortened version: 00
-srcss SS_ID
(Optional) Specifies the subsystem ID of the primary logical subsystem in the format 0x0001 - 0xFFFF.
This value is required for the IBM TotalStorage Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: 0010
-tgtlss target_LSS_ID
(Required) Specifies the logical subsystem ID associated with the secondary storage unit as the target. Use a fully qualified LSS ID, which includes the storage image ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range (1750) 00 - 1F.
Example of a shortened version: 01
-tgtss SS_ID
(Optional) Specifies the subsystem ID of the secondary logical subsystem in the format 0x0001 - 0xFFFF.
This value is required for the IBM TotalStorage Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: 0010
-consistgrp
(Optional) Creates a consistency group for the remote mirror and copy volume pairs. A remote mirror and copy consistency group is a set of remote mirror and copy volume pairs that have the same source and target LSS.
Normally, when an error occurs in a member of a remote mirror and copy volume pair, the storage unit places the volume in a suspended state. However, if the volume participates in a consistency group, it is placed in a long busy state.
source_port_ID:target_port_ID . . . | -
(Required) Establishes a remote mirror and copy path between the source and target ports for the specified source and target logical subsystems. The source and target ports must be fibre-channel I/O ports that are configured for point-to-point or switched fabric topology. They are enabled automatically for remote mirror and copy secondary I/O operations. They are not enabled for FICON I/O operations.
Use fully qualified port IDs, which includes the storage image ID, or use a shortened version without the storage image ID if the -dev parameter is specified. A remote mirror and copy path port pair ID consists of two port IDs. Designate the first as the source port and the second as the target port for the remote mirror and copy path. You must separate the two port IDs with a colon and no spaces. A port ID 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). This number is prefixed with the letter I.
This parameter accepts up to eight remote mirror and copy path port pair IDs. You must separate multiple port pair IDs with spaces.
If you specify a dash (-), this parameter information is automatically supplied.
Example of the shortened version: I1A10:I2A20
Example of multiple pairs: I1A10:I2A20 I1A11:I2A21 I1A12:I2A22

Example (1750)

Invoking the mkpprcpath command
dscli>mkpprcpath -dev IBM.1750-68FA120  
-srclss 01 -tgtlss 01 –remotewwnn 12341234000A000F I0100:I0100
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 
DS: IBM.1750-68FA120 
Remote Mirror and Copy path 01:01 successfully established.
Related reference
mkesconpprcpath
rmpprcpath
lspprcpath
lsavailpprcport
mkpprc
failoverpprc
failbackpprc
rmpprc
lspprc
freezepprc
pausepprc
resumepprc
unfreezepprc
showsi
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.