- REQUEST=XADD
- Adds
pairs of volumes to an XRC session.
- SID=sid
- A required
input character field containing the XRC session
ID to which the request is sent. The ID is left-justified and padded
on the right with blanks.
To code: Specify the RS-type address, or address in register (2)-(12), of an 8-character field.
- ,PVOLSER=pvolser
- Belongs to a set of mutually exclusive keys.
To code: Specify the RS-type address, or address in register (2)-(12), of a 6-character field that contains a primary volser to be added.
- ,VOLLIST=xvollist
- Belongs to a set of mutually exclusive keys. It is the name
(RS-type), or address in register (2)-(12), of a variable character
input field containing from 2 to 100 volsers of volume pairs
to be added. Must be an even number. This field is structured as
follows:
- A 1-byte field with a hexadecimal count of the number of volsers in the list.
- A list of 6-byte volsers.
- ,SVOLSER=svolser
To code: Specify the RS-type address, or address in register (2)-(12), of a required 6-character field that contains a secondary volser to be added.
- ,COPY=copy
- ,COPY=FUL
- An optional input parameter
field containing a keyword that
indicates the type of volume initialization the system should use
to copy the primary volume to the secondary 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 an initial copy not take place.
FUL specifies that a full initial copy take place.
The default is FUL.
QIK specifies that a quick initial copy take place.
To code: Specify the RS-type address, or address in register (2)-(12), of an optional 3-character field.
- ,ERRLVL=errlvl
- ,ERRLVL=SYSTEM
- An optional input parameter field containing an error level
that is associated with the volume pair. The value is left-justified
and padded on the right with blanks. If the field contains binary
zeros, the system program uses the default, which is entered with
the XSTART command.
The default is SYSTEM.
To code: Specify the RS-type address, or address in register (2)-(12), of an optional 8-character field.
- ,DONOTBLOCK=xdonotblock
- ,DONOTBLOCK=NO
- Part of a mutually exclusive set with DVCBLOCK, DONOTBLOCK is
the name (RS-type) (or address in register (2)-(12) ASM only) of an
optional 3 character input field containing a keyword that indicates
if device blocking should be disallowed. The value is left justified
and padded on the right with blanks. If the field contains binary
zeros the default will be taken.
NO specifies that device blocking is allowed. This is the default.
YES specifies that the volume will be exempted from device blocking and write pacing.
- ,DVCBLOCK=xdvcblock
- ,DVCBLOCK=ON | WPn | OFF
- Part of a mutually exclusive set with DONOTBLOCK, DVCBLOCK is the name (RS-type) (or address in
register (2)-(12) ASM only) of an optional 3-character input field containing a keyword that
indicates if device blocking should be enabled or disabled.
Workload-based write pacing affects the
behavior of DVCBLOCK. For more information, refer to Workload-based write pacing.
ON specifies that device blocking is enabled.
When workload-based write pacing is in use, XRC automatically converts DVCBLOCK=ON to
DVCBLOCK=WPn, where n is the discretionary level, 6.WPn Specifies that write pacing is to be activated for the specified volume(s), with n specifying the level of write pacing delay, 0-F. WP0 specifies that the session default level will be used, as specified the SHADOW DfltWritePacingLvl PARMLIB value. WP1-WP7 results in pacing maximums ranging from 0.02 to 2 ms per recordset, and are useful for volumes with high rates of small blocksize writes, such as data base logs, where minimal response time impact is essential. WP8-WPB results in pacing maximums ranging from 5 to 50 ms per recordset, useful for volumes with high mb/sec write rates. WPC-WPF results in pacing maximums ranging from 100 to 1000 ms per recordset, and should be used in exceptional situations where a high degree of pacing is required.
OFF specifies that both device blocking and write pacing are disabled. The value is left justified and padded on the right with blanks. If the field contains binary zeros the default will be taken.
If neither DVCBLOCK nor DONOTBLOCK is specified, DONOTBLOCK=NO is the default.
- ,SCSESSION=scsession
- ,SCSESSION=– –
- An optional input parameter field containing an alphabetic value
that allows specifying a storage control session name for a volume
pair. The value is left-justified and padded on the right with blanks.
If the field contains binary zeros, the program uses the default.
The default is – –.
SCSESSION cannot be specified when LOGPLUS=YES is specified.
To code: Specify the RS-type address, or address in register (2)-(12), of an optional 2-character field.
- ,LOGPLUS=xlogplus
- ,LOGPLUS=NO | YES
- Specifies whether the primary volume of the volume pair is to
be explicitly written to by the z/OS® System
Logger.
YES the primary volume of the volume pair is to be explicitly written to by the z/OS System Logger. When using LOGPLUS, you can specify a single pair or a single pair and a utility pair, but the utility pair must be specified last. A unique storage control session number will be assigned to the primary volume. LOGPLUS=YES cannot be specified with SCSESSION.
NO indicates that LOGPLUS is not used. The default is NO.
To code: Specify the RS-type address, or address in register (2)-(12), of an optional 3-character field.
- ,SUSPENDED=suspended
- Belongs to a set of mutually exclusive keys. A required input
parameter field containing a keyword that indicates if all suspended
volume pairs are to be added back into the session. The value is left-justified
and padded on the right with blanks. If the field contains binary
zeros, the program uses the default.
YES specifies that suspended volume pairs be re-added.
NO specifies that suspended pairs not be re-added.
The default is NO.
To code: Specify the RS-type address, or address in register (2)-(12), of a 3-character 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.
- ,MESSAGES=messages
- A required output parameter field in which ANTRQST will place
the address of a buffer containing messages about the results of executing
the request. These are the messages that would have been returned
to the caller if the TSO interface had been used. If there are no
messages, the address will be zero.
An ANTRQST message buffer has the following format:
- Bytes 1-4 contain the size of the ANTRQST message buffer.
- Byte 5 contains the subpool of the ANTRQST message buffer.
- Byte 6 is not used.
- Bytes 7-8 contain the number of messages in the array that follows.
The rest of the message buffer is an array of messages. Each message has the following format:
- Bytes 1-2 contain the size of the message in bytes 3-x.
- Bytes 3-x contain the message.
To code: Specify the RS-type address, or address in register (2)-(12), of a required 4-byte field.
- ,ECB=ecb
- ,ECB=NO_ECB
- An optional input
parameter field that SDM posts 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 parameter
field containing how long in seconds
SDM must wait for a request to complete. A value of zero says to
not time the request. If the time expires before the request is complete
a value of 7039 (RQST_WAITTIME_EXPIRED [see ANTRQSTL]) is returned.
If the request is a synchronous request the value is placed in the
RTNCODE part of the RETINFO field. If the request is an asynchronous
request the value is used as the ECB post code. The default is 0.
To code: Specify the RS-type address, or address in register (2)-(12), of a halfword field.