Tivoli Header

Administrator's Reference


MOVE NODEDATA (Move Data by Node in a Sequential Access Storage Pool)

Use this command to move data located in a sequential-access storage pool. You can move data for one or more nodes, or a single node with selected filespaces. The data can be located in either a primary or copy storage pool. This command is helpful for reducing the number of volume mounts during client restore or retrieve operations by consolidating data for a specific node within a storage pool, or to move data to another storage pool. For example, you can use this command for moving data to a random-access storage pool in preparation for client restore processing.

The MOVE NODEDATA command takes two forms, depending on whether you are moving data only for selected filespaces. The syntax and parameters for each form are defined separately.

MOVE NODEDATA -- All File Spaces for One or More Nodes

Use this command to move data for all filespaces for one or more nodes.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the source storage pool. If your authorization is restricted storage privilege and you intend to move data to another storage pool, you must also have the appropriate authority for the destination storage pool.

Syntax

                  .-,---------.
                  V           |
>>-MOVe NODEdata----node_name-+--------------------------------->
 
>--FROMstgpool--=--source_pool_name----------------------------->
 
>--+-------------------------------------+---------------------->
   '-TOstgpool--=--destination_pool_name-'
 
   .-Type--=--ANY--------------.
>--+---------------------------+-------------------------------->
   '-Type--=--+-ANY----------+-'
              +-Backup-------+
              +-ARchive------+
              '-SPacemanaged-'
 
   .-MAXPRocess--=--1-------------.  .-Wait--=--No------.
>--+------------------------------+--+------------------+------->
   '-MAXPRocess--=--num_processes-'  '-Wait--=--+-No--+-'
                                                '-Yes-'
 
   .-RECONStruct--=--No------.
>--+-------------------------+---------------------------------><
   '-RECONStruct--=--+-No--+-'
                     '-Yes-'
 
 

Parameters

node_name (Required)
Specifies the node name related to the data that is moved with this command. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names.

FROMstgpool (Required)
Specifies the name of a sequential-access storage pool that contains data to be moved. This storage pool must be in the NATIVE or NONBLOCK data format.

TOstgpool
Specifies the name of a storage pool to which data will be moved. This storage pool must be in the NATIVE or NONBLOCK data format. This parameter is optional and does not apply when the source storage pool is a copy storage pool. That is, if the source storage pool is a copy storage pool the destination must be the same copy storage pool. If a value is not specified, data is moved to other volumes within the source pool.
Note:
If you are moving data within the same storage pool, there must be volumes available that do not contain the node data you are moving. That is, the server cannot use volumes that contain the data to be moved as destination volumes.

Type
Specifies the type of files to be moved. This parameter is optional. The default value is ANY. Possible values are:

ANY
Specifies that all types of files are moved.

Backup
Specifies that backup files are moved.

ARchive
Specifies that archive files are moved.

SPacemanaged
Specifies that space-managed files are moved.

MAXPRocess
Specifies the maximum number of parallel processes to use for moving data. This parameter is optional. You can specify a value from 1-999, inclusive. The default value is 1. Increasing the number of parallel processes should improve throughput.

When determining this value, consider the number of logical and physical drives that can be dedicated to this operation. To access a sequential access volume, TSM uses a mount point and, if the device type is not FILE, a physical drive. The number of available mount points and drives depends on other TSM and system activity and on the mount limits of the device classes for the sequential access storage pools that are involved in the move. Each process needs a mount point for storage pool volumes, and, if the device type is not FILE, each process also needs a drive.

Wait
Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default value is No. Possible values are:

No
Specifies that the server processes this command in the background. You can continue with other tasks while the command is being processed. The server displays messages that are created from the background process either in the activity log or the server console, depending on where messages are logged.

To cancel a background process, use the CANCEL PROCESS command. If a background process is canceled, some files may have already been moved before the cancellation.

Yes
Specifies that the server processes this command in the foreground. You wait for the command to complete before continuing with other tasks. The server then displays the output messages to the administrative client when the command completes.
Note:
You cannot specify WAIT=YES from the server console.

RECONStruct
Specifies whether to reconstruct file aggregates during data movement. Reconstruction removes empty space that has accumulated during deletion of logical files from an aggregate. This parameter is optional. The default value is No. Possible values are:

No
Specifies that reconstruction of file aggregates will not be performed during the move.

Yes
Specifies that reconstruction of file aggregates will be performed during the move. You may only specify this option when both the source and the target storage pools are sequential-access.

Examples

Task

Move all data belonging to node MARY that is stored in storage pool TAPEPOOL. Data should be moved to disk storage pool BACKUPPOOL.

Command:
move nodedata mary
 fromstgpool=tapepool tostgpool=backuppool
 

MOVE NODEDATA -- Selected File Spaces for One Node

Use this command to move data for selected filespaces belonging to a single node.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the source storage pool. If your authorization is restricted storage privilege and you intend to move data to another storage pool, you must also have the appropriate authority for the destination storage pool.

Syntax

>>-MOVe NODEdata--node_name--FROMstgpool--=--source_pool_name--->
 
>--+-------------------------------------+---------------------->
   '-TOstgpool--=--destination_pool_name-'
 
>--+-----------------------------------+------------------------>
   |               .-,---------------. |
   |               V                 | |
   '-FIlespace--=----file_space_name-+-'
 
>--+---------------------------------------------+-------------->
   |                  .-,----------------------. |
   |                  V                        | |
   '-UNIFILESpace--=----unicode_filespace_name-+-'
 
>--+-----------------------------------+------------------------>
   |          .-,--------------------. |
   |          V                      | |
   '-FSID--=----filespace_identifier-+-'
 
   .-Type--=--ANY--------------.
