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, container-copy storage pools, and active-data storage pools.
- 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.
- Container-copy storage pools
- By default, volumes in container-copy storage pools are not eligible for processing by the MOVE DRMEDIA command. To process container-copy storage pool volumes, you must issue the SET DRMCOPYCONTAINERSTGPOOL command first, or specify the COPYCONTAINERSTGPOOL parameter on the MOVE DRMEDIA command.
- 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.
Privilege class
- 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-' >--+------------------------------------+-----------------------> '-COPYCONtainerstgpool--=--pool_name-' >--+---------------------------+--------------------------------> '-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.
- Container-copy storage pool volumes from the storage pools named in the COPYCONTAINERSTGPOOL parameter. If you do not use the COPYCONTAINERSTGPOOL parameter, the server processes volumes from container-copy storage pools that were previously specified in the SET DRMCOPYCONTAINERSTGPOOL 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.
- 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 - COPYCONtainerstgpool
- Specifies the name of the container-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 container-copy storage pools that are specified with this parameter override storage pools that are specified with the SET DRMCOPYCONTAINERSTGPOOL command. If this parameter is not specified, the server selects the storage pools as follows:
- If the SET DRMCOPYCONTAINERSTGPOOL command was previously issued with valid container-copy storage pool names, the server processes only those storage pools.
- If the SET DRMCOPYCONTAINERSTGPOOL command was not issued, or if all of the container-copy storage pools were removed by using the SET DRMCOPYCONTAINERSTGPOOL command, the server processes all container-copy storage pool volumes based on the setting of the WHERESTATE parameter. If the parameter is set to a value of NOTMOUNTABLE, COURIER, VAULTRETRIEVE, or COURIERRETRIEVE, the volumes are processed. If the value is MOUNTABLE, the volumes are not processed.
- 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.
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.
- 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.
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.
- 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:
The following example is not a valid way to specify the CMD parameter:cmd="checkin libvol lib8mm &vol status=scratch"
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.
Rules for destination states and destination locations
- 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
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.
The current state of the volume | Destination state | ||
---|---|---|---|
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 |
The current state of the volume | Destination state | |
---|---|---|
VAULT | VAULTRETRIEVE | |
MOUNTABLE | Y | N |
NOTMOUNTABLE | Y | N |
COURIER | Y | N |
VAULT | N | N |
VAULTRETRIEVE | N | N |
COURIERRETRIEVE | N | N |
ONSITERETRIEVE | N | N |
The current state of the volume | Destination state | |
---|---|---|
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
checkin libvol lib8mm CSTP01 status=scratch
checkin libvol lib8mm CSTP02 status=scratch
checkin libvol lib8mm DBTP10 status=scratch
checkin libvol lib8mm DBTP11 status=scratch
Related commands
Command | Description |
---|---|
BACKUP DB | Backs up the IBM Spectrum Protect 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 DRMCOPYCONTAINERSTGPOOL | Specifies the container-copy storage pools that are used in DRM commands. |
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. |