Open [Terminal] from [Applications] | [Utilities] and type sudo dsmc.

You will b
e prompted for your Mac password then should see a prompt of the form:
IBM Tivoli Storage Manager
Command Line Backup-Archive Client Interface
Client Version 6, Release 4, Level 1.5
Client date/time: 13-03-2014 14:57:05
(c) Copyright by IBM Corporation and other(s) 1990, 2013. All Rights Reserved.
Node Name: ABCD1234-LAPTOP-ITSERV
Session established with server OX_HFS_B1: AIX
Server Version 6, Release 3, Level 4.200
Server date/time: 13-03-2014 14:57:05 Last access: 10-03-2014 12:34:35
tsm>
2.3. Unix/Linux
Run dsmc as root from the shell prompt (e.g., in Ubuntu, run sudo dsmc). You sho
uld see a prompt of the form:
IBM Tivoli Storage Manager
Command Line Backup-Archive Client Interface
Client Version 6, Release 4, Level 1.7
Client date/time: 13-03-2014 15:01:20
(c) Copyright by IBM Corporation and other(s) 1990, 2014. All Rights Reserved.
Node Name: TEST-UBUNTU-OUCS
Session established with server OX_HFS_B1: AIX
Server Version 6, Release 3, Level 4.200
Server date/time: 13-03-2014 15:01:15 Last access: 13-03-2014 13:01:04
tsm>
2.4. Netware
Type load dsmc at the console.
3. Accessing Help
Online help for TSM commands, options and error messages is available by typing
help at the tsm> prompt. The result will be similar to below:
1.0 New for IBM Tivoli Storage Manager Version 6.4
2.0 Using commands
2.1 Start and end a client command session
2.1.1 Process commands in batch mode
2.1.2 Process commands in interactive mode
2.2 Enter client command names, options, and parameters
2.2.1 Command name
2.2.2 Options
2.2.3 Parameters
2.2.4 File specification syntax
2.3 Wildcard characters
2.4 Client commands reference
2.5 Archive
2.6 Archive FastBack
Enter 'q' to exit help, 't' to display the table of contents,
press enter or 'd' to scroll down, 'u' to scroll up or
enter a help topic section number, message number, option name,

command name, or command and subcommand:

Note that commands and options may be abbreviated to a short form as indicated b
y capitalisation of words in the syntax entry for a command. Thus, for example,
query filespace can be abbreviated to q fi. Options and commands can also be inc
luded on the original command line so, using the above example, on a Netware mac
hine you can run load dsmc q fi to just run a query of the current partitions ba
cked up. Obviously, more complex queries and commands can be similarly run in th
e same manner.
4. Querying the server
The following query commands illustrate typical command syntax and output.
4.1. Querying your scheduled backup slot
To query your scheduled backup slot enter q sched (which is short for query sche
dule). The output should look similar to that below:
tsm> q sched
Schedule Name:
Description:
Schedule Style:
Action:
Options:
Objects:
Priority:
Next Execution:
Duration:
Period:
Day of Week:
Month:
Day of Month:
Week of Month:
Expire:

WEEKLY_ITSERV
ITSERV weekly incremental backup
Classic
Incremental
5
149 Hours and 35 Minutes
15 Minutes
1 Week
Wednesday

Never

4.2. Querying what files are included/excluded for backup

At the tsm> prompt enter q inclexcl to list output similar to the following:
tsm> q inclexcl
*** FILE INCLUDE/EXCLUDE ***
Mode Function Pattern (match from top down)
---- --------- -----------------------------Excl Filespace /var/run
.excl
Excl Filespace /tmp
.excl
Excl Directory /.../.opera/.../cache4
.excl
Excl Directory /.../.mozilla/.../Cache
.excl
Excl Directory /.../.netscape/.../cache
.excl
Excl Directory /var/tmp
.excl
Excl All
/.../dsmsched.log
.excl
Excl All
/.../core
.excl
Excl All
/.../a.out

Source File
----------------/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl
/opt/tivoli/tsm/client/ba/bin/incl

