Description
ACSLM Command Structures
eject - Ejects from one to MAX_ID tape cartridges from an LSM.
The eject request ejects tape cartridges from the library, removing them from library control. Cartridges are ejected through a specified CAP. From one to MAX_ID cartridges can be ejected at a time. See Chapter 3: ACSLM Common Data Structures for a definition OfMAX_ID.
For each cartridge to be ejected, the LSM robot does the following:
1. Moves to the cell location indicated in the data base.
2. Reads the external label of the cartridge and verifies that it is the specified cartridge,
3. Moves the cartridge to an available cell in the specified CAP.
When the specified cartridges have been moved to the CAP, the cell locations of the ejected cartridges are deassigned, and the cartridges are removed from the data base. The Command Processor then displays an unsolicited message in the Displa:y Area to remove the cartridges from the CAP.
After the cartridges are removed and the CAP door is closed, the Command Processor displays one message in the Command Area for each cartridge designated for ejection. In each message, the status indicates whether or not the cartridge was actually ejected.
If, for any reason, a specified cartridge cannot be ejected, an error message is displayed in the Command Area, and an entry is made in the Event Log.
ACSLM Command Structures eject
Within MESSAGE_HEADER, command is set to COMMAND EJECT.
cap _id is the CAP used to eject the tape cartridge.
count is the number of vol_ids to eject. count has a range of 1 to MAX _ ID.
Each votid is the external label of a tape cartridge to be ejected.
Responses
Intermediate Response Format Not applicable.
Final Response Format
struct eject_response
Final Response Values
ipc _header;
message_header;
message_status ; cap_id;
count;
Within MES SAGE_HEADER, command is COMMAND_EJECT.
Within RESPONSE_STATUS, status indicates the disposition of the entire
eject ACSLM Command Structures
• STATUS_CAP _IN_USE if the request cannot be processed because the CAP is being used by an audit, an enter, or another eject
request.
• STATUS_SUCCESS if the fixed portion of the request is correct.
Following are common RESPONSE_STATUS status values. See the Common Statuses section in Chapter 3 for their descriptions.
• STATUS_ACS_NOT_IN_LIBRARY
count is the number of tape cartridges that the ACSLM attempted to eject.
Within volume_status, voCid is the extemallabel of each tape cartridge the ACSLM attempted to eject.
Within volume_status, status is the disposition of each vol_id.
Following are status values specific to this command.
• STATUS_AUDIT_IN_PROGRESS, if an in-process audit has locked out access to a cell record in the data base. The cartridges are not ejected. This status is issued only after the data base has attempted retries on the cell record.
• STATUS_CAP_FULL if the CAP is full before all vol_ids have been processed. Remaining vol_ids are not ejected.
• STATUS_MISPLACED_TAPE if a different tape cartridge is in the location specified by the data base. The data base is updated with the external tape cartridge label of the tape cartridge found in the storage location.
ACSLM Command Structures
• STATUS_NOT_IN_SAME_ACS if the CAP identifier and volume identifier are not in the same ACS.
• STATUS_SUCCESS if the tape cartridge was ejected successfully.
eject
• STATUS_VOLUME_IN_DRIVE if the tape cartridge is in a library drive.
The cartridge is not ejected.
• STATUS_VOLUME_IN_USE if the tape cartridge is in use by another request. The cartridge is not ejected.
• STATUS_VOLUME_NOT_IN_LIBRARY if the vol_ill does not exist in the data base, or if the tape cartridge has already been ejected as part of this request. If no tape cartridge is in the location specified by the data base and the volume is not in transit or in a library drive, the data base entry is removed.
Following are common volume_status status values. See the Common Statuses section in Chapter 3 for their descriptions.
• STATUS INVALID VOLUME -
-• STATUS LIBRARY FAILURE -
-• STATUS LIBRARY BUSY -
-• STATUS LSM OFFLINE
Final Response Values - Cancelled Request
Within MES SAGE_HEADER, command is COMMAND_EJECT.
Within RESPONSE_STATUS, status is STATUS_CANCELLED.
cap _id is the CAP used to eject the tape cartridges.
count is the number of tape cartridges to be ejected, as specified in the request.
Within volume_status, vol_id is the external label of each tape cartridge the ACSLM attempted to eject.
Within volume_status, status is as follows:
• STATUS_CANCELLED if the tape cartridge was not processed before the request was cancelled.
• Any valid status value if the tape cartridge was processed before the request was cancelled. See Final Response Values above for the valid final response status values.
eject
Notes
See Also
ACSLM Command Structures
• If all voCids have been processed and at least one cartridge has been moved to the CAP, or the CAP is full, a
STATUS_REMOVE_CARTRIDGES unsolicited message is sent to the ACSSA. The fmal response is not returned until the CAP is closed.
• The cancel command for details on cancelling a current or pending
eject request.
• The enter command for details on entering cartridges into the ACS.
• Appendix A for entries that may be written to the Event Log.
ACSLM Command Structures enter