RSESSION (control a Global Mirror session)

Use request type RSESSION to control a Global Mirror session. This invokes ANTRQST ILK=ESSRVCS REQUEST=RSESSION.

SNBR(snbr)

Specifies the hexadecimal 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 to be used for I/O. DEVN is mutually exclusive with VOLSER. Either VOLSER or DEVN is required.

ACTION(action)

Specifies the action to be taken on the request. It is required. The values for action are:

DEFINE: The new Global Mirror physical session will be defined using the value specified with SNBR
UNDEFINE: The Global Mirror physical session specified with SNBR will be removed
START: The Global Mirror logical session is to start forming consistency groups
STOP: The Global Mirror logical session is to be terminated
PAUSE: The Global Mirror logical session is to pause forming consistency groups
RESUME: The Global Mirror logical session is to resume forming consistency groups.
If the Global Mirror session was paused in a consistent manner using CGPAUSE, RESUME automatically unsuspends and resyncs the Global Copy pairs in the session.
CGPAUSE: The Global Mirror session it so be paused and the Global Copy pairs in the session suspended so that the secondaries are consistent.

LSSTYPE(CKD | FB)

Specifies the type of devices within the LSS.

CKD: System z®-attached devices. This is the default.
FB: Open devices

LSSNBR(lssnbr)

Specifies the number of the LSS upon which the action, specified with ACTION, will be performed. This is required when a value of DEFINE or UNDEFINE is specified with ACTION.

ESSSERIAL(esserial)

Specifies the serial number of the storage control upon which the action, specified with ACTION, will be performed. This is required when a value of DEFINE or UNDEFINE is specified with ACTION.

MSSERIAL(msserial)

Specifies the serial number of the storage control of the Master. This is required when a value of START, RESUME, PAUSE or STOP is specified with ACTION.

SBINFO(sbinfo)

Specifies the information that describes the subordinate storage controls in a Global Mirror session. This is used with a value of START, RESUME, PAUSE or STOP for ACTION. It is specified once for each subordinate storage control in the session.

The format of sbinfo is mssid,sssid,serialno where:

mssid: Is the four-digit SSID number in the master storage control where the control path to this subordinate originates
sssid: Is the four-digit SSID number in the subordinate storage control where the control path from the master storage control terminates
serialno: Is the twelve-digit serial number of the subordinate storage control

The SSID values in a set come from the corresponding values that were used for the PESTPATH command connecting the master storage control and storage control subordinates.

Supply the value for SBINFO in SUPERZAP format, using a comma between every 4 digits. For example, to add a subordinate with a master session SSID of 1111, a subordinate serial number of 2222 and a subordinate serial number of 000000012345, specify:

SBINFO(1111,2222,0000,0001,2345)

To specify multiple subordinates, use a separate keyword for each subordinate:

SBINFO(1111,2222,0000,0001,2345)
SBINFO(3333,4444,0000,0006,7890)

MASTER(YES | NO)

Specifies whether the command is issued to the master storage control or a subordinate storage control in the Global Mirror session.

YES: It is issued to the master storage control. This is the default.
NO: It is issued to the subordinate storage control, pointed to by VOLSER or DEVN.

FORCE(NO | YES)

Used when STOP is specified with ACTION. Specifies whether the STOP action will wait until a consistent copy of the data has been formed.

NO: STOP will not complete until a consistent copy of the data has been formed. This is the default.
YES: STOP will be done even if a consistent copy of the data has not been formed

CGINTERVAL(cginterval)

Specifies, in hexadecimal, the number of seconds between formation of consistency groups. A value of zero means consistency groups will be formed consistently. CGINTERVAL is required if CGDRAIN is specified.

The default is 0.

CGDRAIN(cgdrain)

Specifies, in hexadecimal, the number of seconds allowed for updated tracks to be transferred from the primary volumes to the secondary volumes. The default is the larger of four minutes or twice the time specified with CGINTERVAL. If you specify 0, the value will be set to the default. CGDRAIN requires CGDRAIN and COORDINTERVAL.

COORDINTERVAL(coordinterval)

Specifies, in hexadecimal, the number of milliseconds allotted to allow the master storage control to communicate with subordinates in forming consistency groups. A value of zero requests the default, X'32' (decimal 50). COORDINTERVAL requires CGDRAIN and CGINTERVAL.

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.