RMM TSO subcommand reason codes

DFSMSrmm issues reason codes that are only available in the REXX environment and only if command output is directed to REXX variables. The reason code is set into a fixed variable name by the command processor, EDG@RC. Where line mode output is used in the CLIST or the REXX procedure environment, the RMM TSO subcommand issues an explanatory message instead of setting a reason code. DFSMSrmm sets reason codes only when the return code is 4, 12, or 20.

DFSMSrmm sets reason codes, or returns messages, for return code 20 only when DFSMSrmm processing determines an error other than value range or naming restrictions. In other cases, it is the TSO parse function that provides the information messages for parse errors. See Table 1 for command abbreviations that are also used in Table 1.

Table 1 lists the reason codes issued by DFSMSrmm when return code 4, 12, or 20 is issued. The table also lists related messages that can provide additional information about the error. DFSMSrmm messages can be found in z/OS MVS System Messages, Vol 5 (EDG-GFS).

Table 1. DFSMSrmm reason codes
Return code	Reason code	Message number	Issuing command	Description
00	00	EDG3016	AV CV	Processing successful. DFSMSrmm returns a value for variable EDG@RCK when COUNT=1 or not used.
00	00	EDG3015	GV	Processing successful. DFSMSrmm returns a value for variable EDG@OWN and EDG@VOL when the RMM GETVOLUME request is successful.
04	02	EDG3203 EDG3025I	SB SD SO SP SR SS SV	Search processing indicates more records might exist
04	04		SB SD SO SP SR SS SV	Search processing indicates fewer records returned than were requested
04	06		All	Subsystem does not support function
04	06	EDG3312	SS	NEXTVRS does not exist for SS with CHAIN
04	08	EDG3010	SB SR	No rack or bin numbers meet search criteria
04	08	EDG3010	SD	No data sets meet search criteria
04	08	EDG3010	SO	No owners meet search criteria
04	08	EDG3010	SP	No software products meet search criteria
04	08	EDG3010	SS	No vital record specifications meet search criteria
04	08	EDG3010	SV	No volumes meet search criteria
04	10	EDG3921 EDG3025I	SB SD SO SP SR SS SV	Insufficient storage for search processing. More records might exist
04	12	EDG3328	SD SV	A record in a chain is not found.
04	14	EDG3026E	SB SD SO SP SR SS SV	Search subcommand interrupted by operator command.
04	16	EDG3027E	AB AR AV DB DR	Add/delete subcommand interrupted by operator command. COUNT was specified.
04	158	EDG3304	CV	Move is not pending.
04	160	EDG3305 EDG3306 EDG3307 EDG3285	CV	Move is not confirmed.
04	162	EDG3286	CV	Action is not confirmed.
04	164	EDG3287	CV	Action is not pending.
04	278	EDG3369I	AD, CD	File expiration attributes accepted but ignored for the volume expiration because volume is retained by FIRSTFILE.
12	00		All	I/O error on DFSMSrmm control data set
12	ALL	EDG3013	AV	DFSMSrmm issues values for variables EDG@CNT, EDG@RCK, and EDG@VOL when COUNT is greater than 1 and the command fails.
12	02	EDG3220	CO	Incorrect node and user ID combination
12	04	EDG3005	All	Issued when subcommand issued incorrectly
12	08	EDG3207	All	Subsystem does not exist
12	10	EDG3208	All	Disastrous error during subsystem processing
12	12	EDG3209	All	Logical error during subsystem processing
12	14	EDG3221	AD	Incorrect request for a scratch volume
12	14	EDG3221	CV	Incorrect request for a scratch volume
12	16	EDG3222	DO	Owner owns volumes but no new owner specified
12	18	EDG3017 EDG3018	AB AR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	18	EDG3200	AO	Owner already exists
12	18	EDG3200	AP	Software product already exists
12	18	EDG3200	AB AR	Rack or bin number already exists
12	18	EDG3200	AS	Vital record specification already exists
12	18	EDG3200	AV	Volume already exists
12	18	EDG3201	CD DD LD	Data set does not exist
12	18	EDG3201	CO DO LO	Owner does not exist
12	18	EDG3201	CP DP LP	Software product does not exist
12	18	EDG3201	CV DV LV	Volume does not exist
12	18	EDG3201	DB DR LB LR	Rack or bin number does not exist
12	18	EDG3201	DS LS SS	Vital record specification does not exist
12	20	EDG3204	All	I⁄O error on DFSMSrmm control data set
12	22	EDG3211	All	Subsystem abnormally ends due to incorrect data
12	24	EDG3212	All	Backup in progress - DFSMSrmm control data set cannot be changed
12	26	EDG3009	AP AS AV CP CV GV SD SV	Owner does not exist
12	28	EDG3223	AD SD SV	Volume does not exist
12	30	EDG3224	AD CD CV DD	Incorrect request for a DFSMSrmm recorded volume
12	32	EDG3225	AD	A data set already exists at that position on the volume
12	34	EDG3226	AD	Previous data sets not defined on volume
12	36	EDG3227	SB SR	Incorrect rack number key in data area
12	36	EDG3228	SB SR	Incorrect bin number key in data area
12	38	EDG3017	AB AR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	38	EDG3229	AV CV DB DR	Rack number does not exist or is not empty
12	40	EDG3230	AV CV GV SB SR SV	Pool not defined
12	42	EDG3231	DV	Incorrect delete option in data area
12	44	EDG3232	DV	Volume is not a SCRATCH volume
12	46	EDG3233	DR	No empty bins in storage location
12	48	EDG3234	All	Incorrect date in data area
12	50	EDG3235	All	Incorrect time in data area
12	54	EDG3237	AV CV	Pool or unit mismatch
12	56	EDG3238	AV CV	Pool is full
12	58	EDG3239	AB AR DB DR LB LR SB SR	Incorrect storage location ID in data area
12	60	EDG3240	AV CV	Unknown software product
12	62	EDG3241	CV	Unknown accessors in DELUSERS parameter
12	64	EDG3242	CV	Too many user IDs specified for ADDUSERS()
12	66	EDG3243	AV CV	Both Pool and rack specified in the data area
12	68	EDG3017 EDG3018	AB AR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	68	EDG3019 EDG3020	DB DR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	68	EDG3244	AV	Count too big. Volume serial number generated >999999
12	68	EDG3244	AB AR DB DR	Count too big. Rack number or bin number generated >999999
12	70	EDG3017 EDG3018	AB AR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	70	EDG3019 EDG3020	DB DR	DFSMSrmm issues values for EDG@CNT and EDG@RCK when the COUNT operand is greater than 1 and the command fails.
12	70	EDG3245	AB AR AV DB DR	Count too big. Volume serial numeric suffix or rack number suffix exhausted
12	72	EDG3246	AV CV	Previous volume already has a next volume
12	74	EDG3247	DB DR	Bin not empty
12	76	EDG3248	DV	Volume is already a scratch volume
12	78	EDG3249	AV CV	Maximum volumes already assigned to software product
12	80	EDG3003	All	Severe error during TSO service routine
12	82	EDG3250	AV	No volume status supplied in data area
12	84	EDG3251	AV	More than 1 volume status supplied in data area
12	86	EDG3252	AV CV	Unknown previous volume
12	88	EDG3253	AV CV	Previous volume is a scratch volume
12	90	EDG3254	CV	Volume has a next volume
12	92	EDG3255	GV	No default scratch pool of unit type defined
12	94	EDG3256	GV	No available volumes in pool
12	96	EDG3257	CV	Confirm action is not outstanding
12	98	EDG3258	CV	Confirm movement is not outstanding
12	100	EDG3259	AS	Count is too small
12	100	EDG3263	AS	COUNT is too small when the DELAY operand is used.
12	102	EDG3260	CV	Incorrect confirm release
12	104	EDG3008	All	Abnormal end in command processor
12	106	EDG3021	DO	New owner is the same as the old owner
12	108	EDG3022	AD, CD	Installation defined maximum retention period exceeded.
12	110	EDG3023	CV DV	Volume pending release
12	114	EDG3265	AS	First STORENUMBER cannot be 99999
12	116	EDG3268	SB SD SO SP SR SS SV	Unable to open CLIST data set
12	118	EDG3269	SB SD SO SP SR SS SV	CLIST organization not sequential or partitioned
12	120	EDG3270	SB SD SO SP SR SS SV	CLIST data set too small
12	122	EDG3277	AV CV	Manual cartridge entry failed
12	124	EDG3278	AV CV	Cannot override storage group. Current® SG returned in EDG@CSG variable
12	126	EDG3279	CV	Volume is not in a system-managed library
12	128	EDG3283	CV	Confirm move rejected until volume library resident
12	130	EDG3284	CV	RACK or POOL not allowed for a volume residing in a system-managed library
12	132	EDG3288	CV DV	Volume eject failed
12	134	EDG3289	CV	Manual cartridge entry failed during confirm move
12	136	EDG3290	CV	Confirm RETURN or REPLACE not accepted while volume is library resident
12	138	EDG3291	AV CV	Rack number and volser are not the same
12	140	EDG3292	AV CV	Volume defined to SMS in different library. Current library returned in EDG@CLIB variable
12	144	EDG3295	CV	LOCATION change rejected for volume that is already moving.
12	146	EDG3296	SS	CHAIN operand used but no exact match on vital record specification was found.
12	150	EDG3300	AV	Specified volume status conflicts with TCDB volume status
12	152	EDG3301	AV CV GV	Attempt to update volume status in TCDB failed.
12	154	EDG3302	CV	RACK or POOL not allowed for volume moving to a system-managed library
12	156	EDG3303	CV	RACK or POOL not allowed for volume with a home location of a system-managed library
12	166	EDG3308	SS	CHAIN operand specified without either DSNAME, NAME, or VOLUME operands.
12	168	EDG3309	CV	Confirm move rejected until volume ejected
12	170	EDG3310	CV DV	Volume location or destination not known on this system
12	172	EDG3311	AV CD CV DV	Update of TCDB failed
12	176	EDG3314	CV	Volume cannot be moved to a location because the media name is not eligible. Current media name returned in EDG@MEDN variable.
12	178	EDG3315	CV DB	Bin number does not exist or is not empty.
12	180	EDG3266	AS	COUNT is too small.
12	182	EDG3267	AS	COUNT must equal STORENUMBER.
12	184	EDG3297	AS	STORENUMBER is missing.
12	186	EDG3325	SD SV	CHAIN specified without a specific resource
12	188	EDG3327	AS	Data set name mask not suitable
12	190	EDG3326	AV CV	Current label version has been specified for a non-AL type tape volume
12	192	EDG3333	CV	HOME location value is not supported for a logical volume
12	194	EDG3329	CV DV	EJECT is not supported for a private logical volume
12	196	EDG3330	AV CV	TYPE and LOCATION are inconsistent
12	198	EDG3331	AV CV	RACK or POOL are not supported for a logical volume
12	200	EDG3332	CV	RACK number is not supported for a logical volume
12	202	EDG3334	AV CV DV	Library type cannot be determined. The library correctly configured with at least one tape drive operational.
12	204	EDG3335	CV	New volume is not supported for the volume type
12	206	EDG3336	DV	Stacked volume is not empty
12	208	EDG3337	AV CV	Stacked volume container does not exist and stacked volume support is enabled
12	210	EDG3338	AV CV	Initialize action is not supported for a stacked volume.
12	212	EDG3339	DV	RELEASE option is not supported for a stacked volume
12	214	EDG3340	AV CV	Storage group and library combination are not valid
12	216	EDG3341	AV CV	System-managed library information is not consistent with the type of volume
12	218	EDG3342	CV	A virtual export cannot be performed because the export token does not match or the volume was never in the container and the stacked volume is export recorded.
12	220	EDG3205	AB AD AO AP AR AS AV CD CO CP CV DB DD DO DP DR DS DV GV	Journal is locked.
12	222	EDG3343	AV	Status SCRATCH is not supported for a stacked volume.
12	224	EDG3344	AV	Volume catalog (TCDB) information conflicts with Library Manager information.
12	226	EDG3345	AV CV	Media type is required for manual cartridge entry.
12	228	EDG3346	CV DR	Subcommand failed because extended bin support is enabled.
12	230	EDG3347	CV	Cancel move failed because bin is already moving.
12	232	EDG3351	CV	Start move rejected, another volume is already moving out of bin.
12	234	EDG3352	CV	Bin support is not supported for a logical volume or a volume in a container.
12	236	EDG3353	CV	Unexpected return code xx and reason Code yyyy from subsystem request.
12	238	EDG3354	CV	Container change rejected as the volume is moving.
12	240	EDG3355	AV CV	VOL1 is not supported for NL tapes, logical volumes, or stacked volumes
12	242	EDG3356	DV	Delete volume rejected; TCDB status does not match DFSMSrmm volume status
12	244	EDG3357I	CV	WWID cannot be changed once it is set.
12	246	EDG3359E	AV, CV	Inconsistent media information.
12	248	EDG3358E	DV	Volume not pending replace.
12	250	EDG3215I	GV	GV request rejected. Another GV request is in progress, and your request is cancelled.
12	254	EDG3360E	SB SD SO SP SR SS SV	A CLIST data set with fixed LRECL has a too short record length.
12	256	EDG3216	All	DFSMSrmm is quiesced.
12	258	EDG3361	CV DV	Volume HOLD attribute is set.
12	260	EDG3362	CV	Volume HOLD attribute is not set.
12	262	EDG2002I	All	DFSMSrmm subsystem cancelled by operator
12	264	EDG2003E	All	Subcommand ended abnormally
12	266	EDG3363	CV AV	Retention method can be specified only for the first volume in a set.
12	268	EDG3364	CD	VRSELEXCLUDE(NO) can be specified only for a data set in a volume set managed by VRSEL retention method.
12	270	EDG3365	CD	COPYFROM data set does not exist.
12	272	EDG3366	CD	COPYFROM validation failed for LRECL/RECFM between source and target data sets.
12	274	EDG3367	AD, CD	LASTREF and NOLASTREF can be specified only for data sets on a volume retained by the EXPDT retention method.
12	276	EDG3368	AD, CD, CV	FORCE operand required.
12	280	EDG3370	AV, CV	RETAINBY only valid with RM(EXPDT).
12	282	EDG3371	AV, CV	RETAINBY can be specified only for a the first volume in a set.
12	284	EDG3372	CV	Change of expiration date not allowed for volumes retained by first file.
12	285	EDG3373E	CD	WHILECATALOG(ON) and WHILECATALOG(UNTILEXPIRED) can be specified only for data sets on a volume retained by the EXPDT retention method.
12	286	EDG3374E	CD	WHILECATALOG(UNTILEXPIRED) specified, but catalog status is not YES
20	0		All	Parse error for which we have no more specific reason.
20	2	EDG3106	AD AV CD CV GV LC	SECLEVEL value is not defined to DFSMSrmm
20	4	EDG3107	AD AV CD CV GV LC	Do not use SECLEVEL because your installation has no security classes defined.
20	6	EDG3272	AV CV GV AR AS	LOCATION operand specified a library that is not defined to DFSMS.
20	8	EDG3274	AS CV GV	LOCATION operand specified a library and libraries are not supported.
20	10	EDG3273	AV CV	STORAGEGROUP operand value is not defined to DFSMS.
20	12	EDG3275	AV CV	STORAGEGROUP operand is not supported.
20	14		AS SS	DSNAME value does not meet DFSMSrmm generic naming restrictions.
20	16	EDG3272	CV	HOME operand specified a location name that is not defined to DFSMS, or a storage location that is not allowed as a home location.
20	18	EDG3274	CV	HOME operand specified a library and libraries are not supported.
20	20	EDG3276	AV	STATUS(VOLCAT) operand is not supported.
20	22	EDG3316	AB AR	Media name is not valid for the specified location.
20	24		AS DS LS SD SS SV	JOBNAME value does not adhere to DFSMSrmm generic naming rules.
20	26		SD	PROGRAMNAME/LASTPROGRAMNAME value does not adhere to DFSMSrmm generic naming rules.
20	28	EDG3348	AV CV GV	LOCATION operand specified a storage location name that is not defined as a home location.
20	30	EDG3348	CV	HOME operand specified a storage location name that is not defined as a home location.
20	32	EDG3349	AV CV GV	LOCATION operand specified a storage location name, and storage locations are not allowed.
20	34	EDG3349	CV	HOME operand specified a storage location name, and storage locations are not allowed.
20	36	EDG3350	AR	LOCATION is not bin-managed.
20	38		AV, CV, SV	An unsupported media type is specified.
20	40		AV, CV, SV	An unsupported recording technology is specified.
20	42		AV, CV	Specified media information not defined.
20	44		SV	LOCATION value does not adhere to DFSMSrmm generic naming rules.
20	46		AD AS AV CD CV	Data set name failed data set name rules check.
28	0	EDG3028	All	Attention key (ATTN) interrupted DFSMSrmm subsystem request processing. The RMM TSO command processor cannot determine whether command completed or not.