ACSLS useful commands

ACSLS Quick Reference

Throughout this quick reference, underlines show valid command and keyword abbreviations. For example, aud is an abbreviation of the audit command. Brackets [ ] enclose optional parameters. A vertical bar ( | ) separates parameter choices.

To do this task...

Use this command or utility...

Configure ACSLS
Run the configuration script	acsss_config
Display values of dynamic options	dv_print
Display values of static options	dv_config -s
Display values of dynamic and static options	dv_config -d

Query Status
Display ACSLS and library status	query server
Display ACS status	query acs acs_id ... | all
Display LSM status	query lsm lsm_id ... | all
Display CAP status	query cap cap_id ... | all
Display transport status	query drive drive_id ... | all
Display LMU and port status for both single-LMU and dual-LMU ACS configurations	query lmu acs_id ... | all
Display status of media-compatible transports for a specified data volume	query mount vol_id
Display status of media-compatible transports for a specified scratch pool (or volume media type within the pool)	query mount * pool_id ... [media media_type | media *]
Display port status	query port port_id .... | all
Display the location of a volume	query volume vol_id ... | all
Display cleaning cartridge status	query clean vol_id ... | all
Display the status of scratch volumes in a pool	query scratch pool_id ... | all
Display scratch pool attributes	query pool pool_id ... | all
Display request status	query request request_id ... | all
Cancel a current or pending request	cancel request_id
Display the lock status of a transport or volume	query lock drive | volume identifier ... | all

Manage CAPs
Display CAP status	query cap cap_id ... | all
Set CAP's entry mode (manual or automatic)	set cap mode manual | automatic cap_id
Set CAP's automatic selection priority	set cap priority cap_priority cap_id
Make manual mode CAP ready to enter labelled carts	enter cap_id
Make CAP ready to enter unlabeled carts into library	venter cap_id vol_id | volrange

Manage volumes
Mount a data volume or cleaning cartridge	mount vol_id drive_id [bypass] [readonly]
Dismount a data volume or cleaning cartridge	dismount vol_id drive_id [force]
Create a volume report	volrpt [-s vol | loc | use] [-d] [-f filename] [-z] [-a | -l | -v identifier_list]
Set volume ownership	set owner owner_id volume vol_id | volrange
Eject volumes from the library	eject cap_id vol_id | volrange ...
Move volumes to a specified LSM	move vol_id lsm_id

Manage scratch volumes/pools
Create or modify scratch pools	define pool low_water_mark high_water_mark pool_id ...[overflow]
Display scratch pool attributes	query pool pool_id ... | all
Display the status of scratch volumes in a pool	query scratch pool_id ... | all
Set volume's scratch attribute and assign the volume to a scratch pool	set scratch pool_id vol_id | volrange
Change volume from scratch to data	set scratch off pool_id vol_id | volrange
Delete an empty scratch pool	delete pool pool_id ... | all
Mount a scratch volume from a specified pool (single media libraries)	mount * drive_id pool_id
Mount a scratch volume from the common pool (single media libraries)	mount * drive_id
Mount a scratch volume from a specified pool with specific media type	mount * drive_id pool_id media media_type
Mount a scratch volume from a specific pool, media type based on scratch preferences defined	mount * drive-id pool_id media *
Mount a scratch volume from common pool, media type based on defined scratch preferences	mount * drive_id media *
Mount a scratch volume from common pool with specified media type	mount * drive_id media media_type
Display status of media-compatible transports for a specified scratch pool (or volume media type within the pool)	query mount * pool_id ... [media media_type | media *]

Manage Locks
Set your lock ID	set lock lock_id
Display your current lock ID or user ID	show lock | user
Lock a volume or drive (to your current lock ID)	lock drive | volume identifier ... [wait]
Remove active locks (to your current lock ID) on spe cified drives or volumes or all active locks	unlock drive | volume identifier ... | all
Remove all active and pending locks on specified drives or volumes	clear lock drive | volume identifier

Clean transports
Set cleaning cartridge attributes	set clean max_usage | vol_id | volrange
Set cleaning attributes back to data cartridges	set clean off vol_id | volrange
Display cleaning cartridge attributes	query clean vol_id... | all

Manage a dual LMU
Display LMU and port status for both single-LMU and dual-LMU ACS configurations	query lmu acs_id ... | all
Manually switch ACS management from the ACS's master LMU to the standby LMU	switch lmu acs_id

Audit the library
Audit the entire library	audit cap_id server
Audit an ACS	audit cap_id acs acs_id
Audit an LSM	audit cap_id lsm lsm_id
Audit an LSM panel	audit cap_id panel panel_id
Audit an LSM subpanel	audit cap_id subpanel subpanel_id

Maintain the database (UNIX prompt)
Save database to tape or a file before upgrading or reinstalling ACSLS	db_export.sh [-f filename | norewind tape_device] [-o]
Import the exported database from tape or a file	db_import.sh [-f filename | norewind tape_device]
Back up the database	bdb.acsss [-o] [-f filename | tape_device]
Start up or shut down the database	db_command start | stop
Recover the database after a database failure	rdb.acsss [-f filename | tape_device]

Install optional second disk (UNIX prompt)
Initialize the second disk	sd_mgr.sh

Vary library components
Change the state of an ACS	vary acs acs_id ... online | offline | diagnostic [force]
Change the state of an LSM	vary lsm lsm_id ... online | offline | diagnostic [force]
Change the state of a CAP	vary cap cap_id ... online | offline | diagnostic [force]
Change the state of a transport	vary drive drive_id ... online | offline | diagnostic [force]
Change the state of a port	vary port _port_id ... online | offline

Command Identifiers

Each command identifier corresponds to a type and consists of one or more components separated by commas. ACSLS allows a maximum of 42 identifiers per type.

acs_id	acs(0-126)
cap_id	acs(0-126),lsm(0-23),cap(0-2) An asterisk (*) in a cap_id does the following: acs,lsm,* - causes ACSLS to select the highest priority available CAP in the LSM. acs,* - causes ACSLS to select the highest priority available CAP in the ACS. * - for an enter request causes ACSLS to se lect the CAP in the ACS with the most free cells. * - for an eject request causes ACSLS to select the highest priority CAP in each ACS with a volume designated for ejection.
cell_id	acs(0-126),lsm(0-23),panel(0-19),row(0-41),col umn(0-23)
drive_id	acs(0-126),lsm(0-23),panel(0-19),drive(0-9)
drive_type	10 characters transport type identifier; can be any com bination of numbers (0-9) or letters (A-Z).
lock_id	decimal number (0-32767)
lsm_id	acs(0-126),lsm(0-23)
media_type	10 character media type identifier; can be any combination of numbers (0-9) or letters (A-Z). Spaces are not allowed. Two common media types are 3480 and 3490E.
panel_id	acs(0-126),lsm(0-23),panel(0-19)
pool_id	decimal number (0-65534) Specifying an asterisk (*) for the pool_id reassigns a volume to its current pool_id
port_id	acs(0-126),port(0-23)
request_id	unique decimal number (0-65535) assigned by the ACSLS.
subpanel_id	acs(0-126),lsm(0-23),panel(0-19),startrow(0-41),startco lumn(0-23),endrow(0-41),endcolumn(0-23)
vol_id	Six-character identifier consisting of any combination of numbers (0-9), letters (A-Z), dollar sign ($), pound sign (*), and spaces ( ). Use single or double quotes to enclose vol_ids with leading or trailing spaces. Do not specify vol_ids with embedded spaces.
volrange	Specifies an ascending range of volumes separated by a dash. Specify only the right-most numeric portions of the vol_ids as the range. All preceding characters must be identical.