EXPORT POLICY (Export policy information to sequential media)

Use this command to export policy information from an IBM® Tivoli® Storage Manager server to sequential media for later import to another server.

Privilege class

To issue this command, you must have system privilege.

Syntax


                  .-*---------------.   
>>-EXPort Policy--+-----------------+--------------------------->
                  | .-,-----------. |   
                  | V             | |   
                  '---domain_name-+-'   

   .-Preview--=--No--------------.   
>--+-----------------------------+------------------------------>
   |         (1) (2)             |   
   '-Preview----------=--+-No--+-'   
                         '-Yes-'     

>--+------------------------------------+----------------------->
   |          (1)                       |   
   '-DEVclass------=--device_class_name-'   

   .-Scratch--=--Yes---------.   
>--+-------------------------+---------------------------------->
   |         (2)             |   
   '-Scratch------=--+-Yes-+-'   
                     '-No--'     

>--+------------------------------------------+----------------->
   |                       .-,-----------.    |   
   |             (2)       V             |    |   
   '-VOLumenames------=--+---volume_name-+--+-'   
                         '-FILE:--file_name-'     

>--+------------------------------+----------------------------><
   '-USEDVolumelist--=--file_name-'

Notes:

If PREVIEW=NO, a device class must be specified.
If PREVIEW=NO and SCRATCH=NO, one or more volumes must be specified.

Parameters

domain_name

Specifies the policy domains for which information is to be exported. This parameter is optional. The default is all policy domains. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names.

Preview

Specifies whether to preview the results of the export operation, without exporting information. You can use this parameter to preview how many bytes of data are transferred so that you can determine how many volumes are required. This parameter supports the following values:

No: Specifies that the policy information is to be exported. If you specify this value, you must also specify a device class.
Yes: Specifies that the operation is previewed but not completed. Information is reported to the server console and the activity log. If you specify this value, you do not need to specify a device class.

This parameter is optional. The default value is NO.

DEVclass

Specifies the device class to which export data is to be written. This parameter is required if you specify PREVIEW=NO.

You cannot specify the DISK, NAS, or CENTERA device classes.

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

Tip: You can export data to a storage pool on another server by specifying a device class whose device type is SERVER.

Scratch

Specifies whether scratch volumes can be used. The default value is YES. You can specify one of the following values:

Yes: Specifies that scratch volumes can be used for export. If you also specify a list of volumes, scratch volumes are used only if there is not enough space on the volumes specified.
No: Specifies that scratch volumes cannot be used for export. To determine how many volumes you might need, you can run the command specifying PREVIEW=YES.

VOLumenames

Specifies the volumes to be used to contain exported data. This parameter is optional, unless you specify SCRATCH=NO and PREVIEW=NO. If you do not specify a volume name, scratch volumes are used.

You can specify one of the following values:

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. For example: /imdata/mt1. d:\program files\tivoli\tsm\data1.dsm.
REMOVABLEFILE	1-6 alphanumeric characters.
SERVER	1-250 alphanumeric characters.

USEDVolumelist

Specifies the file where a list of volumes used in the export operation are stored. This parameter is optional.

This file can be used in the import operation. This file contains comment lines with the date and time the export was done, and the command issued to create the export.

Attention: If you specify an existing file, the file is overwritten.

Example: Export policy information to specific tape volumes

From the server, export policy information to tape volumes TAPE01, TAPE02, and TAPE03. Specify that these tape volumes be read by a device that is assigned to the MENU1 device class.

export policy devclass=menu1 
volumenames=tape01,tape02,tape03

Example: Export policy information to tape volumes listed in a file

From the server, export policy information to tape volumes that are listed in the following file:

TAPEVOL
TAPEVOL.DATA

This file contains the following lines:

TAPE01
TAPE02
TAPE03

Specify that these tape volumes be used by a device that is assigned to the MENU1 device class. Issue the following command: AIX operating systems

export policy devclass=menu1 volumenames=file:tapevol

export policy devclass=menu1 volumenames=file:tapevol.data