.excl
No DFS include/exclude statements defined.
Note that the include/exclude directives are listed at the partition level first
, then the directory/folder level and finally at the file level. The order they
are displayed above is the order in which these directives are applied by TSM. Y
ou will note that the order of the directives at any one level is the opposite o
f the order in which they appear in the options file. That is, TSM reads the dir
ectives listed in options file from the bottom up.
4.3. Querying what partitions have been backed up
At the tsm> prompt enter q fi to list which partitions have been backed up:
Windows:
#
--1

Last Incr Date

-------------01-05-2012 19:46:59

Type
---NTFS

File Space Name

--------------\\tentacles.oucs\c$

tsm> q fi
#
Last Incr Date
---------------1 02-05-2012 02:13:13
2 25-07-2011 12:26:09

Type
---HFS
HFS

File Space Name

--------------/
/Volumes/Disk 2

Type
---EXT4
EXT3

File Space Name

--------------/
/home

Type
---UFS
UFS

File Space Name

--------------/
/export/home

Mac:

Linux:
tsm> q fi
#
Last Incr Date
---------------1 02-05-2013 02:13:13
2 25-07-2014 12:26:09
Solaris:
tsm> q fi
#
Last Incr Date
---------------1 02-05-2012 02:13:13
2 25-07-2011 12:26:09
Netware:
#
--1
2
3
4

Last Incr Date

-------------02-05-2012 00:23:46
02-05-2012 00:22:42
02-05-2012 00:25:33
02-05-2012 00:25:11

Type
---NTW:LONG
NDS
NTW:LONG
NTW:LONG

File Space Name

--------------NSMS1\SYS:
NSMS1\NDS:
NSMS1\USR:
NSMS1\APPS:

4.4. Querying what files have been backed up

The syntax for querying what files you have backed up involves giving a file spe
cification which is necessarily OS specific. Also, if an incorrect file specific
ation is given it may appear that you have no backups. Consequently, several wor
ked examples are displayed below for Windows, Mac, Linux/Unix and Netware enviro
nments.

If you give just a path to a directory/folder you will only get the folder retur
ned as the output:
Windows:
tsm> q ba c:\Downloads
Size
Backup Date
-------------0 B 03-04-2012 19:57:54
\c$\Downloads

Mgmt Class
---------STANDARD

A/I File
--- ---A \\tentacles.oucs

Mgmt Class
---------STANDARD

A/I File
--- ---A /Users

Mgmt Class
---------STANDARD

A/I File
--- ---A /home/ians/proje

Mgmt Class
---------STANDARD

A/I File
--- ---A USR:/ians

Mac:
tsm> q ba /Users
Size
Backup Date
-------------72 B 24-04-2012 02:52:09
Linux:
tsm> q ba /home/ians/projects
Size
Backup Date
-------------512 B 24-04-2012 02:52:09
cts
Netware:
tsm> q ba USR:/ians
Size
Backup Date
-------------0 B 02-05-2012 00:25:32

Note that the Windows client lists the directory in UNC format. This format can
also be used for the file specification in the query.
If you just add a trailing * (star) as a wildcard in the above query, TSM will o
nly return those files and directories backed up immediately below the directory
path given in the query
tsm>q ba
Size
---512
1,024
512
512

