Return codes for TSO/E REXX routines

The TSO/E REXX routines return a return code in register 15 that indicates whether processing was successful. The parameter lists for most of the routines also have a return code parameter that lets you specify a fullword field in which to receive the return code. The return code parameter lets high-level languages more easily obtain return code information. If you provide this parameter, the routine returns the return code in both the return code parameter and in register 15. If the parameter list you pass to the routine is invalid, the return code is returned in register 15 only.

Each TSO/E REXX routine has specific return codes. The individual topics in this book describe the return codes for each routine. Table 1 shows the common return codes that most of the TSO/E REXX routines use.

Table 1. Common return codes for TSO/E REXX routines
Return code	Description
0	Successful processing.
20	Error occurred. Processing was unsuccessful. The requested service was either partially completed or was terminated. An error message may be written to the error message field in the environment block. If the NOPMSGS flag is off for the environment, the message is also written to the output DD that is defined for the environment or to the terminal. For some errors, an alternate message may also be issued. Alternate messages are printed only if the ALTMSGS flag is on for the environment. The NOPMSGS and ALTMSGS flags are described in the topic Flags and corresponding masks. If multiple errors occurred and multiple error messages were issued, all error messages are written to the output DD or to the terminal. Additionally, the first error message is stored in the environment block.
28	A service was requested, but a valid language processor environment could not be located. The requested service is not performed.
32	Processing was not successful. The parameter list is not valid. The parameter list contains either too few or too many parameters, or the high-order bit of the last address in the parameter list is not set to 1 to indicate the end of the parameter list.