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

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--=--poolname--'
 
                                       .-REMove--=--Yes-----.
>-----+----------------------------+---+--------------------+--->
      '-Source--=--+-DBBackup---+--'   '-REMove--=--+-No--+-'
                   +-DBSnapshot-+                   '-Yes-'
                   '-DBNOne-----'
 
>-----+---------------------------------+----------------------->
      '-TOSTate--=--+-NOTMOuntable----+-'
                    +-COUrier---------+
                    +-VAult-----------+
                    +-COURIERRetrieve-+
                    '-ONSITERetrieve--'
 
>-----+-----------------------------+--------------------------->
      '-WHERELOcation--=--location--'
 
>-----+--------------------------+---+--------------------+----->
      '-TOLOcation--=--location--'   '-CMd--=--"command"--'
 
                                       .-Wait--=--No------.
>-----+----------------------------+---+------------------+----><
      '-CMDFilename--=--file_name--'   '-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. If you use a wildcard character in the volume name, you must specify WHERESTATE. For more information, see Table 141 and Table 142.

Possible values are:

MOuntable
Specifies that volumes are to transition from the MOUNTABLE state to the NOTMOUNTABLE state if the TOSTATE is not specified. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to the destination state. Volumes in the MOUNTABLE state contain valid data and are available for onsite processing.

NOTMOuntable
Specifies that volumes are to transition from the NOTMOUNTABLE state to the COURIER state if the TOSTATE is not specified. Volumes in the NOTMOUNTABLE state are onsite, contain valid data, and not available for onsite processing.

COUrier
Specifies that volumes are to transition from the COURIER state to the VAULT state. The only valid destination state for the volumes in COURIER state is VAULT. Volumes in the COURIER state are with the courier and being moved to an offsite location.

VAULTRetrieve
Specifies that volumes are to transition from the VAULTRETIEVE state to the COURIERRETRIEVE state if the TOSTATE is not specified. Volumes in the VAULTRETRIEVE state do not contain valid data and are at the offsite vault.

COURIERRetrieve
Specifies that volumes are to transition from the COURIERRETIEVE state back to the onsite location. The only valid destination state for the volumes in COURIERRETRIEVE state is ONSITERETRIEVE. The volume records of the database backup and scratch copy storage pool volumes are deleted from the database. Volumes in the COURIERRETRIEVE state are with the courier and being moved back to the onsite location.

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 that is used to limit the selection of volumes for processing. This parameter is optional. You can use a pattern-matching expression to specify this name. All matching storage pools are processed. The copy storage pools specified with this parameter override the copy storage pools specified on the SET DRMCOPYSTGPOOL command. If you do not specify a copy storage pool name, all volumes in the specified state, except MOUNTABLE state, are considered for processing. 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.

REMove
Specifies whether Tivoli Storage Manager ejects the volumes from the library during MOVE DRMEDIA processing. This parameter is optional. The default is YES. Possible values are:

Yes
Specifies that the volume is ejected from the library during MOVE DRMEDIA processing. The volume entry is deleted from the Tivoli Storage Manager library inventory. This option applies to all automated libraries.

No
Specifies that the volume is not ejected from a SCSI library during MOVE DRMEDIA processing. This option deletes the volume entry from the Tivoli Storage Manager library inventory and leaves the volume in its slot.

TOSTate
Specifies the destination state of the volumes being processed. This parameter is required if WHERESTATE is not specified. If TOSTATE is specified without specifying WHERESTATE, the volume name has to be explicitly specified, pattern-matching is not allowed. For more information, see Table 141 and Table 142.

Possible values are:

NOTMOuntable
Specifies that volumes are to transition to the NOTMOUNTABLE state. This value is only valid when the volumes being processed have a MOUNTABLE state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to NOTMOUNTABLE state.

COUrier
Specifies that volumes are to transition to the COURIER state. This value is only valid when the volumes being processed have a MOUNTABLE or NOTMOUNTABLE state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to COURIER state.

VAult
Specifies that volumes are to transition to the VAULT state. This value is only valid when the volumes being processed have a MOUNTABLE, NOTMOUNTABLE, or COURIER state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to VAULT state.

COURIERRetrieve
Specifies that volumes are to transition to the COURIERRETRIEVE state. This value is only valid when the volumes being processed have a VAULTRETRIEVE state.

ONSITERetrieve
Specifies that volumes are to transition to the ONSITERETRIEVE state. This value is only valid when the volumes being processed have a VAULTRETRIEVE or COURIERRETRIEVE state. The volume records are deleted from the database for the database backup and scratch copy storage pool volumes that are transition to the ONSITERETRIEVE state.

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. This parameter is optional. You must enclose your executable command specification in quotation marks. The maximum length of the executable command specification is 255 characters. For each volume successfully processed by MOVE DRMEDIA command, DRM writes the associated commands to a file. The filename used by DRM is specified with the CMDFILENAME parameter, the SET DRMCMDFILENAME command, or the default name generated by the MOVE DRMEDIA command. If the length of the line written exceeds 255 characters, it is split into multiple lines and a continuation character, +, is added to all but the last line of the command. You may need to alter the continuation character according to the requirements of the product that executes the commands.

If you do not specify CMD or specify a "" for CMD, MOVE DRMEDIA will not generate any executable commands.

