---------------------------- OS level, as user acsss ---------------------------- greplog pattern ~/log/acsss_event.log (pattern: mount, error, etc) kill.acsss (stop) rc.acsss (start) acsss_config (run only if needed) cmd_proc -l logoff ---------------------------- ACSLS ---------------------------- var port 0,0 0,1 online var lsm 0,0 online var acs 0 online q vol q acs q lsm q port q cap all q request all q clean all cancel request # volrpt audit server (run audit on netbackup when this is finished) mount/dismount move/enter/venter/eject To setup autoclean >acsss_config, 3 (general prod behavior), "auto clean option" true >set clean 50 CLN001 (CLN001 can be mounted/used 50 times) To clean a drive, mount a cleaning tape in the drive, then umount it. Drive shows "in use" but no volume is mounted. Do a force/clear of the drives: dismount X WALL_DRIVE_NUMBER force ------------------------------------------------------------------------------- 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 Make dynamic drive changes config drive panel_id Display Information Display CAP information display cap cap_id ... [ status cap_status ...] [priority cap_priority ... ] [ state cap_state ...] [ manual | automatic ] [ condition cap_condition ... ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display cell information display cell cell_loc ... [ status cell_status ... ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display drive information display drive drive_id ... [ status drive_status ... ] [state drive_state ... ] [ type drive_type ... ] [ volume vol_id ... ] [ lock lock_id... ] [ serial drive_serial# ... ] [ condition drive_condition ...] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display lock information display lock lock_id ... [ user user_id ... ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display LSM information display lsm lsm_id ... [ status lsm_status ...] [state lsm_state ... ] [ free_cells cell_count .. ] [ type lsm_type ... ] [ serial lsm_serial# ... ] [ condition lsm_condition ] [ door_open | door_closed ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display panel information display panel panel_id ... [ type panel_type ... ] [ [ c ]| [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display pool information display pool pool_id ... [ low_water low_water_ mark ... | high_water high_water_mark... ] [overflow | no_overflow ] [ [ c ] | [ f field .] [ s sortfield ... ] [ n nnn ] ] Display port information display port por_tid ... [ online | offline ] [ name port_name ... ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] Display volume information display volume vol_id ... [ acs acs_id ... | home home_loc ... | drive drive_loc ... ] [data | scratch | clean ] [ media media_type ... ] [ pool pool_id... ] [ standard | virtual ] [ status vol_status ... ] [ entry entry_date ... ] [ access access_date ... ] [ lock lock_id ... ] [ [ c ] | [ f field ... ] [ s sortfield ... ] [ n nnn ] ] 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 or display cap cap_id ...|* Set CAPs entry mode (manual or automatic) set cap mode manual | automatic cap_id Set CAPs automatic selection priority set cap priority cap_priority cap_id Make manual mode CAP ready to enter labelled carts enter cap_id Make multiple CAPs in an LSM ready enter lsm_id Make CAP ready to enter unlabeled carts into library venter cap_id vol_id 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] Use Display for dynamic reporting of library components and/or volumes. See Display commands. 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 Delete a volume in an offline LSM del_vol vol_id n q 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 volumes 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 * driveid 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 ACSLS Product Information Display scratch pool information for a specific pool or for all pools. display pool pool_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 *] 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 Remove active locks (to your current lock ID) on specified 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 volume information for cleaning cartridges display volume vol_id | vol_range | *clean 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 ACSs 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) Export database table data and miscellaneous database files to tape or a file. Use when reinstalling ACSLS or upgrading to a new ACSLS version using the same database. db_export.sh -f db_file Import database table data and miscellaneous database files from the export tape or file. Use when reinstalling ACSLS or upgrading to a new ACSLS version using the same database. db_import.sh db_file Back up the database bdb.acsss [f filename | tape_device] [o] Start up or shuts down the database db_command start | stop | stop_force Recover the database after a database failure rdb.acsss Install 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 cconsists of one or more components separated by commas. acs_id acs(0-126) cap_id acs(0126),lsm(023),cap(02) 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 select 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(0126),lsm(023),panel(019),row(041),column(023) drive_id acs(0126),lsm(023),panel(019),drive(019) drive_type Up to 10 characters transport type identifier; can be any combination of numbers (09) or letters (AZ). lock_id decimal number (032767) lsm_id acs(0126),lsm(023) media_type Up to 10 characters media type identifier; can be any combination of numbers (09) or letters (AZ). Spaces are not allowed. Two common media types are 3480 and 3490E. panel_id acs(0126),lsm(023),panel(019) pool_id decimal number (065535) Specifying an asterisk (*) for the pool_id reassigns a volume to its current pool_id port_id acs(0126),port(015) request_id unique decimal number (065535) assigned by the ACSLS. subpanel_id acs(0126),lsm(023),panel(019),startrow(041),startcolumn(023),endrow(041),endcolumn(023) vol_id Six-character identifier consisting of any combination of numbers (09), letters (AZ, az, or mixed case (except for use in volrpt)), 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 For volranges in query, enter, and eject commands: Specify only the right most numeric portions of the vol_ids as the range. All preceding characters must be identical. The display commands support full alphanumeric volranges and allow wildcards * and _.