Tivoli Storage Manager is a client-server licensed product that provides storage management services in a multi-platform computer environment. The backup-archive client program permits users to back up and archive files from their workstations or file servers to storage, and restore and retrieve backup versions and archived copies of files to their local file systems.
In addition to the backup-archive client, Tivoli Storage Manager includes the following programs available on a variety of platforms:
Associated with Tivoli Storage Manager, but sold separately, is the Tivoli Space Manager client program which was previously a feature of ADSM known as Hierarchical Storage Manager (HSM). This publication provides information about the Tivoli Space Manager client. Tivoli Space Manager automatically migrates eligible files to storage to maintain specific levels of free space on local file systems and automatically recalls migrated files when they are accessed. It also permits users to migrate and recall specific files. This client program runs only on AIX and Solaris operating systems. For specific software requirements, see the README file that is shipped on the product installation media.
The terms hierarchical storage management and space management have the same meaning throughout this publication.
Tivoli Storage Manager tasks that can only be performed by authorized users and root users are identified by the phrases, Authorized User and root user. An Authorized User is any user running with a real user ID of 0 (root) or a user who owns an executable whose owner execution permission bit is set to s. In the following example, the user tivoli is an Authorized User while running dsmc since the dsmc owner execution permission bit is set to s:
-rwsr-xr-x 1 tivoli dsmdev 2880479 Nov 5 13:42 dsmc*
This book provides information to help you set up and use the backup-archive client on your workstation. You should be familiar with your workstation, your operating system, and your basic system administration.
Tivoli Storage Manager books are translated into other languages. Contact your Tivoli Storage Manager representative for a list of available translations.
This book uses the following typographical conventions:
Table 1. Typographical Conventions
Example | Description |
---|---|
autoexec.ncf | A series of lowercase letters with an extension indicates Tivoli Storage Manager program file names. |
archive | Boldface type indicates a command that you type at a workstation, such as a command you type on a command line. |
dateformat | Boldface italic type indicates a Tivoli Storage Manager option.
The bold type is used to introduce the option, or used in an example.
All other times in the text it appears as regular type.
Occasionally, file names are entered in boldface italic for emphasis. |
filespec | Italicized type indicates either the name of a parameter, a new term, or
a placeholder for information that you provide.
Italics are also used for emphasis in the text. |
maxcmdretries | Monospaced type represents fragments of a program or information as it would display on a screen. |
plus sign (+) | A plus sign between two keys indicates you should press both keys at the same time. |
This section describes how to read the syntax diagrams used in this book. To read a syntax diagram, follow the path of the line. Read from left to right, and top to bottom.
Syntax items, such as a keyword or variable, can be:
Syntax Diagram Description | Example |
---|---|
Abbreviations:
Uppercase letters denote the shortest acceptable truncation. If an item appears entirely in uppercase letters, it cannot be truncated. You can type the item in any combination of uppercase or lowercase letters. In this example, you can enter KEYWO, KEYWORD, or KEYWOrd. |
>>-KEYWOrd----------------------------------------------------->< |
Symbols:
Enter these symbols exactly as they appear in the syntax diagram. |
|
Variables:
Italicized lowercase items (var_name) denote variables. In this example, you can specify a var_name when you enter the KEYWORD command. |
>>-KEYWOrd--var_name------------------------------------------->< |
Repetition:
An arrow returning to the left means you can repeat the item. A character or space within the arrow means you must separate repeated items with that character or space. A footnote by the arrow references the number of times you can repeat the item. |
.--------. V | >>---repeat-+--------------------------------------------------><
.-,------. V | >>---repeat-+--------------------------------------------------><
.-------------. V (1) | >>---repeat------+---------------------------------------------><
Notes:
|
Required Choices:
When two or more items are in a stack and one of them is on the line, you must specify one item. In this example, you must choose A, B, or C. |
>>-+-A-+------------------------------------------------------->< +-B-+ '-C-' |
Optional Choice:
When an item is below the line, that item is optional. In the first example, you can choose A or nothing at all. When two or more items are in a stack below the line, all of them are optional. In the second example, you can choose A, B, C, or nothing at all. |
>>-+---+------------------------------------------------------->< '-A-'
>>-+---+------------------------------------------------------->< +-A-+ +-B-+ '-C-' |
Defaults:
Defaults are above the line. The default is selected unless you override it. You can override the default by including an option from the stack below the line. In this example, A is the default. You can override A by choosing B or C. You can also specify the default explicitly. |
.-A-. >>-+---+------------------------------------------------------->< +-B-+ '-C-' |
Repeatable Choices:
A stack of items followed by an arrow returning to the left means you can select more than one item or, in some cases, repeat a single item. In this example, you can choose any combination of A, B, or C. |
.-------. V | >>---+-A-+-+--------------------------------------------------->< +-B-+ '-C-' |
Syntax Fragments:
Some diagrams, because of their length, must fragment the syntax. The fragment name appears between vertical bars in the diagram. The expanded fragment appears between vertical bars in the diagram after a heading with the same fragment name. |
>>-| The fragment name |--------------------------------------->< The fragment name .-A-. |--+---+--------------------------------------------------------| +-B-+ '-C-' |
Included here is a list of the publications that are referred to in this
manual.
Table 2. Tivoli Storage Manager Client Publications
Publication Title | Order Number |
---|---|
Tivoli Storage Manager Messages | GC35-0405 |
Tivoli Storage Manager Installing the Clients | SH26-4119 |
Tivoli Storage Manager for Windows Using the Backup-Archive Clients | SH26-4117 |
Tivoli Storage Manager for NetWare Using the Backup-Archive Client | SH26-4116 |
Tivoli Storage Manager for UNIX Using the Backup-Archive Clients | SH26-4122 |
Tivoli Space Manager for Unix Using the Hierarchical Storage Management Clients | SH26-4115 |
Tivoli Storage Manager for Windows Managed System for SAN Storage Agent User's Guide | GC35-0434 |
Tivoli Storage Manager for AIX Managed System for SAN Storage Agent User's Guide | GC36-0001 |
Tivoli Storage Manager for Sun Solaris Managed System for SAN Storage Agent User's Guide | GC36-0002 |
Tivoli Storage Manager Using the Application Programming Interface | SH26-4123 |
Tivoli Storage Manager Quick Reference for the Backup-Archive Clients | SH26-4118 |
Tivoli Storage Manager Trace Facility Guide | SH26-4121 |
Tivoli Storage Manager for AIX Quick Start | GC35-0402 |
Tivoli Storage Manager for AS/400 Quick Start | GC35-0317 |
Tivoli Storage Manager for HP-UX Quick Start | GC35-0412 |
Tivoli Storage Manager for OS/390 and z/OS Quick Start | GC35-0415 |
Tivoli Storage Manager for Sun Solaris Quick Start | GC35-0406 |
Tivoli Storage Manager for Windows Quick Start | GC35-0409 |
The Tivoli Storage Manager publications are available on the following
CD-ROM:
Tivoli Storage Manager Publications Version 4.2, SK3T-1417
Tivoli Storage Manager publications are available in softcopy at the following Web page:
http://www.tivoli.com/support/public/Prodman/public_manuals/ storage_mgr/admanual.htm
The IBM International Technical Support Center redbooks are available in softcopy on the IBM Redbooks Web site at the following Web page:
http://www.redbooks.ibm.com
You can order hardcopies of all our publications from the IBM Direct Publications Catalog Web site at the following Web page:
http://www.elink.ibmlink.ibm.com/pbl/pbl