z/OS DFSMSdfp Diagnosis
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


OAM macro return and reason codes

z/OS DFSMSdfp Diagnosis
SC23-6863-00

Although the OAM macro interface is an internal interface, the return and reason codes occasionally appear to the application invoking the OSREQ macro. The return codes are also contained in messages issued by OAM when they occur. For this reason, the return and reason codes are documented as shown in Table 1.

Table 1. OAM Macro Return Codes
Value Description
0 (X'00') Request completed successfully.
4 (X'04') Request completed with warning condition.

The reason code identifies the warning condition.

8 (X'08') Invalid request.

The reason code identifies the invalid parameter.

12 (X'0C') Request failed.

A required software or hardware resource is unusable or unavailable, a permanent I/O error has occurred, or lack of optical volume space has prevented the writing of an object. The reason code identifies the error type and the specific cause of the failure.

16 (X'10') OAM failed.

The attempted use of a system service failed with a return code other than zero, or an abend occurred during request processing or a logic error occurred. The reason code indicates the failing system service. The return code from the system service or the abend code is placed in the additional error information field OPLFERR in the OPL feedback area.

Table 2 presents the reason codes that are associated with each of the return codes.

Table 2. OAM Macro Reason Codes
Return Code Error Code Reason Code Description
X'00'   X'0000' Request was successfully scheduled.
 
X'04' Warning X'0001' Object length less than buffer length for TYPE(READ).
    X'0002' Object length greater than buffer length for TYPE(READ).
    X'0010' Optical VTOC entry for object not in range given by STSECTOR.
    X'0020' Partial read extends beyond object bounds.
    X'0030' Optical volume specified on query request is a shelf volume.
    X'0031' Tape volume specified on a query request is outside of an ATL. The volume could be inside of an MTL or on the shelf.
    X'0040' Part of volume list operation was successfully scheduled.
    X'0041' Part of a library audit was successfully scheduled.
    X'0042' File system request processing cancelled
 