/home/ians/projects/*
Backup Date
----------12-09-2011 19:57:09
08-12-2011 02:46:53
12-09-2011 19:57:09
24-04-2012 00:22:56

Mgmt Class
---------STANDARD
STANDARD
STANDARD
STANDARD

A/I
--A
A
A
A

File
---/home/ians/projects/hfs0106
/home/ians/projects/hsm41perf
/home/ians/projects/hsm41test
/home/ians/projects/hsm42upg

If you want to query all the current files and directories backed up under a dir
ectory and all its subdirectories you need to add the -subdir=yes option as belo
w:
tsm> q ba /home/ians/projects/*
Size
Backup Date
-------------512 12-09-2011 19:57:09
1,024 08-12-2011 02:46:53
512 12-09-2011 19:57:09
512 24-04-2012 00:22:56
1,024 12-09-2011 19:57:09

-subdir=yes
Mgmt Class A/I
---------- --STANDARD
A
STANDARD
A
STANDARD
A
STANDARD
A
STANDARD
A

File
---/home/ians/projects/hfs0106
/home/ians/projects/hsm41perf
/home/ians/projects/hsm41test
/home/ians/projects/hsm42upg
/home/ians/projects/hfs0106/test

1,024
test2
12,048
les
50,326
0023
50,326
0099
11,013
heck

12-09-2011 19:57:09

STANDARD

A /home/ians/projects/hfs0106/test/

04-12-2011 02:01:29

STANDARD

A /home/ians/projects/hsm41perf/tab

30-04-2012 01:35:26

STANDARD

A /home/ians/projects/hsm42upg/PMR7

27-04-2012 00:28:15

STANDARD

A /home/ians/projects/hsm42upg/PMR7

24-04-2012 00:22:56

STANDARD

A /home/ians/projects/hsm42upg/md5c

Note that file specifications with spaces in them will need to be quoted. Thus t
o query all the files backed up under C:\My Documents and any sub-directories be
low it, the following input would be required:
tsm> q ba "C:\My Documents\*" -subdir=yes
By default only the current versions of files are listed. In order to query both
current active and previous inactive versions of files, add the -inactive optio
n to the query:
tsm> q ba /home/ians/projects/*
Size
Backup Date
-------------512 12-09-2011 19:57:09
1,024 08-12-2011 02:46:53
512 12-09-2011 19:57:09
512 24-04-2012 00:22:56
1,024 12-09-2011 19:57:09
1,024 12-09-2011 19:57:09
test2
12,048 04-12-2011 02:01:29
les
8,448 03-12-2011 01:31:18
les
50,326 30-04-2012 01:35:26
0023
50,326 27-04-2012 00:28:15
0099
11,013 24-04-2012 00:22:56
heck
11,013 23-04-2012 17:10:08
heck

-subdir=yes -inactive
Mgmt Class A/I File
---------- --- ---STANDARD
A /home/ians/projects/hfs0106
STANDARD
A /home/ians/projects/hsm41perf
STANDARD
A /home/ians/projects/hsm41test
STANDARD
A /home/ians/projects/hsm42upg
STANDARD
A /home/ians/projects/hfs0106/test
STANDARD
A /home/ians/projects/hfs0106/test/
STANDARD

A /home/ians/projects/hsm41perf/tab

STANDARD

I /home/ians/projects/hsm41perf/tab

STANDARD

A /home/ians/projects/hsm42upg/PMR7

STANDARD

A /home/ians/projects/hsm42upg/PMR7

STANDARD

A /home/ians/projects/hsm42upg/md5c

STANDARD

I /home/ians/projects/hsm42upg/md5c

Note how the previous versions of files are marked by an I (for Inactive) in the
A/I column.
Unix and Linux users should be aware of potential confusion of how TSM stores fi
les in nested file spaces. This can arise in the following situation: A user bac
ks-up a file myconf.txt on the /usr partition in the /usr/local/etc directory. S
ubsequently, a new disk partition is mounted at /usr/local, or it is defined as
a virtualmountpoint. Running the command:
tsm> q ba /usr/local/etc/*
will not list the myconf.txt file. This is because TSM always looks for a file i
n the filespace (partition) with the longest name that matches the file specific
ation you include in the command. In the above example, the file was not backed
up under the /usr/local filespace but under the /usr filespace. To tell TSM to l
ook for a file in latter filespace you must specify the filespace explicitly usi

ng braces, as below:
tsm> q ba {/usr}/local/etc/*
5. Backing up your data
5.1. Backing up local disks
The basic syntax for backing up local disk volumes is dsmc backup-type disk volu
me(s), where backup-type is one of incremental or selective. We recommend increm
ental backups only; selective backups cause data to be sent even if it already e
xists on the HFS. By default, if the disk volume is omitted, TSM will backup tho
se volumes specified by the Domain option in the dsm.opt options file. If Domain
is set to All-Local, then to backup all local volumes enter:
tsm> incr
where incr is an abbreviation for incremental.
To incrementally back up specific volumes enter:
tsm>
tsm>
tsm>
tsm>

incr
incr
incr
incr

C: D: F:
/
/ /usr /usr/local /home
NDS: USR: SYS: APPS:

**
**
**
**

Windows
Mac
Unix/Linux
Netware

To run an incremental by date backup of the above, add the -incrbydate option, a
s in:
tsm> incr C: D: F: -incrbydate
To back up entire disk volumes irrespective of whether files have changed since
the last backup, use the selective command with a wildcard and -subdir=yes as be
low:
tsm>
tsm>
tsm>
tsm>

sel
sel
sel
sel

C:\* D:\* F:\*

/*
/* /usr/* /home/*
USR:* SYS:* APPS:*

-su=yes
-su=yes
-su=yes
-su=yes

**
**
**
**

Windows
Mac
Unix/Linux
Netware

5.2. Backing up selected files

The basic syntax for backing up selected files is similar to that for backing up
disk partitions. Be aware, however, that you cannot use wildcards in directory/
folder names:
tsm> incr /home/ians/projects/hsm*/* -su=yes
ANS1071E Invalid domain name entered: '/home/ians/projects/hsm*/*'
tsm> sel /home/ians/projects/hsm*/* -su=yes
Selective Backup function invoked.
ANS1081E Invalid search file specification '/home/ians/projects/hsm*/*' entered
You can, however, enter several file specifications on the command line, as belo
w:
** Windows **

