Administrator's Reference

MOVE DATA (Move Files on a Storage Pool Volume)

Use this command to move files from one storage pool volume to other storage pool volumes. You can move files from a primary storage pool volume only to volumes in the same or a different primary storage pool. You can move files from a copy storage pool volume only to volumes in the same copy storage pool.

If you are moving files to volumes within the same storage pool, sufficient space must be available on the volumes or the operation fails.

When you move files from a sequential access volume, multiple sequential access volume mounts are required to move files that span volumes.

When you move files from a random access volume, the server erases any cached copies of files on the volume.

A volume may not be empty after a move data operation completes if one or more files cannot be relocated to another volume because of input/output errors on the device or because errors were found in the file. If needed, you can delete the volume using the option to discard any data. The files with I/O or other errors are then deleted.

You can use this command to move files from an offsite volume in a copy storage pool. Because the offsite volume cannot be mounted, the server obtains the files that are on the offsite volume from either a primary storage pool or another copy storage pool. These files are then written to the destination volumes in the original copy storage pool.

Do not use the MOVE DATA command if a restore process (RESTORE STGPOOL or RESTORE VOLUME) is running. The MOVE DATA command could cause the restore to be incomplete.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to which the volume belongs and also for the new storage pool, if one is specified.

Syntax

>>-MOVe Data--volume_name----+------------------------+--------->
                             '-STGpool--=--pool_name--'
 
      .-Wait--=--No------.
>-----+------------------+-------------------------------------><
      '-Wait--=--+-No--+-'
                 '-Yes-'
 

Parameters

volume_name (Required)
Specifies the storage pool volume from which to move files.

STGpool
Specifies the primary storage pool to which you want to move files. This parameter is optional and applies only to moving data from primary storage pool volumes. If you do not specify a value for this parameter, files are moved to other volumes within the same storage pool.

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 MOVE DATA background process is canceled, some files may have already moved prior to 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.

Examples

Task

Move files from storage pool volume STGVOL.1 to any available volumes assigned to the 8MMPOOL storage pool.

Command:
move data stgvol.1 stgpool=8mmpool

Related Commands

Table 140. Commands Related to MOVE DATA

Command Description
CANCEL PROCESS Cancels a background server process.
DEFINE VOLUME Assigns a volume to be used for storage within a specified storage pool.
DELETE VOLUME Deletes a volume from a storage pool.
MOVE DRMEDIA Moves DRM media onsite and offsite.
QUERY ACTLOG Displays messages from the server activity log.
QUERY DRMEDIA Displays information about disaster recovery volumes.
QUERY PROCESS Displays information about background processes.


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