Subparameters for REQUEST=PESTPAIR

REQUEST=PESTPAIR

Asks for the CESTPAIR function of PPRC to be executed.

,DEVN=devn

A required input parameter field containing the binary device number to use for I/O.

If OPENDVCS=YES is specified, then devn identifies a System z® device to act as a CKD access volume. This devicemust be located in the same subsystem cluster as the primary device.

To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.

,CASCADE=cascade

,CASCADE=YES | NO

Specifies whether primary volume in this pair is also eligible to be the secondary volume in another PPRC pair. The values are:

NO: The primary volume is not eligible to be secondary in another PPRC pair. The default is NO.
YES: The primary volume is eligible to be secondary in another PPRC pair.

FORCE=force

FORCE=YES | NO

Specifies whether validation of the volumes involved in the establish request occurs, or is bypassed.

Note: This parameter is only valid when specified with MODE=INCRES, ACTION=FAILOVER, or ACTION=FAILBACK.

YES

Specifying FORCE(YES) with MODE(INCRES) indicates that normal validation that the volumes in the request have an intermediate volume in common is bypassed.
Specifying FORCE(YES) with ACTION(FAILOVER) or ACTION(FAILBACK) indicates that validation that the specified secondary is the existing suspended device in the existing relationship for the specified primary in FAILOVER mode is bypassed.

NO

Specifying FORCE(NO) with MODE(INCRES) indicates the following validation:
- The current failed secondary device for the primary specified, and the current failed primary device for the secondary specified are the same device.
Specifying FORCE(NO) with ACTION(FAILOVER) or ACTION(FAILBACK) indicates the following validation:
- The devices specified in the establish request are currently part of a suspended relationship (in failover state for ACTION(FAILBACK)).

To code: Specify the RS-type address, or address in register (2)-(12), of a 4-character field.

AUTORESYNC=autoresync

AUTORESYNC=YES|NO

Specifies the name (RS-type) or address in register (2) - (12) of a 3-character field that contains 'YES' or 'NO', specifying whether the auto resync capability is to be enabled or disabled for the Global Copy pair. The auto resync capability attempts to automatically resynchronize the pair if it has been suspended due to something other than a command. The specified character value is left-justified and padded on the right with blanks. The values are:

YES: Indicates that the auto resync capability should be enabled for the Global Copy pair. This is the default.
NO: Indicates that the auto resync capability should be disabled for the Global Copy pair.
You may want to use NO to disable the auto resync capability when the secondary of the Global Copy pair is or will be the source of a Space Efficient FlashCopy® relationship. An outage that results in many updates that must be copied when the pair is resynchronized could cause the space efficient repository to reach warning levels or even be filled.

If the keyword is not specified, the auto resync capability is enabled for the Global Copy pair. If NO is specified and option XD is not specified, the AUTORESYNC option is ignored.

INCRESYNC=incresync

Specifies whether the incremental re-synchronous change recording mechanism for M/GM is enabled. There is no default value for INCRESYNC. INCRESYNC is mutually exclusive with ACTION=FAILOVER.

START: The change recording mechanism is started.
STOP: The change recording mechanism is stopped.
NOCOPY: Used in recovery scenarios, where the incremental resync change recording mechanism needs to be started.

Note: If the INCRESYNC=NOCOPY parameter is specified in scenarios other than where it is intended, it cause you to make the recovery environment vulnerable to data integrity exposures. If blanks or binary zeros are specified, the INCRESYNC parameter is ignored.

,PCCA=pcca

A required input parameter field containing the binary channel connection address of the primary device. For open (fixed block) devices, this specifies the logical unit number (lun).

To code: Specify the RS-type address, or address in register (2)-(12), of a 1-byte field.

,PSERIAL=pserial

A required input parameter field containing the EBCDIC serial number of the primary storage control.

To code: Specify the RS-type address, or address in register (2)-(12), of a 12-character field.

,PSSID=pssid

A required input parameter field containing the binary subsystem ID of the primary storage control. When OPENDVCS=YES this value should be specified as X'FFFF'.

To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.

,SCCA=scca

A required input parameter field containing the binary channel connection address of the secondary device. For open (fixed block) devices, this specifies the logical unit number (lun).

To code: Specify the RS-type address, or address in register (2)-(12), of a 1-byte field.