tsm> incr "C:\My Documents\Word docs\*" "C:\My Documents\html docs\*" -su=yes

** Mac **
tsm> incr /Users/ians/* /Users/test/* -su=yes
** Linux/Unix **
tsm> incr /home/ians/projects/hsm41test/* /home/ians/projects/hsm41perf/* -su=y
es
** Netware **
tsm> incr USR:ians/projects/tsm/* "USR:ians/projects/new html/*" -su=yes
6. Restoring your data
The basic syntax for restoring your data is dsmc restore source-file destination
-file. If the destination-file is omitted then TSM will restore the file(s) to t
heir original location. Be aware that, as with backup, you cannot use wildcards
in directory/folder names. By default, TSM will restore the most current active
version of a file.
6.1. Restoring selected files
** Windows **
tsm> rest "C:\My Documents\Word docs\mydoc.doc" "C:\My Documents\restore\"
tsm> rest "C:\My Documents\Word docs\mydoc.doc" "C:\My Documents\restore\myoldd
oc.doc"
** Mac **
tsm> rest /Users/ians/myfile.txt /Users/ians/restore/
tsm> rest /Users/ians/myfile.txt /Users/ians/restore/myoldfile.txt
** Linux/Unix **
tsm> rest /home/ians/myfile.txt /home/ians/restore/
tsm> rest /home/ians/myfile.txt /home/ians/restore/myoldfile.txt
** Netware **
tsm> rest USR:ians/myfile.txt* "USR:ians/restore/"
tsm> rest USR:ians/myfile.txt* "USR:ians/restore/myoldfile.txt"
Note from the first example of each restore above that in order to specify a dir
ectory as a destination, you need a trailing / (slash) at the end of the destina
tion-filespec. Otherwise TSM may overwrite a file of the same name. The second e
xample demonstrates a filename in the destination-filespec.
Restores of single files cannot be restarted if interrupted. In this case you wi
ll need to restore the file afresh.
6.2. Restoring multiple files and directories
** Windows **
tsm> rest "C:\My Documents\Word docs\*" "C:\My Documents\restore\" -su=yes
** Mac **

tsm> rest /Users/ians/projects/hsm41test/* /Users/ians/projects/restore/ -su=ye

s
** Linux/Unix **
tsm> rest /home/ians/projects/hsm41test/* /home/ians/projects/restore/ -su=yes
** Netware **
tsm> rest USR:ians/projects/tsm/* "USR:ians/projects/restore/" -su=yes
Note that in order to restore a full directory and the contents of all its sub-d
irectories you need the -su=yes option. It is always good practice to terminate
the destination-filespec with a trailing / (slash) if the element in the destina
tion-filespec is a directory.
As this restore is wild-carded, it can be restarted if interrupted due to user i
nput (Ctrl-C), server error or communications error. Restartable restores can be
queried via q rest and will restart at the point of interruption.
6.3. Restoring entire partitions
Essentially, the syntax is the same as in 'Restoring multiple files and director
ies' above. However, the obvious caveats are to ensure enough space in the desti
nation partition and to allow enough time.
** Windows **
tsm> rest C:\* D:\restore\" -su=yes
** Mac **
tsm> rest /Users/* /tmp/restore/ -su=yes
** Linux/Unix **
tsm> rest /home/* /tmp/restore/ -su=yes
** Netware **
tsm> rest USR:* USR:restore/ -su=yes
As with 'Restoring multiple files and directories' above, this restore is wild-c
arded and thus can be restarted if interrupted.
6.4. Restoring old and/or deleted files
As with the GUI, TSM does not, by default, list or restore old and deleted inact
ive versions of files and directories. If you need to restore such a file, you n
eed the -inactive -pick options. The -pick option, while not strictly necessary,
causes TSM to display a list of files from which to pick. Issuing a restore as
below will display the following pick window:
tsm> rest /home/ians/projects/* /tmp/restore/ -su=yes -inactive -pick
TSM Scrollable PICK Window - Restore
#
Backup Date/Time
File Size A/I File
------------------------------------------------------------------------------------------------170. | 12-09-2011 19:57:09
650 B A /home/ians/projects/hsm41test/i
nclexcl.test

171. | 12-09-2011 19:57:09

2.74 KB A /home/ians/projects/hsm41test/i
nittab.ORIG
172. | 12-09-2011 19:57:09
2.74 KB A /home/ians/projects/hsm41test/i
nittab.TEST
173. | 12-09-2011 19:57:09
1.13 KB A /home/ians/projects/hsm41test/m
d5.out
174. | 30-04-2012 01:35:26
512 B A /home/ians/projects/hsm42125upg
/PMR70023
175. | 26-04-2012 01:02:08
512 B I /home/ians/projects/hsm42125upg
/PMR70023
176. | 27-04-2012 00:28:15
512 B A /home/ians/projects/hsm42125upg
/PMR70099
177. | 24-04-2012 19:17:34
512 B I /home/ians/projects/hsm42125upg
/PMR70099
178. | 24-04-2012 00:22:56
1.35 KB A /home/ians/projects/hsm42125upg
/dsm.opt
179. | 24-04-2012 00:22:56
4.17 KB A /home/ians/projects/hsm42125upg
/dsm.sys
180. | 24-04-2012 00:22:56
1.13 KB A /home/ians/projects/hsm42125upg
/dsmmigfstab
181. | 24-04-2012 00:22:56
7.30 KB A /home/ians/projects/hsm42125upg
/filesystems
182. | 24-04-2012 00:22:56
1.25 KB A /home/ians/projects/hsm42125upg
/inclexcl
183. | 24-04-2012 00:22:56
198 B A /home/ians/projects/hsm42125upg
/inclexcl.dce
184. | 24-04-2012 00:22:56
291 B A /home/ians/projects/hsm42125upg
/inclexcl.ox_sys
185. | 24-04-2012 00:22:56
650 B A /home/ians/projects/hsm42125upg
/inclexcl.test
186. | 24-04-2012 00:22:56
670 B A /home/ians/projects/hsm42125upg
/inetd.conf
187. | 24-04-2012 00:22:56
2.71 KB A /home/ians/projects/hsm42125upg
/inittab
188. | 24-04-2012 00:22:56
1.00 KB A /home/ians/projects/hsm42125upg
/md5check
189. | 24-04-2012 00:22:56
79.23 KB A /home/ians/projects/hsm42125upg
/mkreport.020423.out
190. | 24-04-2012 00:22:56
4.27 KB A /home/ians/projects/hsm42125upg
/ssamap.020423.out
191. | 26-04-2012 01:02:08
12.78 MB A /home/ians/projects/hsm42125upg
/PMR70023/70023.tar
192. | 25-04-2012 16:33:36
12.78 MB I /home/ians/projects/hsm42125upg
/PMR70023/70023.tar
0---------10--------20--------30--------40--------50--------60--------70
--------80--------90-<U>=Up <D>=Down <T>=Top <B>=Bottom <R#>=Right <L#>=Left
<G#>=Goto Line # <#>=Toggle Entry <+>=Select All <->=Deselect All
<#:#+>=Select A Range <#:#->=Deselect A Range <O>=Ok <C>=Cancel
pick>
You are now in the pick interface and can select individual files to restore via
the number to the left, scroll up or down via U and D as described at the botto
m of each listing of files.
Remember to issue the destination-filespec with the original restore command if
you want to prevent overwriting current versions of files with older versions.
7. Restoring your data to another machine
In certain circumstances, it may be necessary to restore some, or all, of your d

ata onto a machine other than the original from which it was backed up. Ideally
the machine platform should be identical to that of the original machine. Where
this is not possible or practical please note that restores are only possible fo
r partition types that the operating system supports. Thus a restore of an NTFS
partition to a Windows 9x machine with just FAT support may succeed but the file
permissions will be lost. Please do not attempt cross-platform restores, e.g. b
y trying to restore files onto a Windows machine that have previously been backe
d up with a non-Windows one: using TSM for Windows to try to access backups sent
by other OS platforms can cause those backups to become inaccessible from the h
ost system.
To restore your data to another machine you will need the TSM software installed
on the target machine. Entries in dsm.sys and/or dsm.opt will need to be edited
if the node that you are restoring from does not reside on the same HFS server
as the one that you are restoring to. Please see our help page section on TSM co
nfiguration files for their locations for your operating system. To check which
HFS server is required, please go to View TSM Client Details, where the listed H
FS Server will be the one needed for the Servername field in both dsm.sys (Mac/U
nix/Linux only) and dsm.opt (all operating systems). If you do need to edit thes
e files, it is recommended that you first of all make copies so that you can get
your old settings back later. The other two values which need to be changed are
TCPServer and TCPPort, in dsm.sys (Mac/Unix/Linux) or dsm.opt (Windows/Netware)
: these can be got from our page on connecting to the HFS through a firewall, wh
ere the relevant fields are in the 'DNS Name' and 'Port' columns respectively.
To access files from another machine you should then start the TSM client as bel
ow:
dsmc -virtualnodename=DEAD.MACHINE
load dsmc -virtualnodename=DEAD.MACHINE

** Windows, Mac, Unix/Linux

** Netware

where DEAD.MACHINE should be substituted for the nodename of the machine to be r

estored. You will then be prompted for the TSM password for this machine.
Querying and restoring the filestore is then as in the previous section, 6. Rest
oring your data. You will probably want to restore to a different destination to
the original files to prevent overwriting files on the local machine, as below:
tsm> rest D:\* D:\RESTORE\
-su=yes ** Windows
tsm> rest /home/* /scratch/
-su=yes ** Mac, Unix/Linux
tsm> rest SOURCE-SERVER\USR:* USR:restore/ -su=yes ** Netware
8. Authorizing another machine to restore your files
If you are responsible for a number of TSM client machines, you can protect agai
nst the loss of one machine by authorizing a different machine(s) to restore bac
kup versions of your files. The basic syntax for this is set access backup files
pec node username. Thus to grant the root user on machine ANOTHER.NODE access to
restore the /home filespace, you would issue the following:
tsm> set acc backup /home/*/* another.node root
The equivalent commands on Windows and Netware machines would look like:
tsm> set acc backup c:\* another.pc system
tsm> set acc backup USR:* another.svr root

** Windows
** Netware

The current access list can be queried and deleted using the query acc and delet
e acc commands.

Once access has been granted from another machine, you can query and restore fil
es from that machine to your local machine using the -fromnode option, as below:
tsm> q files -fromnode=ANOTHER.NODE
tsm> rest -fromnode=ANOTHER.NODE /home/*/* /home/restore/
9. Changing your TSM password
The TSM password is set to expire approximately one year after registration and
at one-yearly intervals after that. Prior to this automatic expiry, you will be
contacted to remind you to re-set this password. Note that even if you have the
option
PASSWORDACCESS Generate
set in your options file, it is recommended you manually re-set your TSM passwor
d. To do this at the tsm> prompt enter:
tsm> set password oldpassword newpassword