- REQUEST=RVOLUME
- Specifies
volumes to be shadowed in the Global Mirror for ESS session.
- ,SNBR=sessno
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 1-byte value between 00 and FF, identifying the session number.
- ,VOLSER=volno
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 6-character MVS volume serial number of the device to be used for I/O. For CKD, volno must be in the LSS as the volumes targeted by the command. For FB, volno must be in the same cluster as the volumes targeted by the command.
- ,DEVN=devn
- A required input parameter field containing the binary device
number to use for I/O.
The allowed values specified in this keyword are a 4 hexadecimal character MVS device number. This keyword is mutually exclusive with the VOLSER keyword.
To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.
- ,LSSTYPE=lsstype
- ,LSSTYPE=CKD
- Is the name (RS-type) (or address in register (2)-(12) ASM only)
of an optional 3-byte (character) field identifying the type of devices
in the LSS. The value is left-justified and padded on the right with
blanks. This parameter defaults to CKD and is only required when addressing
open devices with ACTION DEFINE or UNDEFINE requests. Valid values
are:
- FB
- The LSS contains open, or fixed block devices.
- CKD
- The LSS contains count key data, or System z®-attached devices.
- ,LSSNBR=lss
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 1-byte field identifying the LSS this command targets. This parameter is required for DEFINE and UNDEFINE actions, and ignored for the remaining actions.
- ,ESSSERIAL=ess
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 12-byte field that identifies the serial number of the ESS storage control that this request targets. This parameter is required for DEFINE and UNDEFINE actions, and ignored for the other actions.
- ,ACTION=action
- Is the name (RS-type) (or address in register (2)-(12) ASM only)
of a required 12-character value identifying the specific action to
be performed.
- JOIN
- Indicates that volume sets specified in the VOLLIST or VOLRANGE parameter are to be added to the Global Mirror session specified by SNBR.
- REMOVE
- Indicates that volume sets specified in the VOLLIST or VOLRANGE parameter are to be removed from the Global Mirror session specified by SNBR.
- ,VOLLIST=vlist
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a variable length field that
identifies a list of Channel Connection Addresses (CCAs) or Logical Unit Numbers (LUNs) that are
involved in the action. The first byte, n, indicates how many CCAs or LUNs are specified. The
remaining bytes contain one-byte addresses. Up to 256 CCAs or LUNs can be specified. All CCAs/LUNs
must be defined in the LSS specified in the LSSNBR parameter. This parameter is mutually exclusive
with VOLRANGE
, MTVOLLIST and MTVOLRANGE
. - ,VOLRANGE=vrange
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a variable length field that
identifies a list of ranges of Channel Connection Addresses (CCAs) or Logical Unit Numbers (LUNs)
that are involved in the action. The first byte, n, indicates how many ranges are specified.
The remaining bytes contain two-byte pairs. The first byte is the CCA or LUN of the first device in
the range and the second byte is the CCA or LUN of the last device in the range. Up to 256 ranges of
CCAs or LUNs can be specified. All CCAs/LUNs must be defined in the LSS specified in the LSSNBR
parameter. This parameter is mutually exclusive with VOLLIST,
MTVOLLIST and MTVOLRANGE.
- ,MTVOLLIST=vlist
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a variable length field that
identifies a list of CCAs or LUNs, and their associated PPRC secondary information (serial number,
LSS, and CCA/LUN), that are to be joined to or removed from the Global Mirror session.
The first byte, n, indicates how many primary CCAs or LUNs are specified. The remaining bytes are treated as an array with n entries. Each array entry consists of the following:
- pcca
- Specifies the one-byte primary CCA (or LUN)
- secser#
- Specifies the 12-character serial number of the secondary device's SFI for the Global Copy pair
- slss
- Specifies the one-byte LSS number of the secondary device for the Global Copy pair
- scca
- Specifies the one-byte CCA (or LUN) number of the secondary device for the Global Copy pair
Specify up to 255 device sets. This parameter is mutually exclusive with MTVOLRANGE, VOLLIST and VOLRANGE. When there are multiple secondaries, you must use MTVOLLIST or MTVOLRANGE.
- ,MTVOLRANGE=vrange
- Is the name (RS-type) (or address in register (2)-(12) ASM only) of a variable length field that
identifies a list of primary device ranges in an LSS and their associated PPRC
secondary information (serial number, LSS, and CCA/LUN) that are to be added to or removed from the
Global Mirror session. The first byte, n, indicates how many primary CCAs or LUNs
are specified. The remaining bytes are treated as an array with n entries. Each
array entry consists of the following:
- pcca1
- Specifies the first primary CCA (or LUN) in a range of contiguous primary devices
- pccax
- Specifies the last primary CCA (or LUN) in a range of contiguous primary devices
- secser#
- Specifies the serial number of the secondary device's SFI for the Global Copy pair
- slss
- Specifies the LSS number of the secondary device for the Global Copy pair
- scca1
- Specifies the first CCA (or LUN) of the secondary device for the Global Copy pair. The last secondary CCA is derived from the number of devices specified in the pcca1-pccax range.
- ,SUBCHSET=subchset
- ,SUBCHSET=0
- Specifies the subchannel set in which the command is to be issued.
The subchannel set where the I/O will be issued is the subchannel
set as defined in the Hardware Configuration Dialog (HCD). The valid
values are determined by what is currently supported by the host system's
processor and configured for the device.
If you specify a value of X'00' or omit this keyword, the command is issued to the device that is currently logically in subchannel set 0. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.
To code: Specify the RS-type name, or address in register (2)-(12), of an optional 1-byte (character) field.