Return and reason codes

When the ANTRQST macro returns control to your program the following occurs:

General purpose register (GPR) 15 (and retcode, when you code RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, when you code RSNCODE) contains reason code.

There are two ways that return and reason codes can be returned to the caller:

In the RTNCODE and RSNCODE fields. These codes are returned by the system data mover (SDM) module ANTCDPI that runs in the caller's address space. They are associated with the validation of common parameters supplied on the ANTRQST macro (ASYNCH, for example) along with verifying the environment (for example, a PPRC request that address space ANTAS000 is active). The parameters from the ANTRQST invocation are placed in a parameter list (called the ANTRQSTL).
In the return code and reason code part of the RETINFO field. Once the request has been transferred to the appropriate SDM address space, there is no mechanism provided by z/OS to get information back to the caller's RTNCODE and RSNCODE fields (actually registers 15 and 0). The codes returned in the RETINFO field have to do with additional validation of parameters, scheduling of processing that runs in an SDM address space, and the results of executing the request. For ILK=XRC requests that also specify a MESSAGES subparameter, the RETINFO return code reflects only the results of scheduling the request to the XRC data mover address space. If scheduling is successful, the execution results are placed in the message buffer specified by the MESSAGES subparameter.

Return codes will be found in either RTNCODE or RETINFO, but not both. EXCEPTION: return code 0 can be found in both places.

Executable macro ANTRQSTL has been provided to include definitions and descriptions of the return code and reason code values. These descriptions can also be found in z/OS MVS System Messages, Vol 1 (ABA-AOM).

For ANTRQST return and reason codes, refer to z/OS MVS System Messages, Vol 1 (ABA-AOM). It identifies hexadecimal and decimal return codes and reason codes. IBM® support personnel may request the entire reason code, SYSLOG, and any associated dumps.