XSTATUS (XRC status)

Use request type XSTATUS to return status on an XRC session. This invokes ANTRQST ILK=XRC REQUEST=XSTATUS.

ETYPE(ADDRSPACE | CLUSTER)
Specifies the type of the XSTATUS query. It is required.
ADDRSPACE
Display the names of all active XRC address spaces in the LPAR. This is the default.
CLUSTER
Display information about coupled XRC sessions associated with the cluster session in the LPAR.
DSNAME(dataset-name)
Specifies that XRC direct the XSTATUS output to a sequential data set that is identified by dataset-name. The data set must already be allocated and must be large enough to accommodate the requested XSTATUS reports. DSNAME is mutually exclusive with MESSAGES.
DSDISP(OLD | MOD | SHR)
Specifies how XRC writes the XSTATUS output to the data set:
OLD
Clear the data set before it receives the output. This is the default.
MOD
Append the output to the data set.
SHR
Clear the data set before it receives the output. SHR allows multiple allocations of the same data set.
DSDISP requires DSNAME.
MESSAGES(msg)
Specifies a variable in which ANTRQST will place the address of a buffer containing messages about the results of the processed request. These are messages that would have been returned to the caller if the TSO interface had been used. Refer to the ANTRQST macro for the format of the buffer.
WAITTIME(waittime | 0)
Contains a 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.