mkesconpprcpath

Parameters

-dev storage_image_ID

(Optional). The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.

Example: IBM.2105-FA120

-remotedev storage_image_ID

(Optional). The remote storage image ID, which consists of manufacturer, machine type, and serial number. This parameter is required if you do not fully qualify the target LSS ID.

Example: IBM.2105-FA150

-srclss Source_LSS_ID

(Required). 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). 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). 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). 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). 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 non-fully 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.

The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

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)