Return code

A fullword, set by the exit, that indicates success or failure of the exit call, and the action taken by the assembler on return from the exit. Table 1 summarizes the return codes.

Return code 20 is described at Error handling.

Table 1. User-exit return codes
Exit	Request	RC=0	4	8	16	20⁷
SOURCE	OPEN	Assembler to open the primary input data set ¹	Exit provides records ²		Disable ⁶	Operation failed
	CLOSE	Operation successful				Operation failed
	READ	Exit has provided record			End-of-file indicator	Operation failed
	PROCESS	Accept record	Discard record		Disable ⁶	Operation failed
	REINIT	Operation successful			Disable ⁶	Operation failed
LIBRARY	OPEN	Assembler to open its library ¹	Exit has opened its library ³	Exit has opened its library, assembler to open its library	Disable ⁶	Operation failed
	CLOSE	Operation successful				Operation failed
	READ	Exit has provided record			EOD on input source	Operation failed
	PROCESS (macro or copy member)	Accept record	Discard record		Disable ^5,⁶	Operation failed
	FIND (macro or copy member)	Operation successful	Member not found; search assembler library if available			Operation failed
	END OF MEMBER	Operation successful			Disable ^5,⁶	Operation failed
	REINIT	Operation successful			Disable ⁶	Operation failed
LISTING PUNCH OBJECT(z/OS and CMS) TERM ADATA	OPEN	Assembler opens the output data set ¹	Exit has opened its output data set ⁴		Disable ⁶	Operation failed
	CLOSE	Operation successful				Operation failed
	WRITE	Exit has written record				Operation failed
	PROCESS	Accept record	Discard record		Disable ⁶	Operation failed
	REINIT	Operation successful			Disable ⁶	Operation failed
Notes: The assembler only uses the PROCESS and CLOSE operation codes on subsequent calls. The assembler only uses the READ and CLOSE operation codes on subsequent calls. The assembler only uses the READ, FIND, and CLOSE operation codes on subsequent calls. The assembler only uses the WRITE and CLOSE operation codes on subsequent calls. This return is valid from all PROCESS and END OF MEMBER requests, with these exceptions: PROCESS MACRO requests when the LIBRARY exit set the return code of 8 for the OPEN request. PROCESS COPY requests when the LIBRARY exit set the return code of 8 for the OPEN request. END OF MEMBER requests when the LIBRARY exit set the return code of 4 or 8 for the OPEN request. If an exit sets the disable return code, then the assembler does not call that exit again, so do any any resource clean-up before returning control to the assembler. See Error handling.