Completion codes

This topic lists and explains the completion codes that can be returned by a delayed response message to a user performing operations in the IBM® TS7700 Grid. These codes are generally returned after a command is accepted and the operation begins.

The results of an asynchronous operation are reported back to the host or hosts through a delayed response message. Whether the message is a directed delayed response message (sent to a single host) or a broadcast delayed response message (sent to all hosts attached to the I/O subsystem), all delayed response messages generated for the Perform Library Function (PLF) command share a common set of completion codes as shown in Table 1.
Table 1. Completion codes
Completion code Description
X'00' Complete - No Errors or Exceptions

The requested function was completed and there were no unusual conditions detected.

X'01' Complete - Vision Not Operational

The requested function was completed without VOLSER validation. The requested function normally uses the vision system to validate the VOLSER on the volume label as part of the execution of the function. However, the vision system was not operational at the time the function was performed.

X'02' Complete - VOLSER Not Readable

The requested function was completed without VOLSER validation. The requested function normally uses the vision system to validate the VOLSER on the volume label as part of the execution of the function. However, the VOLSER was not recognized by the vision system because the label was not readable or not present at the time the function was performed.

X'04' Complete - Demount Signaled Complete before Execution

The requested function was a library demount and in order to optimize a subsequent command execution, the demount is signaled as complete before its actual execution has begun.

X'05' Complete - With Exceptions
The requested function has completed but during the execution of the function, exceptions were encountered.
  • If the request was for an Export or Import operation, the status file on the volume specified in the completion message should be examined to determine what exceptions were encountered.
  • If the request was for an export operation, virtual volumes specified in the export list volume that are not in the library performing the export are not considered exceptions that would result in this completion code.
  • If the request was for an import operation, physical volumes specified in the import list volume that are not in the import category of the library performing the import are not considered exceptions that would result in this completion code.
X'06' Complete - No Volumes Found to Export or Import

The request was for an Export operation, but none of the virtual volumes in the export volume list were found in the Virtual Tape Server subsystem the request was issued to.

The request was for an Import operation, but there were no stacked volumes in the import category, in the library the request was issued to, that matched any of the stacked volumes specified in the import volume list.

X'07' Complete - Construct Assignments not Changed

The requested function was completed, but construct assignment included in the function could not be completed due to an internal processing error.

X'08' Complete - Construct Limit Exceeded

The requested function was completed, but construct creation included in the function could not be performed because the maximum number of unique names for one of the constructs has already been reached.

X'20' Canceled - Program Request

The requested function was canceled due to the program issuing a Perform Library Function command which specified the Library Cancel order.

X'22' Canceled - Manual Mode

The requested function was canceled because the automated tape library entered manual mode after the operation was queued and the requested function is not allowed in manual mode.

X'23' Canceled - Library Operator

The requested function was canceled by an operator through the library manager console.

X'40' Failed - Hardware

The requested function failed because of some hardware failure condition at the time the function was attempted.

X'41' Failed - Vision Not Operational

The requested function failed because the vision system was not operational at the time the function was attempted. The requested operation requires validation of the VOLSER in order to complete normally.

X'42' Failed - VOLSER Not Readable

The requested function failed because the vision system could not validate the VOLSER of the volume because the label was unreadable or not present at the time the function was attempted. The requested operation requires validation of the VOLSER in order to complete normally.

X'43' Failed - Volume Inaccessible

The requested function failed because the volume specified was in a position which was inaccessible to the library at the time the function was attempted. This completion code is also returned for a Library Mount order that specifies a source category and the device had previously accepted a Library Set Device Category order which specified the Category Order option for the same category and the next volume in the category compatible with the type of device the Perform Library Function order was issued to is inaccessible.

X'44' Failed - Volume Misplaced

The requested function failed because the volume specified is misplaced at the time the function was attempted. This completion code is also returned for a Library Mount order that specifies a source category and the device had previously accepted a Library Set Device Category order which specified the Category Order option for the same category and the next volume in the category compatible with the type of device the Perform Library Function order was issued to is misplaced.

