Reason codes

Table 1 contains only general-use return and reason codes. All other return and reason codes are for diagnostic use only and are reserved for IBM internal use. Refer to z/OS DFSMSdfp Diagnosis for information about diagnostic return and reason codes. For more detailed information concerning the keywords referenced in this section, refer to OSREQ keyword parameter descriptions.

Table 1. Return/Reason Codes
Return code	Reason code (bytes)				Error description	Installation action
Return code	0	1	2	3	Error description	Installation action
0	0	0	0	0	The request has successfully completed.	No action is required.
4	t	x	y	z	The request has completed with a warning condition: t UNIQUE OSREQ REASON CODE x INTERNAL FUNCTION CODE y ERROR INDICATION z RESERVED	Correct program, if necessary.
4	4	x	1	z	The QEL buffer segments are too short to accommodate all of the available entries. As many entries as can fit in the segments are returned.	Execute the QUERY with a larger QEL buffer.
4	4	x	2	z	An unavailable resource condition was detected during a generic group query which excludes one or more databases from the results. The QEL may contain entries from the available databases.	Activate the databases, if necessary.
4	4	x	3	z	An UNACCESS has completed. The token has been cleared. There are one or more requests outstanding. The outstanding requests are not terminated.	Correct the program, if necessary.
4	4	x	4	z	A STORE or CHANGE request has completed but one or more of the following conditions occurred, as indicated by bits set in byte 3 (z). Z=BIT MAP: 1xxx xxxx Catalog entry was created for the collection x1xx xxxx ODRETDT overrode RETPD, EVENTEXP, or Management Class expiration date xx1x xxxx Storage class specified for the collection was overridden xxx1 xxxx Management class specified for the collection was overridden xxxx 1xxx Retention period specified for the object by RETPD or EVENTEXP was overridden xxxx x1xx Reserved xxxx xx1x Storage class specified for the object was overridden xxxx xxx1 Management class specified for the object was overridden	Issue query to see new parameters, if desired.
4	4	x	5	z	DB2 SQL return code conversion, Module DSNTIAR, was not found in the LINKLIST.	Ensure that module DSNTIAR is available in the LINKLIST.
4	4	x	6	z	First backup copy retrieved; primary copy of the object was not available with Access Backup active.
4	4	x	7	z	Second backup copy retrieved; primary copy of the object was not available with Access Backup active.
8	t	x	y	z	Request unsuccessful. t UNIQUE OSREQ REASON CODE x INTERNAL FUNCTION CODE y FIRST PARAMETER WITH AN ERROR z TYPE OF ERROR	Correct calling program.
8	24	x	y	z	The parameter is unusable, incorrect, invalid, or incomplete.
8	24	x	1	z	PARAMETER LIST (MF=L)
8	24	x	1	1	The parameter list is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the parameter list name or the parameter list name length.
8	24	x	1	2	The parameter list is invalid or incomplete.
8	24	x	2	z	SIZE
8	24	x	2	1	The size (fullword) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the size (fullword).
8	24	x	2	2	The size passed to OAM on the OSREQ macro contains an invalid value.
8	24	x	2	3	The size specified on an OSREQ STOREBEG is not greater than 50 megabytes.
8	24	x	2	4	The size specified on an OSREQ STOREPRT is not less than or equal to the total object size specified on the OSREQ STOREBEG for this store sequence.
8	24	x	2	5	The size specified on an OSREQ STOREPRT when added to all of the previous OSREQ STOREPRT requests exceeds the total object size specified on the OSREQ STOREBEG for this store sequence.
8	24	x	2	6	The size specified on an OSREQ STOREEND is not equal to the size specified on the OSREQ STOREBEG for this store sequence.
8	24	x	2	7	The size specified on an OSREQ STOREEND is not equal to the total of the object sizes provided with previous OSREQ STOREPRT requests for this store sequence.	Check the previous STOREPRT requests to ensure that they provided all of the parts of the object data and that these previous STOREPRT requests were all successful.
8	24	x	2	8	The size specified on an OSREQ STOREPRT is less than the minimum part size allowed. Only the last STOREPRT in the store sequence can be less than the minimum.
8	24	x	3	z	RETPD
8	24	x	3	1	The RETPD area (fullword) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the RETPD (fullword).
8	24	x	3	2	RETPD invalid value, must be -2 thru 93000 or X'7FFFFFFF'.
8	24	x	4	z	STORCLAS
8	24	x	4	1	The STORCLAS area passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the STORCLAS.
8	24	x	4	2	The STORCLAS passed to OAM on the OSREQ macro contains an invalid character.
8	24	x	4	3	The STORCLAS passed to OAM on the OSREQ macro contains an invalid length value.
8	24	x	5	z	MGMTCLAS
8	24	x	5	1	The MGMTCLAS area passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the MGMTCLAS.
8	24	x	5	2	The MGMTCLAS passed to OAM on the OSREQ macro contains an invalid character.
8	24	x	5	3	The MGMTCLAS passed to OAM on the OSREQ macro contains an invalid length value.
8	24	x	6	z	QEL
8	24	x	6	1	The QEL Buffer List passed to OAM in the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the QEL Buffer List.
8	24	x	6	2	The QEL Buffer List passed to OAM in the OSREQ macro contains one of the following conditions: Incorrect ID Incorrect length field Incorrect version field The user turned the RESERVED BIT "on" in the Query Buffer List Control Block.
8	24	x	6	4	The QEL Buffer passed to OAM in the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the QEL Buffer.
8	24	x	7	z	REASON/RETURN CODE STORAGE
8	24	x	7	1	The REASON code area passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the REASON code.	Check REGISTER 0 for REASON code error conditions.
8	24	x	7	2	The RETURN code area passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the RETURN code.	Check REGISTER 15 for RETURN code error conditions.
8	24	x	8	z	BUFLIST
8	24	x	8	1	The BUFLIST passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the BUFLIST.
8	24	x	8	2	The BUFLIST passed to OAM in the OSREQ macro contains one of the following conditions: Incorrect ID Incorrect length field Incorrect version field The user turned the RESERVED BIT "on" in the Data Buffer List Control Block.
8	24	x	8	4	The BUFFER passed to OAM from the OSREQ macro is in unusable storage.
8	24	x	8	5	The amount of buffer data provided on the STORE request is less than the specified size of the object.
8	24	x	8	6	The amount of buffer data provided on the STORE request is greater than the specified size of the object.
8	24	x	8	8	The amount of buffer data space provided on the RETRIEVE request is insufficient for the object.
8	24	x	8	A	When storing an object greater than 50 MB and less than or equal to 256 MB, multiple data buffers are supplied, which are not in contiguous storage.
8	24	x	9	z	TOKEN
8	24	x	9	1	The TOKEN area passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the TOKEN.
8	24	x	9	2	The TOKEN set by the ACCESS macro is not being specified correctly on subsequent OSREQ requests.
8	24	x	A	z	OBJECT NAME
8	24	x	A	1	The OBJECT NAME passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the OBJECT NAME or the OBJECT NAME length.
8	24	x	A	2	The OBJECT NAME passed to OAM on the OSREQ macro is not fully qualified. The OBJECT NAME contains one or more wildcard characters ('*','%', '_') but the function is not QUERY.
8	24	x	A	3	The OBJECT NAME passed to OAM on the OSREQ macro contains a qualifier longer than 8 characters.
8	24	x	A	4	The OBJECT NAME passed to OAM on the OSREQ macro contains an invalid character. One of the characters in the OBJECT NAME is not an uppercase alphabetic (A-Z), numeric (0–9), or national (@, #, $) character.
8	24	x	A	5	The OBJECT NAME passed to OAM on the OSREQ macro contains a null qualifier, meaning ONE of the following is true: The first character of the OBJECT NAME is a period. The last character of the OBJECT NAME is a period. The OBJECT NAME contains two consecutive periods.
8	24	x	A	6	The OBJECT NAME passed to OAM on the OSREQ macro contains more than one asterisk ("*") wildcard and/or an invalid mix of asterisks with percent and/or underscore ("%" or "_") characters.
8	24	x	A	7	The OBJECT NAME passed to OAM on the OSREQ macro contains an invalid qualifier. One of the qualifiers does not start with an uppercase alphabetic character (A-Z) or national character ($, #, @).
8	24	x	A	8	The OBJECT NAME passed to OAM on the OSREQ macro contains an imbedded blank.
8	24	x	A	9	The OBJECT NAME passed to OAM on the OSREQ macro has an invalid length. The length is zero, negative, or longer than 44 characters.
8	24	x	B	z	The OSREQ function.
8	24	x	B	2	The function specified is unknown.
8	24	x	C	z	OFFSET
8	24	x	C	1	The OFFSET passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the OFFSET.
8	24	x	C	2	The OFFSET value is larger than the length of the object.
8	24	x	C	3	The OFFSET value is negative.
8	24	x	C	4	The offset specified on an OSREQ STOREPRT is not immediately following the last part of the object stored on the previous OSREQ STOREPRT for this store sequence or is not zero for the first OSREQ STOREPRT for this store sequence.
8	24	x	D	z	LENGTH
8	24	x	D	1	The LENGTH passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the LENGTH.
8	24	x	D	2	The LENGTH value requested, plus the value specified on the OFFSET keyword, is larger that the SIZE of the object.
8	24	x	D	3	The LENGTH value is negative.
8	24	x	D	4	The length specified on an OSREQ RETRIEVE is greater than 256 megabytes.
8	24	x	E	z	MSGAREA
8	24	x	E	1	The MSGAREA passed to OAM from the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the MSGAREA.
8	24	x	E	2	The MSGAREA length value is negative.
8	24	x	F	z	COLLECTION NAME
8	24	x	F	1	The COLLECTION NAME passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the COLLECTION NAME or the COLLECTION NAME length.
8	24	x	F	2	The COLLECTION NAME passed to OAM on the OSREQ MACRO is not fully qualified. The COLLECTION NAME contains an asterisk (*) as the last character in the name.
8	24	x	F	3	The COLLECTION NAME passed to OAM on the OSREQ macro contains a qualifier longer than 8 characters.
8	24	x	F	4	The COLLECTION NAME passed to OAM on the OSREQ macro contains an invalid character. One of the characters in the COLLECTION NAME is not an uppercase alphabetic (A-Z), numeric (0–9), or national (@, #, $) character.
8	24	x	F	5	The COLLECTION NAME passed to OAM on the OSREQ macro contains a null qualifier, meaning ONE of the following is true. The first character of the COLLECTION NAME is a period. The last character of the COLLECTION NAME is a period. The COLLECTION NAME contains two consecutive periods.
8	24	x	F	6	Reserved
8	24	x	F	7	The COLLECTION NAME passed to OAM on the OSREQ macro contains an invalid qualifier. One of the qualifiers does not start with an uppercase alphabetic character (A-Z) or national character ($, #, @).
8	24	x	F	8	The COLLECTION NAME passed to OAM on the OSREQ macro contains an imbedded blank.
8	24	x	F	9	The COLLECTION NAME passed to OAM on the OSREQ macro has an invalid length. The length is zero, negative, or longer than 44 characters.
8	24	x	10	z	IADDRESS ERROR
8	24	x	10	10	The IADDRESS passed to OAM from the OSREQ macro points to unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the IADDRESS.
8	24	x	11	z	TTOKEN
8	24	x	11	1	The TTOKEN passed to OAM is in unusable storage. This means that the tracking token is contained in the virtual storage area for which the application program does not have both fetch and store authorization. This is an indication of a programming logic error in the application program that is issuing the OSREQ macro invocation.
8	24	x	12	1	The RECALL parameter is in unusable storage for which the application program does not have both fetch and store authorization. This is an indication of a programming logic error in the application program that is issuing the OSREQ macro invocation.
8	24	x	12	2	The RECALL parameter is larger than the maximum allowed.
8	24	x	12	3	The RECALL parameter is a negative number.
8	24	x	13	1	The RETCODE2 parameter is in unusable storage for which the application program does not have both fetch and store authorization. This is an indication of a programming logic error in the application program that is issuing the OSREQ macro invocation.
8	24	x	14	z	STOKEN
8	24	x	14	1	The STOKEN parameter is in unusable storage for which the application program does not have both fetch and store authorization. This is an indication of a programming logic error in the application program that is issuing the OSREQ macro invocation.
8	24	x	14	2	The STOKEN value provided does not represent a store sequence currently in progress.
8	24	x	15	z	STIMEOUT
8	24	x	15	1	The STIMEOUT area (fullword) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, an OC4 ABEND) when it attempted to reference the area of storage containing the STIMEOUT (fullword).
8	24	x	15	2	The value specified for STIMEOUT is invalid.
8	24	x	16	1	EVENTEXP area is unusable storage.
8	24	x	16	2	EVENTEXP invalid value, must be 0 to 93 000.
8	24	x	16	3	EVENTEXP and RETPD both supplied, only one allowed.
8	28	x	y	z	An IADDRESS routine error was detected during execution of the DB2 language interface routine specified by IADDRESS x, y, z SYSTEM/USER COMPLETION CODE
8	2C	x	y	z	No valid object was found. z RESERVED AND UNDEFINED
8	2C	x	1	z	The directory entry was not found.
8	2C	x	2	z	The object segment was not found.
8	2C	x	3	z	An OSREQ retrieval request with VIEW=BACKUP was received, but a backup copy of the object does not exist.
8	2C	x	4	z	An OSREQ retrieval request with VIEW=BACKUP2 was received, but a second backup copy of the object does not exist.
8	2C	x	5	z	The specified object's size is larger than the maximum object size supported by the OSREQ function at the current system level. Retry the requested OSREQ function on a system that supports objects of such size.
8	30	x	y	z	The object already exists. z RESERVED AND UNDEFINED
8	30	x	1	z	The directory entry already exists.
8	30	x	2	z	The object segment already exists.
8	34	x	y	z	Request rejected for this task. z RESERVED AND UNDEFINED
8	34	x	1	z	A request was issued from a task control block (TCB) other than the initial ACCESS request TCB.
8	34	x	2	z	An ACCESS request is issued from the TCB while the prior ACCESS request is still active.
8	38	x	y	z	Store sequence with STOREBEG, STOREPRT, STOREEND error z RESERVED AND UNDEFINED
8	38	x	1	z	A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREBEG is in progress
8	38	x	2	z	A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREPRT is in progress
8	38	x	3	z	A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREEND is in progress
8	38	x	4	z	A store sequence could not be begun (STOREBEG) because the object location of Optical is not supported for a store sequence
8	38	x	6	z	On a STOREPRT or STOREEND request for an object to be stored to disk sublevel 1, an attempt to access the DB2 buffer resulted in a -423 DB2 SQL code. It was determined that the DB2 buffer can no longer be accessed. Note: This could be the case that the DB2 locator is invalid because the application did a COMMIT during the store sequence. A STOREBEG or STOREPRT request has completed. This store sequence is not finished because an UNACCESS has been issued.	Ensure that the application program did not issue a COMMIT or ROLLBACK during a store sequence, which can be a cause of the -423 DB2 SQL code. Once a STOREBEG has been issued, the application cannot perform a COMMIT or ROLLBACK until after the corresponding STOREEND for the store sequence. Also see the IBM Information Management Software for z/OS Solutions Information Center for more information on the -423 DB2 SQL code.
8	38	x	7	z	A STOREBEG or STOREPRT request has completed after an UNACCESS has been issued. In this case, the UNACCESS will be deferred and will fail because of the pending store sequence.	Ensure that the application program does a STOREEND to finish the store sequence or a STOREEND with CANCEL=YES to cancel the store sequence, then issue UNACCESS again.
8	38	x	8	z	The expected length of the object to be retrieved is greater than the maximum retrieval buffer size of 256 megabytes. If LENGTH has a value of 0 or is not specified on an OSREQ RETRIEVE request, then by default the length will be set to the length from either the offset (if OFFSET specified) or beginning (if OFFSET not specified) to the end of the object.
8	38	x	9	z	UNACCESS request can not be processed because of a pending store sequence.	Ensure that the application program did a STOREEND to finish the store sequence or a STOREEND with CANCEL=YES to cancel the store sequence before issuing UNACCESS.
8	38	x	0A	z	On a STOREPRT or STOREEND request for an object to be stored to Tape, it was determined that the buffer can no longer be accessed in the OAM address space. A possible cause could be too low STIMEOUT value specified on the OSREQ STOREBEG.
8	3C	5	1	1	OSREQ CHANGE: The EVENTEXP parameter is not allowed because the object is not waiting for an event-based-retention event.
8	3C	5	2	2	OSREQ CHANGE: The RETPD parameter not allowed for an event-based-retention object.
8	40	6	1	0	OSREQ DELETE: Deletion is not allowed because the object is in DELHOLD=HOLD state.
8	40	6	2	1	OSREQ DELETE: Deletion is not allowed because the object is under deletion-protection and is still in event-based-retention state.
8	40	6	2	2	OSREQ DELETE: Deletion is not allowed because the object is under deletion-protection and the object's expiration date has not yet been reached.
8	40	6	3	1	OSREQ DELETE: Deletion is not allowed because the object is under retention-protection and is still in event-based-retention state.
8	40	6	3	3	OSREQ DELETE: Deletion is not allowed because the object is under retention-protection and the object's retention date has not yet been reached.