MOVE DRMEDIA (Move disaster recovery media offsite and back onsite)

Use this command to track volumes that are to be moved offsite and to identify the expired or empty volumes that are to be moved onsite. You can track database backup volumes, and volumes in copy storage pools and active-data storage pools.

The processing of volumes by this command depends on what the volumes are used for:

Backups of the server database: To control whether the command processes database backup volumes, use the SOURCE parameter on this command. The command can process volumes that are used for full plus incremental or snapshot database 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.
Copy storage pools: The MOVE DRMEDIA command always processes copy storage-pool volumes.
Active-data storage pools: By default, volumes in active-data storage pools are not eligible for processing by the MOVE DRMEDIA command. To process active-data pool volumes, you must issue the SET DRMACTIVEDATASTGPOOL command first, or specify the ACTIVEDATASTGPOOL parameter on the MOVE DRMEDIA command.

You can use the QUERY ACTLOG command to see whether the MOVE DRMEDIA command was successful. You can also view this information from the server console.

Restriction: Do not run the MOVE DRMEDIA and BACKUP STGPOOL commands concurrently. Ensure that the storage pool backup processes are complete before you issue the MOVE DRMEDIA command.

Privilege class

To issue this command, you must have one of the following privilege classes:

If the CMD parameter is specified and the REQSYSAUTHOUTFILE server option is set to NO: operator, unrestricted storage, or system privilege.
If the CMD parameter is specified and the REQSYSAUTHOUTFILE server option is set to YES (the default): system privilege.

Syntax


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

Parameters

volume_name (Required)

Specifies the name of the volume to be processed. You can use wildcard characters. If you use wildcard characters to specify this name, you must also specify the WHERESTATE parameter. The server looks for matching names among the following eligible volumes:

Database backup volumes, as specified by the SOURCE parameter of this command.
Copy storage pool volumes from the storage pools named in the COPYSTGPOOL parameter. If you do not use the COPYSTGPOOL parameter, the server processes volumes from copy storage pools that were previously specified in the SET DRMCOPYSTGPOOL command.
Active-data storage pool volumes from the storage pools named in the ACTIVEDATASTGPOOL parameter. If you do not use the ACTIVEDATASTGPOOL parameter, the server processes volumes from active-data storage pools that were previously specified in the SET DRMACTIVEDATASTGPOOL command.

Other parameters can also limit the results of the command.

WHERESTate

Specifies the state of volumes to be processed. This parameter is required if the TOSTATE parameter is not specified or if you use a wildcard character in the volume name. For more information, see Table 2 and Table 3. Specify one of the following values:

MOuntable

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, the server 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.

NOTMOuntable

These volumes are onsite, contain valid data, and are not available for onsite processing. The values change to COURIER if the TOSTATE parameter is not specified.

COUrier

These volumes are with the courier and being moved offsite. The values change only to VAULT.

VAULTRetrieve

These volumes are at the offsite vault and do not contain valid data. The values change to COURIERRETRIEVE if the TOSTATE parameter is not specified.

COURIERRetrieve

These volumes are with the courier and being moved onsite. The values change only to ONSITERETRIEVE. The server deletes the volume records of the database backup and scratch copy storage pool volumes from the database.

BEGINDate

Specifies the beginning date that is used to select volumes. This parameter is optional. Volumes are considered eligible if the MOVE DRMEDIA command changes 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 date by using one of the following values:

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

ENDDate

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

You can specify the date by using one of the following values:

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.

BEGINTime

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

You can specify the time by using one of the following values:

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, the server identifies the volumes that were changed to their current state at 5:30 on the begin date that you specify.

ENDTime

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

You can specify the time by using one of the following values:

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, the server 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. If you use wildcard characters to specify this name, you must also specify the WHERESTATE parameter.

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, the server selects the storage pools as follows:

If the SET DRMCOPYSTGPOOL command was previously issued with valid copy storage pool names, the server processes only those storage pools.
If the SET DRMCOPYSTGPOOL command was not issued, or if all of the copy storage pools are removed by using the SET DRMCOPYSTGPOOL command, the server processes all copy storage pool volumes in the specified state. The states available are MOUNTABLE, NOTMOUNTABLE, COURIER, VAULTRETRIEVE, or COURIERRETRIEVE.

ACTIVEDatastgpool

