Use this command to track database backup and copy storage pool volumes that are to be moved offsite and to identify the expired or empty volumes that are to be moved onsite. The database backup volumes can be for full plus incremental or snapshot backups. You cannot specify virtual volumes (backup objects stored on another server). You can change volumes through each state, or you can use the TOSTATE parameter and skip states to simplify the movements.
Note: | The MOVE DRMEDIA command always processes copy storage pool volumes (see the description of the COPYSTGPOOL parameter for more information). You can use the SOURCE parameter to control whether the command processes database backup volumes. |
You can use the QUERY ACTLOG command to see if the MOVE DRMEDIA command was successful. You can also view this information from the server console.
Privilege Class
To issue this command, you must have one of the following privilege classes:
Syntax
>>-MOVe DRMedia--volume_name------------------------------------> >-----+-------------------------------------+-------------------> '-WHERESTate--=--+-MOuntable-------+--' +-NOTMOuntable----+ +-COUrier---------+ +-VAULTRetrieve---+ '-COURIERRetrieve-' >-----+---------------------+---+-------------------+-----------> '-BEGINDate--=--date--' '-ENDDate--=--date--' >-----+---------------------+---+-------------------+-----------> '-BEGINTime--=--time--' '-ENDTime--=--time--' >-----+----------------------------+----------------------------> '-COPYstgpool--=--pool_name--' .-Source--=--DBBackup-------. >-----+---------------------------+-----------------------------> '-Source--=--+-DBBackup---+-' +-DBSnapshot-+ '-DBNOne-----' .-REMove--=--Yes-------------. >-----+----------------------------+----------------------------> '-REMove--=--+-No----------+-' +-Yes---------+ +-Bulk--------+ '-Untileefull-' >-----+---------------------------------+-----------------------> '-TOSTate--=--+-NOTMOuntable----+-' +-COUrier---------+ +-VAult-----------+ +-COURIERRetrieve-+ '-ONSITERetrieve--' >-----+-----------------------------+---------------------------> '-WHERELOcation--=--location--' >-----+--------------------------+---+--------------------+-----> '-TOLOcation--=--location--' '-CMd--=--"command"--' .-APPend--=--No------. >-----+----------------------------+---+--------------------+---> '-CMDFilename--=--file_name--' '-APPend--=--+-No--+-' '-Yes-' .-Wait--=--No------. >-----+------------------+------------------------------------->< '-Wait--=--+-No--+-' '-Yes-'
Parameters
You can specify the data using one of the values below:
Value | Description | Example |
---|---|---|
MM/DD/YYYY | A specific date | 09/15/1998 |
TODAY | The current date | TODAY |
TODAY-days or-days | The current date minus days specified | TODAY-7 or -7.
To identify volumes that were changed to their current state a week ago, you can specify TODAY-7 or simply -7. |
You can specify the data using one of the values below:
Value | Description | Example |
---|---|---|
MM/DD/YYYY | A specific date | 09/15/1998 |
TODAY | The current date | TODAY
To identify volumes that were changed to their current state today, specify TODAY. |
TODAY-days or-days | The current date minus days specified. The maximum number of days is 9999. | TODAY-1 or -1.
To identify volumes that were changed to their current state a week ago, you can specify TODAY-1 or simply -1. |
You can specify the data using one of the values below:
Value | Description | Example |
---|---|---|
HH:MM:SS | A specific time on the specified begin date | 12:33:28 |
NOW | The current time on the specified begin date | NOW |
NOW+HH:MM or +HH:MM | The current time plus hours and minutes on the specified begin date | NOW+03:00 or +03:00. |
NOW-HH:MM or -HH:MM | The current time minus hours and minutes on the specified begin date | NOW-03:30 or -03:30.
If you issue the MOVE DRMEDIA command at 9:00 with BEGINTIME=NOW-03:30 or BEGINTIME= -03:30, TSM identifies the volumes that were changed to their current state at 5:30 on the begin date you specify. |
You can specify the data using one of the values below:
Value | Description | Example |
---|---|---|
HH:MM:SS | A specific time on the specified end date | 12:33:28 |
NOW | The current time on the specified end date | NOW |
NOW+HH:MM or +HH:MM | The current time plus hours and minutes on the specified end date | NOW+03:00 or +03:00.
If you issue the MOVE DRMEDIA command at 9:00 with ENDTIME=NOW+03:30 or ENDTIME=+03:30, TSM identifies the volumes that were changed to their current state at 12:30 on the end date you specify. |
NOW-HH:MM or -HH:MM | The current time minus hours and minutes on the specified end date | NOW-03:30 or -03:30. |
Note: | For a 349x library, the volume is always ejected from the library even if you specify NO. |
Note: | TSM issues a message stating that the tape volume should be removed from the Entry/Exit port. |
If there is an available slot in the I/O station, the volume moves to the next available slot in the I/O station, and TSM issues a message indicating that the volume should be removed from the I/O station, and waits until a REPLY id is issued. If the I/O station is full, the command fails and any remaining eligible volumes are not processed. After removing the volumes from the I/O station, the MOVE DRMEDIA command must be re-issued to process any remaining eligible volumes. The UNTILEEFULL option behaves like the YES option until the I/O station is full.
Possible values are:
VALID:
cmd="checkin libvol lib8mm &vol status=scratch"
NOT VALID:
cmd=""checkin libvol lib8mm" &vol status=scratch""
The command can include substitution variables. The variables are not case-sensitive, and must not contain blank spaces after the ampersand (&). The possible variables are:
If you do not specify a file name or if you specify a null string (""), DRM uses the file name specified by the SET DRMCMDFILENAME. If you do not specify a file name with the SET DRMCMDFILENAME command, DRM generates a file name by appending exec.cmds to the directory pointed to by the DSMSERV_DIR environment variable or to the directory path name of the current working directory of the TSM server.
If the operation fails after the command file has been created, the file is not deleted.
Note: | You cannot specify WAIT=YES from the server console. |
Destination State and Location Tables:
The following table shows how DRM determines the destination state and location of a volume.
Table 136. Volume Destination and Location Table
Parameters Specified | Destination State | Destination Location |
---|---|---|
WHERESTATE | The next state of the WHERESTATE | Location of the next state |
WHERESTATE TOSTATE | TOSTATE | Location of the TOSTATE |
WHERESTATE TOLOCATION | The next state of the WHERESTATE | TOLOCATON |
WHERESTATE TOSTATE TOLOCATION | TOSTATE | TOLOCATION |
TOSTATE | TOSTATE | Location of the TOSTATE |
TOSTATE WHERELOCATION | TOSTATE | Location of the TOSTATE |
TOSTATE WHERELOCATION TOLOCATION | TOSTATE | TOLOCATION |
State change
The following tables show the eligible state changes:
Table 137. State Transition for Volumes Table
Volume's Current State | Destination State | |||
---|---|---|---|---|
MOUNTABLE | NOTMOUNTABLE | COURIER | VAULT | |
MOUNTABLE | N | Y | Y | Y |
NOTMOUNTABLE | N | N | Y | Y |
COURIER | N | N | N | Y |
VAULT | N | N | N | N |
VAULTRETRIEVE | N | N | N | N |
COURIERRETRIEVE | N | N | N | N |
ONSITERETRIEVE | N | N | N | N |
Volume's Current State | Destination State | ||
---|---|---|---|
VAULT-RETRIEVE | COURIER-RETRIEVE | ONSITE-RETRIEVE | |
MOUNTABLE | N | N | N |
NOTMOUNTABLE | N | N | N |
COURIER | N | N | N |
VAULT | N | N | N |
VAULTRETRIEVE | N | Y | Y |
COURIERRETRIEVE | N | N | Y |
ONSITERETRIEVE | N | N | N |
Examples
Task 1
Move DRM media that is in the NOTMOUNTABLE state to the COURIER state.
move drmedia * wherestate=notmountable tostate=courier query actlog search="MOVE DRMEDIA"
+--------------------------------------------------------------------------------+ | 08/11/1999 11:12:24 ANR0984I Process 10 for MOVE DRMEDIA started | | in the BACKGROUND at 11:12:24. | | 08/11/1999 11:12:24 ANR0610I MOVE DRMEDIA started by HSIAO as | | process 10. | | 08/11/1999 11:12:25 ANR6683I MOVE DRMEDIA: Volume TAPE0P was moved | | from NOTMOUNTABLE state to COURIER. | | 08/11/1999 11:12:25 ANR6683I MOVE DRMEDIA: Volume TAPE1P was moved | | from NOTMOUNTABLE state to COURIER. | | 08/11/1999 11:12:25 ANR6683I MOVE DRMEDIA: Volume DBTP02 was moved | | from NOTMOUNTABLE state to COURIER. | | 08/11/1999 11:12:25 ANR6683I MOVE DRMEDIA: Volume DBTP01 was moved | | from NOTMOUNTABLE state to COURIER. | | 08/11/1999 11:12:25 ANR6682I MOVE DRMEDIA command ended: 4 volumes | | processed. | | 08/11/1999 11:12:25 ANR0611I MOVE DRMEDIA started by HSIAO as | | process 10 has ended. | | 08/11/1999 11:12:25 ANR0985I Process 10 for MOVE DRMEDIA running in | | the BACKGROUND processed 4 items with a | | completion state of SUCCESS at 11:12:25. | +--------------------------------------------------------------------------------+
Task 2
Move DRM media from the MOUNTABLE state to the COURIER state. If the media is in an automated library, MOVE DRMEDIA ejects the media before changing the state.
move drmedia * wherestate=mountable tostate=courier wait=yes
+--------------------------------------------------------------------------------+ |ANR0984I Process 12 for MOVE DRMEDIA started | | in the FOREGROUND at 09:57:17. | |ANR0609I MOVE DRMEDIA started as process 12. | |ANR0610I MOVE DRMEDIA started by HSIAO as | | process 12. | |ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume TAPE01 in library LIB8MM starting. | |ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume TAPE01 in library LIB8MM completed | | successful. | |ANR6683I MOVE DRMEDIA: Volume TAPE01 was moved | | from MOUNTABLE state to COURIER. | |ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume TAPE02 in library LIB8MM starting. | |ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume TAPE02 in library LIB8MM completed | | successful. | |ANR6683I MOVE DRMEDIA: Volume TAPE02 was moved | | from MOUNTABLE state to COURIER. | |ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume DBTP05 in library LIB8MM starting. | |ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume DBTP05 in library LIB8MM completed | | successful. | |ANR6683I MOVE DRMEDIA: Volume DBTP05 was moved | | from MOUNTABLE state to COURIER. | |ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume DBTP04 in library LIB8MM starting. | |ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for | | volume DBTP04 in library LIB8MM completed | | successful. | |ANR6683I MOVE DRMEDIA: Volume DBTP04 was moved | | from MOUNTABLE state to COURIER. | |ANR6682I MOVE DRMEDIA command ended: 4 volumes | | processed. | |ANR0611I MOVE DRMEDIA started by HSIAO as | | process 12 has ended. | |ANR0985I Process 12 for MOVE DRMEDIA running | | in the FOREGROUND processed 4 items with a | | completion state of SUCCESS at 10:12:25. | +--------------------------------------------------------------------------------+
Task 3
Move DRM media that is in the VAULTRETRIEVE state to the ONSITERETRIEVE state, and generate a CHECKIN LIBVOLUME command for each volume successfully processed in a file, /drm/move/exec.cmds.
move drmedia * wherestate=vaultretrieve tostate=onsiteretrieve cmdfilename=/drm/move/exec.cmds cmd="checkin libvol lib8mm &vol status=scratch"
query actlog search="MOVE DRMEDIA"
+--------------------------------------------------------------------------------+ |08/13/1999 09:12:24 ANR0984I Process 15 for MOVE DRMEDIA started in | | the BACKGROUND at 09:12:24. | |08/13/1999 09:12:24 ANR0610I MOVE DRMEDIA started by HSIAO as process | | 15. | |08/13/1999 09:12:24 ANR6684I MOVE DRMEDIA: Volume CSTP01 was deleted. | |08/13/1999 09:12:24 ANR6684I MOVE DRMEDIA: Volume CSTP02 was deleted. | |08/13/1999 09:12:24 ANR6684I MOVE DRMEDIA: Volume DBTP10 was deleted. | |08/13/1999 09:12:24 ANR6684I MOVE DRMEDIA: Volume DBTP11 was deleted. | |08/13/1999 09:12:27 ANR6682I MOVE DRMEDIA command ended: 4 volumes | | processed. | |08/13/1999 09:12:42 ANR0611I MOVE DRMEDIA started by HSIAO as process | | 15 has ended. | |08/13/1997 09:12:42 ANR0985I Process 15 for MOVE DRMEDIA running in | | the BACKGROUND processed 4 items with a | | completion state of SUCCESS at 09:12:42. | +--------------------------------------------------------------------------------+
MOVE DRMEDIA also created commands in /drm/move/exec.cmds:
+--------------------------------------------------------------------------------+ |checkin libvol lib8mm CSTP01 status=scratch | |checkin libvol lib8mm CSTP02 status=scratch | |checkin libvol lib8mm DBTP10 status=scratch | |checkin libvol lib8mm DBTP11 status=scratch | +--------------------------------------------------------------------------------+
Note: | To process the CHECKIN LIBVOLUME commands, issue the MACRO command with /drm/move/exec.cmds as the macro name. |
Related Commands
Table 138. Commands Related to MOVE DRMEDIA
Command | Description |
---|---|
BACKUP DB | Backs up the TSM database to sequential access volumes. |
BACKUP STGPOOL | Backs up a primary storage pool to a copy storage pool. |
CANCEL PROCESS | Cancels a background server process. |
CHECKOUT LIBVOLUME | Checks a storage volume out of an automated library. |
DISMOUNT VOLUME | Dismounts a sequential, removable volume by the volume name. |
PREPARE | Creates a recovery plan file. |
QUERY ACTLOG | Displays messages from the server activity log. |
QUERY DRMSTATUS | Displays DRM system parameters. |
QUERY PROCESS | Displays information about background processes. |
QUERY DRMEDIA | Displays information about disaster recovery volumes. |
SET DRMCOPYSTGPOOL | Specifies that copy storage pools are managed by DRM. |
SET DRMCOURIERNAME | Specifies the name of the courier for the disaster recovery media. |
SET DRMDBBACKUPEXPIREDAYS | Specifies criteria for database backup series expiration. |
SET DRMVAULTNAME | Specifies the name of the vault where DRM media is stored. |
SET DRMCMDFILENAME | Specifies a file name for containing DRM executable commands. |
SET DRMFILEPROCESS | Specifies whether the MOVE DRMEDIA or QUERY DRMEDIA command processes files associated with a device type of file. |
SET DRMNOTMOUNTABLENAME | Specifies the location name of the DRM media to be sent offsite. |