MOVE CONTAINER (Move a container)

Use this command to move the contents of a storage pool container to another container if a storage pool directory is removed or if a container is damaged.

You can also use this command to move the contents of a storage pool container under these conditions:

When you upgrade hardware
If I/O errors occur on a disk

Privilege class

To issue this command, you must have restricted storage privilege.

Syntax


>>-MOVe CONTainer--container_name------------------------------->

>--+-------------------------------------+---------------------->
   '-STGPOOLDIRectory--=--directory_name-'   

   .-Wait--=--Yes-----.   
>--+------------------+----------------------------------------><
   '-Wait--=--+-Yes-+-'   
              '-No--'

Parameters

container_name(Required)

Specifies the name of the container to move. You must specify the full path name of the container.

STGPOOLDIRectory

Specifies the name of the storage pool directory where the container is moved. This parameter is optional.

If you specify a storage pool directory, it must be in the same storage pool as the original container. The storage pool directory is used for the new container. If you don't specify a storage pool directory, the Tivoli® Storage Manager server selects a storage pool directory from the same storage pool.

Wait

Specifies whether to wait for the Tivoli Storage Manager server to complete processing this command in the foreground. This parameter is optional. Specify the following values:

No: The server processes this command in the background and you can continue with other tasks while the command is processing. Messages that are related to the background process are shown either in the activity log file or the server console, depending on where the messages are logged. This is the default.
Yes: The server processes this command in the foreground. The operation must complete before you can continue with other tasks. Messages are shown either in the activity log file or the server console, or both, depending on where the messages are logged.
Restriction: You cannot specify the WAIT=YES parameter from the server console.

Example: Move a container

Move a container, 0000000000000001.dcf, from the /data1/storage/dir1 storage pool directory to the /data/storage/dir2 storage pool directory.

move container /data1/storage/dir1/00/0000000000000001.dcf 
stgpooldir=/data/storage/dir2

Move a container, 0000000000000001.dcf, from the e:\data1\storage\dir1 storage pool directory to the e:\data\storage\dir2 storage pool directory.

move container e:\data1\storage\dir1\00\0000000000000001.dcf 
stgpooldir=e:\data\storage\dir2

Table 1. Commands related to MOVE CONTAINER
Command	Description
AUDIT CONTAINER	Audit a directory-container storage pool.
QUERY CONTAINER	Displays information about a container.