![]() |
![]() |
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.
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-----' >--+---------------------------------+--------------------------> '-TOSTate--=--+-NOTMOuntable----+-' +-COUrier---------+ +-VAult-----------+ +-COURIERRetrieve-+ '-ONSITERetrieve--' >--+----------------------------+-------------------------------> '-WHERELOcation--=--location-' >--+-------------------------+--+-------------------+-----------> '-TOLOcation--=--location-' '-CMd--=--"command"-' .-APPend--=--No------. >--+---------------------------+--+--------------------+--------> '-CMDFilename--=--file_name-' '-APPend--=--+-No--+-' '-Yes-' .-Wait--=--No------. >--+-----------------+--+------------------+------------------->< '-LRecl--=--lrecl-' '-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. |
Possible values are:
cmd="rmm changevolume &vol"This is an example of a CMD parameter that is notvalid:
cmd=""rmm changevolume" &vol"
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.
DRM allocates the file name specified as a physical sequential file if it has not already been preallocated. You can specify the logical record length for the file by specifying a value with the LRECL parameter. If you preallocate the file, it must be a physical sequential file. If the file name exists, DRM tries to use it. If this happens and the executable commands in the file have not been run, issue the QUERY DRMEDIA command to rebuild the executable commands for the desired date and volume transition. You can specify APPEND=YES to prevent the existing data from being overwritten.
If the operation fails after the command file is allocated, the file is not deleted.
Destination State and Location Tables:
The following table shows how DRM determines the destination state and location of a volume.
Table 127. 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 128. 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 that is in the MOUNTABLE state to the VAULT state.
move drmedia * wherestate=mountable tostate=vault 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. | |ANR6683I MOVE DRMEDIA: Volume TAPE01 was moved from | | MOUNTABLE state to VAULT. | |ANR6683I MOVE DRMEDIA: Volume TAPE02 was | | moved from MOUNTABLE state to VAULT. | |ANR6683I MOVE DRMEDIA: Volume DBTP05 was | | moved from MOUNTABLE state to VAULT. | |ANR6683I MOVE DRMEDIA: Volume DBTP04 was | | moved from MOUNTABLE state to VAULT. | |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 completed with completion state SUCCESS | | at 10:12:25. | +--------------------------------------------------------------------------------+
Task 3
Move DRM media that is in the MOUNTABLE state to the VAULT state, and generate a RMM CHANGEVOLUME command for each volume successfully processed in a file, DRM.MOVE.EXEC.CMDS.
move drmedia * wherestate=mountable tostate=vault cmdfilename=DRM.MOVE.EXEC.CMDS cmd="RMM CHANGEVOLUME &VOL LOCATION(&LOC)"
query actlog search="MOVE DRMEDIA"
+--------------------------------------------------------------------------------+ |09/13/1997 09:12:24 ANR0984I Process 15 for MOVE DRMEDIA | | started in the BACKGROUND at 09:12:24. | |09/13/1997 09:12:24 ANR0610I MOVE DRMEDIA started by HSIAO | | as process 15. | |09/13/1997 09:12:25 ANR6683I MOVE DRMEDIA: Volume CSTP01 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:25 ANR6683I MOVE DRMEDIA: Volume CSTP02 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:26 ANR6683I MOVE DRMEDIA: Volume DBTP10 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:27 ANR6683I MOVE DRMEDIA: Volume DBTP11 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:27 ANR6682I MOVE DRMEDIA command ended: | | 4 volumes processed. | |09/13/1997 09:12:42 ANR0611I MOVE DRMEDIA started by HSIAO | | as process 15 has ended. | |09/13/1997 09:12:42 ANR0985I Process 15 for MOVE DRMEDIA | | running in the BACKGROUND completed with | | completion state SUCCESS at 09:12:42. | | | +--------------------------------------------------------------------------------+
MOVE DRMEDIA also created RMM-executable commands in DRM.MOVE.EXEC.CMDS:
+--------------------------------------------------------------------------------+ |RMM CHANGEVOLUME CSTP01 LOCATION(Irnvault) | |RMM CHANGEVOLUME CSTP02 LOCATION(Irnvault) | |RMM CHANGEVOLUME DBTP10 LOCATION(Irnvault) | |RMM CHANGEVOLUME DBTP11 LOCATION(Irnvault) | +--------------------------------------------------------------------------------+
Task 4
Move DRM media that is in the MOUNTABLE state to the VAULT state, and generate control statements for CA-1 batch update utility TMSUPDTE for each volume successfully processed in a file, DRM.MOVE.EXEC.CMDS. The file will have a logical record length of 80.
move drmedia * wherestate=mountable tostate=vault cmdfilename=DRM.MOVE.EXEC.CMDS lrecl=80 cmd="VOL &VOL&NLVER DSN=&VOLDSN&NLREP OUTDEST=&LOC" query actlog search="MOVE DRMEDIA"
+--------------------------------------------------------------------------------+ |09/13/1997 09:12:24 ANR0984I Process 20 for MOVE DRMEDIA | | started in the BACKGROUND at 09:12:24. | |09/13/1997 09:12:24 ANR0610I MOVE DRMEDIA started by HSIAO | | as process 20. | |09/13/1997 09:12:25 ANR6683I MOVE DRMEDIA: Volume CSTP01 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:25 ANR6683I MOVE DRMEDIA: Volume CSTP02 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:26 ANR6683I MOVE DRMEDIA: Volume DBTP10 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:27 ANR6683I MOVE DRMEDIA: Volume DBTP11 was | | moved from MOUNTABLE state to VAULT. | |09/13/1997 09:12:27 ANR6682I MOVE DRMEDIA command ended: | | 4 volumes processed. | |09/13/1997 09:12:42 ANR0611I MOVE DRMEDIA started by HSIAO | | as process 20 has ended. | |09/13/1997 09:12:42 ANR0985I Process 20 for MOVE DRMEDIA | | running in the BACKGROUND completed with | | completion state SUCCESS at 09:12:42. | +--------------------------------------------------------------------------------+
MOVE DRMEDIA also generated the control statements for CA-1 TMSUPDTE batch utility in DRM.MOVE.EXEC.CMDS:
+--------------------------------------------------------------------------------+ |VOL CSTP01 | |VER DSN=TSM.BFS | |REP OUTDEST=Irnvault | |VOL CSTP02 | |VER DSN=TSM.BFS | |REP OUTDEST=Irnvault | |VOL DBTP10 | |VER DSN=TSM.DBB | |REP OUTDEST=Irnvault | |VOL DBTP11 | |VER DSN=TSM.DBB | |REP OUTDEST=Irnvault | +--------------------------------------------------------------------------------+
Related Commands
Table 129. Commands Related to MOVE DRMEDIA
Command | Description |
---|---|
BACKUP DB | Backs up the Tivoli Storage Manager 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. |
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. |