Common TSM Command Line Options

Common TSM Command Line Options

Here are some common commands for getting started with TSM.

TSM Prompt

Most commands are executed at the TSM prompt. To launch a TSM command line session — which on most systems will require root/administrator-level direct or sudo access — type:


You may need to change to the directory where TSM lives:

  • Solaris and Linux, typically /opt/tivoli/tsm/client/ba/bin
  • AIX, typically /usr/tivoli/tsm/client/ba/bin
  • Windows, typically C:\Program Files\tivoli\tsm\baclient

Once instantiated, you should see something like the following:

cjcase@enya:/home/cjcase> dsmc

IBM Tivoli Storage Manager

Command Line Backup/Archive Client Interface – Version 5, Release 2, Level 0.

(c) Copyright by IBM Corporation and other(s) 1990, 2003. All Rights Reserved.

Node Name: TSM-SRVxxx

Session established with server TSM-SRV-01: AIX-RS/6000

Server Version 5, Release 3, Level .4

Server date/time: 03/08/05 13:18:34 Last access: 03/08/05 13:15:58


At the TSM prompt, type help or h and Enter to launc the help section, using the numbers that appear to enter the help system of your choice. For sections that are more than one screen in length, continue pressing Enter to return to the screen where you started.

Use the command quit or q at the TSM prompt to exit.

Common TSM Commands

These commands can be run from the TSM prompt, or can follow the command dsmc directly (e.g., q sched from TSM prompt, or dsmc q sched from command line or script with appropriate access.)

  • dsmc query schedule (short version: q sched)
  • query inclexcl (short version: q inclexcl)
  • query filespace (short version: q fi)
  • query archive “/home/foo/*” (short version: q arch “/home/foo/*”
  • query backup “/home/foo/*” (short version: q ba “/home/foo/*”
  • query mgmtclass (short version: q mgmtcl)
  • query restore (short version: q rest)
  • query session (short version: q se)
  • query access (short version: q acc)

Ensure TSM Scheduler is Running

On a Unix system, check all processes and look to make sure dsmc is running with the command line argument schedule:

cjcase@blitzen:/home/cjcase> ps -ef|grep dsmc

root 19458 73194 0 14:42:50 pts/3 0:00 grep dsmc

root 21178 1 0 Aug 19 – 7:53 /usr/bin/dsmc schedule or /opt/tivoli/tsm/client/ba/bin/dsmcad

Common Restore Commands

These commands are used to check on files that need to be restored or for launching restores from the command line.


restore “/home/foo/*” -ina -pick

This command will let the administrator pick the file desired to be restored to the original path, /home/foo/filename. Select the file by entering the number that appears to the left of the filename, then press the letter “o.”


restore -sub=yes “/home/foo/*” /home/foo/restore/

Restore from the original path to another path; the first path is the original /home/foo/* source, the second path is the restoration target. TSM will create target directories assuming you have permissions sufficient to do so.


restore “/home/foo/*” /home/foo/restore/ -ina -pick

This will allow you to restore from either active versions or inactive versions of a file; in this context, it will allow restoration from the first (source) path to the second (target) path.

Incremental Backups

The incremental command backs up all new or changed files or directories in the default client domain or from file systems, directories, or files you specify, unless you exclude them from backup services. See the INCREMENTAL command topic for supported file systems support.

To incrementally back up selected files or directories, enter a file specification in the command. If you do not enter a file specification, the default is to back up files or directories in the default domain. See the DOMAIN topic for information on how to change which objects are included in the default domain.

For example, to run an incremental backup of the default client domain specified in your client user options file (dsm.opt); by default, file systems id all-local: incremental or inc

To run an incremental backup for the /home, /usr, and /proj file systems: incremental /home /usr /proj

To run an incremental backup for the /proj/test directory: incremental /proj/test/