ACSLM COMMAND STRUCTURES
AUDIT Name
Description
4-2
ACSLM Command Structures
a udi t - Perfonns a physical inventory on the tape cartridges in a library, ACS, LSM, panel, or subpanel.
The audit request perfonns a physical inventory of one or more specified ACSs, LSMs, LSM panels, or LSM subpanels. It can be used to resolve inconsistencies between the data base and the physical contents of the library. These inconsistencies may be the result of a person physically entering the LSM and manually adding, removing, or moving cartridges in the storage cells.
Only one device type at a time can be audited. Within that type, up to
MAX _ ID different devices can be specified in each request.
The LSM robot physically scans e'ach cell in the specified object The cell contents are compared with the contents recorded in the data base. If there is a difference, or if the robot finds a duplicate or unreadable external label, the physical contents of the cell are
rechecked. If there is still a discrepancy, the data base is corrected and a record of the change is written to the Event Log. Through this process, the data base is updated to reflect the observed contents in cell storage. It is recommended that the data base be backed up after the completion of an audit.
Any cartridges with duplicate or unreadable external labels are ejected through the specified CAP. The CAP is reserved for the entire audit.
The audit process does not begin ejecting cartridges until after it has made all necessary data base updates.
Concurrent audits are allowed as long as they do not overlap one
another. They are not recommended, however, when duplicate volumes are suspected.
9036
ACSLM Command Structures
Within MESSAGE_HEADER, command is set to COMMAND_AUDIT.
cap _id is the CAP used for ejection of cartridges.
type is the type of object to audit. Only one type can be specified in a single request. type is one of the following:
TYPE SERVER TYPE ACS TYPE LSM TYPE PANEL TYPE SUBPANEL
count is the number of identifiers that follows. For TYPE_SERVER, count must equall. For all other types, count must equal 1 to MAX_ID.
audit
Within identifier, acs_iIl, Ism_id, panel_ill, or sub panel_ill is the unique ID of the object to be audited.
Responses
Intermediate Response Format
Part of audit processing is ejection of tape cartridges. The ACSLM returns an intermediate response when a tape cartridge is added or deleted from the data base. In the case of duplicate or unreadable labels, the tape cartridge is also physically ejected from the library through the CAP specified in the request.
audit ACSLM Command Structures
The fonnat of the intennediate response is:
struct eject_enter { Within MESSAGE HEADER:
• command is COMMAND _ AUDI T.
• message_options is set to INTERMEDIATE, indicating a partial response to the a udi t request.
Within RESPONSE_STATUS, status is STATUS_AUDIT_ACTIVITY.
cap _id is the identifier of the CAP, specified in the request, that is used to eject cartridges.
count is the number of tape cartridges added, deleted, or ejected associated with this response. The number ranges from 1 to MAX_ID.
See the Common Variables section in Chapter 3 for a description of
MAX ID.
Within volume_status, vol_id is the external tape cartridge label.
Within volume_status, status is the disposition of each vol_ide Following are status values specific to this command.
• STATUS_DUPLICATE_LABEL if the robot finds a tape cartridge with a duplicate external label; the cartridge is ejected from the·LSM.
• STATUS_VOLUME_ADDED if the robot finds a tape cartridge that is not listed in the data base; the votid is added to the data base.
• STATUS_VOLUME_NOT_IN_LIBRARY if a tape cartridge listed in the data base is not found in the library; the vol_ id is deleted from the data base.
• STATUS_UNREADABLE_LABEL if the robot finds a tape cartridge with an unreadable external label; the cartridge is ejected from the library. Within votid question marks (?) are substituted for the characters that the robot was unable to read.
ACSLM Command Structures
Final Response Format
struct audit_response
Final Response Values
ipc _header;
Within MESSAGE_HEADER, command is COMMAND AUDIT.
audit
Within RESPONSE_STATUS, status is the disposition of the entire request.
Following are status values specific to this command.
• STATUS_AUDIT_FAILED if the request fails during audit processing.
See the identifier_status for the nature of the failure.
• STATUS_AUDIT_IN_PROGRESS, for TYPE_SERVER only, if another in-process audit is already auditing the library.
• STATUS_CANCELLED if the request is cancelled. See Final Response Values - Cancelled Request.
• STATUS_CAP_IN_USE if the specified CAP is being used by an eject, enter, or another audit request.
• STATUS_MULTI_ACS_AUDIT if the request identifier list spans more than one ACS.
audit ACSLM Command Structures
Following are common RESPONSE_STATUS status values. See the Common Statuses section in Chapter 3 for their descriptions.
• STATUS_ACS_NOT_IN_LIBRARY
• STATUS_LSM_NOT_IN_LIBRARY
• STATUS_CONF I GURATI ON_ERROR
• STATUS_COUNT_TOO_LARGE
• STATUS_COUNT_TOO_SMALL
• STATUS_DATABASE_ERROR
• STATUS_INVALID_ACS
• STATUS_INVALID_LSM
• STATUS_INVALID_OPTION
• STATUS_INVALID_TYPE
• STATUS_LIBRARY_BUSY
• STATUS LIBRARY FAILURE -
-• STATUS_LIBRARY_NOT_AVAILABLE
• STATUS_LSM_OFFLINE
• STATUS_MESSAGE_TOO_LARGE
• STATUS_MESSAGE_TOO_SMALL
• STATUS_PROCES S_FAI LURE
• STATUS UNSUPPORTED OPTION
-
-• STATUS_UNSUPPORTED_TYPE
cap _id is the identifier of the CAP, specified in the request, that is used to eject cartridges.
type is the type of object being audited, as indicated in the request.
count is the number of IDENTIFIERS, as indicated in the request. For
TYPE_SERVER, count is always
o.
Within identifier_status, acs_id, lsm_id, panel_id, or subpanel_id is the unique ID of the object being audited, as indicated in the request.
Within identifier_status, status is the disposition of the identifier.
Following are status values specific to this command.
• STATUS_AUDIT_IN_PROGRESS if another in-process audit is already auditing the LSM specified in identifier. Only one audit may be active on any single LSM.
• STATUS_CANCELLED if the request is cancelled. See Final Response Values - Cancelled Request.
• STATUS_DUPLlCATE_IDENTIFIER if the IDENTIFIER duplicates or overlaps a previous IDENTIFIER in the list.
ACSLM Command Structures audit
Notes
• STATUS_INVALID_SUBPANEL if the subpanel is not correctly specified. A subpanel identifier indicates the upper-left and lower-right corners of a panel subsection. The ending row must be > the beginning row, and the ending column must be> the beginning column. This status is returned if these conditions are not met.
• STATUS_VALID if the IDENTIFIER was successfully validated.
Following are common identifier_status status values. See the Common Statuses section in Chapter 3 for a description.
• STATUS_INVALID_ACS
• STATUS_INVALID_COLUMN
• STATUS_INVALID_LSM
• STATUS_INVALID_PANEL
• STATUS INVALID ROW -
-• STATUS_LSM_OFFLINE
• STATUS_LSM_NOT_IN_LIBRARY
Final Response Values - Cancelled Request
Within MESSAGE_HEADER, command is COMMAND_AUDIT.
Within RESPONSE_STATUS, the status is STATUS_CANCELLED.
cap _id is the identifier of the CAP, specified in the request, that is used to eject cartridges.
type is the type of object being audited, as indicated in the request.
count is the number of identifiers that were validated prior to the cancel. For a cancelled pending request count is 0 and no
identifier_status records follow. For a cancelled current request, count ranges from 1 to MAX_ID. See Common Variables section in Chapter 3 for a definition of MAX_ID.
Within identifier_status, the status for each identifier is set to
STATUS VALID.
• Messages are written to the Event Log whenever an audit starts, terminates, or is cancelled.
• A STATUS_REMOVE_CARTRIDGES unsolicited message is sent to the ACSSA if the CAP becomes full during audit processing. Audit processing is suspended until the CAP is unloaded and resumes
audit ACSLM Command Structures