EXPORT ADMIN (Export administrator definitions to sequential media)

You can export administrator and authority definitions from a server to sequential media for later importing to another server.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramEXPort Admin*,admin_namePreview=NoPreview=NoYesDEVclass1=device_class_nameScratch=YesScratch2=YesNoVOLumenames2=,volume_nameFILE:file_nameUSEDVolumelist=file_nameENCryptionstrength=AESENCryptionstrength=AESDES
Notes:
  • 1 If PREVIEW=NO, a device class must be specified.
  • 2 If PREVIEW=NO and SCRATCH=NO, one or more volumes must be specified.

Parameters

admin_name
Specifies the administrators for which information is to be exported. This parameter is optional. The default is all administrators.

Separate the items in the list by commas, with 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, and determine how many volumes are required. The following parameter values are supported:
No
Specifies that the administrator information is to be exported. If you specify this value, you must 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, IBM Spectrum® Protect 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.
Restriction: The export operation writes to volumes that are associated with a sequential-access device class. It cannot write to volumes that are assigned to a storage pool.

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:

Linux operating systemsAIX operating systems/imdata/mt1.

Windows operating systemsd:\program files\tivoli\tsm\data1.dsm.
Windows operating systemsLinux operating systemsAIX operating systemsREMOVABLEFILE Windows operating systemsLinux operating systemsAIX operating systems1-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.
ENCryptionstrength
Indicates which algorithm to use to encrypt passwords when exporting administrative and node records. This parameter is optional. The default value is AES. If you are exporting to a server that does not support AES, specify DES. You can specify one of the following values:
AES
Specifies the Advanced Encryption Standard.
DES
Specifies the Data Encryption Standard.

Example: Export administrator definitions to tape volumes

From the server, export the information for all defined administrators 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. The number and types of objects that are exported are reported to the system console and in the activity log. Issue the command:
export admin devclass=menu1 
volumenames=tape01,tape02,tape03

Example: Export administrator definitions to tape volumes listed in a file

From the server, export the information for all defined administrators to tape volumes that are listed in the following file:
  • Linux operating systemsAIX operating systemsTAPEVOL
  • Windows operating systemsTAPEVOL.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 command:
Linux operating systemsAIX operating systems
export admin devclass=menu1 volumenames=file:tapevol
Windows operating systems
export admin devclass=menu1 volumenames=file:tapevol.data

The number and types of objects that are exported are reported to the system console and in the activity log.