Moving Recovery Media

This operation can do the following:

To perform these tasks, first complete the following fields and then click Finish, or click Cancel to end the task.

Volume Name

Enter the names of the database backup or copy storage pool volumes to be processed. This parameter is required. You can use a wildcard character (*) to specify this name. All matching volumes are considered for processing. If you use a wildcard character, you must specify the State field.

State

Enter the state of the volumes to be processed. If you use a wildcard character for the volume name, you must specify State.

Possible values are:

Mountable Volumes in the MOUNTABLE state to be changed to the NOTMOUNTABLE state. Volumes in an automated library will be ejected from the library before their state is changed. Volumes in the MOUNTABLE state contain valid data and are accessible for onsite processing.
Notmountable Volumes in the NOTMOUNTABLE state to be changed to the COURIER state. Volumes in the NOTMOUNTABLE state are onsite, contain valid data, and are not accessible for onsite processing.
Courier Volumes in the COURIER state to be changed to the VAULT state. Volumes in the COURIER state are with the courier and are being moved to an offsite location.
Vaultretrieve Volumes in the VAULTRETRIEVE state to be changed to the COURIERRETRIEVE state. Volumes in the VAULTRETRIEVE state do not contain valid data and are at the offsite vault.
Courierretrieve Volumes in the COURIERRETRIEVE state to be moved to the onsite location. The only valid destination state for these volumes is the ONSITERETRIEVE state. The volume records of the database backup and scratch copy storage pool volumes are deleted from the database. Volumes in the COURIERRETRIEVE state are with the courier and being moved back to the onsite location.

Begin Date

Enter the beginning date used to select volumes. Volumes are considered eligible when the Move Drmedia processing has changed the state of the volume on or after the specified date.  This field is optional. The default is the earliest date for which volume information exists.

Possible values are:

MM/DD/ YYYY Selects volumes that were changed to their current state on or after a specific date, using MM/DD/YYYY format.
TODAY Selects volumes that were changed to their current state today.
TODAY -days
 or
-days
Selects volumes that were changed to 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 changed to their current state a week ago,  specify TODAY-7 or simply -7.

End Date

Enter the ending date used to select volumes for processing. Volumes are considered eligible when Move Drmedia processing has changed the state of the volume on or before the specified date.  This field is optional. The default is the current date.

Possible values are:

MM/DD/ YYYY Selects volumes that were changed to their current state on or after a specific date, using MM/DD/YYYY format.
TODAY Selects volumes that were changed to their current state ending with today.
TODAY -days
 or
-days
Selects volumes that were changed to 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 changed to their current state a week ago,  specify TODAY-7 or simply -7.

Begin Time

Enter the beginning time used to select volumes for processing. Volumes are considered eligible when Move Drmedia processing has changed the state of the volume on or after the specified time and date.  This field is optional. The default is midnight (00:00:00).

Possible values are:

HH:MM:SS Selects volumes that were changed to their current state on or after a specific time on the specified date, using HH:MM:SS format.
NOW Selects volumes that were changed to their current state beginning with the current time on the specified begin date.
NOW +hours:minutes
 or
+hours:minutes
Selects volumes that were changed to 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 -hours:minutes or 
-hours:minutes
Selects volumes that were changed to 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.

End Time

Enter the ending time used to select volumes for processing. Volumes are considered eligible when Move Drmedia processing has changed the state of the volume on or before the specified time and date.  This field is optional. The default is 23:59:59.

Possible values are:

HH:MM:SS Selects volumes that were changed to their current state on or before a specific time on the specified date, using HH:MM:SS format.
NOW Selects volumes that were changed to their current state ending with the current time on the specified begin date.
NOW +hours: minutes
 or
+hours:minutes
Selects volumes that were changed to 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 -hours: minutes
 or
-hours:minutes
Selects volumes that were changed to 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.

Copy Storage Pool

Enter the name of the copy storage pool whose volumes are to be processed. This field is optional. The default is that all volumes in the specified state, except MOUNTABLE, are considered for processing.

Display Database Backup Volumes

Select whether database backup volumes are included for processing. The default is Yes.

Yes Include database backup volumes for processing.
No Do not include database backup volumes for processing.

Move to State

Select the destination state of the volumes being processed. This field is required if State is not specified. If Move to State is specified without specifying State, the volume name must not include the wildcard character.

Notmountable Specifies that volumes are to change to the NOTMOUNTABLE state. This value is only valid when the volumes being processed are in the MOUNTABLE state. Volumes in an automated library will be ejected from the library before moving the volumes to the NOTMOUNTABLE state.
Courier Specifies that volumes are to change to the COURIER state. This value is only valid when the volumes being processed are in the MOUNTABLE or NOTMOUNTABLE state. Volumes in an automated library will be ejected from the library before moving to the COURIER state.
Vault Specifies that volumes are to change to the VAULT state. This value is only valid when the volumes being processed are in the MOUNTABLE, NOTMOUNTABLE, or COURIER state. Volumes in an automated library will be ejected from the library before moving to the VAULT state.
Courierretrieve Specifies that volumes are to change to the COURIERRETRIEVE state. This value is only valid when the volumes being processed have a VAULTRETRIEVE state.
Onsiteretrieve Specifies that volumes are to change 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 database for the database backup and scratch copy storage pool volumes that are moving to the ONSITERETRIEVE state.

Where Location is

Enter the name of the location from which the volumes are to be processed. The maximum length of the name is 255 characters. This field is optional.

Move to Location

Enter the destination location of the volumes being processed. This field is optional.

Command

Enter the commands to be created. The commands will be stored in the file specified by the Command File Name field, in the file name specified by the Set DRM Command File Name panel, or in the file whose name is generated by Query Drmedia processing. To display the commands on the console only, specify a "" for the Command File Name field. This field is optional.

String

The command string used to process the volume name or volume location or both. Do not include quotation marks in the string.

Variables

Variables that can be replaced by a value during processing. The possible variables are:

&VOL A volume name.
&LOC A volume location.
&VOLDSN A file name to be written into the sequential access media labels.
&NL A new line character. During  processing, the command is split the &NL variable is and does not append a continuation character. If a continuation character is required, you must specify it just before the &NL. If the &NL is not specified and the line length exceeds 240 characters, the command line is split into multiple lines and continuation characters (+) are added as needed.

Command File Name

Enter the full path file name of the file that will contain the commands specified with the Command field. This field is optional.

Append

Select whether to append the commands to any existing commands in the file. The default is No.

Yes Append the commands.
No Overwrite any existing commands in the file.

Wait for Completion

Select whether to wait for the server to complete processing this command in the foreground. The default is No.

Yes The server processes this command in the foreground.
No The server processes this command in the background.

Remove Media

Select whether Tivoli Storage Manager ejects the volume from the library. The default is Yes.

Yes The volume is ejected from the library, and the volume entry is deleted from the library inventory. This option applies to all automated libraries.
No The volume is not ejected from a SCSI library. The volume entry is deleted from the library and the volume is left in its slot.

The REMOVE=NO option is not honored for EXTERNAL, RSM, or 349X libraries. REMOVE=YES is used instead, and the volume is ejected from the library. In addition, the volume entry is deleted from the library inventory.

Bulk The volume is ejected to a predefined high capacity area, instead of an I/O station, in the library. This selection only applies to libraries with a defined bulk eject area (for example, IBM 349x libraries). This selection does not apply to either the SCSI or External library types.