RVOLUME (Global Mirror manage volumes)

Use request type RVOLUME to manage Global Mirror volumes. This invokes ANTRQST ILK=ESSRVCS REQUEST=RVOLUME.

SNBR(snbr)

Specifies the hexadecimal Global Mirror session number. It is required.

VOLSER(volser)

Specifies the volume serial number of the device to be used for I/O. VOLSER is mutually exclusive with DEVN. Either VOLSER or DEVN is required.

DEVN(devn)

Specifies the hexadecimal device number of the device to be used for I/O. DEVN is mutually exclusive with VOLSER. Either DEVN or VOLSER is required.

ACTION(JOIN | REMOVE)

Specifies the action to be taken. It is required.

JOIN

Devices specified should be added to the Global Mirror session that is defined with the SNBR parameter

REMOVE

Devices specified should be removed from the Global Mirror session that is defined with the SNBR parameter

LSSNBR(lssnbr)

Specifies the number of the LSS upon which the action will be performed. It is required.

ESSSERIAL(essserial)

Specifies the serial number of the storage control upon which the action will be performed. It is required.

VOLLIST(vol1,vol2,….)

Specifies a list of Channel Connection Addresses (CCAs) or Logical Unit Numbers (LUNs) that are affected by the action specified with ACTION. VOLLIST is mutually exclusive with VOLRANGE, MTVOLLIST and MTVOLRANGE. VOLLIST, VOLRANGE, MTVOLLIST or MTVOLRANGE is required. You can include up to 14 2-digit CCAs, separated by commas, with each VOLLIST keyword, and you can specify VOLLIST multiple times. For example, to specify devices from CCA 00 to CCA 07, you could use:

VOLLIST(00,01,02,04,05,06,07)

or

VOLLIST(00,01,02,03)
VOLLIST(04,05,06,07) 

You can specify up to 26 CCAs with an RVOLUME command.

VOLRANGE(volrange1,xvolrange2,….)

Specifies a list of ranges of Channel Connection Addresses (CCAs) or Logical Unit Numbers (LUNs) that are affected by the action specified with ACTION. VOLRANGE is mutually exclusive with VOLLIST, MTVOLLIST and MTVOLRANGE. VOLLIST, VOLRANGE, MTVOLLIST or MTVOLRANGE is required. You can specify up to 8 4-digit volume ranges, separated by commas, with each VOLRANGE keyword, and you can specify VOLRANGE multiple times. For example, to specify devices from CCA 00 to CCA 07 and CCA 09 to CCA 14, you could use:

VOLRANGE(0007,0914) 

or

VOLRANGE(0007)
VOLRANGE(0914)  

You can specify up to 31 ranges with an RVOLUME command.

MTVOLLIST(pcca,secser#,slss,scca)

Specifies a list of Global Copy device numbers that are affected by the action specified with ACTION.

pcca

Specifies the primary CCA (or LUN)

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

scca

Specifies the CCA (or LUN) number of the secondary device for the Global Copy pair

You can use the MTVOLLIST keyword up to 32 times to specify more devices. MTVOLLIST is mutually exclusive with VOLLIST, VOLRANGE, and MTVOLRANGE.

MTVOLRANGE(pcca1:pccax,secser#,slss,scca1)

Specifies a list of primary device ranges in an LSS that are affected by the action specified with ACTION.

pcca1:pccax

Specifies the first and last primary CCA (or LUN) in a range of contiguous primary devices. The first and last CCA indicated are separated by a colon.

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.

Up to 32 device set ranges may be specified, specifying the MTVOLRANGE keyword for device set. MTVOLRANGE is mutually exclusive with VOLLIST, VOLRANGE, and MTVOLLIST.

LSSTYPE(CKD | FB)

Specifies the type of devices within the LSS.

CKD

System z-attached devices. This is the default.

FB

Open devices

WAITTIME(waittime | 0)

Specifies the number of seconds that SDM must wait for a request to complete. A value of zero specifies that the request should not be timed. Valid values are 0 through 65535. The default is 0.

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 supported by the host system's processor and configured for the device.

If you omit the parameter, the command is issued to the device that is 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.