![]() |
![]() |
Use this command to import client node definitions from sequential media to a target Tivoli Storage Manager server. The imported nodes are associated with the same policy domain as they were on the source server, if you specify the domain and if that policy domain exists on the target server. Otherwise, imported nodes are associated with the STANDARD policy domain on the target 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 may already be imported. To display information on background processes, use the QUERY PROCESS 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:
Privilege Class
To issue this command, you must have system privilege.
Syntax
.-*-------------. >>-IMport Node--+---------------+-------------------------------> |.-,---------. | |V | | '--node_name-+--' >--+--------------------------------+---------------------------> | .-,---------------. | | V | | '-FILESpace=---file_space_name-+-' >--+------------------------------------+-----------------------> | .-,---------------. | | V | | '-HEXFILESpace-=---file_space_name-+-' >--+------------------------------------+-----------------------> | .-,---------------. | | V | | '-UNIFILESpace-=---file_space_name-+-' >--+--------------------------+---------------------------------> | .-,-----------. | | V | | '-DOmains=---domain_name-+-' .-FILEData--=--None-------------. .-Preview--=--No------. >--+-------------------------------+--+---------------------+---> '-FILEData--=--+-ALl----------+-' '-Preview--=--+-No--+-' +-None---------+ '-Yes-' +-ARchive------+ +-Backup-------+ +-BACKUPActive-+ +-ALLActive----+ '-SPacemanaged-' .-Dates--=--Absolute-----. >--DEVclass=device_class_name--+------------------------+-------> '-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.
Notes:
Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify a name.
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, the server 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. An example is /imdata/mt1. |
OPTICAL | 1-32 alphanumeric characters. |
REMOVABLEFILE | 1-6 alphanumeric characters. |
SERVER | 1-250 alphanumeric characters. |
To view the hexadecimal representation of a file space name, you can use the QUERY FILESPACE command with FORMAT=DETAILED.
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.
Task 2
From the server, import client node information from 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.
Task 3
From the server, import the active backup versions of file data for client node JOE to tape volume TAPE01. The file space is Unicode.
Related Commands
Table 142. 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. |