Administrator's Reference

MOVE DRMEDIA (Move Disaster Recovery Media Offsite and Back Onsite)

This command only applies to environments licensed to use the ADSM Disaster Recovery Manager (DRM) feature.

Use the MOVE DRMEDIA command to identify and track volumes that are to be moved offsite for disaster recovery protection and to identify the expired or empty volumes that are to be moved back to onsite location for reuse. This command processes one or more database backup and copy storage pool volumes. It does not process the database backup and copy storage pool volumes that are the backup objects on another server.

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

The MOVE DRMEDIA command defines a staged process that allows volumes to transition through the following states. You may choose to transition your offsite volumes through each of the following states or may choose to simplify your volume movements by skipping some of the states using the TOSTATE parameter.

MOUNTABLE: Volumes in this state contain valid data and are accessible for onsite processing.
NOTMOUNTABLE: Volumes in this state are onsite, contain valid data, and not available for onsite processing.
COURIER: Volumes in this state are with the courier and being moved to an offsite location.
VAULT: Volumes in this state contain valid data and are at the offsite location. When volume data becomes invalid the volumes automatically transition to the VAULTRETRIEVE state. Since this is an automatic transition, you cannot use the MOVE DRMEDIA command to change the VAULT state.
VAULTRETRIEVE: Volumes in this state do not contain valid data and are at the offsite vault. Copy storage pool volumes are empty and have met the REUSEDELAY days and database backup volumes are associated with the series that are expired based on the SET DRMDBBACKUPEXPIREDAYS command. These volumes are to be reused.
COURIERRETRIEVE: Volumes in this state do not contain valid data and are with the courier and being moved back to the onsite location.
ONSITERETRIEVE: Volumes in this state do not contain valid data, are at the onsite location, and not managed by DRM. The volume records of the database backup and scratch copy storage pool volumes are deleted from the ADSM database. The volume records of the private copy storage pool volumes are updated with the READWRITE access mode in ADSM database.

Privilege Class

To issue this command, you must have system, unrestricted storage, or operator privilege.

Syntax

>>-MOVe DRMedia--volname---------------------------------------->
 
>---+-------------------------------------+--------------------->
    '-WHERESTate--=--+-MOuntable-------+--'
                     +-NOTMOuntable----+
                     +-COUrier---------+
                     +-VAULTRetrieve---+
                     '-COURIERRetrieve-'
 
>---+---------------------+--+-------------------+-------------->
    '-BEGINDate--=--date--'  '-ENDDate--=--date--'
 
>---+---------------------+--+-------------------+-------------->
    '-BEGINTime--=--time--'  '-ENDTime--=--time--'
 
                                    .-DBBackup--=--Yes------.
>---+----------------------------+--+-----------------------+--->
    '-COPYstgpool--=--poolname---'  '-DBBackup--=--+-Yes-+--'
                                                   '-No--'
 
     .-REMove--=--Yes-------.
>----+----------------------+----------------------------------->
     '-REMove--=--+-No---+--'
                  +-Yes--+
                  '-Bulk-'
 
>----+----------------------------------+----------------------->
     '-TOSTate--=--+-NOTMOuntable----+--'
                   +-COUrier---------+
                   +-VAult-----------+
                   +-COURIERRetrieve-+
                   '-ONSITERetrieve--'
 
>----+------------------------------+--------------------------->
     '-WHERELOcation--=--location---'
 
>----+---------------------------+------------------------------>
     '-TOLOcation--=--location---'
 
>----+---------------------------------------------------------+>
     '-CMd--=--"string substitution string substitution ..."---'
 
                                     .-APPend--=--No-------.
>----+----------------------------+--+---------------------+---->
     '-CMDFilename--=--filename---'  '-APPend--=--+-No--+--'
                                                  '-Yes-'
 
     .-Wait--=--No-------.
>----+-------------------+-------------------------------------><
     '-Wait--=--+-No--+--'
                '-Yes-'

Parameters

volname

Specifies the name of the database backup or copy storage pool volume to be processed. This parameter is required. You can use a pattern- matching expression to specify this name. All matching volumes are considered for processing. If you use pattern-matching expression, you must specify WHERESTATE.

WHERESTate=statevalue

Specifies the state of volumes to be processed. This parameter is used to restrict processing to volumes that are currently in the specified state. This parameter is required if the TOSTATE is not specified. If you use a pattern-matching expression for the volume name, you must specify WHERESTATE. For more information, see Table 114 and Table 115.

Possible values are:

MOuntable: Specifies that volumes are to transition from the MOUNTABLE state to the NOTMOUNTABLE state if the TOSTATE is not specified. If the volumes are in an automated library (including an external library type), MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to the destination state. Volumes in the MOUNTABLE state contain valid data and are available for onsite processing.
NOTMOuntable: Specifies that volumes are to transition from the NOTMOUNTABLE state to the COURIER state if the TOSTATE is not specified. Volumes in the NOTMOUNTABLE state are onsite, contain valid data, and not available for onsite processing.
COUrier: Specifies that volumes are to transition from the COURIER state to the VAULT state. The only valid destination state for the volumes in COURIER state is VAULT. Volumes in the COURIER state are with the courier and being moved to an offsite location.
VAULTRetrieve: Specifies that volumes are to transition from the VAULTRETIEVE state to the COURIERRETRIEVE state if the TOSTATE is not specified. Volumes in the VAULTRETRIEVE state do not contain valid data and are at the offsite vault.
COURIERRetrieve: Specifies that volumes are to transition from the COURIERRETIEVE state back to the onsite location. The only valid destination state for the volumes in COURIERRETRIEVE state is ONSITERETRIEVE. The volume records of the database backup and scratch copy storage pool volumes are deleted from the ADSM database. Volumes in the COURIERRETRIEVE state are with the courier and being moved back to the onsite location.

BEGINDate=date

Specifies the beginning date used to select volumes for processing. Volumes are considered eligible if the MOVE DRMEDIA command has transitioned the state of the volume on or after the specified date. This parameter is optional. The default is the earliest date for which volume information exists. Possible values are:

MM/DD/YYYY: Specifies that you want to process volumes that were transitioned into their current state on or after a specific date, using MM/DD/YYYY format (for example, 01/31/1997).
TODAY: Specifies that you want to process volumes that were transitioned into their current state today.
TODAY-numdays or -numdays: Specifies that you want to process volumes that were transitioned into their current state beginning with a date determined by today minus a specific number of days. The maximum value for the number of days is 9999.
For example, to move volumes beginning with records transitioned into their current state a week ago, you can specify TODAY-7 or simply -7.

ENDate=date

Specifies the ending date used to select volumes for processing. Volumes are considered eligible if the MOVE DRMEDIA command has transitioned the state of the volume on or before the specified date. This parameter is optional. The default is the current date. Possible values are:

MM/DD/YYYY: Specifies that you want to process volumes that were transitioned into their current state on or before a specific date, using MM/DD/YYYY format (for example, 01/31/1997).
TODAY: Specifies that you want to process volumes that were transitioned into their current state ending with today.
TODAY-numdays or -numdays: Specifies that you want to process volumes that were transitioned into their current state ending with a date determined by today minus a specific number of days. The maximum value for the number of days is 9999.
For example, to move volumes beginning with records transitioned into their current state a week ago, you can specify TODAY-7 or simply -7.

BEGINTime=time

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

HH:MM:SS: Specifies that you want to process volumes that were transitioned into their current state on or after a specific time on the specified date, using HH:MM:SS format (for example, 12:33:28).
NOW: Specifies that you want to process volumes that were transitioned into their current state beginning with the current time on the specified begin date.
NOW+numhours:numminutes or +numhours:numminutes: Specifies that you want to process volumes that were transitioned into their current state beginning with a time determined by the current time plus a specific number of hours (and, optionally, minutes) on the specified date.
NOW-numhours:numminutes or -numhours:numminutes: Specifies that you want to process volumes that were transitioned into their current state beginning with a time determined by the current time minus a specific number of hours (and, optionally, minutes) on the specified date.

ENDTime=time

Specifies the ending time used to select volumes for processing. Volumes are considered eligible if the MOVE DRMEDIA command has transitioned the state of the volume on or before the specified time and date. This parameter is optional. The default is 23:59:59. Possible values are:

HH:MM:SS: Specifies that you want to process volumes that were transitioned into their current state on or before a specific time on the specified date, using HH:MM:SS format (for example, 12:33:28).
NOW: Specifies that you want to process volumes that were transitioned into their current state beginning with the current time on the specified begin date.
NOW+numhours:numminutes or +numhours:numminutes: Specifies that you want to process volumes that were transitioned into their current state ending with a time determined by the current time plus a specific number of hours (and, optionally, minutes) on the specified date.
NOW-numhours:numminutes or -numhours:numminutes: Specifies that you want to process volumes that were transitioned into their current state ending with a time determined by the current time minus a specific number of hours (and, optionally, minutes) on the specified date.

COPYstgpool=poolname

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.

DBBackup=dbvalue

Specifies whether database backup volumes are included in the selection of volumes for processing. This parameter is optional. The default is to consider database backup volumes for processing. Possible values are:

