Tivoli Storage Manager for Windows 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.

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"--'
 
                                       .-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 or if you use a wildcard character in the volume name. For more information, see Table 144 and Table 145. 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. TSM ejects volumes that are in an automated library (including an external library type) before changing to the destination state.

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

REMove
Specifies whether TSM ejects the volumes from the library. This parameter is optional. The default is YES.
Note:For a 349x library, the volume is always ejected from the library even if you specify NO.
Possible values are:

Yes
Specifies that the volume is ejected from the library. The volume entry is deleted from the TSM library inventory. This option applies to all automated libraries.

No
Specifies that the volume is not ejected from a SCSI library. This option only applies to a SCSI library. This option deletes the volume entry from the TSM library inventory and leaves the volume in its slot.

Bulk
This option does not apply to a library type of EXTERNAL.
  • For 349x libraries: Specifies that the volume is ejected to a predefined high capacity area in the library, instead of an I/O station.
  • For SCSI libraries with multiple Entry/Exit ports: Specifies that the volume is ejected to the next available Entry/Exit port.
    Note:TSM issues a message stating that the tape volume should be removed from the Entry/Exit port.

Untileefull
Specifies that the volume is ejected from the library if there is at least one empty slot in the I/O station. If the volume is ejected from the library, TSM deletes the volume entry from the library inventory. This option applies only to a SCSI library.

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.

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 144 and Table 145.

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. If the volumes are in an automated library, TSM ejects the volumes before changing them to the NOTMOUNTABLE 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. If the volumes are in an automated library, TSM ejects the volumes before changing them to the COURIER 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. If the volumes are in an automated library, TSM ejects them before changeing them to the VAULT 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 changeing 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,

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:

&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 259 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. If you do not specify a file name with the SET DRMCMDFILENAME, DRM generates a file name by appending exec.cmds to the directory representing this "instance" of the Tivoli Storage Manager server (typically the directory from which the server was originally installed. DRM allocates the file name specified or generated. If the file name exists, DRM tries to use it; any existing data is overwritten. 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, the allocated file name is 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.

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

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.                                                          |
|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, 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"
query actlog search="MOVE DRMEDIA"

Output:
+--------------------------------------------------------------------------------+
|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.cmdsc:\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:To process the CHECKIN LIBVOLUME commands, issue the MACRO command with /drm/move/exec.cmdsc:\drm\move\exec.cmd as the macro name.

Related Commands

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


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