Required parameters

DEVN

Specifies the device number of any simplex disk volume that is attached to the primary site storage control without directing any operation to the volume. The device number is the 4-digit hexadecimal address of any disk volume behind the primary site storage control.

When defining paths between open device LSSs, DEVN identifies a System z® device to act as a CKD access volume. This device must be located in the same subsystem cluster as the primary device.

PRIM

For ESCON® paths this parameter specifies the primary site subsystem ID (SSID), serial number (serialno), and logical subsystem (LSS). For FCP paths, this parameter specifies the primary site subsystem ID (SSID), the World Wide Node Name (wwnn), and logical subsystem (LSS).

Where:

ssid

Specifies a 4-character hexadecimal subsystem identifier (SSID). ssid must be specified in X'' notation.

serialno

Specifies the storage subsystem serial number, which can include up to 12 digits, depending on the type of logical subsystem. Using a serial number indicates the LINK addresses are for ESCON channel interfaces. If the serial number is supplied for the primary logical subsystem, the serial number must also be supplied for the secondary logical subsystem.

Note: If the link addresses between subsystems use fibre channel port (FCP) numbers, WWNN is specified instead of storage control serial number.

wwnn

Specifies the World Wide Node Name and it is exactly 16-hexadecimal digits in length. The World Wide Node Name is used to access the primary logical subsystem referenced by the ssid using FCP. When the wwnn is specified it also indicates that the LINK addresses contain Fibre Channel adapter numbers. If you specify the wwnn for the primary logical subsystem, you must also specify the wwnn for the secondary logical subsystem. NOTE: wwnn cannot be used with serialno.

lss

Specifies a 2-digit hexadecimal value that specifies the logical subsystem for the device (ESS only).

Note: LSS number is required if the storage control supports logical subsystems (like the ESS) and not allowed if the storage control does not support logical subsystems.

SEC

Specifies the recovery site storage subsystem ID and serial number. The descriptions for the values are the same as for the PRIM parameter.

Note: The PRIM and SEC parameters must both specify either a serialno or a wwnn.

LINK

Specifies the addressing paths from the primary site logical subsystem to the recovery site logical subsystem.

Note: Duplicate link addresses are not allowed.

You can specify up to eight path addresses (if the primary site logical subsystem supports eight paths), separated with a blank, for each LINK parameter.

Each path address is an 8-digit hexadecimal address. If serialno is specified on the PRIM and SEC parameters, the format of each path address has the hex digit form of aaaabbcc where:

aaaa

Specifies the System Adapter ID (SAID) interface identifier on the primary system that uniquely identifies the physical location of the associated storage subsystem interface. The first two values are zeros (00aa), and the last two values are hexadecimal SAID byte values that correspond to ESCON channel interfaces, as follows:

                           
                   bit 0 = storage cluster (0 or 1)            
                   bit 1 = 0                                   
                   bit 2 = I/O board (0 or 1)                  
                   bit 3 = 0                                   
                   bits 4-5 = slot (00, 01, 10, or 11)         
                   bit 6 = 0                                   
                   bit 7 = port number (0 or 1 for each slot)  

bb

Specifies the recovery site logical subsystem ESCON link destination address. If the connection is routed through an ESCON Director, the bb value is the ESCON Director destination port. This value will be 00 if the link is between two open device logical subsystems. For direct fiber-optic cable connections between storage controls or static connections through an ESCON Director, the link address value is zero.

cc

For storage controls supporting logical subsystems, this value is the logical subsystem number. For storage controls not supporting logical subsystems or for fixed block logical subsystems, this value is 00.

If wwnn is specified on the PRIM and SEC parameters, the format of each Fibre Channel path address has the hex digit form of aaaabbbb where:

aaaa

Specifies the Fibre Channel adapter used for the path in the primary subsystem.

bbbb

Specifies the Fibre Channel adapter used for the path in the secondary subsystem.

For additional information about the LINK parameter, see Establishing PPRC paths.