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).

>>-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: - 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.
- 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 commanddscli>mkesconpprcpath -dev IBM.2105-75FA120 -remotedev IBM.2105-75FA150
-srclss 01 -tgtlss 01 I0100:I20 I0110:I21
The
resulting outputDate/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.