User manual AMPEX DATA DST ACL APPLICATION PROGRAMMING INTERFACE (LIBACL) PROGRAMMER S GUIDE, PART NO. 1308904-X4

[. . . ] DST/DIS Automated Cartridge Library UNIX Application Programmer's Guide ® TM 1308904-X4 NOTICE The contents of this technical manual have been checked and are believed to be accurate. However, no responsibility is assumed for any inaccuracies in the information provided herein. Ampex Corporation reserves the right to make changes without notice to improve reliability, function or design. TRADEMARKS UNIX is registered trademark licensed exclusively by X/Open Co. , Ltd. DIS is a trademark of Ampex Corporation. [. . . ] DST_FAILURE. SEE ALSO libacl_api_intro (3), aclReserve(3) DST/DIS Automated Cartridge Library Application Programming Interface (libacl) Programmer's Guide 4-34 Preliminary Draft Ampex 1308904-X4 ACL Application Programmer's Guide aclReserve 4. 17 aclReserve (TBS) Ampex 1308904-X4 Preliminary Draft 4-35 Running Head aclReqSense Model No. ACL Application Programmer's Guide 4. 18 NAME aclReqSense aclReqSense() - retrieve ACL SCSI sense data. SYNOPSIS #include <acl. h> int aclReqSense(char *device, sense_data_t *sp, int size); Writer_Note: Should we list the sense_data_t structure in the man page and describe the structure members?Even if we do so, the supporting detail necessary to interpret the sense data is currently published only in the ICD which the customer doesn't get. I plan to include the detail in some future release of the libacl Programmer's Guide, but I have no idea when that will be as eight months have elapsed since I last had a chance to work on it. DESCRIPTION aclReqSense() issues a SCSI Request Sense command to the ACL to retrieve the current Sense Data. This function is usually called to determine the condition(s) that caused the previous function to fail. · The ACL clears Sense Data prior to executing any command other than Request Sense and sets Sense Data when a command results in a Check Condition or Command Terminated status. Separate Sense Data is preserved for each initiator. Sense Data is cleared after it is retrieved by a Request Sense command. In general, the ACL retains the original Sense Data when an error occurs executing a Request Sense command. However, when the error occurs parsing the command descriptor block (CDB), the original Sense Data is lost and is replaced with Sense Data corresponding to the parsing error · aclReqSense() is available to all users. PARAMETERS *device Pointer or string specifying the device special file associated with the ACL. Pointer to a structure of type sense_data_t. (TBS) *sp Writer_Note: size 4-36 Preliminary Draft Ampex 1308904-X4 ACL Application Programmer's Guide aclReqSense USAGE aclReqSense() reports current Sense Data in the *sp structure. See the acl. h header file for details. ENVIRONMENT When the $RETRY_ON_RESET environment variable is set, all libacl functions automatically perform one retry when a failure is caused by a SCSI Bus Device Reset of the ACL. RETURN VALUES Exit status codes are: 0 -1 DST_SUCCESS. DST_FAILURE. SEE ALSO libacl_api_intro(3) DST/DIS Automated Cartridge Library Application Programming Interface (libacl) Programmer's Guide Ampex 1308904-X4 Preliminary Draft 4-37 Running aclRezero Head Model No. ACL Application Programmer's Guide 4. 19 NAME aclRezero aclRezero() - reset the ACL and ensure that element status is current in the internal database. SYNOPSIS #include <acl. h> int aclRezero(char *device); DESCRIPTION aclRezero() resets the ACL cartridge handling system and directs the ACL to check element status. If a discrepancy is found, the ACL re-initializes to update its internal database. aclRezero() is available to all users. PARAMETERS *device Pointer or string specifying the device special file associated with the ACL. ENVIRONMENT When the $RETRY_ON_RESET environment variable is set, all libacl functions automatically perform one retry when a failure is caused by a SCSI Bus Device Reset of the ACL. RETURN VALUES Exit status codes are: 0 -1 DST_SUCCESS. DST_FAILURE. SEE ALSO libacl_api_intro(3) DST/DIS Automated Cartridge Library Application Programming Interface (libacl) Programmer's Guide 4-38 Preliminary Draft Ampex 1308904-X4 ACL Application Programmer's Guide aclSetParam 4. 20 NAME aclSetParam aclSetParam() - change ACL configuration parameter(s). SYNOPSIS #include <acl. h> int aclSetParam(char *device, aclParam_t *param, int valid); DESCRIPTION aclSetParam() sets the behavior of the ACL by changing one or more configuration parameter settings. To check the current configuration parameter settings, use the aclGetParam() function. aclSetParam() is available to all users. PARAMETERS *device Pointer or string specifying the device special file associated with the ACL. Pointer to a structure of type aclParam_t. The valid parameter is a bit-mask that indicates which member(s) of the aclParam_t structure contain new configuration parameter settings. AutoEject_Valid 0x00000001 AutoAuditOverride_Valid 0x00000002 BarcodeReqEnable_Valid 0x00000003 AutoImport_Valid 0x00000004 If only the AutoEject and AutoImport configuration parameters are being changed for example, the valid mask should be set as follows: valid = AutoEject_Valid | AutoImport_Valid; *param valid USAGE Before calling aclSetParam(), initialize the appropriate members of the *param structure with new values for the configuration parameters you want to change. typedef struct { unsigned char AutoEject; Ampex 1308904-X4 Preliminary Draft 4-39 Running Head aclSetParam Model No. [. . . ] Vendor-Specific ACL Condition Codes (Continued) Sense ASC ASCQ Key 0Bh 5Ah 97h Aborted Command ACL Condition Code 17h Condition Reported ACL Library Door(s) Open A cabinet door was opened while the ACL was executing a command. Recovery Procedure Close all doors (for an 8XX ACL, also reset the MDA POWER switch). The ACL automatically performs any recovery or initialization procedures required. A-12 Preliminary Draft Ampex 1308904-X4 ACL Application Programmer's Guide CHS Failure, Error, and Warning Codes A. 5 CHS Failure, Error, and Warning Codes Table A. 5 lists CHS failure, error, and warning codes the ACL might report in the data returned for aclReqSense(), aclStatus(), and acl_status_library. This information is intended for Ampex factory personnel as interpretation of the codes requires a detailed understanding of ACL internal operation. Table A-5. CHS Failure, Error, and Warning Codes CHS Code Description CHS WARNING TALLY MESSAGE NUMBERS (8XX) 0d (0h) 1d (1h) 2d (2h) 3d (3h) 4d (4h) 5d (5h) 6d (6h) 7d (7h) 8d (8h) 9d (9h) 10d (Ah) 11d (Bh) 23d (17h) 24d (18h) 25d (19h) 26d (1Ah) 27d (1Bh) 28d (1Ch) No warning message Bin was empty on a get CHS was empty on a put No barcode label detected Inverted barcode label read Unreadable barcode label Barcode printed wiring assemble (PWA) failed self test No cartridge on a get Readall procedure aborted I/O port occupied for a put I/O port sensor data error Put retry needed to complete Get retry needed to complete Drive not home for a get Cart not in I/O detent for get Cartridge sensor error on a put Cart rescue required for a get Z-axis vane detector error RESET PROCEDURE WARNINGS (8XX) 100d (64h) 101d (65h) 102d (66h) 103d (67h) Cartridge purged to I/O port Offset read checksum error Excessive offset magnitude Uninitialized offset error Ampex 1308904-X4 Preliminary Draft A-13 Running Head CHS Failure, Error, and Warning Codes Model No. [. . . ]