Return codes

If IRXJCL encounters an error, it returns a return code. If you invoke IRXJCL from JCL to run an exec in MVS™ batch, IRXJCL returns the return code as the step condition code. If you call IRXJCL from an exec or program, IRXJCL returns the return code in register 15. Table 1 describes the return codes.

Table 1. Return codes for IRXJCL routine
Return code	Description
0	Processing was successful. Exec processing completed.
20	Processing was not successful. The exec was not processed.
20021	An invalid parameter was specified on the JCL EXEC statement or the parameter list passed on the call to IRXJCL was incorrect. Some possible errors could be that a parameter was either blank or null or the name of the exec was not valid (more than eight characters long). If you run an exec in MVS batch and a return code of 20021 is returned, the value 3637, in decimal, is returned as the step completion code. For more information, see note 2 below.
Other	Any other return code not equal to 0, 20, or 20021 is the return code from the REXX exec on the RETURN or EXIT keyword instruction. For more information, see the two notes below.

Note:

No distinction is made between the REXX exec returning a value of 0, 20, or 20021 on the RETURN or EXIT instruction and IRXJCL returning a return code of 0, 20, or 20021.
IRXJCL returns a return code as the step completion code. However, the step completion code is limited to a maximum of 4095, in decimal. If the return code is greater than 4095 (decimal), the system uses the rightmost three digits of the hexadecimal representation of the return code and converts it to decimal for use as the step completion code. For example, suppose the exec returns a return code of 8002, in decimal, on the RETURN or EXIT instruction. The value 8002 (decimal) is X'1F42' in hexadecimal. The system takes the rightmost three digits of the hexadecimal value (X'F42') and converts it to decimal (3906) to use as the step completion code. The step completion code that is returned is 3906, in decimal.