X'08' Invalid request X'0400' Invalid parameter list address.
    X'0401' Invalid control block ID.
    X'0402' Invalid VOLLIST parameter specified.
    X'0403' Invalid volume type parameter specified.
    X'0404' No volume type parameter specified.
    X'0405' Invalid volume serial number specified.
    X'0406' Invalid media type found in OAM.
    X'0407' Invalid library device type specified for an OAM request.
    X'0408' Media type and device type cannot coexist.
    X'0410' Invalid request type.
    X'0411' TYPE(WRITE) not specified for chained request.
    X'0412' Only WRITEs and READs can be canceled by invoking the OAM macro, TYPE CANCEL.
    X'0420' Object name is missing.
    X'0421' Collection name is missing.
    X'0422' Library name is missing.
    X'0423' Volume serial number is missing.
    X'0424' Sector number(if optical media) or 3480/3490 blockid (if tape media) is missing.
    X'0425' Object size is missing.
    X'0426' Scope is missing.
    X'0427' Scope is invalid.
    X'0428' SQLCAPTR is missing.
    X'0430' Invalid volume option.
    X'0431' Volume option does not match that of first OPL in chain.
    X'0432' There are tape and optical OPLs in the same chain.
    X'0433' An OPL has both volume types specified. OAM does not know if an object should go to optical or tape media.
    X'0440' Volume serial number missing for TYPE(READ).
    X'0441' Volume serial number not defined in OAM database.
    X'0442' Volume serial number does not match that of first OPL in chain.
    X'0443' Eject request already pending for specified volume.
    X'0444' Invalid volume serial number on an eject request.
    X'0445' Undefined volume serial number on an eject request.
    X'0446' Volume to be ejected already on shelf.
    X'0447' Volume to be ejected has some outstanding request or it has a mount pending.
    X'0448' Library or I/O station not capable of handling this eject.
    X'0449' The volume serial number specified is for a shelf resident volume.
    X'044A' The volume serial specified is not listed in the tape configuration database.
    X'044B' OAM already has an AUDIT outstanding for this volume.
    X'044C' OAM already has an AUDIT outstanding for this library.
    X'044E' OAM already has a REMAP outstanding for this library.
    X'044F' The volume is not supported at this software level (volume record for this volume contains TDSI information that is not understood at this software level).
    X'0450' Group name not defined in optical configuration database.
    X'0452' Group name does not match that of first OPL in chain.
    X'0460' Request for library, but no libraries defined in optical configuration database.
    X'0461' Library name not defined in optical configuration database.
    X'0462' NONGROUP volume set not defined in optical configuration database.
    X'0463' Library name does not match that of first OPL in chain.
    X'0464' Library name not defined in the tape configuration database.
    X'0465' Library specified is a pseudo library.
    X'0466' Library specified is an empty library.
    X'0467' Library specified is a manual tape library.
    X'0468' A write request for tape media was received, but the OBJECT/OBJECT BACKUP storage group associated with the write has a blank TAPEUNITNAME.
    X'0469' A write request for tape sublevel2 was received, but the storage group associated with the write has a blank L2TAPEUNITNAME.
    X'0470' Invalid SUBLEVEL option specified.
    X'0471' The OBJECT BACKUP storage group is not defined in the current active SMS configuration.
    X'0472' A write request for a second backup copy was received. However, the storage group to which the object belongs does not have a second backup storage group defined.
    X'0480' Invalid optical VTOC sector number.
    X'0481' Invalid 3480/3490 blockid is specified for this request.
    X'0482' Requested Object or Collection name not the same as the Object or Collection name in the prefix of the actual tape record at the specified blockid.
    X'0490' Buffer address missing.
    X'0491' Buffer length missing.
    X'0492' One buffer parameter supplied and one missing for TYPE(READ).
    X'04A0' One parameter is inconsistent for partial object read request on a TYPE(READ).
    X'04A1' Partial read parameter invalid or exceeded object bounds.
    X'04B0' File system driver parameter list missing
    X'04B1' File system driver parameter list identifier invalid
    X'04B2' File system driver request type invalid
    X'04B3' File system driver file system type invalid
    X'04B4' File system driver file system directory invalid
    X'04B5' File system driver system name invalid
    X'04B6' File system driver storage group name invalid
    X'04B7' File system driver collection name invalid
    X'04B8' File system driver object name invalid
    X'04B9' File system driver request origination type invalid
    X'04BA' File system driver conflicting buffer specifications
    X'04BB' File system driver missing buffer specification
    X'04BC' File system driver buffer length invalid
    X'04BD' File system driver buffer length conflicts with request size
    X'04BE' File system driver instance id missing on a read
    X'04BF' File system driver instance id invalid on a write
    X'04C0' File system driver instance id missing on a delete
    X'04C1' File system driver actual file system length less than expected
    X'04C2' File system driver work-to-do data missing on a read
    X'04C3' File system driver work-to-do data missing on a write
    X'04C4' File system driver work-to-do data invalid on a delete
    X'04C5' File system driver object size less than buffer length
    X'04C6' File system driver object size greater than buffer length
    X'04C7' File system driver read position exceeds actual file size
    X'04C8' File system driver read offset exceeds actual file size
    X'04C9' Missing file system driver connection token
    X'04CA' Missing task name
    X'0500' Invalid type specified on a QUERY request.
    X'0520' Volume that was the subject of a QUERY (for optical or tape) was not found in the optical configuration database.
    X'0530' Database error while processing some request.
    X'0540' Volume to be reinitialized still contains active objects.
    X'0549' Drive specified for REFORMAT not defined in SMS ACDS. Retry the REFORMAT using another drive or do not specify a drive, allowing OAM to select a drive.
    X'0550' Volume RELABEL already in progress for volume specified on REFORMAT utility. If REFORMAT is still desired, retry after the RELABEL is complete.
    X'0551' Volume REFORMAT already in progress for volume specified on REFORMAT utility.
    X'0552' Volume REINIT already scheduled for volume specified on REFORMAT utility
    X'0554' An active write is currently scheduled to the volume specified on REFORMAT utility request. If REFORMAT is still desired, wait until the writes complete, then use the MOVEVOL utility to move all active objects off the volume, then retry the REFORMAT request.
    X'0555' At least one active object exists on a volume specified on a REFORMAT utility request. Use MOVEVOL utility to move all active objects off the volume, then retry the REFORMAT request.
    X'0556' Drive specified is not an operator accessible drive. When the volume is shelf resident, the user can specify a target drive. When the volume is library resident, OAM must select the target drive.
    X'0557' Volume specified on REFORMAT utility request is LMSI media. Only 3995 media is supported for the REFORMAT utility.
    X'0559' Volume specified on REFORMAT request is an OBJECT BACKUP volume (belongs to the OBJECT BACKUP storage group). Only volumes belonging to OBJECT storage groups are supported for the REFORMAT utility.
    X'0710' No SETDISK statements have been specified
    X'0711' Missing storage group name on a file system request
    X'0712' Missing file system instance id on a file system read or delete request
 
