Administrator's Reference

EXPORT NODE (Copy Client Node Information to Sequential Media)

Use this command to export client node definitions from a TSM server to sequential media. Each client node definition includes following:

Optionally, you can also export the following:

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.

Privilege Class

To issue this command, you must have system privilege.

Syntax

                  .-*----------------.
>>-EXPort Node----+------------------+-------------------------->
                  |  .-,-----------. |
                  |  V             | |
                  '----node_name---+-'
 
>-----+-------------------------------------------+------------->
      |            .-,-------------------------.  |
      |            V                           |  |
      '-FILESpace=-----+-----------------+-----+--'
                       '-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:

  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

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.

DOmains
Specifies the policy domains from which nodes should be exported. This parameter is optional. Separate multiple names with commas and no intervening spaces. For a node to be exported, it must belong 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
TSM exports all backup versions of files, all archived files, and all space-managed files.

None
TSM does not export files, only definitions.

ARchive
TSM exports only archived files.

Backup
TSM exports only backup versions, whether active or inactive.

BACKUPActive
TSM exports only active backup versions.

ALLActive
TSM exports all active backup versions of files, all archived files, and all space-managed files.

SPacemanaged
TSM 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:

  1. If all drives for the device class are busy when the export runs, TSM cancels lower priority operations, such as reclamation, to make a drive available.

  2. 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.

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. An example is /imdata/mt1.
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.

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 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:tapevol

Related Commands

Table 116. 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 ]