,SSERIAL=sserial

A required input parameter field containing the EBCDIC serial number of the secondary storage control.

To code: Specify the RS-type address, or address in register (2)-(12), of a 12-character field.

,SSSID=sssid

A required input parameter field containing the binary subsystem ID of the secondary storage control. When OPENDVCS=YES this value should be specified as X'FFFF'.

To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.

,RETINFO=retinfo

A required output parameter field that is used to return detailed information about the results of executing the request. Information about the results of scheduling the request are returned in the RETCODE and RSNCODE fields. Align the area on a word boundary. The first 4-bytes contain the return code and the second 4-bytes contain the reason code. The remainder of the information is dependent on the return and reason codes. See the coding example SDM API usability guide about how to coordinate the RETCODE, RSNCODE, and RETINFO fields.

To code: Specify the RS-type address, or address in register (2)-(12), of a 100-character field.

,PLSS=plss

,PLSS=NO_PLSS

An optional input parameter field containing the binary logical subsystem number within the primary storage subsystem. This keyword is required for storage subsystems with logical subsystems and is invalid for 3990 and other 3990–compatible storage controls.

NO_PLSS Specifying this value is the same as omitting the PLSS keyword.

The default is NO_PLSS.

To code: Specify the RS-type address, or address in register (2)-(12), of an optional 1-byte field.

,SLSS=slss

,SLSS=NO_SLSS

An optional input parameter field containing the binary logical subsystem number within the secondary storage subsystem. This keyword is required for storage subsystems with logical subsystems and is invalid for 3990 and other 3990–compatible storage controls.

NO_SLSS Specifying this value is the same as omitting the SLSS keyword.

The default is NO_SLSS.

To code: Specify the RS-type address, or address in register (2)-(12), of an optional 1-byte field.

,CRIT=crit

,CRIT=NO

An optional input parameter field containing a keyword that indicates if this is a critical volume. The value is left-justified and padded on the right with blanks. If the field contains binary zeros, the program uses the default.

NO specifies that, following an I/O completion error, subsequent write requests to the PPRC primary volume are allowed.

YES specifies that if an I/O error occurs, subsequent writes are either allowed or not allowed, based on the 3990 maintenance panel setting. CRIT=YES is not supported with the ACTION parameter.

The default is NO.

To code: Specify the RS-type address, or address in register (2)-(12), of a 3-character field.

,MODE=mode

,MODE=COPY

An optional input parameter field containing a keyword that specifies how a volume pair is to be setup. The value is left-justified and padded on the right with blanks. If the field contains binary zeros, the program uses the default.

COPY specifies that all tracks on the primary volume are to be copied to the secondary volume. MODE=COPY is not supported with the ACTION parameter.

NOCOPY specifies that only those tracks on the primary volume that are updated after this request is executed are to be copied to the secondary volume.

INCRES causes that an incremental resynchronization using the change recording bitmaps to limit the tracks to be copied.

Note: MODE=INCRES is mutually exclusive with the all values for the ACTION and INCRESYNC keywords.

RESYNC specifies that a suspended copy be reestablished.

The default is COPY.

To code: Specify the RS-type address, or address in register (2)-(12), of a 6-character field.

,MSGREQ=msgreq

,MSGREQ=NO

An optional input parameter field containing a keyword that specifies whether to wait for FlashCopy Establish initialization to complete. The value is left-justified and padded on the right with blanks. If the field contains binary zeros, the program uses the default.

NO indicates to not wait.

YES indicates to wait.

The default is NO. MSGREQ is not supported with the ACTION parameter.

To code: Specify the RS-type address, or address in register (2)-(12), of a 3-character field.

,ONLINSEC=onlinsec

,ONLINSEC=NO

An optional input parameter field that contains a keyword that specifies whether Establish Pair processing should continue if the secondary device is possibly online to some host system. The value is left-justified and padded on the right with blanks. If the field contains binary zeros, the program uses the default.

YES indicates to continue Establish Pair processing if the secondary device is online to a host system.

NO indicates to fail Establish Pair processing if the secondary device is online to a host system.

The default is NO.

To code: Specify the RS-type address, or address in register (2)-(12), of an optional 3-character field.

,PACE=pace

,PACE=DEFAULT

