z/OS TSO/E Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return codes for the CLIST built-in function exit

z/OS TSO/E Customization
SA32-0976-00

Table 1 shows the return codes that the CLIST built-in function exit supports.

Table 1. Return codes for the CLIST built-in function exit
Return code (decimal) Description
0 The exit has successfully evaluated the built-in function and has returned the result in the 256-byte answer area provided. CLIST processing continues.
4 The exit has successfully evaluated the built-in function. The exit has obtained an alternate buffer to return the result of evaluating the built-in function. CLIST processing continues, and frees the storage obtained for the buffer.
8 Exit processing was unsuccessful. The variable was not an installation-written built-in function and could not be evaluated. CLIST processing continues, and initializes the variable to a null value.
12 Exit processing was unsuccessful. The built-in function could not be evaluated. The following action is taken:
  • CLIST processing issues an error message to the terminal user
  • Control is passed to the ERROR exit, if one was specified, or CLIST processing terminates
  • The CLIST return code is set to 604
  • The variable &SYSREASON is set to the exit's return code
16 Exit processing was unsuccessful. The built-in function could not be evaluated. The following action is taken:
  • Control is passed to the ERROR exit, if one was specified, or CLIST processing terminates. However, CLIST processing does not issue a message.
  • The CLIST return code is set to 604
  • The variable &SYSREASON is set to the exit's return code

If your exit sets a return code of 16, you should consider displaying an informational message to the user. You can use the PUTLINE service routine to issue an informational message. See for more information.

Note: If the exit returns an undefined return code, CLIST processing terminates without issuing an error message to the user.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014