Tivoli Header

Administrator's Reference

IMPORT POLICY (Import Policy Information)

Use this command to import policy domain information from sequential export media to the Tivoli Storage Manager server.

Tivoli Storage Manager client data can be moved between servers with export and import processing, if the same removable media type is supported on both platforms.

You can use the QUERY ACTLOG command to view the status of the import operation. You can also view this information from the server console.

This command generates a background process that can be cancelled with the CANCEL PROCESS command. If an IMPORT POLICY background process is cancelled, some of the data is already imported. To display information on background processes, use the QUERY PROCESS command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

                  .-*---------------.
>>-IMport Policy--+-----------------+--------------------------->
                  |.-,-----------.  |
                  |V             |  |
                  '--domain_name-+--'
 
   .-Preview--=--No------.
>--+---------------------+--DEVclass=device_class_name---------->
   '-Preview--=--+-No--+-'
                 '-Yes-'
 
                     .-,-----------.
                     V             |
>--VOLumenames--=--+---volume_name-+-+-------------------------->
                   '-FILE:file_name--'
 
   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------><
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'
 
 

Parameters

domain_name
Specifies the policy domains for which information is to be imported. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names. The default (*) is all policy.

Preview
Specifies whether you want to preview the results of the import operation without importing information. The PREVIEW=YES option requires that you mount the export volumes. This parameter is optional. The default value is NO. The values are:

No
Specifies that the information is to be imported.

Yes
Specifies that the operation will be previewed but not performed. Information is reported to the server console and the activity log.

DEVclass (Required)
Specifies the device class from which import data is to be read. You cannot specify the DISK device class or a device class with a device type of NAS.

If all drives for the device class are busy when the import runs, Tivoli Storage Manager cancels lower priority operations, such as reclamation, to make a drive available.

VOLumenames (Required)
Specifies the volumes to be used for the import operation. Volumes must be imported in the same order as they were exported. The values are:

volume_name
Specifies the volume name. To specify multiple volumes, separate the names with commas and no intervening spaces.

FILE:file_name
Specifies the name of a file that contains a list of volumes. In the file, each volume name must be on a separate line. Blank and comment lines that begin with an asterisk are ignored.

Use these naming conventions when specifying volumes associated with the following device types:

For this device Specify
TAPE 1 - 6 alphanumeric characters.
FILE Any fully qualified file name string. An example is /imdata/mt1.
OPTICAL 1-32 alphanumeric characters.
REMOVABLEFILE 1-6 alphanumeric characters.
SERVER 1-250 alphanumeric characters.

 

Replacedefs
Specifies whether to replace policy definitions on the target server. The default value is NO. The values are:

Yes
Specifies that objects are to be replaced by the imported objects.

No
Specifies that objects are not to be replaced by imported objects.

Examples

Task 1

From the server, import the information for all defined policies from tape volumes TAPE01, TAPE02, and TAPE03. Specify that these tape volumes be read by a device assigned to the MENU1 device class.

Command:
import policy devclass=menu1 
volumenames=tape01,tape02,tape03

Task 2

From the server, import the information for all defined policies from tape volumes listed in a file named TAPEVOL. This file contains these lines:

TAPE01
TAPE02
TAPE03

Specify that these tape volumes be read by a device assigned to the MENU1 device class.

Command:
import policy devclass=menu1 volumenames=file:tapevol

Related Commands

Table 143. Commands Related to IMPORT POLICY

Command Description
CANCEL PROCESS Cancels a background server process.
EXPORT POLICY Copies policy information to external media.
IMPORT ADMIN Restores administrative information from external media.
IMPORT NODE Restores client node information from external media.
IMPORT SERVER Restores all or part of the server from external media.
QUERY ACTLOG Displays messages from the server activity log.
QUERY PROCESS Displays information about background processes.


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