Specifies the name of the active-data pool whose volumes are to be processed. This parameter is optional. You can use wildcard characters to specify this name. If you use wildcard characters to specify this name, you must also specify the WHERESTATE parameter.

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, the server selects the storage pools in the following way:

If the SET DRMACTIVEDATASTGPOOL command was previously issued with valid active-data pool names, the server processes only those storage pools.
If the SET DRMACTIVEDATASTGPOOL command was not issued, or all of the active-data pools are removed by using the SET DRMACTIVEDATASTGPOOL command, the server processes all active-data pool volumes in the specified state. The states available are NOTMOUNTABLE, COURIER, VAULTRETRIEVE, or COURIERRETRIEVE. Volumes in the MOUNTABLE state are not processed.

Source

Specifies whether to include database backup volumes for processing. This parameter is optional. The default is DBBACKUP. Specify one of the following values:

DBBackup: Specifies that the server includes full and incremental database backup volumes for processing.
DBSnapshot: Specifies that the server includes database snapshot backup volumes for processing.
DBNOne: Specifies that the server does not include any database backup volumes for processing.

REMove

Specifies that the server tries to move the volume out of the library and into the convenience I/O station or entry/exit ports. This parameter is optional. Possible values are YES, NO, BULK, and UNTILEEFULL. The default is BULK. The response of the server to each value and the default value depends on the type of library.

Restriction: You can use the REMOVE=UNTILEEFULL option only with the library type SCSI.

SCSI libraries

The response of the server to the command depends on whether the library has entry/exit ports, and if so, whether a port is available for use. See the following table.

Table 1. Server response for SCSI libraries
Library characteristic	Server response when you specify REMOVE=YES	Server response when you specify REMOVE=BULK	Server response when you specify REMOVE=NO	Server response when you specify REMOVE=UNTILEEFULL
Library has no 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.
Library 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.
Library 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.

349X libraries

REMOVE=YES: The 3494 Library Manager ejects the cartridge to the convenience I/O station.
REMOVE=BULK: The 3494 Library Manager ejects the cartridge to the high-capacity output facility.
REMOVE=NO: 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.

ACSLS libraries

REMOVE=YES or REMOVE=BULK

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.

REMOVE=NO

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.

External libraries

You can specify REMOVE=YES, REMOVE=BULK, or REMOVE=NO. For any value, the server requests the external library manager to eject the volume from the library.

It depends on the external library manager 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.

TOSTate

Specifies the destination state of the volumes that are processed. This parameter is required if the WHERESTATE parameter is not specified. If you specify TOSTATE parameter but not WHERESTATE parameter, you must specify the volume name. Wildcard characters are not allowed. See Table 2 and Table 3.

Specify one of the following values:

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 volumes are in an automated library, the server 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. Whether the volumes are ejected from the library depends 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.

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.

Depending on the behavior of the REMOVE parameter and whether volumes are in an automated library, the server might eject the volumes from the library before you change 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.

Depending on the behavior of the REMOVE parameter and whether volumes are in an automated library, the server might eject the volumes from the library before you change 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 changing to the ONSITERETRIEVE state, the server 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 that is 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 that is defined by the SET DRMNOTMOUNTABLE command is used.

CMd

Specifies a command to be issued for each volume that is processed by the MOVE DRMEDIA command. DRM writes the commands to a file that is specified by the CMDFILENAME parameter. After the MOVE DRMEDIA operation is completed, the commands in the file can be issued. The command can contain up to 255 characters. If the command contains more than 240 characters, it is split into multiple lines, and continuation characters (+) are added. You might need to alter the continuation character based on the operating system. This parameter is optional.

command

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

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

The command can include substitution variables. The variables are not case-sensitive, and must not contain blank spaces after the ampersand (&). You can specify the following values:

&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 BKP as the tape volume prefix, a copy storage pool tape volume file name might be BKP.BFS and a database backup tape volume file name might be BKP.DBB.
&NL: The new line character. When you use the new line character, the command is split at the &NL variable. If required, you must specify the appropriate continuation character before the &NL character. If the &NL character 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 contains the commands that are specified by CMD parameter. This parameter is optional.

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

If the operation fails after the command file is created, the file is not deleted.

CMDFilename

Specifies the fully qualified name of the file that contains the commands that are 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 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 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.

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. Specify one of the following values:

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. Specify one of the following values:

No

Specifies that the server processes this command in the background.

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.

Yes

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

