Return and reason codes for CBRXLCS change use attribute

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 change use attribute processing. See CBRXLCS return codes for more information. Also, for more information concerning other return and reason codes not specific to change use attribute processing, see z/OS DFSMSdfp Diagnosis.

Table 1. Change use attribute return and reason codes
Return code	Error type	Reason code	Meaning
0	Successful	0	Successful execution.
4	Warning	4	Requested change to SCRATCH but volume was already SCRATCH.
		5	Requested change to PRIVATE but volume was already PRIVATE.
		8	Scratch volume threshold processing did not successfully complete. Check the console log for further diagnostic information.
		131	Scratch volume threshold processing not performed because library was not operational.
		138	Library scratch count 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.
		14	Required use parameter not specified.
		15	Invalid value specified for use.
		16	Required volume parameter not specified.
		17	Invalid volume serial specified.
		25	Invalid expiration date specified.
		26	Library in which volume resides not defined to specified storage group.
		28	Invalid write protect value specified.
		29	Invalid parameter address for LCSPL.
		30	LCSPL not aligned on fullword boundary.
		34	Invalid storage group name specified.
		38	Invalid compaction type specified in TDSI.
		39	Invalid special attribute specified in TDSI.
		40	Invalid combination of TDSI values specified.
		41	Ambiguous TDSI combination specified.
		43	Invalid pointer to TDSI specified.
		54	Storage group not of type tape.
		219	Invalid outboard policy management construct. (SC, MC, and DC)
		220	Mutually exclusive optional keywords specified. This reason code is returned if GETPOLICY is specified with GRPNAME, SCNAME, MCNAME, or DCNAME.
12	Failure	6	Request failed because CUA processing disabled for private to scratch requests.
		7	Installation exit vetoed the requested change.
		53	Library not defined to active configuration.
		58	Failure accessing volume record in TCDB.
		59	Failure accessing library record in TCDB.
		60	Failure accessing SMS storage group constructs.
		61	Device services failure.
		63	Volume record not found in TCDB.
		64	Library record for specified volume not found in TCDB.
		65	No library attached at last IPL.
		70	Volume not found in library manager inventory.
		82	Installation exit abended.
		83	Installation exit returned bad data.
		84	Abend occurred during LCS External Services processing.
		310	Media type or recording technology not supported at this software level.
		312	Function is not compatible with the library (the request cannot be performed by the library due to its current state, its configuration, or set of installed features).
		313	Volume is currently in use.
		322	Command rejected by the library.
		323	Unable to retrieve library policy constructs from a library that supports outboard policy management.
		324	Volume expire time has not elapsed at the library.
		325	I/O terminated due to timeout detection.
		326	Selective device access control group denied request.
		327	Selective device access control group is not valid.
16	Environment	2	OAM control blocks not available.¹
		80	LCS External Services unable to establish an ESTAE.
		81	LCS External Services unable to obtain storage for installation exit parameter list.
¹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.