Yes: Specifies to consider database backup volumes for processing.
No: Specifies to not consider database backup volumes for processing.

REMove=removevalue

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

Yes: Specifies that the volume is ejected from the library during MOVE DRMEDIA processing. The volume entry is deleted from the ADSM library inventory. This option applies to all automated libraries.
No: Specifies that the volume is not ejected from a SCSI library during MOVE DRMEDIA processing. This option only applies to a SCSI library. This option deletes the volume entry from the ADSM library inventory and leaves the volume in its slot. REMOVE=NO option does not apply to a 349x library. For a 349x library, the volume is always ejected from the library even if REMOVE=NO is specified on the MOVE DRMEDIA command.
Bulk: For 349x libraries, it specifies that the volume is ejected to a predefined high capacity area, instead of an I/O station, in the library. For SCSI libraries with multiple Entry/Exit ports, it specifies that the volume is ejected to the next available Entry/Exit port. An informational message is issued stating that the tape volume should be removed from the Bulk I/O station at the convenience of the operator. Please note, the user is not prompted to issue the REPLY command. Once all Entry/Exit ports are full, the cartridge will be left in its home cell and an informational message is issued stating that the tape volume should be removed from its home cell at the convenience of the operator. This message will provide the home cell's element number, which in some libraries may require an element map to identify it. ADSM documentation provides maps for many of the common libraries, and it should also be in the hardware documentation. If you specify REMOVE=BULK for a SCSI library that does not have multiple Entry/Exit ports, ADSM will leave the volume at its home cell (works as if you have specified REMOVE=NO). REMOVE=BULK does not apply to a library type of EXTERNAL.

TOSTate=statevalue

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

Possible values are:

NOTMOuntable: Specifies that volumes are to transition to the NOTMOUNTABLE state. This value is only valid when the volumes being processed have a MOUNTABLE state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to NOTMOUNTABLE state.
COUrier: Specifies that volumes are to transition to the COURIER state. This value is only valid when the volumes being processed have a MOUNTABLE or NOTMOUNTABLE state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to COURIER state.
VAult: Specifies that volumes are to transition to the VAULT state. This value is only valid when the volumes being processed have a MOUNTABLE, NOTMOUNTABLE, or COURIER state. If the volumes are in an automated library, MOVE DRMEDIA will eject the volumes out of the library before transition the volumes to VAULT state.
COURIERRetrieve: Specifies that volumes are to transition to the COURIERRETRIEVE state. This value is only valid when the volumes being processed have a VAULTRETRIEVE state.
ONSITERetrieve: Specifies that volumes are to transition to the ONSITERETRIEVE state. This value is only valid when the volumes being processed have a VAULTRETRIEVE or COURIERRETRIEVE state. The volume records are deleted from the ADSM database for the database backup and scratch copy storage pool volumes that are transition to the ONSITERETRIEVE state.

WHERELOcation=location

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

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 the destination location is not specified with the TOLOCATION, the location defined by the DRM SET command for the state that the volume is transition to will be used.

CMd="string substitution string substitution ..."

Specifies the creation of executable commands. This parameter is optional. You must enclose your executable command specification in quotation marks. The maximum length of the executable command specification is 255 characters. For each volume successfully processed by MOVE DRMEDIA command, DRM writes the associated commands to a file. The filename used by DRM is specified with the CMDFILENAME parameter, the SET DRMCMDFILENAME command, or the default name generated by the MOVE DRMEDIA command. If the length of the line written exceeds 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 MOVE DRMEDIA command. You can specify any free form text for the string. Do not use embed quotation marks. For example, the following is a valid executable command specification:

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

The following is an invalid executable command specification:

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

substitution

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

&VOL: Specifies the volume name is to be substituted for &VOL. You can specify the lowercase characters, &vol. No spaces or blanks between ampersand, &, and VOL. If there are spaces or blanks between ampersand and VOL, MOVE DRMEDIA will treat them as strings and no substitution will be set. If &VOL is not specified, no volume name is set in the executable command.
&LOC: Specifies the volume location is to be substituted for &LOC. You can specify lowercase characters, &loc. No spaces or blanks between ampersand, &, and LOC. If there are spaces or blanks between ampersand and LOC, MOVE DRMEDIA will treat them as strings and no substitution will be set. If &LOC is not specified, no location name is set in the executable command.
&VOLDSN: Specifies the file name, that the server writes into the sequential access media labels, is to be substituted for &VOLDSN. An example of a copy storage pool tape volume file name using the default prefix ADSM is ADSM.BFS. An example of a database backup tape volume file name using a prefix ADSM221 defined with the device class is ADSM221.DBB. If &VOLDSN is not specified, no volume file 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=filename

