Every ANTRQST invocation must be specified with the subparameter
of RETINFO. The value specified with this subparameter references
a 100 byte area used by the SDM API to return detailed information
about the results of executing the request. This area is not used
to return information requested, such as when querying for information.
The first word returns the return code. The second word returns the
reason code. The information returned in the rest of the area depends
on the REQUEST type.
The following common parameters are all optional on every ANTRQST
invocation.
- RETCODE
- A RETCODE value may be specified to indicate the location of
an area into which the SDM API will place the scheduling return code.
Initial diagnostics are done by the SDM API to determine if all parameters
required and specified meet the needed requirements of a request,
and to determine if the environment can satisfy the request. This
diagnosis is called scheduling for the purposes of this documentation.
The return code is also always returned in register 15.
- RSNCODE
- A RSNCODE value may be specified to indicate the location of
an area into which the SDM API will place the scheduling reason code.
The reason code is also always returned in register 0.
- PLISTVER
- A PLISTVER value may be specified to indicate the SDM API parameter
area size to be used by the ANTRQST macro - whether to use the smallest
needed for the subparameters specified on the request, or to use the
maximum allowed by the SDM API macros.
- MF
- A MF value may be specified to indicate the ANTRQST macro form
to be used. For example, L for the list form of the macro, and E
for the executible form of the macro.