X'45' Failed - Category Empty

The requested function failed because it requested a volume using the category parameter from a category which contained no available volumes compatible with the type of device the Perform Library Function order was issued to at the time the function was attempted. The function requires a volume in order to complete normally.

X'47' Failed - Volume Manually Ejected

The requested function failed because the volume had been manually ejected from the library between the time the function was requested and attempted.

X'48' Failed - Volume No Longer In Inventory

The requested function failed because the volume was deleted from the inventory between the time the function was requested and attempted.

X'49' Failed - Device No Longer Available

The requested function failed because the device requested is no longer available to the library.

X'4A' Failed - Unrecoverable Load Failure

The requested function failed because the device requested had an unrecoverable load failure during the attempt to perform the function.

X'4B' Failed - Damaged Cartridge Ejected
For physical volumes
The requested function failed because the library determined that the cartridge was damaged in such a way that it could not be loaded on a drive and it has been ejected.
X'4C' Failed - Device not Rewound and Unloaded
A request to demount a volume was received from a direct attached Library Manager control path and the specified device still has a volume mounted.
Note: This completion code is not applicable to hosts that send PLF commands through the hosts data path to a device.
X'4D' Failed - Export or Import List Volume Could Not Be Processed

During the execution of an Export or Import Operation, the virtual volume containing the list of volumes to export or import could not be processed. The operation completion message will contain a text message indicating the reason that the volume could not be processed.

X'4E' Failed - Virtual Volume Mount

The delayed response message for the mount request indicates the reason for the failure:

CBR4171I Mount failed
LVOL
virtual-volser
LIB
library-name
PVOL
physical-volser
RSN
reason-code
Reason Code Description
X'10' Internal error detected
X'11' Resend special case
X'20' Specific volume is in use on another cluster
X'21' Scratch volume selected is in use on another cluster
X'22' Valid volume is inaccessible
X'23' Local cluster path to volume's data is no longer available
X'24' Remote cluster path to volume's data is no longer available
X'25' Copy required, but cluster copying is inhibited
X'26' Internal Message Timeout During Open Request
X'27' Unable to Meet The Configured Synchronous Copy Requirements
X'30' Local cluster recall failed; the stacked volume is misplaced
X'31' Local cluster recall failed; the stacked volume is inaccessible
X'32' Local cluster recall failed; the stacked volume is unavailable
X'33' Local cluster recall failed; the stacked volume is no longer in library
X'34' Local cluster recall failed; the stacked volume load failure
X'35' Local cluster recall failed; the stacked volume access error
X'38' Remote cluster recall failed; stacked volume is misplaced
X'39' Remote cluster recall failed; stacked volume is inaccessible
    X'3A Remote cluster recall failed; stacked volume is unavailable
X'3B' Remote cluster recall failed; stacked volume is no longer in library
X'3C' Remote cluster recall failed; stacked volume load failure
X'3D' Remote cluster recall failed; stacked volume access error
X'40' Insufficient cache space
X'41' World-wide ID mismatch
X'42' Excessive concurrent large volume mounts detected
X'43' BVIR volume is too small to store the result
X'44' Encryption Exchange Failed Due To An Expired Certificate
X'45' BVIR Failure Due to a MC With More Than One Copy Consistency Point Defined
X'80' Reserved

This completion code is reserved for host control program usage only.

Note: For the IBM tape libraries, the verification that a volume is in the correct location is performed when the door to the library is closed, not at the execution of the operation unless that operation is the result of a library audit order.
When the library attempts to execute an eject operation as a result of a Library Set Volume Category PLF order and the operation fails for one of the following completion codes, the volume is re-assigned to the category it was in before the Library Set Volume Category PLF order was accepted:
  • X'40' Failed - Hardware
  • X'43' Failed - Volume Inaccessible
  • X'44' Failed - Volume Misplaced
Note: A device can become unavailable to the library either through action at the library manager console or due to a failure of the device detected by the library manager. In general, a device is made not available to the library so that service can be performed on the device.