mkesconpprcpath

The mkesconpprcpath command creates a remote mirror and copy (formerly PPRC) path between source and target logical subsystems over an ESCON connection. The command allows you to specify ESCON direct and ESCON switch connections. Use this command only with IBM System Storage™ Enterprise Storage Servers (2105, Model 800 and Model 750).

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

>--+-------------------------------+--+--------------------+---->
   '- -remotedev--storage_image_ID-'  '- -remotewwnn--WWNN-'   

>-- -srclss--Source_LSS_ID--+----------------+------------------>
                            '- -srcss--ss_ID-'   

>-- -tgtlss--Target_LSS_ID--+----------------+------------------>
                            '- -tgtss--ss_ID-'   

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

>--+-Source_Port_ID:Target_Port_ID--+-------+-+----------------><
   |                                '-. . .-' |   
   '-" - "------------------------------------'   

Parameters

Notes:
  1. The mkesconpprcpath command is applicable only for the IBM System Storage Enterprise Storage Server (2105, Model 800 and Model 750). Models 2107 and 1750 support only fibre-channel connections.
  2. When you specify a switch port ID as the target port, specify the outgoing port that is connected to the remote ESS and not to the incoming port that is connected to the local ESS.
-dev storage_image_ID
(Optional). Specifies the source storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not fully qualify the source LSS ID.
Example: IBM.2105-75FA120
-remotedev storage_image_ID
(Optional). Specifies the remote storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not fully qualify the target LSS ID.
Example: IBM.2105-75FA150
-srclss Source_LSS_ID
(Required). Specifies the source logical subsystem (LSS) ID. Accepts a fully qualified LSS ID, which includes the storage image ID or 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 '00 - FE'.
-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 Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: 0010
-tgtlss Target_LSS_ID
(Required). Specifies the target logical subsystem (LSS) ID. Accepts a fully qualified LSS ID, which includes the storage image ID, or a shortened version without the storage image ID, if the -remotedev parameter is used. The fully qualified LSS ID format is storage_image_ID/xx, where 'xx' is a hexadecimal number in the range '00 - FE'.
 -remotewwnn WWNN
(Optional). Specifies the worldwide node name. The format is a 16-hexadecimal ID.
Note: If you use this parameter, the format is checked even though there might be times that the value is not used.
Example: 12341234000A000F
-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 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 that are associated with the PPRC paths that are established by this command. 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 volume is put in a suspended state. However, if the volume is participating in a consistency group, it is placed in a long busy state.
-force
(Optional). Creates a new remote mirror and copy path even if the specified remote mirror and copy path already exists.
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 port must be an ESCON I/O port that is configured for point-to-point or switch topology. The source port is enabled automatically for remote mirror and copy primary I/O operations. The target port must be a switch I/O port that is configured for point-to-point or switch topology. The target port is enabled automatically for remote mirror and copy primary I/O operations.
Note: Do not specify a target port ID when you specify an ESCON direct connection. Instead, specify only the source port ID.
This parameter accepts only nonfully qualified port IDs, which does not include the storage image ID. A remote mirror and copy path port pair ID consists of two port IDs. The first is designated 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 direct ESCON I/O 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. A switch ESCON I/O port ID is two hexadecimal characters in the range '00 - FF'. 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 the dash (-), this parameter information is automatically supplied.
Example pair: I1A10:I20
Example of a source ESCON port and target switch port pair: I1A10:I20
Example of multiple pairs: I1A10:I20 I1A11:I21 I1A12 (the last object identifies an ESCON connection)

Example (2105 use only)

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