Restriction: You cannot specify WAIT=YES from the server console.

CAP

Specifies which cartridge access port (CAP) to use for ejecting volumes if you specify REMOVE=YES. This parameter applies to volumes in ACSLS libraries only. If the CAP priority value is set to 0 in the library, this parameter is required. If a CAP priority value greater than 0 is set in the library, this parameter is optional. By default, all CAPs initially have a priority value of 0, which means that ACSLS does not automatically select the CAP.

To display valid CAP identifiers (x,y,z), issue the QUERY CAP command with ALL specified from the Automated Cartridge System System Administrator (ACSSA) console on the ACSLS server host. The identifiers are as follows:

x: The Automated Cartridge System (ACS) ID. This identifier can be a number in the range 0 - 126.
y: The Library Storage Module (LSM) ID. This identifier can be a number in the range 0 - 23.
z: The CAP ID. This identifier can be a number in the range 0 - 11.

For more information, see the StorageTek documentation.

Rules for destination states and destination locations

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

Destination state

The value of the TOSTATE parameter that was specified
The next state of the WHERESTATE parameter that was specified, if the TOSTATE parameter was not specified

Destination location

The value of the TOLOCATION parameter that was specified
The location of the TOSTATE parameter that was specified, if the TOLOCATION parameter was not specified
The location of the next state of the WHERESTATE parameter that was specified, if the TOLOCATION and TOSTATE parameters are not specified

Table 2. Volume destination and location
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

Rules for state transitions

The following tables show the state transitions that volumes are eligible for, based on their current state.

Table 3. State transitions for volumes
The current state of the volume	Destination state
The current state of the volume	MOUNTABLE	NOTMOUNTABLE	COURIER
MOUNTABLE	N	Y	Y
NOTMOUNTABLE	N	N	Y
COURIER	N	N	N
VAULT	N	N	N
VAULTRETRIEVE	N	N	N
COURIERRETRIEVE	N	N	N
ONSITERETRIEVE	N	N	N

Table 4. State transitions for volumes
The current state of the volume	Destination state
The current state of the volume	VAULT	VAULTRETRIEVE
MOUNTABLE	Y	N
NOTMOUNTABLE	Y	N
COURIER	Y	N
VAULT	N	N
VAULTRETRIEVE	N	N
COURIERRETRIEVE	N	N
ONSITERETRIEVE	N	N

Table 5. State transitions for volumes
The current state of the volume	Destination state
The current state of the volume	COURIERRETRIEVE	ONSITERETRIEVE
MOUNTABLE	N	N
NOTMOUNTABLE	N	N
COURIER	N	N
VAULT	N	N
VAULTRETRIEVE	Y	Y
COURIERRETRIEVE	N	Y
ONSITERETRIEVE	N	N

Example: Move disaster recovery media from the NOTMOUNTABLE state

Move disaster recovery media that is in the NOTMOUNTABLE state to the COURIER state, and then query the results.

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.

Example: Move disaster recovery media from the MOUNTABLE state

Move disaster recovery media from the MOUNTABLE state to the COURIER state. If the media is in an automated library, MOVE DRMEDIA ejects the media before you change the state.

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.

Example: Move disaster recovery media from the VAULTRETRIEVE state

Move disaster recovery media that is in the VAULTRETRIEVE state to the ONSITERETRIEVE state. Generate a CHECKIN LIBVOLUME command for each volume that is successfully processed and store the commands in a file:

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 that was specified with the CMDFILENAME parameter:

/drm/move/exec.cmds
c:\drm\move\exec.cmd

The file contains these lines:

checkin libvol lib8mm CSTP01 status=scratch
checkin libvol lib8mm CSTP02 status=scratch
checkin libvol lib8mm DBTP10 status=scratch
checkin libvol lib8mm DBTP11 status=scratch

Tip: To process the CHECKIN LIBVOLUME commands, issue the MACRO command with the file name as the macro name.

Related commands

Table 6. Commands related to MOVE DRMEDIA
Command	Description
BACKUP DB	Backs up the Tivoli Storage Manager database to sequential access volumes.
BACKUP STGPOOL	Backs up a primary storage pool to a copy storage pool.
CANCEL PROCESS	Cancels a background server process.
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 DRMEDIA	Displays information about disaster recovery volumes.
QUERY DRMSTATUS	Displays DRM system parameters.
QUERY PROCESS	Displays information about background processes.
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.