Specifies the fully qualified file name that will contain the commands specified with CMD. This parameter is optional. If you do not specify a file name or specify a "" with the CMDFILENAME, the file name specified with the SET DRMCMDFILENAME will be used. If you do not specify a file name with the SET DRMCMDFILENAME, MOVE DRMEDIA will generate a file name by appending the 'exec.cmds' to the directory pointed to by the DSMSERV_DIR environment variable or to the directory path name of the current working directory of the ADSM server process.

MOVE DRMEDIA automatically creates the file name specified or generated. See the APPEND parameter for information to determine whether to open the file in append mode. If MOVE DRMEDIA fails after the command file has been created, the file is not deleted.

APPend=appendvalue

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. 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.
Yes: Specifies to open the command file in append mode for writing at the end of the file.

Wait=waitvalue

Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default value is No.

Note:

You cannot specify Wait=Yes from the server console.

Possible values are:

No: Specifies that the server processes this command in the background. You can continue with other tasks while the command is being processed. Messages created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.
Yes: Specifies that the server processes this command in the foreground. You wait for the command to complete before continuing with other tasks. The server then displays the output messages to the administrative client when the command completes.

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

Destination state:
- TOSTATE specified.
- The next state of the WHERESTATE specified, if the TOSTATE is not specified.
Destination location:
- TOLOCATION specified.
- The location of the TOSTATE specified, if the TOLOCATION is not specified.
- The location of the next state of the WHERESTATE specified, if the TOLOCATION and TOSTATE are not specified.

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

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 115. 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
VAULT-RETRIEVE N N N N
COURIER-RETRIEVE N N N N
ONSITE-RETRIEVE N N N N

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

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

Output:

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

Command:

query actlog search="MOVE DRMEDIA"

Output:

+--------------------------------------------------------------------------------+
|08/11/1997 11:12:24      ANR0984I Process 10 for MOVE DRMEDIA started           |
|                          in the BACKGROUND at 11:12:24.                        |
|08/11/1997 11:12:24      ANR0610I MOVE DRMEDIA started by HSIAO as              |
|                          process 10.                                           |
|08/11/1997 11:12:25      ANR6683I MOVE DRMEDIA: Volume TAPE0P was moved         |
|                          from NOTMOUNTABLE state to COURIER.                   |
|08/11/1997 11:12:25      ANR6683I MOVE DRMEDIA: Volume TAPE1P was moved         |
|                          from NOTMOUNTABLE state to COURIER.                   |
|08/11/1997 11:12:25      ANR6683I MOVE DRMEDIA: Volume DBTP02 was moved         |
|                          from NOTMOUNTABLE state to COURIER.                   |
|08/11/1997 11:12:25      ANR6683I MOVE DRMEDIA: Volume DBTP01 was moved         |
|                          from NOTMOUNTABLE state to COURIER.                   |
|08/11/1997 11:12:25      ANR6682I MOVE DRMEDIA command ended: 4 volumes         |
|                          processed.                                            |
|08/11/1997 11:12:25      ANR0611I MOVE DRMEDIA started by HSIAO as              |
|                          process 10 has ended.                                 |
|08/11/1997 11:12:25      ANR0985I Process 10 for MOVE DRMEDIA running in        |
|                          the BACKGROUND completed with completion state        |
|                          SUCCESS at 11:12:25.                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

Task 2

Move DRM media that is in the MOUNTABLE state to the COURIER state. If the media is in an automated library, MOVE DRMEDIA will eject the media out of the library before transition them to the COURIER state.

Command:: move drmedia * wherestate=mountable tostate=courier wait=yes
Output:

+--------------------------------------------------------------------------------+
|ANR0984I Process 12 for MOVE DRMEDIA started                                    |
| in the FOREGROUND at 09:57:17.                                                 |
|ANR0609I MOVE DRMEDIA started as process 12.                                    |
|ANR0610I MOVE DRMEDIA started by HSIAO as                                       |
| process 12.                                                                    |
|ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume TAPE01 in library LIBONE starting.                                      |
|ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume TAPE01 in library LIBONE completed                                      |
| successful.                                                                    |
|ANR6683I MOVE DRMEDIA: Volume TAPE01 was moved                                  |
| from MOUNTABLE state to COURIER.                                               |
|ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume TAPE02 in library LIBONE starting.                                      |
|ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume TAPE02 in library LIBONE completed                                      |
| successful.                                                                    |
|ANR6683I MOVE DRMEDIA: Volume TAPE02 was moved                                  |
| from MOUNTABLE state to COURIER.                                               |
|ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume DBTP05 in library LIBONE starting.                                      |
|ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume DBTP05 in library LIBONE completed                                      |
| successful.                                                                    |
|ANR6683I MOVE DRMEDIA: Volume DBTP05 was moved                                  |
| from MOUNTABLE state to COURIER.                                               |
|ANR6696I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume DBTP04 in library LIBONE starting.                                      |
|ANR6697I MOVE DRMEDIA: CHECKOUT LIBVOLUME for                                   |
| volume DBTP04 in library LIBONE 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 completed with completion                                    |
| state SUCCESS at 10:12:25.                                                     |
|                                                                                |
+--------------------------------------------------------------------------------+

