Return and reason codes for CBRXLCS manual cartridge entry

The return code reflecting the most severe error is placed in register 15 and in the LCSPL in field LCSRCODE. The return code for each volume is returned in the field LCSMRET in the volume list array.

The reason code associated with the most severe return code is placed in register 0 and in the LCSPL in field LCSREAS. The reason code for each volume is returned in the field LCSMREAS in the volume list array.

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

Table 1. Manual cartridge entry return and reason codes
Return code	Error type	Reason code	Meaning
0	Successful	0	Successful execution.
4	Warning	8	Scratch volume threshold message processing did not successfully complete. Check the console log for further diagnostic information.
		138	The library scratch volume count is not updated in TCDB.
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.
		17	Invalid volume serial number specified.
		20	Required volume list not specified.
		21	Invalid header value specified in volume list.
		23	Required library name parameter not specified.
		26	MCE library is not defined to storage group on tape volume record.
		27	Invalid library name specified.
		29	Invalid parameter address specified for LCSPL or VOLLIST.
		30	LCSPL or VOLLIST not aligned on fullword boundary.
		34	Invalid storage group name.
		35	Required media type not specified from any source.
		53	Library not defined to active configuration.
		54	Storage group specified on volume record is type tape.
		92	Library specified is not an MTL.
		94	Specified volume already resides in another tape library.
		97	Volume of same name is known DASD volume.
		130	Specified volume already resides in this tape library
12	Failure	60	Failure accessing SMS storage group constructs.
		75	UCB scan failure when attempting to determine volume serial uniqueness.
		78	Catalog failure when attempting to retrieve the volume record.
		79	Catalog failure when attempting to update the volume record.
		84	Abend occurred during LCS External Services processing.
		95	Installation exit vetoed the entry of the volume into the library.
		96	Installation exit said to ignore the volume.
		310	Media type or recording technology not supported at this software level.
		321	The media type returned from the Installation Exit does not match the existing media type defined for the volume record in TCDB.
16	Environment	2	OAM control block structure not available.¹
		80	LCS External Services unable to establish an ESTAE.
		90	Cartridge entry disabled due to an error in the installation exit.
		91	Cartridge entry temporarily suspended.
¹ Depending on the CBRXLCS function being performed, one or more OAM initialization-related control blocks might be required. First, verify whether the OAM1 subsystem entry was specified in the IEFSSNxx PARMLIB member. Then verify whether the OAM address space has been started.