Tivoli Header
Administrator's Reference
Use this command to import administrator and authority definitions for one
or more administrators from export media to the TSM server.
You can use the QUERY ACTLOG command to view the status of the import
operation.
This command generates a background process that can be cancelled with the
CANCEL PROCESS command. If an IMPORT ADMIN 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
.-*--------------. .-Preview--=--No------.
>>-IMport Admin--+----------------+--+---------------------+---->
|.-,----------. | '-Preview--=--+-No--+-'
|V | | '-Yes-'
'--admin_name-+--'
>--DEVclass=device_class_name----------------------------------->
.-,-----------.
V |
>--VOLumename--=--+---volume_name-+-+--------------------------->
'-FILE:file_name--'
.-Replacedefs--=--No------.
>--+-------------------------+---------------------------------><
'-Replacedefs--=--+-No--+-'
'-Yes-'
Parameters
- admin_name
- Specifies the administrators for which you want to import
information. This parameter is optional. Separate multiple names
with commas and no intervening spaces. You can use wildcard characters
to specify names.
- Preview
- Specifies whether you want to preview the results of the import operation,
without importing administrator 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 on the number and types of objects imported, together with the
number of bytes transferred, are 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. If all drives for the device
class are busy when the import runs, TSM cancels lower priority operations,
such as reclamation, to make a drive available.
- VOLumename (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
names with commas and no intervening spaces.
- FILE:file_name
- Specifies the name of a file that contains a list of volumes used for the
imported data. In the file, each volume name must be on a separate
line. Blank and comment lines that begin with an asterisk are
ignored.
- Note:
- When the file name is specified within single quotation marks, the value
entered is used as the data set name. When the file name is specified
without quotation marks, the user prefix associated with the server job is
appended to the front of the file name and the resulting string is used as the
data set name. For example, the user prefix associated with the server
job is SRVRV4 and the file name specified is LIST.TAPES. The
data set name will be SRVRV4.LIST.TAPES.
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,
im.data.mtl.
|
SERVER
| 1-250 alphanumeric characters.
|
- Replacedefs
- Specifies whether to replace administrator definitions on the target
server. The default value is NO. The values are:
- No
- Specifies that definitions are not to be replaced.
- Yes
- Specifies that definitions are to be replaced.
Examples
Task 1
From the server, import the information for all defined administrators 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 admin devclass=menu1
volumenames=tape01,tape02,tape03
Task 2
From the server, import the information for all defined administrators from
tape volumes listed in a file named LISTOF.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 admin devclass=menu1
volumenames=file:'listof.tapevol'
Related Commands
Table 116. Commands Related to IMPORT ADMIN
Command
| Description
|
CANCEL PROCESS
| Cancels a background server process.
|
EXPORT ADMIN
| Copies administrative information to external media.
|
IMPORT NODE
| Restores client node information from external media.
|
IMPORT POLICY
| Restores policy 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 ]