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 used for full plus incremental or snapshot backups. You cannot specify virtual volumes (backup objects that are 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.
The MOVE DRMEDIA command always processes copy storage-pool volumes. By default, volumes in active-data pools are not eligible for processing by the disaster recovery manager. To process active-data pool volumes, you must issue the SET DRMACTIVEDATASTGPOOL command. To control whether the command processes database backup volumes, you can use the SOURCE parameter on this command.
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.
>>-MOVe DRMedia--volume_name------------------------------------> >--+------------------------------------+-----------------------> '-WHERESTate--=--+-MOuntable-------+-' +-NOTMOuntable----+ +-COUrier---------+ +-VAULTRetrieve---+ '-COURIERRetrieve-' >--+--------------------+--+------------------+-----------------> '-BEGINDate--=--date-' '-ENDDate--=--date-' >--+--------------------+--+------------------+-----------------> '-BEGINTime--=--time-' '-ENDTime--=--time-' >--+---------------------------+--------------------------------> '-COPYstgpool--=--pool_name-' >--+---------------------------------+--------------------------> '-ACTIVEDatastgpool--=--pool_name-' .-Source--=--DBBackup-------. >--+---------------------------+--------------------------------> '-Source--=--+-DBBackup---+-' +-DBSnapshot-+ '-DBNOne-----' .-REMove--=--Bulk------------. >--+----------------------------+-------------------------------> '-REMove--=--+-No----------+-' +-Yes---------+ +-Bulk--------+ '-Untileefull-' >--+---------------------------------+--------------------------> '-TOSTate--=--+-NOTMOuntable----+-' +-COUrier---------+ +-VAult-----------+ +-COURIERRetrieve-+ '-ONSITERetrieve--' >--+----------------------------+-------------------------------> '-WHERELOcation--=--location-' >--+-------------------------+--+-------------------+-----------> '-TOLOcation--=--location-' '-CMd--=--"command"-' .-APPend--=--No------. >--+---------------------------+--+--------------------+--------> '-CMDFilename--=--file_name-' '-APPend--=--+-No--+-' '-Yes-' .-Wait--=--No------. >--+------------------+--+-------------------+----------------->< '-Wait--=--+-No--+-' '-CAP--=----x,y,z---' '-Yes-'
These volumes contain valid data and are available for onsite processing. The values change to NOTMOUNTABLE if the TOSTATE parameter is not specified.
Depending on the outcome of the REMOVE parameter, Tivoli® Storage Manager might eject volumes in an automated library before you change the destination state.
For external libraries, the server sends requests to the external library manager to eject the volumes. It depends on the external library manager whether the volumes are ejected from the library.
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. |
EOLM (End Of Last Month) | The last day of the previous month. | EOLM |
EOLM-days | The last day of the previous month minus days specified. | EOLM-1 To include files that were active a day before the last day of the previous month. |
BOTM (Beginning Of This Month) | The first day of the current month. | BOTM |
BOTM+days | The first day of the current month, plus days specified. | BOTM+9 To include files that were active on the 10th day of the current month. |
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 -1. |
EOLM (End Of Last Month) | The last day of the previous month. | EOLM |
EOLM-days | The last day of the previous month minus days specified. | EOLM-1 To include files that were active a day before the last day of the previous month. |
BOTM (Beginning Of This Month) | The first day of the current month. | BOTM |
BOTM+days | The first day of the current month, plus days specified. | BOTM+9 To include files that were active on the 10th day of the current month. |
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, Tivoli Storage Manager identifies the volumes that were changed to their current state at 5:30 on the begin date that you specify. |
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, Tivoli Storage Manager 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. |
The copy storage pools that are specified with this parameter override copy storage pools that are specified with the SET DRMCOPYSTGPOOL command. If this parameter is not specified, Tivoli Storage Manager selects the storage pools as follows:
The active-data pools that are specified with this parameter override active-data pools that are specified with the SET DRMACTIVEDATASTGPOOL command. If this parameter is not specified, Tivoli Storage Manager selects the storage pools in the following way:
REMOVE=YES | REMOVE=BULK | REMOVE=NO |
---|---|---|
The 3494 Library Manager ejects the cartridge to the convenience I/O station. | The 3494 Library Manager ejects the cartridge to the high-capacity output facility. | The 3494 Library Manager does not eject the
volume. The server leaves the cartridge in the library in the INSERT category for use by other applications. |
If a library... |
And REMOVE=YES, |
And REMOVE= |
And REMOVE=NO, |
And REMOVE= |
---|---|---|---|---|
Does not have entry/exit ports | The server leaves the cartridge in its current
slot within the library and specifies the slot address in a message.
The server then prompts you to remove the cartridge from the slot and to issue a REPLY command. |
The server leaves the cartridge in its current
slot within the library and specifies the slot address in a message.
The server does not prompt you to remove the cartridge and does not require a REPLY command. |
The server leaves the cartridge in its current
slot within the library and specifies the slot address in a message.
The server does not prompt you to remove the cartridge and does not require a REPLY command. |
The server leaves the cartridge in its current
slot within the library and specifies the slot address in a message.
The server does not prompt you to remove the cartridge and does not require a REPLY command. |
Has entry/exit ports and an entry/exit port is available | The server moves the cartridge to the available
entry/exit port and specifies the port address in a message. The server then prompts you to remove the cartridge from the slot and to issue a REPLY command. |
The server moves the cartridge to the available
entry/exit port and specifies the port address in a message. The server does not prompt you to remove the cartridge and does not request a REPLY command. |
The server specifies the port address in
a message. The server does not prompt you to remove the cartridge and does not request a REPLY command. |
The server moves the cartridge to the available
entry/exit port and specifies the port address in a message. The server does not prompt you to remove the cartridge and does not request a REPLY command. |
Has entry/exit ports, but no ports are available | The server leaves the cartridge in its current
slot within the library and specifies the slot address in a message.
The server then prompts you to remove the cartridge from the slot and to issue a REPLY command. |
The server waits for a port to be made available. | The server specifies the port address in
a message. The server does not prompt you to remove the cartridge and does not request a REPLY command. |
The command fails and any remaining eligible
volumes are not processed. Make the port available and issue the command again. |
REMOVE=YES or REMOVE=BULK | REMOVE=NO |
---|---|
The server ejects the cartridge to the convenience
I/O station. The server then deletes the volume entry from the server library inventory. When you move volumes from the MOUNTABLE state with REMOVE=YES specified, the MOVE MEDIA command uses more than one slot in the CAP for a StorageTek library with ACSLS. |
The server does not eject the cartridge. The server deletes the volume entry from the server library inventory and leaves the volume in the library. |
REMOVE=YES, REMOVE=BULK, or REMOVE=NO |
---|
The server requests the external library manager
to eject the volume from the library. It depends on the external library manager as to whether the volume is ejected from the library. Refer to the external library documentation for information about the procedures to follow when you use the MOVE DRMEDIA command to track volumes. |
If volumes are in an automated library, Tivoli Storage Manager might eject the volumes from the library before you change them to the NOTMOUNTABLE state, depending on the behavior of the REMOVE parameter.
For external libraries, the server sends requests to the external library manager to eject the volumes. It depends whether or not the volumes are ejected from the library is dependent on the external library manager. Refer to the external library documentation for information about the procedures to follow when you use the MOVE DRMEDIA command to track the volumes.
Depending on the behavior of the REMOVE parameter and whether volumes are in an automated library, Tivoli Storage Manager might eject the volumes from the library before you change them to the COURIER state.
For external libraries, the server sends requests to the external library manager to eject the volumes. It depends on the external library manager as to whether or not the volumes are ejected from the library. Refer to the external library documentation for information about the procedures to follow when you use the MOVE DRMEDIA command to track the volumes.
Depending on the behavior of the REMOVE parameter and whether volumes are in an automated library, Tivoli Storage Manager might eject the volumes from the library before you change them to the VAULT state.
For external libraries, the server sends requests to the external library manager to eject the volumes. It depends on the external library manager whether or not the volumes are ejected from the library. Refer to the external library documentation for information about the procedures to follow when you use the MOVE DRMEDIA command to track the volumes.
cmd="checkin libvol lib8mm &vol status=scratch"
The following
example is not a valid way to specify the CMD parameter:cmd=""checkin libvol lib8mm" &vol status=scratch""
If you do not specify a file name or if you specify a null string (""), DRM uses the file name that is specified by the SET DRMCMDFILENAME command. If you do not specify a file name with the SET DRMCMDFILENAME command, DRM generates a file name by appending exec.cmds to the directory path name of the current working directory of the Tivoli Storage Manager server.
If the operation fails after the command file is created, the file is not deleted.
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 that is specified by the SET DRMCMDFILENAME command. If you do not specify a file name with the SET DRMCMDFILENAME command, DRM generates a file name by appending exec.cmd to the directory that represents this instance of the Tivoli Storage Manager server (typically the directory from which the server was installed). The DRM allocates the file name that is specified or generated. If the file name exists, DRM tries to use it; any existing data is overwritten. If this happens and the executable commands in the file have not been run, issue QUERY DRMEDIA command to rebuild the executable commands for the desired date and volume transition
If the MOVE DRMEDIA command fails and none of the command string that is specified with the CMD parameter is written for the volume that successfully moved, the allocated file name is deleted.
Messages that are created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.
To see whether the operation was successful, issue the QUERY ACTLOG command.
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 |
Use the following tables to determine the state transitions that volumes are eligible for, based on their current state.
Current state of the volume | 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 |
Current state of the volume | 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 |
move drmedia * wherestate=notmountable
tostate=courier
query actlog search="MOVE DRMEDIA"
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.
move drmedia * wherestate=mountable tostate=courier wait=yes
ANR0984I Process 12 for MOVE DRMEDIA started
in the FOREGROUND at 09:57:17.
ANR0609I MOVE DRMEDIA started as process 12.
ANR0610I MOVE DRMEDIA started by HSIAO as
process 12.
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.
move drmedia * wherestate=vaultretrieve tostate=onsiteretrieve
cmdfilename=/drm/move/exec.cmds
cmd="checkin libvol lib8mm &vol status=scratch"
move drmedia * wherestate=vaultretrieve tostate=onsiteretrieve
cmdfilename=c:\drm\move\exec.cmd
cmd="checkin libvol lib8mm &vol status=scratch"
Query
the results:query actlog search="MOVE DRMEDIA"
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.
The
volume check-in commands were also created in the file:checkin libvol lib8mm CSTP01 status=scratch
checkin libvol lib8mm CSTP02 status=scratch
checkin libvol lib8mm DBTP10 status=scratch
checkin libvol lib8mm DBTP11 status=scratch
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. |
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 DRMACTIVEDATASTGPOOL | Specifies that active-data storage pools are managed by DRM. |
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. |