Tivoli Header

Administrator's Reference

MOVE DRMEDIA (Move Disaster Recovery Media Offsite and Back Onsite)

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.

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

volume_name (Required)
Specifies the name of the database backup or copy storage pool volume to be processed. If you use wildcard characters to specify this name, you must also specify WHERESTATE.

WHERESTate
Specifies the state of volumes to be processed. This parameter is required if the TOSTATE is not specified or if you use a wildcard character in the volume name. For more information, see Table 127 and Table 128. Possible values are:

MOuntable
These volumes contain valid data and are available for onsite processing. They will change to NOTMOUNTABLE if the TOSTATE is not specified. .

NOTMOuntable
These volumes are onsite, contain valid data, and are not available for onsite processing. They will change to COURIER if the TOSTATE is not specified.

COUrier
These volumes are with the courier and being moved offsite. They will change only to VAULT.

VAULTRetrieve
These volumes do not contain valid data and are offsite. They will change to COURIERRETRIEVE if the TOSTATE is not specified.

COURIERRetrieve
These volumes are with the courier and being moved onsite. They will change only to ONSITERETRIEVE. TSM deletes from the database the volume records of the database backup and scratch copy storage pool volumes.

BEGINDate
Specifies the beginning date used to select volumes. This parameter is optional. Volumes are considered eligible if the MOVE DRMEDIA command has changed the volume to its current state on or after the specified date. The default is the earliest date for which volume information exists.

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.

ENDDate
Specifies the ending date used to select volumes. This parameter is optional. Volumes are considered eligible if the MOVE DRMEDIA command has changed the volume to its current state on or before the specified date. The default is the current date.

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.

BEGINTime
Specifies the beginning time used to select volumes for processing. This parameter is optional. Volumes are considered eligible if the MOVE DRMEDIA command has changed the volume to its current state on or after the specified time and date. The default is midnight (00:00:00) on the date specified with the BEGINDATE parameter.

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.

ENDTime
Specifies the ending time used to select volumes for processing. This parameter is optional. Volumes are considered eligible if the MOVE DRMEDIA command has changed the volume to its current state on or after the specified time and date. The default is 23:59:59.

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.

COPYstgpool
Specifies the name of the copy storage pool whose volumes are to be processed. This parameter is optional. You can use wildcard characters to specify this name. The copy storage pools specified with this parameter override those specified with the SET(TM) DRMCOPYSTGPOOL command. If you do not specify a copy storage pool name, all volumes in the specified state, except MOUNTABLE state, are processed. See SET DRMCOPYSTGPOOL command for processing the volumes in the MOUNTABLE state.

Source
Specifies whether to include database backup volumes for processing. This parameter is optional. The default is DBBACKUP. The choices are:

DBBackup
Specifies that TSM includes full and incremental database backup volumes for processing.

DBSnapshot
Specifies that TSM includes database snapshot backup volumes for processing.

DBNOne
Specifies that TSM does not include any database backup volumes for processing.

TOSTate
Specifies the destination state of the volumes being processed. This parameter is required if WHERESTATE is not specified. If you specify TOSTATE but not WHERESTATE, you must specify the volume name. Wildcard characters are not allowed. For more information, see Table 127 and Table 128.

Possible values are:

NOTMOuntable
Specifies that volumes are to change to the NOTMOUNTABLE state. This value is valid only if the volumes are in the MOUNTABLE state. .

COUrier
Specifies that volumes are to change to the COURIER state. This value is valid only if the volumes are in the MOUNTABLE or NOTMOUNTABLE state. .

VAult
Specifies that volumes are to change to the VAULT state. This value is valid only if the volumes are in the MOUNTABLE, NOTMOUNTABLE, or COURIER state.

COURIERRetrieve
Specifies that volumes are to change to the COURIERRETRIEVE state. This value is valid only if the volumes are in the VAULTRETRIEVE state.

ONSITERetrieve
Specifies that volumes are to change to the ONSITERETRIEVE state. This value is valid only if the volumes are in the VAULTRETRIEVE or COURIERRETRIEVE state. For database backup and scratch copy storage pool volumes that are changing to the ONSITERETRIEVE state, TSM deletes the volume records from the database.

WHERELOcation
Specifies the current location of the volumes. This parameter is optional. The maximum length of the location is 255 characters. Enclose the text in quotation marks if it contains any blank characters.

TOLOcation
Specifies the destination location of the volumes. This parameter is optional. The maximum length of the location specified is 255 characters. Enclose the text in quotation marks if it contains any blank characters. If you do not specify the destination location, the location defined by the SET DRMNOTMOUNTABLE command is used.

CMd
Specifies the creation of executable commands to process each volume obtained by this command. This parameter is optional. The maximum length of this command specification is 255 characters. DRM writes the commands to a file that is specified by the CMDFILENAME parameter. If the length of the written command is greater than 240 characters, it is split into multiple lines and continuation characters (+) are added. You may need to alter the continuation character according to the product that runs the commands.

command
The command string enclosed in quotation marks. The string must not include embedded quotation marks. For example, this is a valid CMD parameter:

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:

&VOL
A volume name.

&LOC
A volume location.

&VOLDSN
The file name to be written into the sequential access media labels. For example, if the applicable device class sets TSM as the tape volume prefix, a copy storage pool tape volume file name might be TSM.BFS and a database backup tape volume file name might be TSM.DBB.

&NL
The new line character. When &NL is specified, the command is split at the &NL variable. If required, you must specify the appropriate continuation character before the &NL. If the &NL is not specified and the command line is greater than 240 characters, the line is split into multiple lines and continuation characters (+) are added.

CMDFilename
Specifies the fully qualified name of the file that will contain the commands specified by CMD parameter. This parameter is optional. The maximum length of the file name is 44 characters.

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.

APPend
Specifies whether to overwrite any existing contents of the command file or append the commands to the file. This parameter is optional. The default is NO. Possible values are:

No
DRM overwrites the contents of the file.

Yes
DRM appends the commands to the file.

LRecl
Specifies the logical record length for the file containing the command string specified with CMD. This parameter is optional. You can specify a length from 1 and 1028 characters. The default length is 255 characters. DRM automatically allocates the file described under the CMDFILENAME parameter as a fixed-length and blocked physical sequential file.

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.
Note:
You cannot specify Wait=Yes when you issue this command with the MVS MODIFY command.
Possible values are:

No
Specifies that TSM processes this command in the background. Messages created from the background process are displayed on an MVS system console and in the server's Job Log. To see if the operation was successful, issue the QUERY ACTLOG command.

Yes
Specifies that the server processes this command in the foreground. Wait for the command to complete before continuing with other tasks. The server then displays the output messages to the administrative client.

Destination State and Location Tables:

The following table shows how DRM determines the destination state and location of a volume.

Destination state

Destination 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 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.

Command:
move drmedia * wherestate=notmountable
tostate=courier
 
query actlog search="MOVE DRMEDIA"

Output:
+--------------------------------------------------------------------------------+
| 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.

Command:
move drmedia * wherestate=mountable tostate=vault wait=yes

Output:
+--------------------------------------------------------------------------------+
|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 TSM database backup and copy storage pool volumes from an automated library to an offsite location, Ironvault.

Command:
move drmedia * wherestate=mountable tostate=vault 
cmdfilename=DRM.MOVE.EXEC.CMDS 
cmd="RMM CHANGEVOLUME &VOL LOCATION(&LOC)"
query actlog search="MOVE DRMEDIA"

Output:
+--------------------------------------------------------------------------------+
|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.

Command:
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"

Output:
+--------------------------------------------------------------------------------+
|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.


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