TSM Commands

Command ▾ Common Arguments & Description Command Description
IBMtapeutil -f /dev/IBMchanger0 inventory (Run an inventory on the library, useful to see where tapes are physically located including in the hopper (import/export station)) IBM tape utility for Linux
audit libr lib_name checkl=barcode (Audits the library “lib_name” and uses the barcode reader to read the storage volume label, to decrease the audit time.) Audits and synchronizes volume inventories in an automated library
audit vol V0123 (Audits the volume V0123) Verify database information for a storage pool volume
cancel process 3 (Cancel process number 3) Cancel an administrative process
checkin libv lib_name search=yes status=scratch checkl=barcode (Check volumes into the server inventory of the library “lib_name” as scratch searching the library). Read the barcode on the tape for quicker checkin times. Then type “q req” – see command below.) Checkin a scratch storage volume searching the library into the library
checkin libv lib_name search=bulk vollist=V0123 status=scratch checkl=barcode (Checkin volume V0123 into the library “lib_name” as scratch searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type “q req” – see command below.) Check a scratch storage volume from the hopper into the library
checkin libv lib_name search=bulk vollist=V0123 status=private checkl=barcode (Checkin volume V0123 into the library “lib_name” as private searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type “q req” – see command below.) Check a private storage volume from the hopper into the library
checkin libv lib_name search=bulk status=scratch checkl=yes (Check volumes into the server inventory of the library “lib_name” as scratch searching the entry/exit ports (bulk), reading the media label (checkl=yes). Then type “q req” – see command below.) Checkin a scratch storage volume from the hopper reading the media label
checkin libv lib_name search=bulk status=scratch checkl=barcode (Check volumes into the library “lib_name” as scratch searching the entry/exit ports (bulk). Read the barcode on the tape for quicker checkin times. Then type “q req” – see command below.) Check scratch storage volumes from the hopper into the library
checkout libv lib_name V0123 checkl=no remove=no (Checkout volume V0123 from library “lib_name” without physically moving the tape and do not check the label) Check a storage volume out of the library without moving the tape
checkout libv lib_name V0123 checkl=no (Checkout volume V0123 from library “lib_name” and do not check the label) Check a storage volume out of the library
clean drive lib_name drive_name (clean the drive “drive_name” in the library “lib_name”) Clean a drive with a cleaning tape in the library
define volume backuppool bkup01.dsm formatsize=200 (Increases the size of storage pool BACKUPPOOL by creating a 200MB volume named bkup01.dsm in BACKUPPOOL) Define a volume in a storage pool
dismount vol V0123 (Dismounts a volume V0123 from the drive) Dismount a volume from the drive
dsmadmc With no arguments – runs the administrative command line client Start the administrative command line client
dsmadmc -cons (Run dsmadmc in console mode to monitor TSM activities as they occur) Start an administrative client session in console mode
dsmc arc -archmc=LOGARC -deletefiles “/app/*” (Archive all files in /app binding the archived files to the LOGARC management class, then delete the files from disk after successful archival) TSM client utility – Archive files
dsmc del ar /opt* -su=yes -pick (Delete archive files in archive /opt and use the “pick” command to list the archive files to select) TSM client utility – Delete archive files
dsmc i -quiet > /tmp/tsm.out (Run an incremental backup (i) and only report errors (-quiet) and direct all output to the log file /tmp/tsm.out) TSM client utility – Incremental backup
dsmc q sess (Display information about your session including server and server connection information) TSM client utility – Query session
dsmc q inclexcl (Display a list of include-exclude statements in the order in which they are processed during backup and archive operations) TSM client utility – Query include-exclude statements
dsmc q archive /opt* (Display information about the archive /opt) TSM client utility – Query archived files
dsmc q ar /opt* -subdir=yes (Display information about the files and subdirectories within the archive /opt. Run as root to see all files regardless of permissions) TSM client utility – Query archived files
dsmc rest /app/ (Restore all files in /app not including sub-directories) TSM client utility: Restore – no sub-directories
dsmc rest -subdir=yes -inactive -dateformat=1 -pitdate=01/23/2011 /app/* (Perform a point in time restore of /app including sub-directories from the 23rd Jan. The latest file at or before this date including inactive files will be restored.) TSM client utility – Point in time restore
dsmc rest -replace=all -subdir=yes /app (Restore /app including sub-directories replacing all files) TSM client utility: Restore – including subdirectories
dsmc sel /home/vera -subdir=yes /app (Execute a selective backup of /home/vera including subdirectories. A selective backup will backup files regardless of whether they have changed since the incremental backup.) TSM client utility – Selective backup
grant authority jane classes=system (Grant system authority to the administrator jane) Grant authority to administrator
halt With no arguments – The halt command forces an abrupt shutdown, which cancels all the admin and client node sessions even if they are not completed. Any transactions in progress interrupted by the halt command are rolled back when the server is restarted. Shutdown the server
itdt (Select S to scan for devices, select a device from the list and then select D for a firmware dump (support information log) ITDT IBM Tape Diagnostic Tool
label libv lib_name checkin=scratch search=bulk labelsource=barcode overwrite=yes (Searches library “lib_name” entry/exit ports for useable volumes to label, attempts to read bar-code label and adds them to scratch pool. Then type “q req” – see command below.) Label tape volumes
lslpp -L | grep -i tsm (Lists the installed filesets and filters out any ones with tsm in the name) Check if the TSM server or client is installed
move data V0123 (Moves files from volume V0123 to other volumes in the same storage pool if they have space available) Move files on a storage pool volume
move drm V0123 wherestate=vaultret tostate=onsiteret (moves volume V0123 from vault retrieve to onsite retrieve) Move disaster recovery media offsite and back onsite
move drm V0123 wherestate=mountable tostate=vault (moves volume V0123 from mountable to vault. Used to ready tapes to go offsite and moves them to an exit port.) Move disaster recovery media offsite and back onsite
q act search=checkin begint=-6 (Query activity log for checkin processes within the last 6 hours) Query activity log
q act begind=MM/DD/YYYY begint=HH:MM:SS (Query activity log from date and time specified) Query activity log
q assoc With no arguments – display information about which client nodes are associated with one or more schedules Query client node associations with a schedule
q copy With no arguments – display information about one or more copy groups Query copy groups
q drive With no arguments – display information about all drives associated with the server Query information about a Drive
q drm With no arguments – display info about database backup and copy storage pool volumes Query Disaster Recovery Media
q event * t=a (Query events for all domains using wildcard *, for administration schedules t=a short for type=admin) Query admin scheduled and completed events
q event * * nodes=node1 (Query client events (i.e. backups) for all domains and schedules using wildcards *, for node “node1”) Query client scheduled and completed events
q event * * begint=05:00 (Query client events (i.e. backups) for all domains and schedules using wildcards *, starting from 5am.) Query client scheduled and completed events
q file node1 (Display info about file spaces (as of the last incremental backup) that belong to the client node node1) Query one or more file spaces
q libv With no arguments – query all volumes in all libraries Query a library volume – Displays info about checked in volumes
q mount With no arguments – display info about the status of all sequential access volumes that are mounted. (Shows if there are any tapes in the drives) Display info on mounted sequential access volumes
q node f=d (Display detailed info about all registered nodes including TSM client version) Display info about one or more registered nodes
q opt With no arguments – display information about server options such as BufPoolSize Query server options
q path With no arguments – displays information about all paths associated with the server Query a Path Definition
q proc With no arguments – display all active background process information Query one or more server processes
q req With no arguments – display info about all pending mount requests. See “reply” command below Query one or more pending mount requests
q sch schedule_name t=a f=d (Display detailed information (f=d) about the admin (t=a) schedule “schedule_name” (default displays client schedules)) Displays information about schedules
q script script_name f=r (Display the code of the script “script_name” to the console) Displays the code of TSM scripts
q script With no arguments – display info about all scripts Displays information about TSM scripts
q sess With no arguments – display information about admin and client node sessions Query client sessions
q status With no arguments – display information about system parameters Query system parameters
q stg stgpool_name (Display detailed (f=d) information about storage pool “stgpool_name”) Query storage pools
q vol vol_name f=d (Display detailed info about volume “vol_name”) Query storage pool volumes
q vol access=unavailable (Display volumes with access set to unavailable) Query unavailable storage pool volumes
q volh t=dbb (Display history information about full and incremental database backup volumes) Display sequential volume history information
register admin jane poppy (Register an administrator with a user ID of jane and a password of poppy) Register an administrator
reply 2 (Use “q req” first for the ID number, then reply (if required) to inform the server you have completed a requested operation.) Allow a request to continue processing
reset bufpool (Reset the buffer pool counter) Reset the counters that track server statistics
run script_name (Run script “script_name”) Run a TSM script
set actlogretention 8 (Set the activity log retention period to 8 days) Set a value for a TSM object
setopt bufpoolsize 262144 (Update the server option bufpoolsize to 256MB without restarting the server) Set a server option for dynamic update
tapeutil -f /dev/IBMchanger0 inventory (Run an inventory on the library, useful to see where tapes are physically located including in the hopper (import/export station)) IBM tape utility for AIX
upd drive lib_name drive_name online=no (Update the drive in the library “lib_name” with drive name “drive_name” to be offline) Update a drive
upd path source_name destination_name srct=server destt=library online=no (Change the path to the library to offline. Here source type is server and dest type is library. Use q path to get the relevant details for this command.) Update a path to the library
upd path source_name destination_name srct=server destt=drive library=lib_name online=yes (Change the path to the drive to online. Here source type is server and dest type is drive. Use q path to get the relevant details for this command.) Update a path to a drive
upd sch schedule_name t=a startt=08:00(Update the admin schedule “schedule_name” by changing its start time to 08:00) Update an administrative schedule
upd sch schedule_name t=a cmd=”migrate stg notes_disk lowmig=0″ active=yes(Update the admin schedule “schedule_name” by specifying the administrative command to be scheduled for processing (cmd=””) and make the schedule active.) Update an administrative schedule
upd stg stgpool_name reclaim=90 (Update storage pool stgpool_name and set the reclamation threshold to 90%. Therefore if the volume has 10% utilisation or less the tape can be reclaimed and made available for resuse) Update a storage pool’s reclamation threshold
upd stg stgpool_name maxscr=50 (Update the storage pool “stgpool_name” and set the “Maximum Scratch Volumes allowed” parameter to 50) Update a storage pool and set max scratch
upd vol vol_name access=readwrite (Give vol_name read/write access) Change access mode for one or more storage pool volumes

 

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s