User manual AMPEX DATA DSTDIS ACL PROGRAMMER S GUIDE, PART NO. 1308910-01

[. . . ] DST Automated Cartridge Library UNIX Application Programmer's Guide ® 1308910-01 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 AIX is a registered trademark of International Business Machines Corporation. All other trademarks and registered trademarks are the property of their respective holders. COPYRIGHT INFORMATION U. S. [. . . ] Information unique to specific ACL models is identified by the model name: · · DST 412 DST 712 Ampex 1308910-01 5-1 Running Head ACL Utilities Overview Model ACL Application Programmer's Guide No. · DST 812 See paragraph 1. 1 on page 1-1 for information on previous model names and number series. 5. 2. 2 Utilities Summary The ACL Management Utilities have descriptive names that indicate both the type of operation performed and the type of object upon which the operation is performed: acl_audit_element acl_audit_library acl_errlog_library acl_getparam_library acl_init_chs acl_move_tape acl_move_volume acl_park_chs acl_query_library acl_setparam_library acl_statlog_library acl_status_library Retrieve the status of a single location from the ACL internal database. Move the specified tape cartridge to another ACL location Park the ACL cartridge handling system (DST 412). Get ACL vendor, product, software version, and software release information. Get current ACL status information. 5. 2. 3 Input Conventions The ACL Management Utilities use the following input conventions: · · All arguments or options are specified using explicit, descriptive command-line flags or environment variables. Where applicable, the utilities use the same command-line flag names and content. Every element in this type of specification must be present and enclosed by colons, even if empty (a space between colons is not considered empty). For single-element input specifications, colons are optional. 5-2 Ampex 1308910-01 ACL Utilities ACL Utilities Overview · You can specify integer input values using a standard decimal number, a hexadecimal value (first two characters are 0x), or an octal value (the first character is a zero and the second character is not an x). 5. 2. 4 Output Conventions The ACL Management Utilities have the following output conventions: · Many utilities support the -stdout <output_spec> argument which specifies the output stream written to stdout. Each output field in the string is identified by a unique keyword [%field_name or %(field_name)] that you can specify to display the field, or omit to skip the field. See "Exit Status" on page 5-7 for detailed information on exit status codes. · · 5. 2. 5 Arguments The arguments supported by more than one utility are described below. For other arguments, consult each utility's manual page. -help [ help_type ] Displays help on stderr and invalidates all other options, cancelling any other actions. The optional help_type specification indicates the kind of help to supply: · · · stdout - lists the keywords that are valid for the -stdout <output_spec> argument. revision - displays the ACL Management utilities release number. v_revision - displays the utilities revision number, release date, and engineering release character. When -help is specified without the help_type argument, it displays information on the utility usage line. -stdout <output_spec> The -stdout <output_spec> argument specifies the output stream written to stdout. It is required for all ACL Management Utilities that produce an output, unless you use the -help argument. The -stdout <output_spec> argument allows you to specify the following: Ampex 1308910-01 5-3 Running Head ACL Utilities Overview Model ACL Application Programmer's Guide No. · Keywords [%field_name or %(field_name) as documented in the utility's manual page] that designate the fields in the output stream written to stdout. When specifying more than one keyword, enclose the entire argument in quotes and use spaces to separate the field names. A backslash (\) in the output specification is not itself displayed and causes the following character to be displayed literally, except for \n which produces a newline. For example, you can use \% to display a percent sign without having it interpreted as a keyword indicator. · Keywords that start with v_ (for example, %v_auto_store) provide verbose output that displays a descriptive string; all other keywords produce normal output that displays only the value reported. On output, the command formats the output values by stripping any leading zeroes from numbers and any trailing spaces from strings. Tape cartridge barcode IDs (volume tags) are considered to be strings. 5. 2. 6 Options The options supported by more than one utility are described below. For other options, consult each utility's manual page. -f <device_special_file> Specifies the device special file to use for the operation. If omitted, the device special file specified by the $ACL_DEV environment variable is used. [. . . ] CHS Failure, Error, and Warning Codes (Continued) CHS Code 715 (0x2CB) 719 (0x2CF) 720 (0x2D0) 721 (0x2D1) 722 (0x2D2) 723 (0x2D3) 724 (0x2D4) 725 (0x2D5) 731 (0x2D8) 732 (0x2D9) 733 (0x2DA) Y-axis over speed sensor trip MDA system reset Left overtravel sensor trip Right overtravel sensor trip Upper overtravel sensor trip Lower overtravel sensor trip X-servo did not lock on a goto Y-servo did not lock on a goto Z-cass became false on a goto Z-vane became false on a goto X&Y servo did not lock on goto FAILURE MESSAGES (412) 1001 (0x3E9) 1002 (0x3EA) 1003 (0x3E) 1004 (0x3EC) 1005 (0x3ED) 1006 (0x3EE) 1007 (0x3EF) 1008 (0x3F0) 1009 (0x3F1) 1010 (0x3F2) 1011 (0x3F3) 1012 (0x3F4) 1013 (0x3F5) 1014 (0x3F6) 1015 (0x3F7) 1016 (0x3F8) 1017 (0x3F9) +15Vdc power is missing +24Vdc power is missing Arms calibration sequencer timed out Audit control sequencer timed out Calibrate cannot find elevator bottom vane detector Cannot enable elevator servo position mode Cannot enable in-arm servo position mode Cannot enable out-arm servo position mode Cannot find a large cartridge in bin #7 for calibration Cannot find elevator bottom vane detector Cannot find elevator center vane detector Cannot preset elevator position counter Cannot set in-arm position counter Cannot set out-arm position counter Cartridge appears to be stuck in load port after unload Cartridge caddy door is not closed Cartridge Did not enter drive elevator for loading Description Ampex 1308910-01 A-21 Running Error, CHS Failure, Head and Warning Codes Model Returned Sense Data No. Table A-4. CHS Failure, Error, and Warning Codes (Continued) CHS Code 1018 (0x3FA) 1019 (0x3FB) 1020 (0x3FC) 1021 (0x3FD) 1022 (0x3FE) 1023 (0x3FF) 1024 (0x400) 1025 (0x401) 1026 (0x402) 1027 (0x403) 1028 (0x404) 1029 (0x405) 1030 (0x406) 1031 (0x407) 1032 (0x408) 1033 (0x409) 1034 (0x40A) 1035 (0x40B) 1036 (0x40C) 1037 (0x40D) 1038 (0x40E) 1039 (0x40F) 1040 (0x410) 1041 (0x411) 1042 (0x412) 1043 (0x413) 1044 (0x414) 1045 (0x415) 1046 (0x416) Description Cartridge did not enter load port for loading Cartridge did not enter load port for unloading Cartridge did not exit drive elevator for an unload cartridge abort Cartridge did not exit load port for loading Cartridge did not exit load port for unloading Cartridge did not reach elevator home for loading Cartridge Did Not Return To Drive For An Unload Cartridge Abort Drive elevator roller mda fuse [F1] is open Elevator calibration data write checksum error Elevator calibration sequencer timed out Elevator cannot be moved for an initialization Elevator failed to enable position mode during calibration Elevator failed to enable position mode during calibration Elevator failed to move for a barcode scan Elevator failed to move to barcode scan start Elevator failed to park after an unload cartridge abort Elevator failed to position after calibration Elevator Failed To Position For An Audit Elevator failed to position for calibration Elevator failed to position for loading Elevator failed to position for parking Elevator failed to position for unloading re-try Elevator failed to position for unloading Elevator failed to safety position after audit Elevator failed to safety position after initialization Elevator failed to safety position after loading Elevator Failed to safety position after unloading Elevator failed to step position for calibration Elevator lower over-travel sensor tripped A-22 Ampex 1308910-01 Returned Sense Data CHS Failure, Error, and Warning Codes Table A-4. CHS Failure, Error, and Warning Codes (Continued) CHS Code 1047 (0x417) 1048 (0x418) 1049 (0x419) 1050 (0x41A) 1051 (0x41B) 1052 (0x41C) 1053 (0x41D) 1054 (0x41E) 1055 (0x41F) 1056 (0x420) 1057 (0x421) 1058 (0x422) 1059 (0x423) 1060 (0x424) 1061 (0x452) 1062 (0x426) 1063 (0x427) 1064 (0x428) 1065 (0x429) 1066 (0x42A) 1067 (0x42B) 1068 (0x42C) 1069 (0x42D) 1070 (0x42E) 1071 (0x42F) 1072 (0x430) 1073 (0x43`) 1074 (0x432) 1075 (0x433) Description Elevator lower over-travel sensor tripped Elevator mda fuse [F10] is open Elevator mda fuse [F9] is open Elevator mda was safety shut off Elevator motor drive failed for initialization Elevator Motor voltage out of range Elevator move sequencer timed out Elevator not configured to unload a large cartridge Elevator not configured to unload a medium cartridge Elevator not configured to unload a small cartridge Elevator servo failed to position for a move Elevator servo is not ready for auditing Elevator servo is not ready for loading Elevator servo is not ready for parking Elevator servo is not ready for unloading Elevator servo is not initialized Elevator size configuration is unknown Elevator upper over travel limit exceeded Elevator upper over travel sensor tripped Elevator vane sensor data error Front door is open Front door must be closed for calibration Front door safety switch is open Front door safety switch was opened Illegal in-arm parameter In-arm audit move reported an illegal warning In-arm calibration data write checksum error In-arm failed to bumper position for unload In-arm failed to enable position mode after calibration Ampex 1308910-01 A-23 Running Error, CHS Failure, Head and Warning Codes Model Returned Sense Data No. Table A-4. CHS Failure, Error, and Warning Codes (Continued) CHS Code 1076 (0x434) 1077 (0x435) 1078 (0x436) 1079 (0x437) 1080 (0x438) 1081 (0x439) 1082 (0x43A) 1083 (0x43B) 1084 (0x43C) 1085 (0x43D) 1086 (0x43E) 1087 (0x43F) 1088 (0x440) 1089 (0x441) 1090 (0x442) 1091 (0x443) 1092 (0x444) 1093 (0x445) 1094 (0x446) 1095 (0x447) 1096 (0x448) 1097 (0x449) 1098 (0x44A) 1099 (0x44B) 1100 (0x44C) 1101 (0x44D) 1102 (0x44E) 1103 (0x44F) 1104 (0x4501) Description In-arm failed to move home after calibration In-arm failed to position out for load In-arm failed to position in for load In-arm failed to properly move in for audit In-arm failed to properly move out for audit In-arm failed to restore after an unload cartridge abort In-arm failed to restore after unload failure In-arm mda fuse [F6] is open In-arm mda was safety shut off In-arm move sequencer timed out In-arm servo is not ready for auditing In-arm servo is not ready for loading In-arm servo is not ready for unloading In-arm failed to return home In-arm servo not initialized Load control sequencer timed out Load port became occupied during an elevator move Load port cannot be occupied during initialization Load port cannot be occupied for calibration Load port is not clear for an elevator move Load port motor voltage out of range Load port sensor does not respond to self test Loader frame is not in position for loading Loader frame is not in position for unloading Loader port roller mda fuse [F3] is open Middle vane detector failed to indicate Out-arm calibration data write checksum error Out-arm cannot find elevator bar for calibration Out-arm failed move to safe after calibration A-24 Ampex 1308910-01 Returned Sense Data CHS Failure, Error, and Warning Codes Table A-4. [. . . ]