X'0C' Software resource unavailable X'0700' Invalid 64-bit addressable storage buffer token.
    X'0701' Invalid length specified for data in 64-bit addressable buffer.
    X'0702' Invalid offset specified for data in 64-bit addressable buffer.
  X'0800' OAM address space not available.
    X'0810' Request sent to another OAM in an OAMPLEX to process and the request timed out (did not complete in the customer specified timeout interval in CBROAMxx). If this happens often, consider increasing the timeout value. Also interrogate RMF™ XCF transaction reports for potential performance problems in the coupling facility.
    X'0811' An attempt was made to send the request to another OAM in an OAMPLEX to process, however XCF resources are not available (an error from XCF was received by OAM).
    X'0812' Volume for this request is owned by another OAM in an OAMPLEX.
    X'0813' Resource required to complete this request owned by other OAM in OAMplex, but request exceeds 50MB limit for sending across OAMplex.
    X'0820' File system driver error performing a "stat" function request
    X'0821' File system driver error performing a "close" function request
    X'0822' File system driver error performing a "remove" function request
    X'0823' File system driver detected a file name within a path
    X'0824' File system driver detected error when attempting to determine the file system type
    X'0825' File system driver received an invalid request type
    X'0826' File system driver detected unexpected "mkdir" error
    X'0827' File system driver received an invalid open request
    X'0828' File system driver detected that the file system type of the mounted file system is not the expected type
    X'0829' File system driver error performing a "mkdir" function request
    X'082A' File system driver detected that the path length exceeds the maximum length
    X'082B' File system driver error performing a "realpath" function request
    X'082C' File system driver detected that the sentinel file is missing
    X'082D' File system driver detected that the amount of data written was less than amount of data provided
    X'082E' File system driver detected a symbolic link in the OAM portion of the directory path
    X'082F' File system driver detected a directory that exceeds the maximum length
    X'0830' File system driver detected less data read than expected
    X'0831' File system driver detected invalid offset
    X'0832' File system driver error performing a "lstat" function request
    X'0833' File system driver error performing a "open" function request
    X'0834' File system driver error performing a "read" function request
    X'0835' File system driver error performing a "seek" function request
    X'0836' File system driver error performing a "sync" function request
    X'0837' File system driver error performing a "write" function request
 