>--+---------------------------+-------------------------------->
   '-Type--=--+-ANY----------+-'
              +-Backup-------+
              +-ARchive------+
              '-SPacemanaged-'
 
   .-MAXPRocess--=--1-------------.  .-Wait--=--No------.
>--+------------------------------+--+------------------+------->
   '-MAXPRocess--=--num_processes-'  '-Wait--=--+-No--+-'
                                                '-Yes-'
 
   .-RECONStruct--=--No------.
>--+-------------------------+---------------------------------><
   '-RECONStruct--=--+-No--+-'
                     '-Yes-'
 
 

Parameters

node_name (Required)
Specifies the node name related to the data that is moved with this command. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names.

FROMstgpool (Required)
Specifies the name of a sequential-access storage pool that contains data to be moved. This storage pool must be in the NATIVE or NONBLOCK data format.

TOstgpool
Specifies the name of a storage pool to which data will be moved. This storage pool must be in the NATIVE or NONBLOCK data format. This parameter is optional and does not apply when the source storage pool is a copy storage pool. That is, if the source storage pool is a copy storage pool the destination must be the same copy storage pool. If a value is not specified, data is moved to other volumes within the source pool.
Note:
If you are moving data within the same storage pool, there must be volumes available that do not contain the node data you are moving. That is, the server cannot use volumes that contain the data to be moved as destination volumes.

FILespace
Specifies the name of the non-Unicode filespace that contains data to be moved. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names. This parameter is optional. If you do not specify a value for this parameter and values for UNIFILESPACE or the FSID or both, non-Unicode filespaces are not moved.

UNIFILESpace
Specifies the name of the Unicode filespace that contains data to be moved. Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names. This parameter is optional. If you do not specify a value for this parameter and values for FILESPACE or the FSID or both, non-Unicode filespaces are not moved.

FSID
Specifies file space identifiers (FSIDs) for the file spaces to be moved. Separate multiple names with commas and no intervening spaces. This parameter is optional.

Type
Specifies the type of files to be moved. This parameter is optional. The default value is ANY. Possible values are:

ANY
Specifies that all types of files are moved.

Backup
Specifies that backup files are moved.

ARchive
Specifies that archive files are moved.

SPacemanaged
Specifies that space-managed files are moved.

MAXPRocess
Specifies the maximum number of parallel processes to use for moving data. This parameter is optional. You can specify a value from 1-999, inclusive. The default value is 1. Increasing the number of parallel processes should improve throughput.

When determining this value, consider the number of logical and physical drives that can be dedicated to this operation. To access a sequential access volume, TSM uses a mount point and, if the device type is not FILE, a physical drive. The number of available mount points and drives depends on other TSM and system activity and on the mount limits of the device classes for the sequential access storage pools that are involved in the move. Each process needs a mount point for storage pool volumes, and, if the device type is not FILE, each process also needs a drive.

Wait
Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default value is No. Possible values are:

No
Specifies that the server processes this command in the background. You can continue with other tasks while the command is being processed. The server displays messages that are created from the background process either in the activity log or the server console, depending on where messages are logged.

To cancel a background process, use the CANCEL PROCESS command. If a background process is canceled, some files may have already moved before the cancellation.

Yes
Specifies that the server processes this command in the foreground. You wait for the command to complete before continuing with other tasks. The server then displays the output messages to the administrative client when the command completes.
Note:
You cannot specify WAIT=YES from the server console.

RECONStruct
Specifies whether to reconstruct file aggregates during data movement. Reconstruction removes empty space that has accumulated during deletion of logical files from an aggregate. This parameter is optional. The default value is No. Possible values are:

No
Specifies that reconstruction of file aggregates will not be performed during the move.

Yes
Specifies that reconstruction of file aggregates will be performed during the move. You may only specify this option when both the source and the target storage pools are sequential-access.

Examples

Task

Move data for node Tom in storage pool TAPEPOOL. Restrict movement of data to files in non-Unicode filespaces as well as Unicode filespaces \\jane\d$. Data should be moved to disk storage pool BACKUPPOOL.

Command:
move nodedata tom
 fromstgpool=tapepool tostgpool=backuppool
 filespace=* unifilespace=\\jane\d$
 

Task

Move all data for node sarah, from all primary sequential-access storage pools (for this example, tapepool*) to DISKPOOL.

Note:
To obtain a list of storage pools that contain data for node sarah, issue either:
query occupancy sarah

or

SELECT * from OCCUPANCY where node_name='sarah'
For the example assume that the results were tapepool1, tapepool4, and tapepool5.

Command:
move nodedata sarah
 fromstgpool=tapepool1 tostgpool=DISKPOOL
 
move nodedata sarah
 fromstgpool=tapepool4 tostgpool=DISKPOOL
 
move nodedata sarah
 fromstgpool=tapepool5 tostgpool=DISKPOOL
 

Task

The following is an example of moving non-Unicode and Unicode filespaces for a node. For node NOAH move non-Unicode filespace \\servtuc\d$ and Unicode filespace \\tsmserv1\e$ that has a filespace id of 2 from sequential access storage pool TAPEPOOL to random access storage pool DISKPOOL.

Command:
move nodedata noah
 fromstgpool=tapepool tostgpool=diskpool
 filespace=\\tsmserv1\d$ fsid=2
 

Related Commands


Table 158. Commands Related to MOVE NODEDATA

Command Description
CANCEL PROCESS Cancels a background server process.
MOVE DATA Moves data from a specified storage pool volume to another storage pool volume.
QUERY ACTLOG Displays messages from the server activity log.
QUERY FILESPACE Displays information about data in filespaces that belong to a client.
QUERY OCCUPANCY Displays file space information by storage pool.
QUERY PROCESS Displays information about background processes.
QUERY STGPOOL Displays information about storage pools.
QUERY VOLUME Displays information about storage pool volumes.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]