Tivoli Storage Manager Quick Reference for the Backup-Archive Clients


Windows Backup-Archive Client


Starting a TSM GUI Session

To start a TSM GUI session, use one of the following methods:

Performing a GUI Backup

To run a GUI backup, perform the following steps:

  1. Click on Backup from the TSM main window.
  2. Expand the directory tree. Select the object that you want to back up. To search or filter files, click the Search icon from the tool bar.
  3. Select the type of backup from the pull-down menu:
  4. To modify specific backup options click the Backup Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  5. Click on Backup. The Task List window displays backup processing status.

Restoring Backup Versions

To run a GUI restore, perform the following steps:

  1. Click on Restore from the TSM main window.
  2. Expand the directory tree. Select the object that you want to restore. To search or filter files, click the Search icon from the tool bar.

    To restore a backup set:

    1. Expand the Backup Sets directory tree object.
    2. To restore the backup set from a local device, expand the Local object and specify the local device.
    3. To restore a backup set from the server, expand the Server object and select the desired backup set name.
    4. To restore specific objects, expand the backup set, and select the objects to restore.
  3. To modify specific restore options click the Restore Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  4. Click on Restore. Enter the information.
  5. Select Restore.

Performing a GUI Archive

To archive directory or drive files you can use search and filter criteria to locate the files that match that criteria. To search or filter files during an archive operation, perform the following steps:

  1. Click on Archive from the TSM main window. The Archive window displays.
  2. Expand the directory tree. Select the object that you want to archive. To search or filter files, click the Search icon from the tool bar.
  3. In the Description field:
  4. To modify specific archive options click the Archive Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  5. Click on Archive. The Task List window displays the archive processing status.

Retrieving Archives

Retrieve a file when you want to return an archive copy from the TSM server to your workstation. To retrieve an archived file:

  1. Click on Retrieve from the TSM window. The Retrieve window displays.
  2. Expand the directory tree. Select the object you want to retrieve. To search or filter files, click the Search icon from the tool bar.
  3. To modify specific retrieve options, click the Retrieve Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  4. Click the Retrieve button. The Retrieve Destination window displays. Enter the appropriate information.
  5. Click on Retrieve. The Task List window displays the retrieve processing status.

Displaying GUI Online Help

To display GUI online help, do one of the following:

Ending a GUI Session

Starting the TSM Scheduler

To start the TSM Scheduler, use one of the following methods:

To display information about scheduled work for your client node, enter:

   dsmc query schedule

To display information about completed work for your client node: Check the dsmsched.log file in the current directory.

To stop the scheduler: Enter q.


Starting a TSM Command Line Session

To start a command line session, do one of the following::

Performing a Command Line Backup

Restoring Backup Versions

To run a command line restore:

Note:You can use wildcard characters to restore groups of files, or entire directories.

Performing a Command Line Archive

Use the archive command to archive a single file, a group of files, or all files in a directory and its subdirectories. If you want to archive all the files in a directory and its subdirectories, use the subdir=yes option. For example, to archive the files in the d:\proj directory and its subdirectories, enter:

   dsmc archive d:\proj\ -subdir=yes

You can use more than one file specification with the archive command. For example, to archive the a:\h1.doc and a:\test.doc files, enter:

   dsmc archive a:\h1.doc a:\test.doc

Use the description option to assign a description to the archive, as follows:

   dsmc archive a:\h1.doc -description="chapter 1, first version"

Retrieving Archives

You can use the retrieve command to retrieve files or directories. Enter the file name you want to retrieve and its destination. If you do not indicate a destination, the files are retrieved to their original location. For example, to retrieve the c:\doc\h1.doc file to its original directory; enter:

   dsmc retrieve c:\doc\h1.doc

To retrieve this file under a new name, enter:

   dsmc retrieve c:\doc\h1.doc c:\doc\h2.doc

Use the pick option to display a list of archive copies from which you can select. If you retrieve a file to a disk that has a different label than the disk from which the file was archived, use the file space name (drive label) of the archive disk instead of the drive letter. For example, if you archived a file from the a: drive on the diskette workathome, and you are retrieving it to a diskette labeled extra in the a: drive, enter:

   dsmc retrieve {workathome}\doc\h1.doc a:\doc\h1.doc

Displaying Command Line Help

To display command line help, enter the following command:

   dsmc help

Using the Web Client

