OAM issues return and reason codes during processing of OSREQ macro functions. At the macro exit, register 15 will contain one of the values 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 related to errors in
the file system processing for requests initiated from the OSREQ macro.
See z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support for
information on using this command.
| 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 2 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 internal OSREQ function code used by IBM® service representatives in debugging programming errors. This byte is identified as x in the following table.
- 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 |
Reason Code |
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 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 could 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 is 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 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'02' | SIZE word invalid. | ||||
| X'03' | The size specified on an OSREQ STOREBEG is not greater than 256M. | ||||
| 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'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'06' | The size specified on an OSREQ STOREEND is not equal to the size specified on the OSREQ STOREBEG for this store sequence. | ||||
| 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'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'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'
|
QEL buffer in unusable storage.
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'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 buffer list 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 buffer list 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'
|
Token area in unusable storage. Token contains invalid contents.
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'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. | |
| 8 (X'08') | 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. |
| 8 (X'08') | X'24' | x | X'12' | X'02' | RECALL parameter is larger than maximum
allowed. Correct calling program. |
| 8 (X'08') | 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. |
| 8 (X'08') | X24' | X'14' | X'02' | The STOKEN value provided does not represent a store sequence currently in progress. | |
| 8 (X'08') |
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 |
| 8 (X'08') |
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 |
| 8 (X'08') |
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). |
| 8 (X'08') |
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. |
| 8 (X'08') |
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). |
| 8 (X'08') |
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 |
| 8 (X'08') |
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). |
| 8 (X'08') |
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. |
| 8 (X'08') |
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 |
| 8 (X'08') |
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). |
| 8 (X'08') |
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. |
| 8 (X'08') |
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') | X'28' | x | y | z | IADDRESS routine error. xyz System/User completion code. Correct calling program. |
| 8 (X'08') | X'2C' | x | y | z | No valid object found. |
| 8 (X'08') | X'2C' | x | X'01' | z | Directory entry not found. |
| X'2C' | x | X'02' | z | Object segments not found. | |
| X'2C' | x | X'03' | z | Backup copy was not found. | |
| X'2C' | x | X'04' | z | Second backup copy was not found. | |
| 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. |
| 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 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'02' | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREPRT is in progress. | |||
| 8 (X'08') | X'03' | A store sequence function (STOREBEG, STOREPRT, STOREEND) was issued while a STOREEND is in progress. | |||
| 8 (X'08') | X'04' | 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'06' | 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'07' | 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'08' | 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. |
| 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. | |
| 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 | |
| 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'60' | x | y | z | OTIS interface error detected. |
| 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. | |
| 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'12' |
Invalid number of parms. |
| |
X'60' |
x |
X'02' |
X'13' |
Parameter with invalid size. |
| X'60' | x | X'03' | X'0B' | Error during collection table update.
DB2 not connected. |
|
| X'60' | x | X'03' | X'0C' | Error during collection table update.
DB2 thread not OPEN. Correct application program. |
|
| 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'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 | mf=lDB2 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'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'80' | x | y | z | Database contents inconsistent. |
| X'80' | x | X'01' | z | Directory entry location invalid. | |
| X'80' | x | X'02' | z | Directory entry object size not equal to sum of segment sizes. | |
| 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. |
| 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. | |
| X'80' | x | X'06' | X'00' | ODEXPDT inconsistent with ODRETDT for retention-protected object | |
| 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'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. |
| X'A8' | x | X'02' | z | Parameter list error. | |
| X'A8' | x | X'03' | z | SMS subsystem not active. | |
| X'A8' | x | X'04' | x | SMS subsystem not installed. | |
| X'A8' | x | X'05' | z | Error invoking SMS subsystem. | |
| X'A8' | x | X'06' | z | SMS is restarting. | |
| X'A8' | x | X'08' | z | Storage group not connected. | |
| X'A8' | x | X'09' | z | Constructs not assigned by SMS. | |
| X'A8' | x | X'0A' | z | No expiration criteria in management class | |
| X'A8' | x | X'0B' | z | Error calculating the expiration date | |
| 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 | y | z | Collection definition errors. |
| 12 (X'0C') | X'B4' | x | X'01' | z | Collection is not defined in catalog (on any request other than a store). |
| X'B4' | x | X'02' | z | Collection is not defined in catalog but is defined in collection identifier table (store only). | |
| X'B4' | x | X'03' | z | Collection definition in catalog is incomplete and collection is not defined in collection identifier table (for example, IDCAMS was used to create a collection catalog entry that did not previously exist). | |
| 12 (X'0C') | X'BA' | x | y | z | Installation exit CBRUXSAE has denied
user authorization for this request.
|
| 16 (X'10') | 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.
|
| 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'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'01' | z | Catalog error detected on a superlocate request for a collection. |
| X'E0' | x | X'02' | z | Catalog error detected on a define request for a collection. | |
| X'E0' | x | X'03' | z | Catalog error detected on an alter request for a collection. | |
| X'E0' | x | X'06' | z | Error issuing messages from SMS. | |
| X'E0' | x | X'07' | z | Reserved for IBM use. | |
| X'E0' | x | X'08' | z | Reserved for IBM use. | |
| X'E0' | x | X'0A' | z | Error on ATTACH macro. | |
| X'E0' | x | X'0C' | z | Reserved for IBM use. | |
| 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 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. |