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 for reuse. You cannot specify volumes that are 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. |
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"--' >-----+----------------------------+---+------------------+-----> '-CMDFilename--=--file_name--' '-LRecl--=--lrecl--' .-APPend--=--No------. .-Wait--=--No------. >-----+--------------------+---+------------------+------------>< '-APPend--=--+-No--+-' '-Wait--=--+-No--+-' '-Yes-' '-Yes-'
Parameters
Possible values are:
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:
If you do not specify CMD or specify a " " for CMD, MOVE DRMEDIA will not generate any executable commands.
CMD="RMM CHANGEVOLUME &VOL"
The following is an invalid executable command specification:
CMD=""RMM CHANGEVOLUME" &VOL"
MOVE DRMEDIA automatically allocates the file name specified as a physical sequential file if it has not been preallocated. You can specify the logical record length for the file by specifying a value with the LRECL parameter. If you choose to preallocate the file, the file must be a physical sequential file. If the file name exists, MOVE DRMEDIA will attempt to use it. If this should happen 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 MOVE DRMEDIA fails after the command file is allocated, the file is not deleted.
Note: | You cannot specify Wait=Yes when you issue this command with the MVS MODIFY command. |
To cancel a background process, use the CANCEL PROCESS command.
Destination State and Location: The following table shows how DRM determines the volume's destination state and location:
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 Transition: The following tables show the eligible
state transitions:
Table 128. State Transition for Volumes Table
Volume's Current State | Destination State | |||
---|---|---|---|---|
MOUNTABLE | NOTMOUNT- ABLE | COURIER | VAULT | |
MOUNTABLE | N | Y | Y | Y |
NOTMOUNTABLE | N | N | Y | Y |
COURIER | N | N | N | Y |
VAULT | N | N | N | N |
VAULT-RETRIEVE | N | N | N | N |
COURIER-RETRIEVE | N | N | N | N |
ONSITE-RETRIEVE | 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 |
VAULT-RETRIEVE | N | Y | Y |
COURIER-RETRIEVE | N | N | Y |
ONSITE-RETRIEVE | N | N | N |
Examples
Task 1
Move DRM media that is in the NOTMOUNTABLE state to the COURIER state.
move drmedia * wherestate=notmountable query actlog search="move drmedia"
+--------------------------------------------------------------------------------+ |09/11/1997 11:12:24 ANR0984I Process 10 for MOVE DRMEDIA | | started in the BACKGROUND at 11:12:24. | |09/11/1997 11:12:24 ANR0610I MOVE DRMEDIA started by HSIAO | | as process 10. | |09/11/1997 11:12:25 ANR6683I MOVE DRMEDIA: Volume TAPE0P was | | moved from NOTMOUNTABLE state to COURIER. | |09/11/1997 11:12:25 ANR6683I MOVE DRMEDIA: Volume TAPE1P was | | moved from NOTMOUNTABLE state to COURIER. | |09/11/1997 11:12:25 ANR6683I MOVE DRMEDIA: Volume DBTP02 was | | moved from NOTMOUNTABLE state to COURIER. | |09/11/1997 11:12:25 ANR6683I MOVE DRMEDIA: Volume DBTP01 was | | moved from NOTMOUNTABLE state to COURIER. | |09/11/1997 11:12:25 ANR6682I MOVE DRMEDIA command ended: | | 4 volumes processed. | |09/11/1997 11:12:25 ANR0611I MOVE DRMEDIA started by HSIAO | | as process 10 has ended. | |09/11/1997 11:12:25 ANR0985I Process 10 for MOVE DRMEDIA | | running in the BACKGROUND completed with | | completion state 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.
Note: | It is assumed that a Vital Record Specification (VRS) was defined with Removable Media Management (RMM) to move the ADSM database backup and copy storage pool volumes from an automated library to an offsite location, Irnvault. |
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=ADSM.BFS | |REP OUTDEST=Irnvault | |VOL CSTP02 | |VER DSN=ADSM.BFS | |REP OUTDEST=Irnvault | |VOL DBTP10 | |VER DSN=ADSM.DBB | |REP OUTDEST=Irnvault | |VOL DBTP11 | |VER DSN=ADSM.DBB | |REP OUTDEST=Irnvault | +--------------------------------------------------------------------------------+
Related Commands
Table 129. 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. |
PREPARE | Creates a recovery plan file. |
QUERY ACTLOG | Displays messages from the server activity log. |
QUERY DRMEDIA | Displays information about disaster recovery volumes. |
SET DRMCHECKLABEL | Specifies whether TSM should read volume labels during MOVE DRMEDIA command processing. |
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. |