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.

Restrictions:

You cannot use this command for volumes that are assigned to copy-container storage pools.
You cannot move data into or out of a storage pool that is defined with a CENTERA device class.
You cannot use this command for data in a cold-data-cache storage pool. Also, you cannot use this command for storage pools that are either a target of a cold-data-cache storage pool or were previously designated as a next storage pool of a cold-data-cache storage pool. If you issue the command for a cold-data-cache storage pool or its next pool, you will receive an error message.

When you move files from one storage pool volume to another, consider the storage pool type and the following guidelines:

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.
You can move files from an active-data pool volume only to volumes in the same active-data pool.
You can move files from a retention storage pool volume only to volumes in the same retention storage pool.

In addition to moving data from volumes in storage pools that have NATIVE or NONBLOCK data formats, you can use this command to move data from volumes in storage pools that have NDMP data formats (NETAPPDUMP, CELERRADUMP, or NDMPDUMP). The target storage pool must have the same data format as the source storage pool. If you are moving data out of a storage pool for the purpose of upgrading to new tape technology, the target primary storage pool must be associated with a library that has the new device for the tape drives. IBM Spectrum® Protect supports backend data movement for NDMP images.

If you are moving files to volumes in the same storage pool, sufficient space must be available on the volumes. Otherwise, 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.

After a move data operation completes, a volume might not be empty 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 or active-data 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 or active-data pool.

During the data movement process, active-data pools cannot be used to obtain data.

If you run the MOVE DATA command on an offsite volume that contains collocated data, it might be necessary to issue the MOVE DATA command multiple times to move all of the data out of the volume. For example, if you are using file space collocation groups with an offsite volume that contains file spaces in a collocation group and file spaces that are not in the group, you must issue two MOVE DATA commands. Each MOVE DATA command moves the data for a single collocated or non-collocated group of files.

Do not use the MOVE DATA command if a restore process (RESTORE STGPOOL or RESTORE VOLUME) is running. The MOVE DATA command might cause the restore to be incomplete. If you issue the MOVE DATA command during a restore operation and you receive an error message that indicates that one or more files are locked and cannot be moved, you must reissue the MOVE DATA command after the restore operation completes to move any remaining files.

Remember:

When you issue the MOVE DATA command, you remove duplicate data in the following cases:

Moving data from a primary storage pool that is set up for data deduplication to another primary storage pool that is also set up for data deduplication.
Moving data within a copy storage pool that is set up for data deduplication.
Moving data within an active-data pool that is set up for data deduplication.

A volume in a deduplicated storage pool might contain files that are logically deleted but are still linked by files on other volumes. If you use the MOVE DATA command to move the contents of a deduplicated storage pool volume to a non-deduplicated storage pool, the logically deleted files are not written to the new volume since they do not exist logically. The deleted files are kept on the original volumes for other files to reference. The MOVE DATA process ends successfully but none of the deleted files are moved to the new target volume and the source volume is not deleted. You can issue the QUERY CONTENT command with the FOLLOWLINKS=YES or FOLLOWLINKS=JUSTLINKS parameter to verify whether the volume contains files that are linked by files on other volumes.

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

Notes:

¹ The default is NO if either the source or target storage pool is random access. The default is YES if both the source and target storage pools are sequential access.
² This parameter is not available or is ignored if the data format is NETAPPDUMP, CELERRADUMP, or NDMPDUMP data.

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 (the target storage pool). 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.

SHREDTONOshred

Specifies whether data is moved from a storage pool that enforces shredding to a storage pool that does not enforce shredding. This parameter is optional. The default value is NO. Possible values are:

No: Specifies that the server does not allow data to be moved from a storage pool that enforces shredding to a storage pool that does not enforce shredding. If the source storage pool enforces shredding and the target storage pool does not, the operation fails.
Yes: Specifies that the server allows data to be moved from a storage pool that enforces shredding to a storage pool that does not enforce shredding. The source data is shredded when the operation is complete. The target data is not be shredded when it is deleted.

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. If both the source and target storage pools are sequential access, the default value is YES. If either the source or target storage pool is random access, the default is NO.

The parameter is not available or is ignored if any of the following conditions are true:

The data format is NETAPPDUMP, CELERRADUMP, or NDMPDUMP.
The data is in a storage pool that is configured for data deduplication.
The target storage pool for the data movement is configured for data deduplication.

Attention: Reconstruction removes inactive backup files in active-data pools. If you specify RECONSTRUCT=NO when you move data in an active-data pool that is not configured for data deduplication, inactive backup files remain in the storage pool.

Possible values are:

No: Specifies that reconstruction of file aggregates is not completed during data movement.
Yes: Specifies that reconstruction of file aggregates is completed during data movement. You can specify this option only when both the source and the target storage pools are sequential-access.

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 might 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 you continue with other tasks. The server then displays the output messages to the administrative client when the command completes.

Restriction: You cannot specify WAIT=YES from the server console.

Example: Move files on a storage pool volume

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

move data stgvol.1 stgpool=8mmpool

Related commands

Table 1. 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 CONTENT	Displays information about files in a storage pool volume.
QUERY DRMEDIA	Displays information about disaster recovery volumes.
QUERY PROCESS	Displays information about background processes.
QUERY SHREDSTATUS	Displays information about data waiting to be shredded.
SHRED DATA	Manually starts the process of shredding deleted data.