An optional input parameter field that specifies the minimum number of tracks to be copied at one time before allowing another host interrupt. If a value is not supplied the default setup in the storage control will be used. The default is DEFAULT. PACE is not supported with the ACTION parameter.

To code: Specify the RS-type address, or address in register (2)-(12), of a 1-byte field.

,OPENDVCS=opendvcs

,OPENDVCS=NO

An optional input parameter field containing a keyword that indicates if the request is for Open System (Fixed Block) devices. The value is left-justified and padded on the right with blanks. If the field contains binary zeros, the OPENDVCS keyword is treated as omitted.

YES Specifying this value indicates the information for the primary and secondary devices (SSID, Serial, LSS, and CCA) applies to Open System devices, not the CKD DEVN device. The CCA value is treated as a Fixed Block Logical Unit Number (LUN). The DEVN parameter identifies a CKD device for receiving the request, but is not affected by this PPRC request.

NO Specifying this value is the same as omitting the OPENDVCS keyword. This value indicates the DEVN device and primary and secondary devices are CKD devices.

The default is NO.

To code: Specify the RS-type address, or address in register (2)-(12), of an optional 3-character field.

,ACTION=action

This field is the name (RS-type) (or address in register (2)-(12) of an optional 12-character field that identifies an action to take place on an already existing PPRC pair. The value is left justified and padded on the right with blanks. Values are:

FAILOVER: Specifies that the direction of the PPRC pair is to be reversed and change recording it to begin. Upon completion of the command, the specified primary device will be a suspended primary of a PPRC pair. Be sure to reverse devices when specifying primary and secondary parameters.
FAILBACK: Specifies that the failure condition at the primary site has been resolved and the changes that have taken place at the recovery site since the FAILOVER command was issued should now be copied to the original primary site. Be sure to specify original (non-reversed) primary and secondary device parameters.
MTFAILOVER: Specifies that a multi-target configuration should be created from a cascaded configuration. For example, in a cascaded configuration, H1->H2->H3, where H1 is the primary, issuing a CESTPAIR command with ACTION(MTFAILOVER) to the middle device, H2, causes a multi-target configuration (H2->H1 and H2-H3) in place of the previous cascaded failover state.

If ACTION is specified, the CRIT, CASCADE, PACE, and MSGREQ parameters are ignored.

SETGTOK=setgtok, SETGTOK=NO

This parameter is the name (RS-type) or address in register (2)-(12) of a three-character field that specifies whether the secondary of the specified pair can be a space-efficient volume. The specified character value is left-justified and padded on the right with blanks.

NO: Indicates that secondary cannot be a space-efficient volume. The default value is NO.
YES: Indicates that the secondary can be a space-efficient volume. If YES is specified and the secondary is not a space-efficient volume, the command is processed as if the keyword was not specified.

,ECB=ecb

,ECB=NO_ECB

An optional input parameter field that SDM will post for an asynchronous request. This field is ignored for synchronous requests. The default is NO_ECB.

To code: Specify the RS-type address, or address in register (2)-(12), of a fullword field.

,WAITTIME=waittime

,WAITTIME=0

An optional input field containing how long in seconds SDM waits for a request to complete. A value of zero indicates that the system does not time the request. If the time expires before the request is complete a value of, 7039, RQST_WAITTIME_EXPIRED (see ANTRQSTL) or 7200 (RQST_PESTPAIR_ERROR, with a message ANTP0217E indicating I/O timeout) is returned. If the request is a synchronous request, the value is placed in the return code part of RETINFO. If the request is an asynchronous request, the value is used as the ECB post code. Note that if waittime is specified with MSGREQ yes, then waittime greater than 255 seconds will not be reduced. Otherwise, if waittime is less than five seconds and MSGREQ is not yes, then SDM changes waittime to five seconds. If waittime is greater than 255 seconds, SDM changes waittime to 255 seconds.

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

RESETRSV=resetrsv, RESETRSV=NO

This parameter is the name (RS-type) or address in register (2)-(12) of a three-character field that specifies whether an existing reserve on the specified fixed block secondary should be reset (removed) by the control unit during the establish-pair processing. The specified character value is left-justified and padded on the right with blanks. The values are:

NO: Indicates that any reserve that exists on the specified secondary device should not be reset. This is the default.
YES: Indicates that if there is a reserve on the specified secondary device, that reserve should be reset.