Subparameters for REQUEST=RSESSION

REQUEST=RSESSION

Asks for the Global Mirror for ESS function to be executed.

,SNBR=sessno

Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 1-byte value between 01 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 targeted by the command. For FB, volno must be in the same cluster as the target of 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.

,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.

DEFINE: Define a new Global Mirror session .
UNDEFINE: Remove the specified Global Mirror session.
START: Start forming consistency groups for the specified Global Mirror session.
RESUME: Restart the specified Global Mirror session with new tuning values.
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.
PAUSE: Pause the specified Global Mirror session.
STOP: Terminate the specified Global Mirror session.
CGPAUSE: Pause the Global Mirror session and suspend the Global Copy pairs in the session so that the secondaries are consistent.

,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.

,CGINTERVAL=cgint

,CGINTERVAL=0

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional half-word field containing a hexadecimal number between X'0000' and X'FFFF' that specifies the consistency group interval time in seconds. If this field is set to zero, consistency groups will be formed continuously. This parameter is optional on a START action, required on a RESUME action, and ignored for all other actions. If this parameter is specified, then CGDRAIN and COORDINTERVAL are required.

,CGDRAIN=drain

,CGDRAIN=30

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional half-word field containing a hexadecimal number between X'0000' and X'FFFF' that specifies the maximum consistency group drain time in seconds. If this field is set to zero, the default value of 30 seconds is used. This parameter is optional on a START action, required on a RESUME action, and ignored for all other actions. If this parameter is specified, then CGINTERVAL and COORDINTERVAL are required.

,COORDINTERVAL=coord

,COORDINTERVAL=50

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional half-word field containing a hexadecimal number between X'0000' and X'FFFF' that specifies the consistency group maximum coordination interval in milliseconds. If this field is set to zero, default of 50 ms is used. This parameter is optional on a START action, required on a RESUME action, and ignored for all other actions. If this parameter is specified, then CGINTERVAL and CGDRAIN are required.

,MSSERIAL=msser

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 12-byte field that specifies the serial number of the master storage control. This parameter is required on a START, RESUME, PAUSE, or STOP actions and ignored for other actions.

,SBINFO=nMssidSssidSerialnoMssidSssidSerialno...

Is the name (RS-type) (or address in register (2)-(12) of an optional variable length field that specifies a list of ESS subordinate sets (topography) in the session. The 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. This parameter is required for START, RESUME, PAUSE, and STOP actions and ignored for the other actions.

n: Is the number of ESS subordinate sets, and is one byte long.

Each subordinate set includes:

Mssid: The two-byte master SSID where the control path originates connecting the subordinate storage control.
Sssid: The two-byte subordinate SSID where the control path from the master storage control is established.
Serialno: A 12-byte subordinate storage control serial number.

,MASTER=master

,MASTER=YES

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 3-character field specifying whether this command is being issued to a master storage control or to a subordinate storage control. Valid values are YES and NO. The value is left-justified and padded on the right with blanks. This parameter is optional for a STOP action and is ignored for all other actions. Pause is always done to the Master. Stop is issued to the master unless there is an error, in which case Stop may be issued to each subordinate. If you stop an individual subordinate while a session is running, it will cause the session to go into a fatal status. The session will have to be stopped, corrected, then started again.

YES: Indicates the action is issued to the master storage control. This is the default.
No: Indicates the action is issued to a subordinate storage control.

,FORCE=force

,FORCE=NO

Is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 3-character field specifying what kind of cleanup is to be done. Valid values are YES and NO. The value is left-justified and padded on the right with blanks. This parameter is optional for a STOP action, ignored for all other actions.

YES: Indicates that the STOP is to be performed even if a consistent copy of data cannot be created at the recovery site.
No: Indicates the stop will not complete until a consistent copy of the data has been formed. This is the default.

,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.