DADSM LSPACE return and diagnostic codes

Table 1 describes the DADSM LSPACE return codes.

Table 1. DADSM LSPACE Return Codes
Return Code (R15)	Description
0 (X'00')	Successful LSPACE processing.
4 (X'04')	I/O error while reading DSCBs, or unexpected CVAF error return code. I/O Timeout error while reading volume label.
8 (X'08')	Last allocation on this volume made under VSE, or a DADSM function has prematurely terminated and VTOC errors may exist.
12 (X'0C')	UCB address invalid. UCB not for direct access device. UCB not-ready bit is on, indicating device not ready; UCBVTOC=0, indicating volume not mounted. If a message area was specified, the reason associated with the return code is stored there.
16 (X'10')	Invalid message area address or SMF indicator. Parameter list error – Bad parameter list storage key, or parameter list ID is invalid (not set to ‘LSPA’) , or parameter list size is not sufficient.
20 (X'14')	ESTAE routine entered, processing error in LSPACE.

Table 2 describes additional diagnostic information that is returned by LSPACE in register 0. The abbreviations that are used in Table 2 are defined in Table 3. If the return code is not 16, it is also returned in the LSPACE parameter list at the locations that are identified in Table 4.

Table 2. DADSM LSPACE Diagnostic Information (Register 0)
Byte 0	Byte 1	Byte 2	Byte 3	Description
DADSM Return Code	Subfunction Identifier	Subfunction Return Code	Subfunction Reason Code	Description
04 (X'04')	X'06'	ECBCC	X'00'	Error reading volume label.
04 (X'04')	X'07'	AOMRC	AOMRSC	Error reading volume label with AOM.
04 (X'04')	X'07'	AOMRC	IOSCOD	Error reading volume label due to a timeout condition.
04 (X'04')	X'07'	AOMRC	X'52'	Start pending in subchannel.
04 (X'04')	X'07'	AOMRC	X'53'	I/O timed out canceled by IOS.
04 (X'04')	X'08'	X'00'	X'0D'	No ECBs on the ECBLIST were found to be posted. This is an internal error where neither the ISGENQ OBTAIN ECB or the STIMERM timeout ECB were posted.
04 (X'04')	X'0C'	ISGQRC	ISGQRS	Return-code (RC) and reason-code (RS) from ISGQUERY.
04 (X'04')	X'0D'	X'00'	X'0E'	UCBVOLI is binary-zeroes (volume has gone offline).
04 (X'04')	X'0D'	X'00'	X'0F'	UCBVOLI doesn't match the volser in the volume-label.
04 (X'04')	X'0E'	X'00'	X'10'	ISGQUERY-results indicates that pointer-to the first 'RS' (Resource) record is zero.
04 (X'04')	X'0E'	X'00'	X'11'	ISGQUERY-results indicates that pointer-to the first 'RQ' (Requester) record is zero.
04 (X'04')	X'0E'	X'00'	X'12'	ISGQUERY-results indicates that no 'RQ' (requester) is the "owner" of the SYSVTOC resource.
04 (X'04')	X'0E'	X'00'	X'13'	The required "RESERVE" of SYSVTOC was not performed by the caller's address space.
04 (X'04')	X'80'	DIRRET	CVSTAT	Error getting format-4/space maps.
04 (X'04')	X'81'	DSMRET	CVSTAT	Error getting free extents.
04 (X'04')	X'82'	DSMRET	CVSTAT	Error getting format-0 count.
04 (X'04')	X'83'	DSMRET	CVSTAT	Error getting VIR count.
04 (X'04')	X'84'	VRFRET	CVSTAT	Error checking for VRF.
08 (X'08')	X'80'	X'00'	X'00'	Error: DIRF bit found on or the free space indicators (FMT5/FMT7 DSCBs) are invalid.
12 (X'0C')	X'01'	X'00'	X'03'	Invalid LSPACE flag.
12 (X'0C')	X'01'	X'00'	X'04'	Not authorized for SMF.
12 (X'0C')	X'01'	X'00'	X'05'	Bad MSG/EXPMSG/DATA area storage key.
12 (X'0C')	X'01'	X'00'	X'06'	Bad format-4 area storage key.
12 (X'0C')	X'01'	X'00'	X'07'	UCB not found.
12 (X'0C')	X'01'	X'00'	X'08'	UCB not direct access device.
12 (X'0C')	X'01'	X'00'	X'09'	UCB VTOC pointer is zero.
12 (X'0C')	X'02'	X'00'	X'00'	Invalid UCB status.
12 (X'0C')	X'03'	ENQRET	X'00'	Failed ENQ on SYSZDMNT.
14 (X'0E')	X'86'	X'00'	X'00'	The LSPACE function has timed out, not waiting on the ISGENQ of SYSVTOC.
16 (X'10')	X'01'	X'00'	X'01'	Bad parameter list storage key.
16 (X'10')	X'01'	X'00'	X'02'	Bad parameter list ID.
16 (X'10')	X'01'	X'00'	X'0A'	The size of the referenced parameter list is not large enough to accommodate the specified parameters.
20 (X'14')	X'85'	System completion code		Processing error in LSPACE.
20 (X'14')	X'86'	X'00'	X'0C'	The ISGENQ OBTAIN for the SYSVTOC volser resource timed out.

Table 3. Abbreviation Descriptions for DADSM LSPACE Return and Diagnostic Codes
Abbreviation	Description
CVSTAT	CVSTAT field of CVAF parameter list. For a description of the field, see CVSTAT field codes.
DIRRET	Return code from CVAFDIR. For a description of the return code, see z/OS DFSMSdfp Advanced Services.
DSMRET	Return code from CVAFDSM. For a description of the return code, see z/OS DFSMSdfp Advanced Services
ECBCC	ECB completion code. For a description of the completion code, see z/OS DFSMS Using Data Sets.
ENQRET	Return code from ENQ. For a description of the return code, see z/OS MVS Programming: Assembler Services Reference ABE-HSP.
ISGQRC	Return code from ISGQUERY. For a description of the return code, see z/OS MVS Programming: Assembler Services Reference IAR-XCT.
ISGQRS	Reason code from ISGQUERY. For a description of the return code, see z/OS MVS Programming: Assembler Services Reference IAR-XCT.
N/A	Not Applicable.
VRFRET	Return code from CVAFVRF.

Table 4. DADSM—LSPACE Parameter List Diagnostic Information Fields
LSPACE Parameter List Offset	Diagnostic Information
8 (X'08')	LSPACE return code
9 (X'09')	LSPACE subfunction
10 (X'0A')	LSPACE subfunction return code
11 (X'0B')	LSPACE subfunction reason code