X'0C' Hardware resource unavailable X'0900' No eligible optical drive is capable of executing this request.
    X'0901' OAM received a request to eject a volume, but that volume is mounted on a drive that is offline, pending offline, or not operational.
    X'0902' OAM was unable to schedule a REMAP because one of the drives in subject library is not operational with a cartridge still mounted.
    X'0903' No drives available on this OAM in an OAMPLEX for this request. This request was already sent cross-system once, so will not be sent again. This can happen if a request is sent cross system from one OAM to another in an OAMPLEX, but the library or drives on the target OAM are no longer available (for example, taken offline) when the request gets to the target OAM.
    X'0904' OAM Optical Volume is LOST due to operator cancel of an outstanding mount.
    X'0905' Volume not available on this OAM in an OAMPLEX for this request. This request was already sent cross-system once, so will not be sent again. This can happen if a request is sent cross system from one OAM to another in an OAMPLEX but the volume on the target OAM is no longer mounted when the request gets to the target OAM.
    X'0909' A specific request was made for unreadable volume-access backup activated.
    X'0910' Specific request for unreadable volume.
    X'0911' Specific write request for unwriteable volume.
    X'0912' Specific request for scratch volume.
    X'0913' Specific write request for write-protected volume in library.
    X'0914' Specific request for library volume, but volume is not in assigned slot in library.
    X'0915' Specific request for library volume, but volume is in a nonoperational drive.
    X'0916' The cartridge for this request is stuck in its library slot.
    X'0917' A duplicate volume was detected for this request.
    X'0918' A defrag request was made for a write protected volume.
    X'0919' Unable to read the volume label.
    X'091F' Requesting address space or requesting task (TCB) terminated.
    X'0920' The request was canceled by the operator.
    X'0921' The volume required for this request could not be found to complete the pending mount. This is a result of an operator canceling a previous mount request for this volume (CBR2003I message would have been issued), or an operator command has been entered to mark the volume lost.
    X'0922' All objects on the volume required for this request expired, therefore, this volume has been deleted from the OAM volume inventory.
    X'0923' The volume is mounted on a drive that is not write-compatible with the volume's media type.
    X'0924' End Of Data has been reached reading or writing to a tape volume.
    X'0925' A specific write for backup was received, but volume sublevel is not blank.
    X'0926' A specific write for sublevel 1 was received, but volume sublevel is not '1'.
    X'0927' A specific write for sublevel 2 was received, but volume sublevel is not '2'.
    X'0930' GETMAIN for object buffer in user address space failed.
    X'0940' Object name not found in specified optical VTOC sector.
    X'0941' Object name not found after search of entire optical VTOC.
    X'0942' The requested object was not found on this cartridge.
    X'0951' SSAR (set secondary address space register) was performed, and the target address space was not found.
    X'0952' A cross-memory move failed.
    X'0953' A permanent I/O error occurred while writing to tape.
    X'0954' A permanent I/O error occurred while trying to read from tape.
    X'0955' Unable to OPEN a tape data set.
    X'0956' RDJFCB failed to determine mounted VOLSER for MVS scratch mount.
    X'0957' Read request failed due to a POINT macro failure.
    X'0958' Write request failed due to a NOTE macro failure.
    X'0959' Write request failed due to a SYNCDEV macro failure.
    X'0970' Dynamic allocation failure while allocating a tape drive.
 
X'0C' Permanent I/O error X'0A00' Permanent error on recording medium.
    X'0A01' Request sent to an unformatted cartridge.
    X'0A02' Cartridge was found to be physically incompatible.
    X'0A03' The cartridge format was found to be unrecognizable.
    X'0A04' The data portion of the cartridge was questionable.
    X'0A10' Permanent error on optical drive.
    X'0A11' OAM was unable to schedule a REMAP request because a demount in preparation for the REMAP failed.
    X'0A12' OAM was unable to perform a unit of work because the tape drive that was allocated for the request experienced an error.
    X'0A18' The library logical type field is blank because no library with this ID was physically attached to the host at IPL time. As a result, OAM does not know if the library corresponding to the logical type field is an ATL or an MTL.
    X'0A19' OAM does not know anything about this library because no library with this name was defined in the current active configuration data set (ACDS).
    X'0A20' Permanent error on optical library.
    X'0A21' Library request purged after failure of prior request on same library.
    X'0A22' Permanent I/O error on the channel to channel (CTC).
    X'0A23' The I/O driver timed out while communicating with the library.
    X'0A24' An undocumented fault code has been returned from the controller.
    X'0A29' The Cartridge Eject Installation Exit is disabled.
    X'0A30' None of the requests in this volume list operation were successfully scheduled.
    X'0A31' None of the volumes in this library audit were successfully scheduled for auditing.
 
