TSM Commands
Click on the headings to sort
| Command | Common Arguments & Description | Command Description |
|---|---|---|
| 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=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 |
| 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=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 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 |
| 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 |
| 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 |
| 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 | 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 q | archive /opt* (Display information about the archive /opt) | TSM client utility - Query archived files |
| dsmc q | ba /opt/oraadm/* -subdir=yes (Query all the current files and directories backed up under /opt/oraadm and all its sub-directories) | TSM client utility - Query backed up files |
| dsmc q | fi (Display a list of partitions that have been backed up) | TSM client utility - List backed up partitions |
| 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 | sched (Display scheduled backup slot) | TSM client utility - Query schedule |
| dsmc q | sess (Display information about your session including server and server connection information) | TSM client utility - Query session |
| dsmc rest | / -subdir=yes –replace=no (Restore all files in / (everything) including sub-directories and do not replace existing files) | TSM client utility: Restore everything without overwritting existing files |
| dsmc rest | /app/ (Restore all files in /app not including sub-directories) | TSM client utility: Restore - no sub-directories |
| dsmc rest | /home/oraadm/file1 /tmp/file1-newname (Restore the /home/oraadm/file1 file under a new name and directory) | TSM client utility: Restore - to a different directory and filename |
| dsmc rest | "/home/oraadmin/*" -pick -inactive (Display a list of active and inactive backup versions of files from which you can select versions to restore) | TSM client utility: Restore - select versions of files to restore |
| dsmc rest | -replace=all -subdir=yes /app (Restore /app including sub-directories replacing all files) | TSM client utility: Restore - including subdirectories |
| 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 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 |
| 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 |
| 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=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 |
| move drm | V0123 wherestate=vaultret tostate=onsiteret (moves volume V0123 from vault retrieve to onsite retrieve) | 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 | * * 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 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 | * 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 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 | With no arguments - display info about all scripts | Displays information about TSM scripts |
| q script | script_name f=r (Display the code of the script "script_name" to the console) | Displays the code of 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=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 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 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 |