string
Specifies the string to build an executable command to process the volume name and/or volume location obtained by MOVE DRMEDIA command. You can specify any free form text for the string. Do not use embed quotation marks. For example, the following is a valid executable command specification:
        CMD="CHECKIN LIBVOL LIB8MM &VOL STATUS=SCRATCH"

The following is an invalid executable command specification:

        CMD=""CHECKIN LIBVOL LIB8MM" &VOL STATUS=SCRATCH"

substitution
Specifies a substitution variable to tell MOVE DRMEDIA to substitute a value for the variable. The possible substitution variables are:

&VOL
Specifies the volume name is to be substitued for &VOL You can specify the lowercase characters, &vol No spaces or blanks between ampersand, &, and VOL. If there are spaces or blanks between ampersand and VOL, MOVE DRMEDIA will treat them as strings and no substitution will be set. If &VOL is not specified, no volume name is set in the executable command.

&LOC
Specifies the volume location is to be substituted for &LOC You can specify lowercase characters, &loc No spaces or blanks between ampersand, &, and LOC. If there are spaces or blanks between ampersand and LOC, MOVE DRMEDIA will treat them as strings and no substitution will be set. If &LOC is not specified, no location name is set in the executable command.

&VOLDSN
Specifies the volume data set name is to be substituted for &VOLDSN An example of a copy storage pool tape volume data set name using the default prefix TSM is TSM.BFS. An example of a database backup tape volume data set name using a prefix TSM221 defined with the device class is TSM221.DBB. If &VOLDSN is not specified, no volume data set name is set in the executable command.

&NL
Specifies the new line character is to be substitued for &NL When &NL is specified, MOVE DRMEDIA command will split the command at the position where the &NL is and will not append any continuation character. The user is responsible for specifying the proper continuation character before the &NL if one is required. The user is also responsible for the length of the line written. If the &NL is not specified and the length of the command line exceeds 255, the command line is split into multiple lines and a continuation character, +, is added to all but the last line of the command.

CMDFilename
Specifies the full path file name for containing the command string specified with CMD. This parameter is optional. The maximum length of the file name is 259 characters. If you do not specify a file name or specify a "" with the CMDFILENAME, the file name specified with the SET DRMCMDFILENAME will be used. If you do not specify a file name with the SET DRMCMDFILENAME, MOVE DRMEDIA will generate a file name by appending the 'exec.cmd' to the directory representing this "instance" of the Tivoli Storage Manager server which is typically the directory that the server was originally installed from. MOVE DRMEDIA automatically allocates the file name specified or generated. If the file name exists, MOVE DRMEDIA will attempt to use it and the existing data, if any, in the file will be over written. If this should happen and the executable commands in the file have not been run, issue QUERY DRMEDIA command to re-build the executable commands for the desired date and volume transition. If the MOVE DRMEDIA command fails and none of the command string specified with the CMD parameter has been written for the volume successfully moved, then the allocated file name is deleted.

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 from the server console.
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. Messages created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.

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

Destination State and Location: The following table shows how DRM determines the volume's destination state and location:

  1. Destination state:

  2. Destination location:

Table 141. 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 transition:

Table 142. 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

Output:
+--------------------------------------------------------------------------------+
|ANR0609I MOVE DRMEDIA started as process 10.                                    |
|ANS5104I Process number 10 started.                                             |
+--------------------------------------------------------------------------------+

Command:
query actlog search="MOVE DRMEDIA"

Output:
+--------------------------------------------------------------------------------+
|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 COURIER state. If the media is in an automated library, MOVE DRMEDIA will eject the media out of the library before transition them to the COURIER state.

Command:
move drmedia * wherestate=mountable tostate=courier 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.                                                                    |
|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.                                                          |
+--------------------------------------------------------------------------------+

Task 3

Move DRM media that is in the VAULTRETRIEVE state to the ONSITERETRIEVE state, and generate a CHECKIN LIBVOL command for each volume successfully processed in a file, c:\drm\move\exec.cmd

Command:
move drmedia * wherestate=vaultretrieve tostate=onsiteretrieve cmdfilename=c:\drm\move\exec.cmd cmd="checkin libvol lib8mm &vol status=scratch"

Output:
+--------------------------------------------------------------------------------+
|ANR0609I MOVE DRMEDIA started as process 15.                                    |
|ANS5104I Process number 15 started.                                             |
+--------------------------------------------------------------------------------+

Command:
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:24      ANR6684I MOVE DRMEDIA: Volume CSTP01 was               |
|                          delete.                                               |
|09/13/1997 09:12:24      ANR6684I MOVE DRMEDIA: Volume CSTP02 was               |
|                          delete.                                               |
|09/13/1997 09:12:24      ANR6684I MOVE DRMEDIA: Volume DBTP10 was               |
|                          delete.                                               |
|09/13/1997 09:12:24      ANR6684I MOVE DRMEDIA: Volume DBTP11 was               |
|                          delete.                                               |
|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.                            |
|                                                                                |
+--------------------------------------------------------------------------------+

Output:
MOVE DRMEDIA also created the executable commands in c:\drm\move\exec.cmd:
+--------------------------------------------------------------------------------+
|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: The above CHECKIN LIBVOL commands can be executed by issuing the MACRO command with c:\drm\move\exec.cmd as the macro name.

Related Commands

Table 143. 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 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.
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 ]