Tivoli Header
Administrator's Reference
Use this command to export client node definitions to sequential
media.
Each client node definition includes the following:
- User ID, password, and contact information
- Name of the client's assigned policy domain
- File compression status
- Whether the user has the authority to delete backed up or archived files
from server storage
- Whether the client node ID is locked from server access
Optionally, you can also export the following:
- File space definitions
- Backed up, archived, and space-managed files
- Access authorization information pertaining to the file spaces exported
This command generates a background process that can be cancelled with the
CANCEL PROCESS command. If an EXPORT NODE 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.
You can use the QUERY ACTLOG command to view the status of the export
operation.
- Note:
- Because of unpredictable results, you should not run expiration, migration,
backup, or archive when issuing the EXPORT NODE command.
For a server that has clients with support for Unicode, you may need to
have the server convert the file space name that you enter, or use the:
- FSID parameter
- UNIFILESPACE parameter
Privilege Class
To issue this command, you must have system privilege.
Syntax
.-*-------------.
>>-EXPort Node--+---------------+------------------------------->
|.-,---------. |
|V | |
'--node_name-+--'
>--+--------------------------------+--------------------------->
| .-,---------------. |
| V | |
'-FILESpace=---file_space_name-+-'
>--+---------------------------+-------------------------------->
| .-,-------------. |
| V | |
'-FSID--=---file_space_ID-+-'
>--+-------------------------------------+---------------------->
| .-,---------------. |
| V | |
'-UNIFILESpace--=---file_space_name-+-'
>--+--------------------------+--------------------------------->
| .-,-----------. |
| V | |
'-DOmains=---domain_name-+-'
.-FILEData--=--None-------------.
>--+-------------------------------+---------------------------->
'-FILEData--=--+-ALl----------+-'
+-None---------+
+-ARchive------+
+-Backup-------+
+-BACKUPActive-+
+-ALLActive----+
'-SPacemanaged-'
.-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
- node_name
- Specifies the client node names for which information is to be
exported. This parameter is optional. Separate multiple names
with commas and no intervening spaces. You can use wildcard characters
to specify names.
- FILESpace
- Specifies the file spaces for which data is to be exported. This
parameter is optional. Separate multiple names with commas and no
intervening spaces. You can use wildcard characters to specify a
name.
- FSID
- Specifies the file spaces by using their file space IDs (FSIDs).
The server uses the FSIDs to find the file spaces to export. To find
the FSID for a file space, use the QUERY FILESPACE command. Separate
multiple file space IDs with commas and no intervening spaces. This
parameter is optional.
- UNIFILESpace
- Specifies the file spaces that are known to the server to be Unicode
enabled. The server converts the names you enter from the server code
page to the UTF-8 code page to find the file spaces to export. The
success of the conversion depends on the actual characters in the name and the
server's code page. Separate multiple names with commas and no
intervening spaces. This parameter is optional.
- DOmains
- Specifies the policy domains from which nodes should be exported.
This parameter is optional. Separate multiple names with commas and no
intervening spaces. If you specify domains, a node is exported only if
it belongs to one of the specified domains. You can use wildcard
characters to specify a name.
- FILEData
- Specifies the type of files that should be exported for all nodes defined
to the server. This parameter is optional. The default value is
NONE.
The device class used by the file data is determined by the device class
for the storage pool. If it is the same device class specified in this
command, two drives are needed to export node information. The mount
limit for the device class must be at least 2.
- Note:
- If client nodes registered as TYPE=SERVER are being exported, specify ALL,
ARCHIVE, or ALLACTIVE.
The following descriptions mention active and
inactive backup file copies. An active backup file copy is
the most recent backup copy for a file that still exists on the client
workstation. All other backup file copies are called inactive
copies. The values are:
- ALl
- The server exports all backup versions of files, all archived files, and
all space-managed files.
- None
- The server does not export files, only node definitions.
- ARchive
- The server exports only archived files.
- Backup
- The server exports only backup versions, whether active or
inactive.
- BACKUPActive
- The server exports only active backup versions.
- ALLActive
- The server exports all active backup versions of files, all archived
files, and all space-managed files.
- SPacemanaged
- The server exports only space-managed files.
- 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 would be 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 node 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.
You cannot specify the DISK device class.
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 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 you specify 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.
- 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.
|
- USEDVolumelist
- Specifies the 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 import 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.
If you specify a dataset name, you must enclose the name in single
quotation marks, surrounded by double quotation marks. For example,
USEDVOLUMELIST="'DATA.TAPEVOL'".
Examples
Task 1
From the server, export client node information to tape volumes TAPE01,
TAPE02, and TAPE03. Specify that these tape volumes be used by a device
assigned to the MENU1 device class.
- Command:
- export node devclass=menu1 volumenames=tape01,tape02,tape03
Task 2
From the server, export the client node information to 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:
- export node devclass=menu1
volumenames=file:'listof.tapevol'
Task 3
From the server, use the FSID to export active backup versions of file data
for client node JOE to tape volume TAPE01. To determine the FSID, first
issue a QUERY FILESPACE command.
- Command:
-
- To determine the FSID, issue a QUERY FILESPACE command.
query filespace joe
+--------------------------------------------------------------------------------+
|Node Name Filespace FSID Platform Filespace Is Capacity Pct |
| Name Type Filespace (MB) Util |
| Unicode? |
|---------- ----------- ---- ------- --------- --------- -------- ----- |
|JOE \\joe\c$ 1 WinNT NTFS Yes 2,502.3 75.2 |
|JOE \\joe\d$ 2 WinNT NTFS Yes 6,173.4 59.6 |
| |
+--------------------------------------------------------------------------------+
- Export the active backup versions of file data and specify that the tape
volume be used by a device asssigned to the MENU1 device class.
export node joe fsid=1,2 filedata=backupactive devclass=menu1
volumenames=tape01
Related Commands
Table 108. Commands Related to EXPORT NODE
Command
| Description
|
CANCEL PROCESS
| Cancels a background server process.
|
EXPORT ADMIN
| Copies administrative information to external media.
|
EXPORT POLICY
| Copies policy information to external media.
|
EXPORT SERVER
| Copies all or part of the server to external media.
|
IMPORT NODE
| Restores client node 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 ]