Use this command to import client node definitions from sequential media to the TSM server.
You can use the QUERY ACTLOG command to view the status of the import 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 IMPORT NODE 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
.-*----------------. >>-IMport Node----+------------------+--FILESpace--=------------> | .-,-----------. | | V | | '----node_name---+-' .-*----------------------. >-----+------------------------+--DOmains--=--------------------> | .-,-----------------. | | V | | '----file_space_name---+-' .-*------------------. >-----+--------------------+------------------------------------> | .-,-------------. | | V | | '----domain_name---+-' .-FILEData--=--None-------------. >-----+-------------------------------+-------------------------> '-FILEData--=--+-ALl----------+-' +-None---------+ +-ARchive------+ +-Backup-------+ +-BACKUPActive-+ +-ALLActive----+ '-SPacemanaged-' .-Preview--=--No------. >-----+---------------------+---DEVclass=device_class_name------> '-Preview--=--+-No--+-' '-Yes-' .-Dates--=--Absolute-----. >-----+------------------------+--------------------------------> '-Dates--=--+-Absolute-+-' '-Relative-' .-,-------------. V | >-----VOLumenames--=--+----volume_name---+-+--------------------> '-FILE:file_name-----' .-Replacedefs--=--No------. >-----+-------------------------+------------------------------>< '-Replacedefs--=--+-No--+-' '-Yes-'
Parameters
Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names. All matching nodes are included in the list.
Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names.
Note: | Existing file spaces are not replaced. New file spaces are created when identical names are encountered. |
Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify a name. The default is all domains.
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 import the node information. The mount limit for the device class must be at least 2.
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:
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.
If the export media has been idle for some time after export (sitting on a shelf for six months, for example), the original backup or archive dates may be old enough to trigger immediate expiration of file copies when the data is imported into a server. The RELATIVE specification for this value will adjust for time elapsed since export so that the file copies are not immediately expired.
For example, assume that an export tape contains an archive file copy that was archived 5 days before the export operation. If the media are saved for 6 months and then imported, the archive file will appear to have been inserted six months and 5 days ago by default (DATES=ABSOLUTE) and may be subject to immediate expiration depending on the retention value that is specified in the file's management class. Specifying DATES=RELATIVE will result in resetting the archive date for the file to 5 days ago during import. The DATES=RELATIVE parameter thus adjusts file backup and archive dates for the time that has elapsed since the export operation occurred.
Possible values are:
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. |
Examples
Task 1
From the server, import client node information from tape volumes TAPE01, TAPE02, and TAPE03. Specify that these tape volumes be read by a device assigned to the MENU1 device class.
import node devclass=menu1 volumenames=tape01,tape02,tape03
Task 2
From the server, import client node information from tape volumes listed in a file named TAPEVOL.DATA. This file contains these lines:
TAPE01 TAPE02 TAPE03
Specify that these tape volumes be read by a device assigned to the MENU1 device class.
Related Commands
Table 133. Commands Related to IMPORT NODE
Command | Description |
---|---|
CANCEL PROCESS | Cancels a background server process. |
EXPORT NODE | Copies client node information to external media. |
IMPORT ADMIN | Restores administrative 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. |