- ,LOGPLUS=xlogplus
- ,LOGPLUS=NO | YES
- An optional input parameter field specifying whether the values
for SID and HLQ should be obtained from the DefaultSessionId and DefaultHlq
parmlib values. The value is left-justified and padded on the right
with blanks. If the field contains binary zeros the default NO is
assumed.
NO indicates that the SID and HLQ
values are specified in this request.
YES indicates
that LOGPLUS is to be used and the values for SID and HLQ are to be
obtained from the DefaultSessionId and DefaultHlq parmlib values.
LOGPLUS=YES cannot be specified with any other XCONTIME request parameters.
Note: For XRC coupled sessions, issue the XRECOVER request for
the session before you issue this request. This ensures that the
consistency time returned is the master recoverable time.
To code: Specify the RS-type address,
or address in register (2)-(12), of an 3-character field.
- ,SID=sid
- A
required input parameter field containing the XRC session
ID to which the request is sent. The ID is left-justified and padded
on the right with blanks. SID is not required
when
LOGPLUS=YES is specified.
To code: Specify
the RS-type address, or address in register (2)-(12), of an 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.
- ,TIME=time
- A required output parameter field used to return the consistency
time for the specified XRC session. The returned time is a 64-bit
time-of-day (TOD) value in UTC (universal time, coordinated) format.
The consistency time returned is the time to which volume pairs in
the XRC session were last consistent. The time is taken from the application
system clock.
The optional ALET parameter can be used to specify
the location of the TIME field.
To code: Specify
the RS-type address, or address in register (2)-(12), of an 8-character
field.
- ,ALET=alet
- ,ALET=0
- An
optional input parameter field that specifies the ALET value
to be used if the TIME field has an ALET value different from the
one associated with the caller. The default is 0.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a fullword 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.
- ,HLQ=hlq
- ,HLQ=SYS1
- An optional input
parameter field containing the high level
qualifier that was used on the XSTART command. The name is left-justified
and padded on the right with blanks. If the field contains binary
zeros, the program uses the default.
The HLQ name will only be
used if XRC is not active. In this case the consistency time will
be obtained from the XRC state data set that has the supplied high
level qualifier in the data set name, and a code of 7113 (RQST_XCONTIME_SAVED_CONSISTENCY_TIME
[see ANTRQSTL]) will be returned. The default is SYS1.
To code: Specify the RS-type address, or address
in register (2)-(12), of an 8-character field.
- ,WAITTIME=waittime
- ,WAITTIME=0
- An optional input parameter
field containing how long in seconds
SDM will 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]) will be returned.
If the request is a synchronous request the value will be placed in
the RTNCODE field. If the request is an asynchronous request the value
will be 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.