Task 3

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

Command:

move drmedia * wherestate=vaultretrieve tostate=onsiteretrieve cmdfilename=/drm/move/exec.cmds cmd="checkin libvol lib8mm &vol status=scratch"

Output:

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

Command:

query actlog search="MOVE DRMEDIA"

Output:

+--------------------------------------------------------------------------------+
|08/13/1997 09:12:24   ANR0984I Process 15 for MOVE DRMEDIA started in           |
|                       the BACKGROUND at 09:12:24.                              |
|08/13/1997 09:12:24   ANR0610I MOVE DRMEDIA started by HSIAO as process         |
|                       15.                                                      |
|08/13/1997 09:12:24   ANR6684I MOVE DRMEDIA: Volume CSTP01 was delete.          |
|08/13/1997 09:12:24   ANR6684I MOVE DRMEDIA: Volume CSTP02 was delete.          |
|08/13/1997 09:12:24   ANR6684I MOVE DRMEDIA: Volume DBTP10 was delete.          |
|08/13/1997 09:12:24   ANR6684I MOVE DRMEDIA: Volume DBTP11 was delete.          |
|08/13/1997 09:12:27   ANR6682I MOVE DRMEDIA command ended: 4 volumes            |
|                       processed.                                               |
|08/13/1997 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 completed with completion state           |
|                       SUCCESS at 09:12:42.                                     |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

Output:

MOVE DRMEDIA also created the executable commands in /drm/move/exec.cmds:

+--------------------------------------------------------------------------------+
|checkin libvol libone CSTP01 status=scratch                                     |
|checkin libvol libone CSTP02 status=scratch                                     |
|checkin libvol libone DBTP10 status=scratch                                     |
|checkin libvol libone DBTP11 status=scratch                                     |
+--------------------------------------------------------------------------------+

Note: The above checkin commands can be executed by issuing the ADSM MACRO command with /drm/move/exec.cmds as the macro name.

Related Commands

Table 116. Commands Related to MOVE DRMEDIA

Command Description
BACKUP DB Backs up the ADSM 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 Searches for and displays messages from the server activity log.
QUERY DRMSTATUS Displays DRM system parameters.
QUERY PROCESS Displays information about one or all background server processes.
QUERY DRMEDIA Displays information about disaster recovery volumes.
SET DRMCHECKLABEL Specifies whether ADSM should read volume labels during MOVE DRMEDIA command processing.
SET DRMCOPYSTGPOOL Specifies that copy storage pools are managed by DRM.
SET DRMCOURIERNAME Specifies the name of the courier for the disaster recovery media.
SET DRMDBBACKUPEXPIREDAYS Specifies criteria for database backup series expiration.
SET DRMVAULTNAME Specifies the name of the vault where DRM media is stored.
SET DRMCMDFILENAME Specifies a file name for containing DRM executable commands.
SET DRMFILEPROCESS Specifies whether the MOVE DRMEDIA command processes files associated with a device type of file.
SET DRMNOTMOUNTABLENAME Specifies the location name of the DRM media to be sent offsite.

Command	Description
BACKUP DB	Backs up the ADSM 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	Searches for and displays messages from the server activity log.
QUERY DRMSTATUS	Displays DRM system parameters.
QUERY PROCESS	Displays information about one or all background server processes.
QUERY DRMEDIA	Displays information about disaster recovery volumes.
SET DRMCHECKLABEL	Specifies whether ADSM should read volume labels during MOVE DRMEDIA command processing.
SET DRMCOPYSTGPOOL	Specifies that copy storage pools are managed by DRM.
SET DRMCOURIERNAME	Specifies the name of the courier for the disaster recovery media.
SET DRMDBBACKUPEXPIREDAYS	Specifies criteria for database backup series expiration.
SET DRMVAULTNAME	Specifies the name of the vault where DRM media is stored.
SET DRMCMDFILENAME	Specifies a file name for containing DRM executable commands.
SET DRMFILEPROCESS	Specifies whether the MOVE DRMEDIA 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 ]