You can use the Web client to perform backup, archive, restore, and retrieve operations from any machine, or platform that supports a Java 1.1.6-capable browser, such as Netscape Navigator 4.06 or higher, and Microsoft Internet Explorer 4.01 or higher. Using the Web client, you can back up and restore your own data, or a TSM administrator can centralize the backup or restore operations of many TSM clients. To use it, you can specify the URL of any TSM client machine that is running the Web client. The Web client is only supported on a server that is Version 3 or higher.

All backup and restore procedures in this chapter are also supported on the Web client. The following functions are not supported by the Web client:

To use the Web client, perform the following steps:

  1. From the TSM GUI, select the Utilities menu> Setup Wizard item.
  2. Select the Help me configure the TSM Web Client checkbox.
  3. Follow the instructions on the screen to configure and use the TSM Web client.

If you want to use the Web client with secure socket layer (SSL) communications, which is supported on Windows 95, and Windows 98, Windows NT 4.0 see the Appendix in Tivoli Storage Manager Installing the Clients, order number SH26-4102, for more information.


Summary of Commands


DSMC ARchive [options] filespec[
DSMC BACKup ACTIVED (For Windows NT) [options] [SERVer=servername]LOGFILE [Yes | No]]
DSMC BACKup CERTSErverdb (For Windows 2000)[options]
DSMC BACKup CLUSTERDB (For Windows 2000) [options]
DSMC BACKup COMPlusdb (For Windows 2000 Professional) [options]
DSMC BACKup Eventlog (For Windows NT) ENTIRE | LOG [APPLICATION | SECURITY | SYSTEM] [options]
DSMC BACKup FRs (For Windows 2000) [options]
DSMC BACKup Registry ENTIRE | MACHINE [CONFIG (95, 98 only)| ENUM (95, 98 only)| HARDWARE (95, 98 only)| NETWORK (95, 98 only)| SAM (NT only)| SECURITY | SOFTWARE | SYSTEM] | USER [CURUSER (NT only)| DEFAULT]
DSMC BACKup RSm [options]
DSMC BACKup SYSFiles [options]
DSMC BACKup SYSVol [options]
DSMC CANcel Restore [options]
DSMC Delete ACcess [options]
DSMC Delete ARchive [options] [{filespacename}] filespec
DSMC Delete Filespace [options]
DSMC Help
DSMC Incremental [options][filespec]
DSMC LOOP [options]
DSMC MAcro macroname
DSMC Query ACcess [options]
DSMC Query ARchive [options] [{filespacename}] filespec
DSMC Query Backup [options] [{filespacename}] filespec
DSMC Query BACKUPSET [options] [backupsetname|filename]
DSMC Query Filespace [options]
DSMC Query Mgmtclass [options]
DSMC Query REStore [options]
DSMC Query SCHedule [options]


DSMC Query SEssion [options]
DSMC RESTArt REStore [options]
DSMC REStore [FILE] [options]&cont. [{filespacename}] sourcefilespec [destinationfilespec]
DSMC REStore ACTIVED (For Windows NT) [options] [SERVer=servername]LOGFILE [Yes | No]]
DSMC REStore BACKUPSET [options] [backupsetname|filename sourcefilespec|"sourcefilespec" [destinationfilespec]
DSMC REStore CERTSErverdb (For Windows 2000)[options]
DSMC REStore CLUSTERDB (For Windows 2000) [options]
DSMC REStore COMPlusdb (For Windows 2000 Professional) [options]
DSMC REStore Eventlog (For Windows NT only) ENTIRE | LOG [APPLICATION | SECURITY | SYSTEM] [destinationfilespec] [options]
DSMC REStore FRs (For Windows 2000) [options]
DSMC REStore Registry ENTIRE | MACHINE [CONFIG (95 only)| ENUM (95 only)| HARDWARE (95 only)| NETWORK (95 only)| SAM (NT only)| SECURITY | SOFTWARE | SYSTEM] | USER [CURUSER (NT only)| DEFAULT] | ACTIVATEKEY [Yes | No]
DSMC REStore RSm [restart]
DSMC RETrieve [options][{filespacename}] sourcefilespec [destinationfilespec]
DSMC SCHedule [options]
DSMC Selective [options] filespec
DSMC REStore SYSFiles [options]
DSMC REStore SYSVol [options]
DSMC SET ACcess [archive | backup] [{filespacename}] filespec|{image} image-fs node [user] [options]
DSMC SET Password [oldpw newpw] [options]


For Further Information


For more information, see the following references:
TSM Installing the Clients SH26-4102
TSM for Windows Using the Backup-Archive Clients SH26-4101
DSM.SMP, DSM.OPT (online files)
README.1ST, READMES\*.TXT (online files)


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]