Tivoli Header

Administrator's Reference

QUERY BACKUPSETCONTENTS (Query Contents of a Backup Set)

Use this command to display information about the files and directories contained in a client node's backup set.

Be aware that processing this command can use considerable network resources and mount points.

Privilege Class

To issue this command, you must have system privilege or policy privilege for the domain to which the client node is assigned.

Syntax

>>-Query BACKUPSETCONTENTS--node_name--backup_set_name---------><
 
 

Parameters

node_name (Required)
Specifies the name of the client node whose data is contained in the backup set to display. The name you specify cannot contain wildcard characters nor can it be a list of node names separated by commas.

backup_set_name (Required)
Specifies the name of the backup set to display. The name you specify cannot contain wildcard characters nor can it be a list of node names separated by commas.

Examples

Task

Display the contents from backup set named PERS_DATA.3099 belonging to client node JANE.

Command:
query backupsetcontents jane pers_data.3099

Output:
 
+--------------------------------------------------------------------------------+
|Node Name                Filespace  Client's Name for File                      |
|                         Name                                                   |
|------------------------ ---------- ------------------------                    |
|JANE                     /srvr      /deblock                                    |
|JANE                     /srvr      /deblock.c                                  |
|JANE                     /srvr      /dsmerror.log                               |
|JANE                     /srvr      /dsmxxxxx.log                               |
|JANE                     ...        ......                                      |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

Node Name
Specifies the name of the client node whose data is contained in the backup set.

Filespace Name
Specifies the name of the file space to which the specified file belongs.

File space names and file names that can be in a different code page or locale than the server do not display correctly on the administrator's Web interface or the administrative command-line interface. The data itself is backed up and can be restored properly, but the file space or file name may display with a combination of invalid characters or blank spaces.

If the file space name is Unicode enabled, the name is converted to the server's code page for display. The results of the conversion for characters not supported by the current code page depends on the operating system. For names that TSM is able to partially convert, you may see question marks (??), blanks, unprintable characters, or "...". These characters indicate to the administrator that files do exist. If the conversion is not successful, the name is displayed as "...". Conversion can fail if the string includes characters that are not available in the server code page, or if the server has a problem accessing system conversion routines.

Client's Name for File
Specifies the name of the file.

File space names and file names that can be in a different code page or locale than the server do not display correctly on the administrator's Web interface or the administrative command-line interface. The data itself is backed up and can be restored properly, but the file space or file name may display with a combination of invalid characters or blank spaces.

If the file space name is Unicode enabled, the name is converted to the server's code page for display. The results of the conversion for characters not supported by the current code page depends on the operating system. For names that TSM is able to partially convert, you may see question marks (??), blanks, unprintable characters, or "...". These characters indicate to the administrator that files do exist. If the conversion is not successful, the name is displayed as "...". Conversion can fail if the string includes characters that are not available in the server code page, or if the server has a problem accessing system conversion routines.

Note:
Where the file name is displayed as "......" indicates that both the file path and file name were not successfully converted. An example of the path and name could be:
my\dir\...

Related Commands

Table 167. Commands Related to QUERY BACKUPSETCONTENTS

Command Description
DEFINE BACKUPSET Defines a previously generated backup set to a server.
GENERATE BACKUPSET Generates a backup set of a client's data.
DELETE BACKUPSET Deletes a backup set.
QUERY BACKUPSET Displays backup sets.
UPDATE BACKUPSET Updates a retention value associated with a backup set.


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