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.

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

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 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. The volume records of the database backup and scratch copy storage pool volumes are deleted from the TSM database.

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.

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. If the volumes are in an automated library, MOVE DRMEDIA ejects the volumes before changing them to the 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.

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.

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 ADSM database for the database backup and scratch copy storage pool volumes that are in transition to the ONSITERETRIEVE state.

WHERELOcation
Specifies the from location of the volumes being processed. This parameter is optional. This parameter is used to restrict processing to volumes that are in the specified location. The maximum length of the location specified is 255 characters. The location must be enclosed in quotation marks if it contains any blank characters.

TOLOcation
Specifies the destination location of the volumes being processed. This parameter is optional. The maximum length of the location specified is 255 characters. The location must be enclosed 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. 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 the 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 240 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 the 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="RMM CHANGEVOLUME &VOL"

The following is an invalid executable command specification:

        CMD=""RMM CHANGEVOLUME" &VOL"

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 substituted for &VOL. You can specify the lowercase characters, &vol. No spaces or blanks are allowed between the ampersand, &, and VOL. If there are spaces or blanks between the 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 the lowercase characters, &loc. No spaces or blanks are allowed between the ampersand, &, and LOC. If there are spaces or blanks between the 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 ADSM is ADSM.BFS. An example of a database backup tape volume data set name using a prefix ADSM221 defined with the device class is ADSM221.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 substituted 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 240, 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 name of the file for containing the command string specified with CMD. This parameter is optional. The maximum length of the file name is 44 characters. You can specify any valid MVS file name. If you do not specify a file name or specify " " with CMDFILENAME, the file name specified with SET DRMCMDFILENAME will be used.

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.

LRecl
Specifies the logical record length for the file containing the command string specified with CMD. This parameter is optional. You can specify a logical record length between 1 and 1028. If you do not specify a logical record length, the default length is 255 characters. MOVE DRMEDIA automatically allocates the file described under the CMDFILENAME parameter as a fixed-length and blocked physical sequential file.

APPend
Specifies whether to open the command file in append mode. This parameter is optional. The default is NO. Possible values are:

No
Specifies to write the data from the beginning of the command file. If the given command file exists, its contents are destroyed.

Yes
Specifies to open the command file in append mode for writing at the end of 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 when you issue this command with the MVS MODIFY command.
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 on an MVS system console and in the server's Job Log.

To cancel a background process, use the CANCEL PROCESS command.

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

Command:
move drmedia * wherestate=notmountable
 
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 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 ADSM database backup and copy storage pool volumes from an automated library to an offsite location, Irnvault.

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


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