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 III. Query Volume(s) acsls_qvol -n volID/volID/...|all [-v] [-e] -n volID/volID/... volID in form of 6 character label. -n all Return status on all volumes. 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 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 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 ---- ----- --------- ---------- 0 0 0 2147483647 175 0 0 999 199 0 0 100 200 1 0 999 299 1 0 100 399 0 0 100 500 0 0 20 VI. Set/Unset Scratch Volume(s) acsls_setscratch -f /path/file | -n volID/volID-volID/volID/... -p poolID [-c] [-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 / -p poolID (0 to 65534) options: -c Default is to set vol(s) as scratch, this option removes vol(s) from scratch pool. -l lockID - use if vol(s) are locked. 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 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 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: 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: 0,0,0,0 STATUS_SUCCESS 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 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 0,0,0,0 STATUS_SUCCESS 0,0,0,1 STATUS_SUCCESS acsls_unlockdrive -d 0,0,0,3 -l 20877 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 acsls_lockvol -n 000662 The following vol(s) locked under LOCKID 888: 000662 STATUS_SUCCESS acsls_lockvol -n 000665/000666 -u test The following vol(s) locked under LOCKID 13230: 000665 STATUS_SUCCESS 000666 STATUS_SUCCESS XII. Query Lock Volume(s) acsls_qlockvol -n volID/volID/...|all [-l lockID] [-v] [-e] -n volID/volID/... volID in form of 6 character label. -n all Return status on all vols. options: -l lockID (0 to 32767). Default 0 returns all vol locks. Option restricts search. 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 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 000665 STATUS_SUCCESS 000666 STATUS_SUCCESS acsls_unlockvol -n 000662 -l 888 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. 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 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 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. Example: acsls_eject -n 666666 -c 0,0,0 Eject the following volumes into cap 0,0,0 1. 666666 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