OSREQ return and reason codes
OAM issues return and reason codes during processing of OSREQ macro functions. At the macro exit, register 15 will contain one of the values that are shown in Table 1.
Note:
- The F OAM,START,DIAGMSGS,OSREQFS command can be used to specify that OAM messages are to display reason codes that are related to errors in the file system processing for requests that are initiated from the OSREQ macro. See z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support for information on how to use this command.
The OSREQ return and reason codes are also applicable to
OAM’s REST support since OAM, when processing the REST request will invoke the OSREQ macro on behalf
of the request. To have the OSREQ return and reason codes returned in the response header (along
with the HTTP response code), z/OS Liberty server property
(com.ibm.oam.restapi.osreq.codes=true) can be used. Otherwise, the liberty server directory
(/logs/messages.log) can be used to look for this
information.
| Value | Meaning |
|---|---|
| 0 (X'00') | The requested function was successfully completed. |
| 4 (X'04') | The requested function was only partially completed. |
| 8 (X'08') | The requested function was not completed; the request was incorrectly issued. |
| 12 (X'0C') | The requested function was not completed; there is an error in the environment. |
| 16 (X'10') | The requested function was not completed due to a programming error. |
OAM also places a 4-byte reason code in register 0. Table 3
presents the reason codes that are generated by the OSREQ macro. The 4 bytes are defined as follows:
- Byte 0
- Contains a unique OSREQ reason code.
- Byte 1
- Contains an OSREQ function code. This byte is identified as x in table 90.
| Function code | OSREQ function | Associated REST API Function |
|---|---|---|
| 1 | ACCESS | Issued by OAM on behalf of the REST request. Multiple REST requests can be processed under a single ACCESS/UNACCESS. |
| 2 | STORE | PutObject |
| 3 | RETREIVE | GetObject |
| 4 | QUERY | HeadObject and GetObjectTagging |
| 5 | CHANGE | PutObjectTagging |
| 6 | DELETE | DeleteObject |
| 7 | UNACCESS | Issued by OAM on behalf of the REST request. Multiple REST requests can be processed under a single ACCESS/UNACCESS. |
| 8 | STOREBEG | Not Applicable |
| 9 | STOREPRT | Not Applicable |
| 10 | STOREEND | Not Applicable |
- Bytes 2 and 3
- These bytes are identified as y and z in the
following table. They represent either a 2-byte field yz, or two
single-byte fields y and z, where:
- y
- is an error indicator.
- z
- is reserved for IBM® use, unless otherwise indicated.
|
Return
Code |
Reason Code
(Bytes) |
Description
|
|||
|---|---|---|---|---|---|
|
0
|
1
|
2
|
3
|
||
| 0 (X'00') | X'00' | X'00' | X'00' | X'00' | Request successfully completed. No action required. |
| 4 (X'04') | X'04' | x | y | z | Request that is completed with a warning condition. Correct
program, if necessary.
|
| 4 (X'04') | X'04' | x | X'01' | z | QEL buffer segments are too short to accommodate all available entries; as many entries that might fit in the segments are returned. Execute query with a larger QEL buffer. |
| 4 (X'04') | X'04' | x | X'02' | z | Query element list is incomplete due to unavailable databases. Activate databases, if necessary. |
| 4 (X'04') | X'04' | x | X'03' | z | UNACCESS has completed; the token has been cleared; there are one or more requests outstanding; the outstanding requests were not affected by the UNACCESS. Copies of the token are no longer valid. When the last outstanding request associated with the token is completed, the remaining resources will be freed. Correct the program, if necessary. |
| 4 (X'04') | X'04' | x | X'04' | z | STORE, STOREBEG, or CHANGE has completed but one or more of the
following conditions occurred, as indicated by bits set in byte 3 (z). Z=BIT MAP:
|
| 4 (X'04') | X'04' | x | X'05' | z | DB2® SQL return code conversion module DSNTIAR not found. |
| 4 (X'04') | X'04' | x | X'06' | z | Automatic Access Backup active, primary object on an unavailable resource, backup object retrieved successfully. |
| 4 (X'04') | X'04' | x | X'07' | z | Second backup copy is retrieved. Primary copy is not available with access backup active. |
| 8 (X'08') | X'24' | x | y | z | Parameter is unusable, incorrect, invalid, or incomplete.
|
| 8 (X'08') | X'24' | x | X'01' | X'01' | Parameter list (MF=L) in unusable storage. |
| X'24' | x | X'01' | X'02' | Invalid value in parameter list (MF=L). Correct calling program. |
|
| 8 (X'08') | X'24' | x | X'02' | X'01' | SIZE word in unusable storage. |
| X'24' | x | X'02' | X'02' | SIZE word invalid. | |
| X'24' | x | X'02' | X'03' | The size specified on an OSREQ STOREBEG is not greater than 50MB. | |
| X'24' | x | X'02' | X'04' | 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. | |
| X'24' | x | X'02' | X'05' | 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. | |
| X'24' | x | X'02' | X'06' | The size specified on an OSREQ STOREEND is not equal to the size specified on the OSREQ STOREBEG for this store sequence. | |
| X'24' | x | X'02' | X'07' | 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. Correct calling program. |
|
| X'24' | x | X'02' | X'08' | 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. | |
| X'24' | x | X'02' | X'09' | The SIZE value is required, but was not specified | |
|
Correct calling program. |
|||||
| 8 (X'08') | X'24' | x x |
X'03'
X'03' |
X'01'
X'02' |
RETPD area in unusable storage. RETPD invalid value, must be -2 thru 93000 or X'7FFFFFFF' Correct calling program. |
| 8 (X'08') | X'24'
X'24' X'24' |
x x x |
X'04'
X'04' X'04' |
X'01'
X'02' X'03' |
STORCLAS area in unusable storage. STORCLAS invalid value. STORCLAS name length invalid value. Correct calling program. |
| 8 (X'08') | X'24'
X'24' X'24' |
x x x |
X'05'
X'05' X'05' |
X'01'
X'02' X'03' |
MGMTCLAS area in unusable storage. MGMTCLAS invalid value. MGMTCLAS name length invalid value. Correct calling program. |
| 8 (X'08') | X'24' | x X'06' | X'06'
X'06' |
X'01'
X'02' |
QEL buffer list in unusable storage. QEL buffer list contains incorrect value (for example, incorrect ID, incorrect length field, incorrect version field, reserved bit is on). |
| X'06' X'06' |
X'04' X'05' |
QEL buffer in unusable storage. The QEL value is required, but was not specified Correct calling program. |
|||
| 8 (X'08') | X'24'
X'24' X'24' |
x x |
X'07'
X'07' |
X'01'
X'02' |
Reason code area in unusable storage. Return code area in unusable storage. Correct calling program. |
| 8 (X'08') | X'24' | x | X'08' | X'01' | BUFLIST in unusable storage. |
| X'24' | x | X'08' | X'02' | BUFLIST contains incorrect value (for example, incorrect ID, incorrect length field, incorrect version field, reserved bit is on). | |
| X'24' | x | X'08' | X'03' | OBL BUFLIST contains incorrect ID value for a Non-Query. | |
| X'24' | x | X'08' | X'04' | Buffer in unusable storage. | |
| X'24' | x | X'08' | X'05' | Amount of buffer data provided on store request is less than specified size of object. | |
| X'24' | x | X'08' | X'06' | Amount of buffer data provided on the store request is greater than specified size of object. | |
| X'24' | x | X'08' | X'07' | The QEL or OBL BUFLIST contains incorrect header values. | |
| X'24' | x | X'08' | X'08' | Amount of buffer data space provided on the retrieve request is
insufficient for object. Correct calling program. |
|
| X'24' | x | X'08' | X'09' | The QEL or OBL BUFLIST contains incorrect buffer descriptor fields. | |
| X'24' | x | X'08' | X'0A' | When storing an object greater than 50 MB, multiple data buffers were supplied that are not in contiguous storage. | |
| X'24' | x | X'08' | X'0B' | When retrieving an object greater than 50 MB and less than or equal to 256 MB, the first data buffer supplied is not large enough to contain the object. | |
| X24' | x | X'08' | X'0C' | The BUFLIST value is required, but was not specified | |
|
Correct calling program. |
|||||
| 8 (X'08') | X'24' | x | X'09' | X'01'
X'02' X'03' |
Token area in unusable storage. Token contains invalid contents. The TOKEN value is required, but was not specified Correct calling program. |
| 8 (X'08') | X'24' | x | X'0A' | X'01' | Name in unusable storage. |
| X'24' | x | X'0A' | X'02' | 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. | |
| X'24' | x | X'0A' | X'03' | Qualifier longer than 8 characters. | |
| X'24' | x | X'0A' | X'04' | Name contains an invalid character. | |
| X'24' | x | X'0A' | X'05' | Null qualifier. | |
| X'24' | x | X'0A' | X'06' | 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. | |
| X'24' | x | X'0A' | X'07' | First character in name or qualifier is not alphabetic. | |
| X'24' | x | X'0A' | X'08' | Blank other than at right end. | |
| X'24' | x | X'0A' | X'09' | Name length is 0 or more than 44. | |
| X24' | x | X'0A' | X'0A' | The OBJECT NAME value is required, but was not specified | |
|
Correct calling program. |
|||||
| 8 (X'08') | X'24' | x | X'0B' | X'02' | First positional parameter code for first positional parameter is invalid. |
| 8 (X'08') | X'24' | x | X'0C' | X'01' | Offset in unusable storage. |
| X'24' | x | X'0C' | X'02' | Offset value is larger than length of object. | |
| X'24' | x | X'0C' | X'03' | Offset value is negative. | |
| X'24' | x | X'0C' | X'04' | 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. | |
| X'24'
X'24' X'24' |
x x x |
X'0D'
X'0D' X'0D' |
X'01'
X'02' X'03' X'04' |
Length in unusable storage. Length value is larger than offset value plus the length of the object from offset. Length value is negative. The length specified on an OSREQ RETRIEVE is greater than 256M. Correct calling program. |
|
| 8 (X'08') | X'24'
X'24' |
x x |
X'0E'
X'0E' |
X'01'
X'02' |
MSGAREA in unusable storage. MSGAREA length value negative. Correct calling program. |
| 8 (X'08') | X'24' | x | X'0F' | X'01' | The collection name passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (that is, 0C4 abend) when it attempted to reference the area of storage containing the collection name or the collection name length. |
| X'24' | x | X'0F' | X'02' | 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. | |
| X'24' | x | X'0F' | X'03' | The collection name passed to OAM on the OSREQ macro contains a qualifier longer than 8 characters. | |
| X'24' | x | X'0F' | X'04' | 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. | |
| X'24' | x | X'0F' | X'05' | The collection name passed to OAM on the OSREQ macro contains a
null qualifier. This means that one of the following is true:
|
|
| X'24' | x | X'0F' | X'06' | Reserved. | |
| X'24' | x | X'0F' | X'07' | 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 (@, #, $). | |
| X'24' | x | X'0F' | X'08' | The collection name passed to OAM on the OSREQ macro contains an imbedded blank. | |
| X'24' | x | X'0F' | X'09' | The collection name passed to OAM on the OSREQ macro has an invalid length. The collection name length is zero or longer than 44 characters. | |
| X24' | x | X'0F' | X'0A' | The COLLECTION NAME value is required, but was not specified | |
|
Correct calling program. |
|||||
| 8 (X'08') | X'24' | x | X'10' | X'10' | IADDRESS points to unusable storage. Correct calling program. |
| 8 (X'08') | X'24' | x | X'11' | X'01' | TTOKEN area in unusable storage. Correct calling program. |
| 8 (X'08') | X'24' | x | X'12' | X'01' | RECALL parameter in unusable storage. Correct calling program. |
| X'24' | x | X'12' | X'02' | RECALL parameter is larger than maximum allowed. Correct calling program. |
|
| X'24' | x | X'12' | X'03' | RECALL parameter is negative number. Correct calling program. |
|
| 8 (X'08') | X'24' | x | X'13' | X'01' | RETCODE2 parameter in unusable storage. Correct calling program. |
| 8 (X'08') | X'24' | x | X'14' | X'01' | 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.
Correct calling program. |
| X24' | X'14' | X'02' | The STOKEN value provided does not represent a store sequence currently in progress. | ||
| X24' | x | X'14' | X'03' | The STOKEN value is required, but was not specified | |
|
Correct calling program. |
|||||
| 8 (X'08') | X'24' | x | X'15' | z | STIMEOUT |
| X'24' | x | X'15' | X'01' | 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 0C4 ABEND) when it attempted to reference the area of storage containing the STIMEOUT (fullword). | |
| X'24' | x | X'15' | X'02' | The value specified for STIMEOUT is invalid. | |
| 8 (X'08') | X'24' | x | X'16' | X'01' | EVENTEXP area in unusable storage. |
| X'24' | x | X'16' | X'02' | EVENTEXP invalid value, must be 0-93000. | |
| X'24' | x | X'16' | X'03' | EVENTEXP and RETPD both supplied, only one allowed. | |
| 8 (X'08') | X24' | x | X'17' | z | BUFFER64 |
| X24' | x | X'17' | X'01' | The BUFFER64 area (double word) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, 0C4 ABEND) when it attempted to reference the area of storage containing the BUFFER64 value (double word). | |
| 8 (X'08') | X24' | x | X'18' | z | SIZE64 |
| X24' | x | X'18' | X'01' | The SIZE64 area (double word) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, 0C4 ABEND) when it attempted to reference the area of storage containing the SIZE64 value (double word). | |
| X24' | x | X'18' | X'02' | The size specified in the SIZE64 area for an OSREQ STORE request has an invalid value. The value is negative or zero. | |
| X24' | x | X'18' | X'03' | The size specified in the SIZE64 area for an OSREQ STORE request has an invalid value. The value exceeds the maximum configured object size (which may be up to 2000M). | |
| X24' | x | X'18' | X'04' | The size specified in the SIZE64 area for an OSREQ STORE request has an invalid value. The value exceeds 256M which is the maximum for an object to be stored to the Optical level of the OAM storage hierarchy. | |
| 8 (X'08') | X24' | x | X'19' | z | LENGTH64 |
| X24' | x | X'19' | X'01' | The LENGTH64 area (double word) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, 0C4 ABEND) when it attempted to reference the area of storage containing the LENGTH64 value (double word). | |
| X24' | x | X'19' | X'02' | The length specified in the LENGTH64 area for an OSREQ RETRIEVE request has an invalid value. The value is negative or zero. | |
| X24' | x | X'19' | X'03' | The length specified in the LENGTH64 area for an OSREQ RETRIEVE request has an invalid value. For a retrieve of a full object, the value is larger than the object size. For a partial retrieve, the length, when added to the offset specified in the OFFSET64 area, is beyond the end of the object. | |
| 8 (X'08') | X24' | x | X'1A' | z | OFFSET64 |
| X24' | x | X'1A' | X'01' | The OFFSET64 area (double word) passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, 0C4 ABEND) when it attempted to reference the area of storage containing the OFFSET64 value (double word). | |
| X24' | x | X'1A' | X'02' | The offset specified in the OFFSET64 area for an OSREQ RETRIEVE request has an invalid value. The value is negative. | |
| X24' | x | X'1A' | X'03' | The offset specified in the OFFSET64 area for an OSREQ RETRIEVE request has an invalid value. The offset value specified is beyond the last byte of the object. | |
| 8 (X'08') | X24' | x | X'1B' | z | DB2ID |
| X24' | x | X'1B' | X'01' | The DB2ID area passed to OAM on the OSREQ macro is in unusable storage. This means that OAM encountered a virtual storage translation exception (for example, 0C4 ABEND) when it attempted to reference the area of storage containing the DB2ID value. | |
| X24' | x | X'1B' | X'02' | The DB2ID passed to OAM on the OSREQ macro contains an invalid length value. It is negative, greater than 4, or (in a multiple OAM configuration only) zero. | |
| X24' | x | X'1B' | X'03' | The DB2ID passed to OAM on the OSREQ macro does not match any of the Db2 subsystems that have been configured for OAM or OTIS has not yet connected to the designated Db2 subsystem. | |
| X24' | x | X'1B' | X'04' | The application is running in the CICS or DSN environment or specified the IADDRESS keyword indicating that a connection to a Db2 subsystem has already been made, but the DB2ID passed to OAM on the OSREQ macro is not consistent with the connected Db2 subsystem. | |
| X24' | x | X'1B' | X'06' | In a multiple OAM configuration, when not in a DSN environment and IADDRESS is not specified, the DB2ID keyword is required but was not specified. | |
| X'24' | x | X'1B' | X'07' | The application is either running in the CICS or DSN environment, or it has specified the IADDRESS keyword indicating that a connection to a Db2 subsystem has already been made. Either the connected Db2 subsystem does not match any of the subsystems defined in a multiple OAM configuration, or OTIS has not yet connected to the Db2 subsystem. | |
| 8 (X'08') | X'28' | x | y | z | IADDRESS routine error. xyz System/User completion code. Correct calling program. |
| X'2C' | x | y | z | No valid object found. | |
| 8 (X'08') | X'2C' | x | X'01' | z | Directory entry not found. |
| 8 (X'08') | X'2C' | x | X'02' | z | Object segments not found. |
| 8 (X'08') | X'2C' | x | X'03' | z | Backup copy was not found. |
| 8 (X'08') | X'2C' | x | X'04' | z | Second backup copy was not found. |
| 8 (X'08') | X'2C' | x | X'05' | 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. Correct calling program. |
| 8 (X'08') | X'30' | x | y | z | Object already exists. |
| 8 (X'08') | X'30' | x | X'01' | z | Directory entry already exists. |
| 8 (X'08') | X'30' | x | X'02' | z | Object segment already exists. The directory entry did not exist for this object, however a data segment already exists in the DASD 4K, 32K, or LOB table for this object. Correct calling program. |
| 8 (X'08') | X'34' | x | y | z | Request rejected for this task. |
| 8 (X'08') | X'34'
X'34' |
x x |
X'01'
X'02' |
z z |
Request issued from TCB other than initial
access request TCB. Access issued from TCB with prior access still active. Correct calling program. |
| 8 (X'08') | X'38' | x | y | z | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued
while a STOREBEG is in progress.
|
| 8 (X'08') | X'38' | x | X'01' | z | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREBEG is in progress. |
| 8 (X'08') | X'38' | x | X'02' | z | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREPRT is in progress. |
| 8 (X'08') | X'38' | x | X'03' | z | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREEND is in progress. |
| 8 (X'08') | X'38' | x | X'04' | z | A store sequence could not be begun (STOREBEG) because the object location of Optical is not supported for a store sequence. |
| 8 (X'08') | X'38' | x | X'06' | z | On a STOREPRT or STOREEND request for an object to be stored to DASD 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. 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. |
| 8 (X'08') | X'38' | x | X'07' | 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 (X'08') | X'38' | x | X'08' | z | The expected length of the object to be retrieved is greater than the maximum retrieval buffer size of 256M. 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 (X'08') | X'38' | x | X'09' | 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 (X'08') | X'38' | x | 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. Possible cause could be too low STIMEOUT value specified on the OSREQ STOREBEG. |
| 8 (X'08') | X'3C' | X'05' | X'01' | X'01' | OSREQ CHANGE: The EVENTEXP parameter is not allowed because the object is not waiting for an event-based-retention event. |
| 8 (X'08') | X'3C' | X'05' | X'02' | X'02' | OSREQ CHANGE: The RETPD parameter not allowed for an event-based-retention object. |
| 8 (X'08') | X'40' | X'06' | X'01' | X'00' | OSREQ DELETE: Deletion is not allowed because the object is in DELHOLD=HOLD state. |
| 8 (X'08') | X'40' | X'06' | X'02' | X'01' | OSREQ DELETE: Deletion is not allowed because the object is under deletion-protection and is still in event-based-retention state. |
| X'40' | X'06' | X'02' | X'02' | 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 (X'08') | X'40' | X'06' | X'03' | X'01' | OSREQ DELETE: Deletion is not allowed because the object is under retention-protection and is still in event-based-retention state. |
| X'40' | X'06' | X'03' | X'03' | OSREQ DELETE: Deletion is not allowed because the object is under retention-protection and the object’s retention date has not yet been reached. | |
| 8 (X'08') | X'44' | x | y | z | 64-bit OSREQ request error |
| 8 (X'08') | X'44' | x | X'01' | z | A 64-bit OSREQ STORE request requires that both BUFFER64 and SIZE64 values are specified |
| 8 (X'08') | X'44' | x | X'02' | z | A 64-bit OSREQ RETRIEVE request requires that both BUFFER64 and LENGTH64 values are specified and, optionally, an OFFSET64 can be specified when both BUFFER64 and LENGTH64 have been specified. |
| 8 (X'08') | X'44' | x | X'03' | z | For a 64-bit OSREQ STORE request, BUFFER64 and SIZE64 are mutually exclusive with BUFLIST, RELBUF, and SIZE |
| 8 (X'08') | X'44' | x | X'04' | z | For a 64-bit OSREQ RETRIEVE request, BUFFER64, LENGTH64, and OFFSET64 are mutually exclusive with BUFLIST, LENGTH, and OFFSET |
| 12 (X'0C') | X'50' | x | y | z | Error occurred in file system sublevel configuration
|
| X'50' | x | X'01' | z | File system sublevel work initiated, but no SETDISK statements have been configured. | |
| X'50' | x | X'02' | z | Directory specified on SETDISK statement for storage group resolves to a path that exceeds the maximum allowable OAM path length | |
| X'50' | x | X'03' | z | A component of the OAM constructed portion of the directory or file path now includes a symbolic link, however symbolic links are not allowed | |
| X'50' | x | X'04' | z | The file system type specified on the SETDISK statement for the storage group does not match the mounted file system type at the resolved directory location | |
| X'50' | x | X'05' | z | The z/OS UNIX file system maximum file size that has been configured has prevented OAM file system activity | |
| X'50' | x | X'06' | z | The metafile is invalid. | |
| 12 (X'0C') | X'51' | x | y | z | Unsuccessful Unix System Services file system access. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'52' | x | y | z | Unable to access required file system sentinel. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'53' | x | y | z | Unable to successfully create directory in file system. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'54' | x | y | z | Unable to open file in file system. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'55' | x | y | z | Unable to write file in file system. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'56' | x | y | z | Unable to close file in file system. Look up the
errno, if provided, in z/OS UNIX System Services Messages and Codes.
|
| 12 (X'0C') | X'57' | x | y | z | Unix System Services abnormally ended processing of the file system
request with a EC6 abend code. Look up the reason code, if provided, in z/OS MVS System Codes under the EC6 abend code.
|
| 12 (X'0C') | X'58' | x | y | z | Unix System Services abnormally ended processing of the file system
request with a 422 abend code. Look up the reason code, if provided, in z/OS MVS System Codes under the 422 abend code.
|
| 12 (X'0C') | X'59' | x | y | z | Unix System Services abnormally ended processing of the file system
request with an unexpected abend code. Look for messages in the log to identify the abend code then
look up the associated reason code, if provided, in z/OS MVS System Codes under the abend code.
|
| 12 (X'0C') | X'5A' | x | y | z | Unsuccessful Unix System Services file system access in meta file system. Look up the errno, if provided, in z/OS Unix System Services Messages and Codes, YYZZ is Unix System Services errno. |
| 12 (X'0C') | X'5B' | x | y | z | Unable to access required file system sentinel in meta file system. Look up the errno, if provided, in z/OS Unix System Services Messages and Codes, YYZZ is Unix System Services errno. |
| 12 (X'0C') | X'5C' | x | y | z | Unable to open file in meta file system. Look up the errno, if provided, in z/OS Unix System Services Messages and Codes, YYZZ is Unix System Services errno. |
| 12 (X'0C') | X'5D' | x | y | z | Unable to write file in meta file system. Look up the errno, if provided, in z/OS Unix System Services Messages and Codes, YYZZ is Unix System Services errno. |
| 12 (X'0C') | X'5E' | x | y | z | Unable to close file in meta file system. Look up the errno, if provided, in z/OS Unix System Services Messages and Codes, YYZZ is Unix System Services errno. |
| 12 (X'0C') | X'60' | x | y | z | OTIS interface error detected. |
| 12 (X'0C') | X'60' | x | X'01' | X'01' | Db2 service inactive. |
| X'60' | x | X'01' | X'02' | OTIS not initialized. | |
| X'60' | x | X'01' | X'03' | OTIS not initialized, or error establishing OTIS environment. | |
| 12 (X'0C') | X'60' | x | X'02' | X'04' | Application running in unsupported key. |
| X'60' | x | X'02' | X'05' | Application supplied parameter in fetch protected storage. | |
| X'60' | x | X'02' | X'06' | Reserved for IBM use. | |
| X'60' | x | X'02' | X'07' | Application supplied a parameter that is not in the PRIVATE area. | |
| X'60' | x | X'02' | X'08' | Getmain failed. | |
| X'60 | x | X'02' | X'09' | Unsuccessful attempt to put element on work queue. | |
| X'60' | x | X'02' | X'12' | Invalid number of parms. | |
| X'60' | x | X'02' | X'13' | Parameter with invalid size. | |
| X'60' | x | X'02' | X'14' | Invalid parameter list. | |
| X'60' | x | X'02 | X'0A' | Unsuccessful attempt to take element off completion queue. | |
| 12 (X'0C') | X'60' | x | X'03' | X'0B' | Error during collection table update. Db2 not connected. |
| 12 (X'0C') | X'60' | x | X'03' | X'0C' | Error during collection table update. Db2 thread not OPEN. Correct application program. |
| X'60' | x | X'03' | X'0D' | The Db2 subtask is terminating. | |
| X'60' | x | X'03' | X'0E' | The DB2ID was not specified. | |
| X'60' | x | X'03' | X'0F' | The DB2ID specified is not valid. An OAM instance has not been configured for the Db2 subsystem. | |
| X'60' | x | X'03' | X'10' | The DB2ID specified is not valid. A non-blank value was specified in a classic OAM configuration. | |
| X'60' | x | X'03' | X'11' | The OTIS address space is terminating. | |
| 12 (X'0C') | X'64' | x | y | z | CICS/Db2 communication failure. Db2 not initialized, or CICS® not connected to Db2. Correct Db2 connection to the CICS region. |
| 12 (X'0C') | X'68' | x | y | z | OSR not initialized. Correct the environment. |
| 12 (X'0C') | X'68'
X'68' |
x x |
X'01'
X'02' |
z z |
Control blocks not initialized. OSR not enabled as CICS resource manager. |
| 12(X'0C') | X'68' | x | X'03' | z | The OAM configuration contains no OAM subsystems because all previously defined OAM subsystems have been removed. |
| 12 (X'0C') | X'69' | x | y | z | Cloud Data Access detected failure.
|
| 12 (X'0C') | X'6A' | x | y | z | Web Toolkit detected failure.
|
| 12 (X'0C') | X'6B' | x | y | z | Cloud Provider detected failure.
|
| 12 (X'0C') | X'6C' | x | y | z | OAM address space detected failure.
|
| 12 (X'0C') | X'6D' | x | y | z | OAM address space detected failure:
|
| 12 (X'0C') | X'6E' | x | y | z | OSMC/OAM address space detected failure. Automatic Access Backup
active, primary object on an unavailable resource, retrieve of the backup copy of the object failed.
|
| 12 (X'0C') | X'6F' | x | X'01' | z | Automatic Access Backup active, primary object on an unavailable resource, no backup object available. |
| 12 (X'0C') | X'6F' | x | X'02' | z | An OSREQ retrieve was received. Primary copy was not available. Access backup active for BACKUP2. However, a second backup copy does not exist for the object. |
| 12 (X'0C') | X'70' | x | y | z | Db2 detected failure (media). yz represents the Db2 SQL error. Convert the yz to decimal, and look up the resulting SQL
code.
|
| 12 (X'0C') | X'74' | x | y | z | Db2 detected failure (other).
yz represents the Db2 SQL error. Convert the yz to decimal,
and look up the resulting SQL code.
|
| 12 (X'0C') | X'78' | x | y | z | Db2 detected inadequate DASD
space. yz represents the Db2 SQL error. Convert the yz to
decimal, and look up the resulting SQL code.
|
| 12 (X'0C') | X'7C' | x | y | z | Insufficient virtual storage. |
| 12 (X'0C') | X'7C' | x | X'01' | z | Insufficient virtual storage for re-blocking. |
| 12 (X'0C') | X'7C' | x | X'02' | z | Insufficient virtual storage for OAM buffer. |
| 12 (X'0C') | X'7C' | x | X'03' | z | Insufficient virtual storage for work area. |
| 12 (X'0C') | X'7C' | x | X'04' | z | Insufficient 31-bit virtual storage available in the application address space needed to transfer data to or from a 64-bit addressable storage area |
| 12 (X'0C') | X'7C' | x | X'05' | z | Insufficient virtual storage for parameter list. |
| 12 (X'0C') | X'80' | x | y | z | Database contents inconsistent. |
| 12 (X'0C') | X'80' | x | X'01' | z | Directory entry location invalid. |
| 12 (X'0C') | X'80' | x | X'02' | z | Directory entry object size not equal to sum of segment sizes. |
| 12 (X'0C') | X'80' | x | X'03' | z | The object size returned by OAM interface not equal to size requested. |
| 12 (X'0C') | X'80' | x | X'04' | X'00' | ODSTATF_EBR inconsistent with ODEXPDT. ODEXPDT must be ‘0002-02-02’ for event-based-retention object. |
| 12 (X'0C') | X'80' | x | X'05' | X'00' | ODSTATF_RETPROT inconsistent with ODRETDT. For retention-protected object, the ODRETDT can only be ‘0001-01-01’ if the ODSTATF_EBR flag is ON. |
| 12 (X'0C') | X'80' | x | X'06' | X'00' | ODEXPDT inconsistent with ODRETDT for retention-protected object |
| 12 (X'0C') | X'80' | x | X'07' | X'00' | ODLSLOC is inconsistent with ODLOCFL which indicates a cloud storage level. ODLSLOC must be in the format of ‘ C’ followed by a 4 hexadecimal character cloud ID. |
| 12 (X'0C') | X'84' | x | y | z | Caller not authorized. yz represents the Db2 SQL error. Convert the yz to decimal, and look up the resulting SQL
code.
|
| 12 (X'0C') | X'88' | x | y | z | Resource not available. yz represents the Db2 SQL error. Convert the yz to decimal, and look up the resulting SQL
code.
|
| 12 (X'0C') | X'8C' | x | y | z | Deadlock or time out occurred. Database rolled back to previous
synchronization point. yz represents the Db2 SQL error.
Convert the yz to decimal, and look up the resulting SQL code.
|
| 12 (X'0C') | X'90' | x | y | z | Deadlock or time out occurred. Database not rolled back to previous
synchronization point. yz represents the Db2 SQL error.
Convert the yz to decimal, and look up the resulting SQL code.
|
| 12 (X'0C') | X'94' | x | y | z | OTIS Db2 error during
collection table processing. yz represents the Db2 SQL error.
Convert the yz to decimal, and look up the resulting SQL code.
|
| 12 (X'0C') | X'98' | x | y | z | Error attempting to retrieve variable value from Db2. yz represents the Db2 SQL error. Convert the yz to decimal, and look up the resulting SQL code. yz Db2 SQL code. |
| 12 (X'0C') | X'A0' | x | y | z | SMS error during SMS review.
|
| 12 (X'0C') | X'A4' | x | y | z | Db2 error during SMS
interface utility processing. yz represents the Db2 SQL error.
Convert the yz to decimal, and look up the resulting SQL code.
|
| 12 (X'0C') | X'A8' | x | y | z | Internal error during SMS review.
|
| 12 (X'0C') | X'A8' | x | X'01' | z | Invalid function code in CBRSMSI. |
| 12 (X'0C') | X'A8' | x | X'02' | z | Parameter list error. |
| 12 (X'0C') | X'A8' | x | X'03' | z | SMS subsystem not active. |
| 12 (X'0C') | X'A8' | x | X'04' | x | SMS subsystem not installed. |
| 12 (X'0C') | X'A8' | x | X'05' | z | Error invoking SMS subsystem. |
| 12 (X'0C') | X'A8' | x | X'06' | z | SMS is restarting. |
| 12 (X'0C') | X'A8' | x | X'08' | z | Storage group not connected. |
| 12 (X'0C') | X'A8' | x | X'09' | z | Constructs not assigned by SMS. |
| 12 (X'0C') | X'A8' | x | X'0A' | z | No expiration criteria in management class |
| 12 (X'0C') | X'A8' | x | X'0C' | z | Storage group has the wrong associated Db2 identifier in a multiple OAM address space configuration. |
| 12 (X'0C') | X'A8' | x | X'0D' | z | Storage group has the wrong associated Db2 identifier in a multiple OAM address space configuration. A new collection name has been inserted into the OAM Collection table for this Storage Group. You might need to manually remove this new collection or update the DB2ID in the storage group definition. |
| 12 (X'0C') | X'AC'
X'AC' |
x x |
X'01'
X'02' |
z z |
SMS not active. Default Db2 name not in SMS control blocks. |
| 12 (X'0C') | X'B0' | x | y | z | Request denied due to storage group state. |
| 12 (X'0C') | X'B0'
X'B0' |
x x |
X'01'
X'02' |
z z |
Storage group state is DISABLE NEW. Storage group state is DISABLE ALL. Resubmit the request on a system where the group is enabled, or enable the group on this system, activate the modified SCDS, and resubmit the request. |
| 12 (X'0C') | X'B2' | x | y | z | Request denied due to Db2 environment |
| 12 (X'0C') | X'B2' | x | X'01' | z | For a 64-bit OSREQ STORE request, the required LOB environment does not exist for storage of an object greater than 256M to the Db2 sublevel |
| 12 (X'0C') | X'B4' | x | X'01' | z | Collection definition errors. |
| 12 (X'0C') | X'B4' | x | X'01' | z |
Collection is not defined (on any request other than a store). |
| 12 (X'0C') | X'BA' | x | y | z | Installation exit CBRUXSAE has denied user authorization for this
request.
|
| 12 (X'0C') | X'BC' | x | y | z | Installation exit CBRUXSAE has resulted in an abend. This OSREQ
request is failed and subsequent requests will fail until the error in CBRUXSAE is fixed and the
exit is reset using the LIBRARY RESET,CBRUXSAE command. OSREQ functions that are in BYPASSED mode
prior to the abend are not affected, and will not be failed. The D SMS,OAM command can be used to
display the CBRUXSAE status for each OSREQ function type.
|
| 12 (X'0C') | X'BF' | x | y | X'00' | Error related to coexistence. |
| 12 (X'0C') | X'BF' | x | X'01' | X'00' | OSREQ STORE to the requested storage hierarchy level/sublevel is not supported at this maintenance or release level. |
| 16 (X'10') | X'CA' | x | y | z | An abend occurred. |
| 16 (X'10') | X'CC' | x | y | z | OSR detected error. Contact your IBM service representative. |
| 16 (X'10') | X'CC' | x | X'01' | z | Invalid Db2 data base name. |
| 16 (X'10') | X'CC' | x | X'02 | z | Invalid OSMI data base function code. |
| 16 (X'10') | X'CC' | x | X'03' | z | Insufficient storage for OSMI data base services. |
| 16 (X'10') | X'CC' | x | X'04' | z | Invalid OSMI work area chain. |
| 16 (X'10') | X'CC' | x | X'05' | z | An OSMI work area has been damaged. |
| 16 (X'10') | X'CC' | x | X'06' | z | ASXB ptr to OMCB is invalid. |
| 16 (X'10') | X'D0' | x | y | z | OAM detected programming error.
|
| 16 (X'10') | X'D2' | x | y | z | OAM Delete Object Table Db2
error. yz represents the Db2 SQL error. Convert the yz to
decimal, and look up the resulting SQL code.
|
| 16 (X'10') | X'D4' | x | y | z | Db2 detected error. yz
represents the Db2 SQL error. Convert the yz to decimal, and
look up the resulting SQL code.
|
| 16 (X'10') | X'D8' | x | y | z | Db2 Call Attach Facility E/P DSNALI/DSNTIAR/DSNCLI not found when loaded. |
| 16 (X'10') | X'DC' | x | y | z | Db2 Call Attach Facility
error.
|
| 16 (X'10') | X'DD' | x | y | z | OAM File System Delete Table Db2 error.
yz represents the Db2 SQL error. Convert the yz
to decimal, and look up the resulting SQL code.
|
| 16 (X'10') | X'DE' | x | y | z | OAM File System Delete Table general error. |
| 16 (X'10') | X'E0' | x | y | z | SMSI detected error.
|
| 16 (X'10') | X'E0' | x | X'06' | z | Error issuing messages from SMS. |
| 16 (X'10') | X'E0' | x | X'07' | z | Reserved for IBM use. |
| 16 (X'10') | X'E0' | x | X'08' | z | Reserved for IBM use. |
| 16 (X'10') | X'E0' | x | X'0A' | z | Error on ATTACH macro. |
| 16 (X'10') | X'E0' | x | X'0C' | z | Reserved for IBM use. |
| 16 (X'10') | X'E0' | x | X'0D' | z | Unexpected error from Db2. |
| 16 (X'10') | X'E4' | x | y | z | Store sequence environmental error:
|
| 16 (X'10') | X'E4' | x | X'01' | z | A STOREBEG request was issued for an object to be stored on DASD, but the required Db2/LOB environment does not exist. |
| 16 (X'10') | X'E4' | x | X'02' | z | A STOREBEG request was issued for an object to be stored on File system or
Tape, but a buffer could not be acquired in the OAM address space for the object. Ensure system configured to make sufficient 64-bit addressable virtual memory available to the OAM address space. |