Tivoli Header
Administrator's Reference
Use this command to export policy information from a Tivoli Storage Manager
server to sequential media. The server exports administrator
information, such as:
- Policy domain definitions
- Policy set definitions, including the active policy set
- Management class definitions, including the default management class
- Backup copy group and archive copy group definitions
- Schedule definitions for each policy domain
- Client node associations, if the client node exists on the target server
You can use the QUERY ACTLOG command to view the status of the export
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 EXPORT POLICY background process is
cancelled, the sequential media holding the exported data are incomplete and
should not be used for importing data. To display information on
background processes, use the QUERY PROCESS command.
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, allowing you to determine how many volumes will
be required. This parameter is optional. The default value is
NO. The values are:
- 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 will be previewed but not performed.
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.
- DEVclass
- Specifies the device class to which export data is to be written.
This parameter is required, unless you specified PREVIEW=YES. You
cannot specify the DISK device class or a device class with a device type of
NAS.
Notes:
- If all drives for the device class are busy when the export runs, Tivoli
Storage Manager cancels lower priority operations, such as reclamation, to
make a drive available.
- You can export data to a storage pool on another server by specifying a
device class whose device type is SERVER. For details about storing
data on another server, see the Administrator's Guide.
- Scratch
- Specifies whether scratch volumes can be used. The default is
SCRATCH=YES. The values are:
- Yes
- Specifies that scratch volumes can be used for the 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 may 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 SCRATCH=NO and PREVIEW=NO. If you do not
specify a volume name, scratch volumes are used. 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. For example,
d:\program files\tivoli\tsm\data1.dsm.
|
OPTICAL
| 1-32 alphanumeric characters.
|
REMOVABLEFILE
| 1-6 alphanumeric characters.
|
SERVER
| 1-250 alphanumeric characters.
|
- USEDVolumelist
- Specifies a file where a list of volumes used in the export operation will
be stored. This parameter is optional.
This file can be used as input to the export operation. This file
will contain comment lines with the date and time the export was done, and the
command issued to create the export.
- Note:
- If you specify an existing file, the file will be overwritten.
Examples
Task 1
From the server, export policy information to tape volumes TAPE01, TAPE02,
and TAPE03. Specify that these tape volumes be read by a device
assigned to the MENU1 device class.
- Command:
-
export policy devclass=menu1
volumenames=tape01,tape02,tape03
Task 2
From the server, export policy information to tape volumes listed in a file
named TAPEVOL.DATA. This file contains these lines:
TAPE01
TAPE02
TAPE03
Specify that these tape volumes be used by a device assigned to the MENU1
device class.
- Command:
- export policy devclass=menu1
volumenames=file:tapevol.data
Related Commands
Table 136. Commands Related to EXPORT POLICY
Command
| Description
|
CANCEL PROCESS
| Cancels a background server process.
|
EXPORT ADMIN
| Copies administrative information to external media.
|
EXPORT NODE
| Copies client node information to external media.
|
EXPORT SERVER
| Copies all or part of the server to external media.
|
IMPORT POLICY
| Restores policy information 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 ]