X'0C' Out of space error X'0B00' Write request for specific volume, but not enough space on volume.
    X'0B50' OAM was initialized with a null configuration.
    X'0B60' Library specified is inaccessible–offline, pending offline, or nonoperational.
    X'0B61' Tape library is in manual mode.
    X'0B62' Tape library vision system is inoperative.
    X'0B63' Remap is pending or in progress for this library.
    X'0B64' A specific request (READ) for a volume failed because it is in a library that is offline or pending offline.
    X'0B65' A specific request (READ) for a volume was received and the library in which it resides is offline or pending offline. Access Backup is active for offline libraries, a read will be attempted for the backup copy of the object.
    X'0B66' A specific request (READ) for a volume failed because it is in a library that is currently not operational.
    X'0B67' A specific request (READ) for a volume was received and the library in which it resides is not operational. Access Backup is active for nonoperational libraries, a read will be attempted for the backup copy of the object.
    X'0B70' The retry limit for the WTD was met.
    X'0B71' Read of an object from tape failed due to a NOTE macro failure. Investigate any messages issued with NOTE macro error. Retry request after corrections or repairs are made.
    X'0B72' Read of an object from tape failed. This is a general read failure. Investigate any messages issued with more specific information. Retry the request after corrections or repairs are made.
    X'0B73' Volume was not demounted
    X'0B74' Specific request for a LOST volume
    X'0B75' Specific request for an undefined volume
    X'0B76' Read of an object from the file system failed. Access Backup is active for file system errors; for OSREQ requests a read may be attempted for the backup copy of the object.
    X'0B80' LCS file system tasks not operational
    X'0B81' Missing file system directory for storage group
    X'0B82' Object to be deleted from file system could not be added to file system delete table
 
X'10' OAM ABEND X'0C00' OAM ABEND during request processing.
    X'0C01' z/OS Unix ended a LCS file system task with a EC6 abend code.
Note: The OAM address space must be stopped before shutting down z/OS Unix. Shutting down z/OS Unix when the OAM address space has been started can result in an EC6 abend.
    X'0C02' z/OS Unix ended a LCS file system task with a 422 abend code.
    X'0C03' A LCS file system task ended with an unexpected abend code.
 
X'10' System service failure X'0D00' Nonzero return code from GETMAIN.
    X'0D10' Nonzero return code from ESTAE.
    X'0D20' Unable to make user's address space nonswappable.
    X'0D29' OAM requested allocation of a tape device, but something other than an acceptable tape device was allocated.
    X'0D30' Unable to add a control block to a queue.
    X'0D40' Unable to update a volume table row.
    X'0D41' Unable to delete a volume table row.
    X'0D44' Database row contents in error.
    X'0D46' OAM failed in its attempt to insert a row into TAPEVOL (tape volume) table in the optical configuration database.
    X'0D47' OAM failed in its attempt to update a row into TAPEVOL (tape volume) table in the optical configuration database.
    X'0D50' A TCDB (tape configuration database) catalog access error occurred.
    X'0D51' A TCDB (tape configuration database) catalog authorization error occurred.
    X'0D60' A DB2® error occurred when accessing the object directory table.
    X'0D90' File system driver unable to MVS LOAD LE CELQPIPI
    X'0D91' File system driver unable to start LE CELQPIPI
    X'0D92' File system driver unable to end LE CELQPIPI
    X'0D93' File system driver unable to invoke LE CELQPIPI
    X'0D94' File system driver internal logic error
    X'0D95' File system driver internal logic error
    X'0D96' File system driver internal logic error
    X'0D97' File system driver internal logic error
    X'0D98' File system driver internal logic error
    X'0D99' File system driver internal logic error
 
X'10' OAM error X'0E00' Unspecified logical error during OAM processing.
    X'0E01' An invalid library or drive command was received by the controller.
    X'0E02' Packet incorrectly filled in.
    X'0E03' Attempted to use side 2 of a single-sided cartridge.
    X'0E04' Attempted to eject a cartridge with the I/O station already occupied.
    X'0E05' The controller returned with an OS/2 error from the PC.
    X'0E06' The controller returned that there are no more operational or available slots in the library.
    X'0E07' The controller returned with the wrong volume found or volume misfiled.
    X'0E08' The controller returned with volume not where expected or volume lost.
    X'0E09' The controller returned with access denied.
    X'0E0A' The volume is not in the outboard inventory.
    X'0E0B' OAM was unable to find the matching optical drive control block.
    X'0E0C' I/O attempted to an offline CTC.
    X'0E0D' Error attempting to write a full volume.
    X'0E0E' Error attempting to write a write-protected volume.
    X'0E0F' Request failed because the controller responded with a too many files open return code.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014