Tivoli Storage Manager (TSM) is a client-server licensed product that provides storage management services in a multiplatform 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, TSM includes the following programs available on a variety of platforms:
Associated with TSM is the Tivoli Space Manager client program which was previously a feature of ADSM known as Hierarchical Storage Manager (HSM). 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 the following operating systems:
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.
TSM books are translated into other languages. Contact your TSM 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 TSM 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 TSM option. The bold type is used
to introduce the option, or in an example. All other times in the text
it appears as regular font.
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 appear on a display 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. TSM Client Publications
Short Title | Publication Title | Order Number |
---|---|---|
TSM Messages | Tivoli Storage Manager Messages | GC35-0382 |
TSM Installing the Clients | Tivoli Storage Manager Installing the Clients | SH26-4102 |
TSM for Windows Using the Backup-Archive Clients | Tivoli Storage Manager for Windows Using the Backup-Archive Clients | SH26-4101 |
TSM for NetWare Using the Backup-Archive Client | Tivoli Storage Manager for NetWare Using the Backup-Archive Client | SH26-4100 |
TSM for UNIX Using the Backup-Archive Clients | Tivoli Storage Manager for UNIX Using the Backup-Archive Clients | SH26-4105 |
Using the UNIX HSM Clients | ADSTAR Distributed Storage Manager Using the UNIX Hierarchical Storage Management Clients | SH26-4083 |
TSM AFS/DFS Backup Clients | Tivoli Storage Manager AFS/DFS Backup Clients | SH26-4106 |
Using the API | Tivoli Storage Manager Using the Application Programming Interface | SH26-4107 |
TSM Reference Cards for the Backup-Archive Clients | Tivoli Storage Manager Reference Cards for the Backup-Archive Clients | SX26-6021 |
TSM Trace Facility Guide | Tivoli Storage Manager Trace Facility Guide | SH26-4104 |
TSM for AIX Quick Start | Tivoli Storage Manager for AIX Quick Start | GC35-0367 |
TSM for AS/400 Quick Start | Tivoli Storage Manager for AS/400 Quick Start | GC35-0317 |
TSM for HP-UX Quick Start | Tivoli Storage Manager for HP-UX Quick Start | GC35-0370 |
TSM for MVS and OS/390 Quick Start | Tivoli Storage Manager for MVS and OS/390 Quick Start | GC35-0376 |
TSM for Sun Solaris Quick Start | Tivoli Storage Manager for Sun Solaris Quick Start | GC35-0373 |
TSM for Windows NT Quick Start | Tivoli Storage Manager for Windows NT Quick Start | GC35-0379 |
TSM publications are available in softcopy on the following CD-ROMs:
TSM publications are available in softcopy on the TSM Web site at the following URL:
http://www.tivoli.com/tsm
The IBM International Technical Support Center redbooks are available in softcopy on the IBM Redbooks Web site at the following URL:
http://www.redbooks.ibm.com
You can order hardcopies of all our publications from the IBM Direct Publications Catalog Web site at the following URL:
http://www.elink.ibmlink.ibm.com/pbl/pbl
Follow these links in the order given, making the appropriate choices when prompted: