Tivoli Header
Administrator's Reference
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.
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
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
Table 160. 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 ]