Installed with EDT in the subdirectory util, there is a host of utilities each running a basic ACSLS command. Each utility imitates a command that can be run from the ACSLS command line interface, cmd_proc, that resides on the ACSLS Server. The output of each utility is programmed to look like that seen through the command line interface. The advantage of having these utilities available on the EDT client, is - The local access of commands to use in custom maintenance scripts. - Testing particular command error. - Quickly testing the communication path to the ACSLS server with acsls_qserver. - Able to operate on lists of volumes obtained from the TSM server, acsls_eject, acsls_eject. The syntax of each utility is obtained by typing in the utility name and hitting enter. Each utility has the capability to use any of the configuration options associated with the SSI API. To see the API overrides, enter the option "-e" with the utility and hit enter. For explanation of the SSI API config options and utilities see the guide "SSI API". I. Query Server acsls_qserver -r [-v] [-e] -r Proceed with server query. -v option prints debug info to standard output. -e show additional override syntax Example: acsls_qserver -r Query Server: Free Cells 355 State run AUDIT current 0 AUDIT pending 0 MOUNT current 0 MOUNT pending 0 DISMOUNT current 0 DISMOUNT pending 0 ENTER current 0 ENTER pending 0 EJECT current 0 EJECT pending 0 Server Query SUCCESS: connection to media manager confirmed. II. Query Drive(s) acsls_qdrive -d driveID/driveID/...|all [-v] [-e] -d driveID/driveID/... driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) -d all Return status on all drives. Example: acsls_qdrive -d all Identifier State Status Volume Type ---------- ----- ------ ------ ---- 0,0,0,0 online available IBM-LTO 0,0,0,1 online available 9840 0,0,0,2 online available T9940B 0,0,0,3 online available IBM-LTO2 0,0,0,4 online available 9840 0,0,0,5 online available T9940A 0,0,0,6 online available T9940A ACS drive state State --------------- ----- STATE_DIAGNOSTIC diagnostic STATE_OFFLINE offline STATE_OFFLINE_PENDING offline_pending STATE_ONLINE online ACS drive status Status ---------------- ------ STATUS_CLEAN_DRIVE clean_drive STATUS_DRIVE_AVAILABLE available STATUS_DRIVE_IN_USE in use STATUS_DRIVE_NOT_IN_LIBRARY not_in_library STATUS_DRIVE_OFFLINE offline STATUS_DRIVE_RESERVED reserved STATUS_INVALID_DRIVE invalid ACS drive type Type -------------- ---- 0 4480 1 4490 2 9490 3 SD3 4 4890 5 DLT2000 6 DLT2000XT 7 DLT4000 8 DLT7000 9 9840 10 9491 11 DLT8000 12 9840-3590 13 T9940A 14 9940-3590 15 SDLT 16 T9840B 17 T9840B35 18 HP-LTO 19 IBM-LTO 20 SGT-LTO 21 T9940B 22 T9940B35 23 VIRT-DRV 24 SDLT-320 25 T9840C 26 T9840C35 27 HP-LTO-2 28 IBM-LTO-2 29 SGT-LTO-2 30 SDLT-600 *NOTE* Type only shown when status is available, in use, and reserved. Otherwise Identifier and ACS status are shown. Volume only shown when status is in use. III. Query Volume(s) acsls_qvol -n volID/volID/volID-volID/vol*/...|all [-a] [-v] [-e] -n volID/volID/... volID in form of 6 character label. Volume ranges are seperated by - Wild card is also supported. Example: ISV* which would issue query volume on vols ISV000-ISV999. Individual vols, volume ranges, and vol* seperated by / -n all Return status on all volumes. options: -a Show vol status not_in_library for wildcard and range. Default is to show for listed vol, suppress for * and - . -v print debug info to standard output. -e show additional override syntax. Example: acsls_qvol -n all Identifier Status Location Type ---------- ------ -------- ---- 000658 home 0,0,2,1,2 LTO-100G 000659 home 0,0,0,1,0 LTO-100G 000660 home 0,0,1,33,1 STK1R 000662 home 0,0,2,1,1 STK2P 000663 home 0,0,0,0,4 STK2P 000665 home 0,0,0,1,1 STK2P 000666 home 0,0,2,2,1 STK2P 000780 home 0,0,1,34,2 LTO-100G 000782 home 0,0,1,33,2 LTO-100G ACS vol status Status -------------- ------ STATUS_INVALID_VOLUME invalid STATUS_VOLUME_HOME home STATUS_VOLUME_IN_DRIVE in drive STATUS_VOLUME_IN_TRANSIT transit STATUS_VOLUME_NOT_IN_LIBRARY not_in_library STATUS_VOLUME_EJECTED ejected STATUS_VOLUME_MISSING missing STATUS_VOLUME_ABSENT absent ACS vol type Type ------------ ---- 0 3480 1 3490E 2 DD3A 3 DD3B 4 DD3C 5 DD3D 6 DLTIII 7 DLTIV 8 DLTIIIXT 9 STK1R 10 STK1U 11 EECART 12 JLABEL 13 STK2P 14 STK2W 15 KLABEL 16 LTO-100G 17 LTO-50GB 18 LTO-35GB 19 LTO-10GB 20 LTO-CLN2 21 LTO-CLN3 22 LTO-CLN1 23 SDLT 24 VIRTUAL 25 LTO-CLNU 26 LTO-200G 27 SDLT-2 *NOTE* Location and Type only shown when status is in drive, home, tansit. Otherwise Identifier and ACS status are shown. IV. Query Cap(s) acsls_qcap -c capID/capID/...|all [-v] [-e] -c capID/capID/... capID in form: #,#,# (ACS,LSM,CAP) -c all Return status on all caps. Example: acsls_qcap -c all Identifier Status State Mode Size Prity ---------- ------ ----- ---- ---- ----- 0,0,0 eject online automatic 20 0 ACS cap status Status -------------- ------ STATUS_CAP_AVAILABLE available STATUS_AUDIT_ACTIVITY audit STATUS_EJECT_ACTIVITY eject STATUS_ENTER_ACTIVITY enter STATUS_INSERT_MAGAZINES insert_magazines ACS cap state State ------------- ----- STATE_DIAGNOSTIC diagnostic STATE_OFFLINE offline STATE_ONLINE online ACS cap mode Mode ------------ ---- CAP_MODE_AUTOMATIC automatic CAP_MODE_MANUAL manual *NOTE* State, Mode, Size, Priority shown only when one of above mentioned cap status. Othewise, Identifier and ACS status are shown. V. Query Pool(s) acsls_qpool -p poolID/poolID/...|all [-v] [-e] -p poolID/poolID/... poolID (0 to 65534) -p all Return status on all pools. Example: acsls_qpool -p all Pool Count Low Water High Water Status ---- ----- --------- ---------- ------ 0 0 0 2147483647 low water 175 0 0 999 low water 199 0 0 100 low water 200 1 0 999 good status 299 1 0 100 good status 399 0 0 100 low water 500 0 0 20 low water *NOTE* Count, Low Water, High Water only shown is if status is good status, low water, high water. Otherwise POOL and ACS status is shown. VI. Set/Unset Scratch Volume(s) acsls_setscratch -f /path/file | -n volID/volID-volID/volID/... | -a start volID [-b end volID] -p poolID [-c DATA | SCRATCH] [-L lockID] -f /path/file: open file and extract vol names from file OR -n volID/volID-volID/volID/... volID is 6 character identifier. volume ranges are seperated by - individual vols and volume ranges seperated by / OR -a start volID [-b end volID] Backward compatibility with EDT 6. -p poolID (0 to 65534) options: -c SCRATCH | DATA. SCRATCH to assign to pool, DATA to remove from pool. Default is SCRATCH. this option removes vol(s) from scratch pool. -L lockID - use if vol(s) are locked. -l /path/file. Same as -f. Backward compatibility with EDT 6. -v print debug info to standard output. -e show additional override syntax. Examples: acsls_setscratch -n 000662/000663/000665 -p 299 Set Scratch SUCCESS: The following volume(s) set to scratch state ON: 000662 STATUS_SUCCESS 000663 STATUS_SUCCESS 000665 STATUS_SUCCESS acsls_setscratch -n 000662/000663/000665 -p 299 -c DATA Set Scratch SUCCESS: The following volume(s) set to scratch state OFF: 000662 STATUS_SUCCESS 000663 STATUS_SUCCESS 000665 STATUS_SUCCESS acsls_setscratch -n 000662-000666 -p 299 Set Scratch SUCCESS: The following volume(s) set to scratch state ON: 000662 STATUS_SUCCESS 000663 STATUS_SUCCESS 000665 STATUS_SUCCESS 000666 STATUS_SUCCESS VII. Query Scratch Volume(s) acsls_qscratch -p poolID/poolID/...|all [-v] [-e] -p poolID/poolID/... poolID (0 to 65534) -p all Return scratch status on all pools. Example: acsls_qscratch -p all Identifier Status Location Pool Type ---------- ------ -------- ---- ---- 000665 home 0,0,0,1,1 299 STK2P 000666 home 0,0,2,2,1 299 STK2P 000662 home 0,0,2,1,1 299 STK2P 000663 home 0,0,0,0,4 299 STK2P 532673 home 0,0,2,0,2 200 STK1R 001327 home 0,0,0,0,2 299 STK2P For info on Status and Type, refer to Query Volume(s). VIII. Lock Drive(s) acsls_lockdrive -d driveID/driveID... [-u userID] [-l lockID] [-w] [-v] [-e] -d driveID/driveID/... driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) options: -u userID (up to 64 char identifier). Default is hostname. -l lockID (0 to 32767). Default lets server generate lock. -w If drive locked, wait until unlocked to gain our lock. Examples: acsls_lockdrive -d 0,0,0,3 The following drive(s) locked under LOCKID 20877 Drive 0,0,0,3 STATUS_SUCCESS acsls_lockdrive -d 0,0,0,0/0,0,0,1 -u test The following drive(s) locked under LOCKID 26883 Drive 0,0,0,0 STATUS_SUCCESS Drive 0,0,0,1 STATUS_SUCCESS IX. Query Lock Drive(s) acsls_qlockdrive -d driveID/driveID/...|all [-l lockID] [-v] [-e] -d driveID/driveID/... driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) -d all Return status on all drives. options: -l lockID (0 to 32767). Default 0 returns all drive locks. Option restricts search. Examples: acsls_qlockdrive -d all Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 0,0,0,0 26883 299 0 in use test 0,0,0,1 26883 299 0 in use test 0,0,0,3 20877 60 0 in use abyss acsls_qlockdrive -d 0,0,0,1 Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 0,0,0,1 26883 299 0 in use test acsls_qlockdrive -d all -l 20877 Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 0,0,0,3 20877 60 0 in use abyss *Note* Other than staus in use or available, only Identifier and ACS status is shown. X. Unlock Drive(s) acsls_unlockdrive -d driveID/driveID/...|all -l lockid [-v] [-e] -d driveID/driveID/... driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) -d all Unlocks all drives associated with lock. -l lockid (0 to 32767). Examples: acsls_unlockdrive -d all -l 26883 Drive 0,0,0,0 STATUS_SUCCESS Drive 0,0,0,1 STATUS_SUCCESS acsls_unlockdrive -d 0,0,0,3 -l 20877 Drive 0,0,0,3 STATUS_SUCCESS XI. Lock Volume(s) acsls_lockvol -n volID/volID... [-u userID] [-l lockID] [-w] [-v] [-e] -n volID/volID/... volID in form of 6 character label. options: -u userID (up to 64 char identifier). Default is hostname. -l lockID (0 to 32767). Default lets server generate lock. -w If vol locked, wait until unlocked to gain our lock. Examples: acsls_lockvol -n 000662 The following vol(s) locked under LOCKID 888 Volume 000662 STATUS_SUCCESS acsls_lockvol -n 000665/000666 -u test The following vol(s) locked under LOCKID 13230 Volume 000665 STATUS_SUCCESS Volume 000666 STATUS_SUCCESS XII. Query Lock Volume(s) acsls_qlockvol -n volID/volID/volID-volID/vol*/...|all \ [-l lockID] [-a] [-v] [-e] -n volID/volID/... volID in form of 6 character label. Volume ranges are seperated by - Wild card is also supported. Example: ISV* which would issue query volume lock on vols ISV000-ISV999. Individual vols, volume ranges, and vol* seperated by / -n all Return status on all vols. options: -l lockID (0 to 32767). Default 0 returns all vol locks. Option restricts search. -a Show vol status not_in_library for wildcard and range. Default is to show for listed vol, suppress for * and - . -v print debug info to standard output. -e show additional override syntax. Example: acsls_qlockvol -n all Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 000662 888 272 0 in_use abyss 000665 13230 206 0 in_use test 000666 13230 206 0 in_use test acsls_qlockvol -n 000666 Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 000666 13230 206 0 in_use test acsls_qlockvol -n all -l 13230 Identifier Lock ID Lk Drtn Pending Status User ID ---------- ------- ------- ------- ------ ------ 000665 13230 206 0 in_use test 000666 13230 206 0 in_use test Other than staus in use or available, only Identifier and ACS status is shown. XIII. Unlock Volume(s) acsls_unlockvol -n volID/volID/...|all -l lockid [-v] [-e] -n volID/volID/... volID in form of 6 character label. -n all Unlocks all vols associated with lock. -l lockid (0 to 32767). Examples: acsls_unlockvol -n all -l 13230 Volume 000665 STATUS_SUCCESS Volume 000666 STATUS_SUCCESS acsls_unlockvol -n 000662 -l 888 Volume 000662 STATUS_SUCCESS XIV. Mount Volume acsls_mount -n volID -d driveID [-l lockid] [-r] [-b] [-v] [-e] -n volID (6 character label) -d driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) options: -l lockID (0 to 32767). If vol and drive not locked, lockID not needed. Either vol or drive can be locked, use corresponding lockID. If both vol and drive locked, the lockID must be the same. -r mount readonly. -b bypass for virtual label. Only needed if barcode can not be read. Example: acsls_mount -n 000662 -d 0,0,0,5 Mount Volume SUCCESS: 000662 on 0,0,0,5 XV. Mount Scratch Volume acsls_mountscratch -p poolID -d driveID [-l lockid] [-v] [-e] -p poolID (0 to 65534) -d driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) options: -l lockID (0 to 32767). If vol and drive not locked, lockID not needed. Example: acsls_mount -p 100 -d 0,0,0,5 Mount Scratch Volume SUCCESS: 000662 from 100 on 0,0,0,5 XVI. Dismount Volume acsls_dismount -n volID -d driveID [-l lockid] [-f] [-v] [-e] -n volID (6 character label) -d driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) options: -l lockID (0 to 32767). If vol and drive not locked, lockID not needed. -f force. Turn off force dismount. Example: acsls_dismount -n 000662 -d 0,0,0,5 Dismount Volume Success: 000662 from 0,0,0,5 XVII. Eject Volume(s) acsls_eject -f /path/file | -n volID/volID/volID/... -c capID [-d eject count] [-L lockID] -f /path/file: open file and extract vol names from file OR -n volID/volID/volID/... volID is 6 character identifier. -c capID in form: #,#,# (ACS,LSM,CAP) options: -d eject count. Override default size 42 volumes sent per request. Choose number equal to the slot count of the cap. -L lockID - use if vol(s) are locked. -l /path/file: same as -f. Backwardly compatible with EDT 6. -v print debug info to standard output. -e show additional override syntax. Example: acsls_eject -n 666666 -c 0,0,0 Eject the following volumes into cap 0,0,0 1. 666666 Identifier Status --------- ------ 666666 STATUS_SUCCESS XVIII. Enter Volume(s) acsls_enter -c capID [-d] -c capID in form: #,#,# (ACS,LSM,CAP) options: -d continuous mode. If run in continuous mode, you need to cancel at server using requestID. XIX. Query ACS(s) acsls_qacs -a acsID/acsID/...|all [-v] [-e] -a acsID/acsID/... acsID in form of # (ACS) -a all Return status on all ACSs. Example: acsls_qacs -a all Identifier State Free Cell Audit Mount Dismnt Enter Eject Count C/P C/P C/P C/P C/P ---------- ----- --------- ----- ----- ------ ----- ----- 0 online 354 0/0 0/0 0/0 0/0 0/0 XX. Query LSM(s) acsls_qlsm -l lsmID/lsmID/...|all [-v] [-e] -l lsmID/lsmID/... lsmID in form of #,# (ACS,LSM) -l all Return status on all LSMs. Example: acsls_qlsm -l all Identifier State Free Cell Audit Mount Dismnt Enter Eject Count C/P C/P C/P C/P C/P ---------- ----- --------- ----- ----- ------ ----- ----- 0,0 online 354 0/0 0/0 0/0 0/0 0/0 XXI. Query Port(s) acsls_qport -p portID/portID/...|all [-v] [-e] -p portlID/portID/... portID in form of #,# (ACS,PORT) -p all Return status on all ports. Example: acsls_qport -p all Identifier State ---------- ----- 0,0 online XXII. Vary Drive(s) acsls_varydrive -d driveID/driveID/... -r state [-l lockid] [-v] [-e] -d driveID/driveID/... driveID in form: #,#,#,# (ACS,LSM,PANEL,DRIVE) -r state must be one of: online, offline, diagnostic. options: -l lockid is only needed if a drive(s) are locked. Example: acsls_varydrive -d 0,0,0,2 -r offline The following drive(s) varied to state offline 0,0,0,2 STATUS_SUCCESS acsls_varydrive -d 0,0,0,2/0,0,0,3 -r online The following drive(s) varied to state online 0,0,0,3 STATUS_SUCCESS 0,0,0,2 STATUS_SUCCESS XXIII. Vary ACS(s) acsls_varyacs -a acsID/acsID/... -r state [-f] [-v] [-e] -a acsID/acsID/... AcsID in form: # (ACS) -r state must be one of: online, offline, diagnostic. options: -f force Example: acsls_varyacs -a 0 -r offline The following ACS(s) varied to state offline 0 STATUS_SUCCESS XXIV. Vary LSM(s) acsls_varylsm -l lsmID/lsmID/... -r state [-f] [-v] [-e] -l lsmID/lsmID/... lsmID in form: #,# (ACS,LSM) -r state must be one of: online, offline, diagnostic. options: -f force Example: acsls_varylsm -l 0,0 -r offline The following LSM(s) varied to state offline 0,0 STATUS_SUCCESS XXV. Vary Port(s) acsls_varyport -p portID/portID/... -r state [-v] [-e] -a portID/portID/... portID in form: #,# (ACS,PORT) -r state must be one of: online, offline, diagnostic. Example: acsls_varyport -p 0,0 -r offline The following PORT(s) varied to state offline 0,0 STATUS_SUCESS