Return and reason codes for CBRXLCS query volume residence

The return code is placed in register 15 and in the LCSPL in field LCSRCODE. The reason code is placed in register 0 and in the LCSPL in field LCSREAS.

Table 1 provides the reason codes associated with each of the return codes returned by query volume residence function. For more information, see CBRXLCS return codes. Also, for more information concerning other return and reason codes not specific to the query volume residence function, see z/OS DFSMSdfp Diagnosis.

Table 1. Query Volume residence return and reason codes
Return code	Error type	Reason code	Meaning
0	Successful	0	Successful execution. If volume resides in an MTL, if VOLINFO=YES was specified, TVI contains the volume TCDB record information. if LIBNAME was specified, the library name specified matches the volume record library name. If the volume resides in an ATL, if VOLINFO=YES was specified, TVI contains TCDB and library manager information. if LIBNAME was specified, the specified library name and the volume record library name match, and the library manager information indicates that the volume resides in the specified library. if LIBNAME,TCDBCHK=NO and VOLINFO=YES was specified, the TVI contains library manager information only. if neither VOLINFO or LIBNAME was specified, the volume record is found in the TCDB and the TCDB record indicates that the volume is library-resident; no library manager validation is performed.
4	Warning	52	Volume is shelf-resident. If VOLINFO=YES was specified, TVI contains only TCDB information. LIBNAME was not specified.
		61	Unable to access library manager. If VOLINFO=YES, TVI contains only TCDB information. If LIBNAME was specified, the library name specified and the volume record library name matched.
		63	Volume record for specified volume not found in TCDB. If VOLINFO=YES was specified, no volume information is returned. If LIBNAME was specified and the library specified was an MTL, no further validation is performed.
		70	Volume not found in library manager inventory. If VOLINFO=YES was specified, TVI contains only TCDB information. If LIBNAME was specified, the library name specified and the volume record library name matched.
		134	No volume record was found in the TCDB; however, LIBNAME was specified and the volume resides in the specified library. If VOLINFO=YES was specified, TVI contains only library manager information.
		135	Volume record was found in the TCDB. LIBNAME was specified and the volume was found in the library specified. However, the volume record library name and the specified library name did not match. If VOLINFO=YES was specified, TVI contains the volume TCDB information and the library manager information from the library specified for LIBNAME.
		136	Volume record was found in the TCDB. LIBNAME was specified and the volume was not found in the library specified. The volume record library name and the specified library name did not match. If VOLINFO=YES was specified, TVI contains only the volume TCDB information.
		137	Volume record was found in the TCDB. LIBNAME was specified. The volume record library name and the specified library name did not match. Unable to access the library manager of the specified library. If VOLINFO=YES was specified, TVI contains only the volume TCDB information.
		139	Volume record was found in the TCDB. LIBNAME was specified and it did not match the volume record library name. If the library specified was an MTL, no further validation is performed. If VOLINFO=YES was specified, TVI contains the volume record TCDB information.
		323	Unable to retrieve policy names from the library.
8	Invalid request	9	Required type parameter not specified.
		11	Invalid value specified for type.
		12	Required function parameter not specified.
		13	Invalid value specified for function.
		16	Required volume parameter not specified.
		17	Invalid volume serial specified.
		27	Invalid library name specified. SHELF is a reserved name and not allowed for library name specification.
		29	Invalid address specified for LCSPL or mapping macro.
		30	LCSPL or TVI not aligned on fullword boundary.
		216	TCDBCHK=NO and LIBNAME was specified. The library specified is an MTL, no further validation is performed. If VOLINFO=YES was specified, no TVI information is returned.
		221	Invalid storage header or length, or both, specified. If the TVI length specified is incorrect, the correct length is returned in the TVILENG field of the CBRTVI macro.
12	Failure	45	Library name as defined in volume record is unknown in the SMS configuration.
		58	Failure accessing volume record in TCDB.
		59	Failure accessing library record in TCDB. If LIBNAME was specified, there was a failure accessing the library record in TCDB for the specified library name. If LIBNAME was not specified, the failure was in accessing the library record in TCDB for the library name found in the volume record.
		64	Library record not found for specified library.
		65	Library logical type not defined. If LIBNAME is not specified, library logical type is not defined for the library name found in the volume record. If LIBNAME is specified, library logical type is not defined for the library name specified.
		81	GETMAIN failed for TVI storage.
		84	Abend occurred during LCS External Services processing.
		310	Media type or recording technology not supported at this software level.
		319	No volume record found in the TCDB. LIBNAME was specified. The volume was not in the library specified. If VOLINFO=YES was specified, no TVI information is returned.
		320	No volume record found in the TCDB. LIBNAME was specified. Unable to access library manager for the library specified. If VOLINFO=YES was specified, no TVI information is returned.
		322	Command rejected by the library.
16	Environment	80	LCS External Services unable to establish an ESTAE.