DESERV FUNC=EXIT Return and Reason Codes

The formats of the return and reason codes are:

Offset/length: Description
00 (X'00') 1 byte: SMS Component code (X'27') indicates Common Adaptor (of which DESERV is a part)
01 (X'01') 1 byte: Module ID - used for problem diagnosis
02 (X'02') 2 bytes: Reason code - identifies the error. A program testing the DESERV reason code should only look at these last two bytes. The component id and module id should not be tested. They are reported for diagnostic purposes only.

The following are the two low order byte values for the reason codes that DESERV FUNC=EXIT might return (sorted by return code).

Table 1. Return and Reason Codes for the Exit DESERV Function
Return Code	Reason Code	Symbolic name	Description
X'0'		DESRC_SUCC	Successful
	X'00'	DESRS_SUCC	Successful
X'4'		DESRC_INFO	Not completely successful.
	X'400'	DESRS_NAME_ NOT_DEFINED	Name to be replaced did not previously exist
X'8'		DESRC_WARN	Results questionable
X'12'		DESRC_PARM	Missing or invalid parameters
	X'411'	DESRS_INVALID_ PARM_LIST_HEADER	The id, length, or level of the DESP is not valid
	X'415'	DESRS_PDS_ NOT_SUPPORTED	This function requires a PDSE data set
	X'41E'	DESRS_INVALID_ DEB_PTR	Address of the DEB is 0 or DEB was input but the DCB pointed to by the DEB did not point back to the DEB
	X'41F'	DESRS_DCB_NOT_ OPEN_OUTPUT	With function PUT the DCB must have been opened for output
	X'421'	DESRS_DCB_ NOT_OPEN	The passed DCB is not opened
	X'422'	DESRS_INVALID_ DCB_PTR	The address of the DCB is 0
	X'423'	DESRS_DEB_ REQUIRES_AUTH	To pass the DEB, the caller must be in supervisor state or a privileged key
	X'424'	DESRS_ UNSUPPORTED_FUNC	The FUNC value is incorrect
	X'427'	DESRS_INVALID_ MEM_DATA_CNT	The count of entries in the MEM_DATA block is 0
	X'428'	DESRS_INVALID_ MEM_DATA_PTR	The address of the MEM_DATA block is 0
	X'429'	DESRS_INVALID_ PUT_OPTION	The PUT function requires that the OPTION field be specified
X'16'		DESRC_CALR	Caller has a problem
	X'3FD'	DESRS_PRI_ NM_THIS_FILE	Alias name is same name as primary name for this member
	X'400'	DESRS_NAME_ ALREADY_EXISTS	Name to be replaced did not previously exist
	X'40E'	DESRS_NAME_ ALREADY_EXISTS	The PUT failed because of a name conflict
	X'40F'	DESRS_NP_ PRIMARY_NAME	The MEM_DATA must have one member designated as primary
	X'410'	DESRS_INVALID_ NAME_PREFIX	The first 8 bytes of a name were all X'FF'
	X'412'	DESRS_MORE_ THAN_!_PRIMARY	The MEM_DATA must have only one member designated as primary
	X'413'	DESRS_ INVALID_MLT	MLT is not valid
	X'414'	DESRS_ INVALID_CT	Connect token is not valid
	X'41D'	DESRS_DEBCHK_ FAILED	The DEBCHK macro failed, the DCB or DEB was not valid
	X'425'	DESRS_INVALID_ NAME_LENGTH	The length of an alias name was either 0 or greater than 8
	X'43A'	DESRS_DATA_ LENGTH_ERROR	The DESD data length is not valid, data length must be greater than 0 and less than 108 bytes
	X'43C'	DESRS_NAME_ IS_PRIMARY_NAME	The alias name specified is a primary name and the options did not allow for deleting primary name
X'20'		DESRC_ENVR	Resources unavailable
X'24'		DESRC_IOER	I/O error
X'28'		DESRC_MEDE	Media Error
X'32'		DESRC_DSLE	Data Set logical error
X'36'		DESRC_SEVE	Severe error
	X'407'	DESRS_ SETLOOK_ERR	Bad return code from SETLOCK
	X'437'	DESRS_ADD_ STACK_FAILED	Non-zero return code from an IGWFESTK request
	X'447'	DESRS_UNKNOWN	Issued by the DESERV recovery routine when entered for an unknown reason (for example, a program check) while the exit routine was in control. Most likely an exit error.
X'0C'	X'469'	DESRS_DST_EXIT_PTR_NOT_COMMON	Global exit address is not in common storage.

Additional Return and Reason Codes: For the GET, RENAME, DELETE, and UPDATE return and reason codes, refer to z/OS DFSMS Macro Instructions for Data Sets.