List Archive Files

The Archive Files grid on the Restore Request Editor serves several purposes.

The purposes served by the Archive Files grid include the following:

To list an Archive File, right-click the grid and click Add Archive File(s) > Archive Directory Index or Add Archive File(s) > File System from the shortcut menu. The option that you select depends upon the source of information about the Archive File or files to be added to the list. If the desired file is not registered, or if you can easily identify a file to add to the list, click Add Archive File(s) > File System to display the Open dialog. Select the Optim™ Server, if any, on which the file resides and click Refresh to display a list of Archive Files on the specified server, drive, and Directory.

However, clicking Add Archive File(s) > Archive Directory Index allows you to search the Archive Directory and locate registered Archive Files. You can also search for Archive Files that contain specific data.

If the Archive Files grid already contains an archive file and you want to list a different Archive File, click Replace Archive File > Archive Directory Index or Replace Archive File > File System from the shortcut menu.

Archive Directory Search

The Archive Directory Search allows you to search the Archive Directory and locate registered Archive Files. You can also search for Archive Files that contain specific data.

When you select Archive Directory Index, both the Select Archive File(s) and the Archive File Filters dialogs open, with the Archive File Filters dialog enabled. Use the Archive File Filters dialog to provide criteria for Archive Files that are candidates for the Archive Files list.

Archive File Filters dialog with default wildcard patterns

When the Archive File Filters dialog opens initially, each filter includes default wildcard patterns. (In other words, File Name, Server Name, Group, Creator, Table Name, and Description each contain a default wildcard pattern.) To display all Directory entries for Archive Files, you can accept these defaults. However, to limit the list of Archive Files in the Select Archive File(s) dialog, enter appropriate patterns and text for one or more filters. You can use the % (percent) symbol and the _ (underscore) as wildcards. You can also enter a date range to limit the list to Archive Files created within a specific time frame. Filter entries are profiled and presented the next time you open the Select Archive File(s) dialog.

Note: In an automated Search and Restore process, values for one or more filters can be provided from the command line to designate Archive Files for Restore processing.

After specifying the appropriate criteria, click OK to close the Archive File Filters dialog and populate the Select Archive File(s) dialog with information about files that match the Archive File Filters criteria.

Select Archive File(s) dialog with a list of Archive Files that match the entered criteria

This list of Archive Files can be refined further by using search criteria or the Archive File Filters at the bottom of the dialog. See Search and Archive File Filters for more information.

Select Archive File(s) Grid

The grid on the Select Archive File(s) dialog includes:

Status: Archive File
The status of the Archive File for each listed Directory entry, as follows:
(blank)
The Archive File is valid and accessible, or the file is stored on removable media (for example, zip disk, backup device).
Inaccessible
The Archive File is valid, but not available to the workstation or server.
Invalid
The file is not an Archive File, or the Archive File is secured by a File Access Definition and Archive File Security is not enabled.
Not Found
The Archive File is not found (the Archive File, but not the Directory entry, may have been deleted, or the file moved to a different drive or Directory).
Offline
The Archive File has been moved to offline storage during hierarchical storage management (HSM) processing. The Archive File has been replaced by a stub file and is not immediately available.
Note: The Offline status is set by the HSM software (for example, Symantec VERITAS Enterprise Vault).
Status: Search
The status of the most recent search operation since the list has been refreshed. (Clicking Refresh clears the Search Status.) See Search for more information about searching listed Archive Files.
(blank)
No search was attempted.
Match
A row or rows match the Search criteria.
No Match
No rows match the Search criteria. This status cannot be displayed if the Automatically Trim Search List check box on the Archive tab in Personal Options is selected.
Indeterminate
A match could not be determined on the basis of information in the Index File. Use the Resolve or Resolve All shortcut menu command to search the Archive File.

This status cannot be displayed if the Only Use Index to Perform Search check box on the Archive tab in Personal Options is cleared.

Invalid Index
The Index File is invalid. This status cannot be displayed if the Only Use Index to Perform Search check box on the Archive tab in Personal Options is cleared.
No Index
An Index File for the Archive File does not exist. This status cannot be displayed if the Only Use Index to Perform Search check box on the Archive tab in Personal Options is cleared.
Not Searched
The file was not searched because:
  • The file is inaccessible and the search applies to accessible files only. (See information on the Shortcut Menu Commands.)
  • The grid row was excluded during the search. (See information on the Shortcut Menu Commands.)
  • The file is not searchable.

This status cannot be displayed if the Automatically Trim Search List check box on the Archive tab in Personal Options is selected.

Archive File
The fully qualified name of the Archive File referenced by the listed entry.
Server
The server, if any, on which the Archive File resides. If the Archive File was created on a workstation (Local) is displayed. If the machine name does not match the current machine name, (Local) is italicized.
Media Type
The type of media on which the Archive File resides.
Fixed
The file is stored on a local hard drive.
Network
The file is stored on a network drive.
Removable
The file is stored on removable media (for example, a zip disk).
WORM Device
The file is stored on a WORM device.
Note: If a minimum file retention period is not specified for an Archive File on a WORM device, the file will have a Fixed or Network Media Type.
Backup Device
The type of backup device used during the Archive Process: Centera, Tivoli, NetWorker, or (None).
Searchable
Indicator that the Archive File or Index File can be accessed.
Secured File
Indicator that the Archive File is secured using a File Access Definition.
Group
Group name or information for the Archive File.
Created Date
The date the Archive File was created.
Description
Description for the Archive File.
Created on Machine
The name of the machine or server on which the Archive File was created.

Shortcut Menu Commands

Right-click the grid on the Select Archive File(s) dialog to display shortcut menu commands:

Search
Search for Archive Files that contain specific data. Select a command from the submenu to open the Index Search Selection Criteria dialog.
All Media
Search all Archive Files listed in the Archive Directory Maintenance dialog.
Direct Access Media
Search only the listed Archive Files stored on a local hard drive, network drive, or a WORM device.
Removable Media and Backup Devices
Search only the listed Archive Files stored on removable media (for example, a zip disk or backup device).
Note: The Search command is disabled following a search. Click Refresh to restore the original list, clear the Search Status, and enable the Search command.
Resolve
Resolve is enabled for a listed Archive File with a status of Indeterminate. Use Resolve to search the file for data that matches the search parameters.
Resolve All
Resolve All is enabled if one or more listed Archive Files have a status of Indeterminate. Use Resolve All to search all listed files with this status for data that matches the search parameters.
Trim Search List
Select this option to limit the display to Archive Files that match search criteria or have a status of Indeterminate. (If the Automatically Trim Search List option in Personal Options is selected, this menu option is disabled.)
Exclude
Remove the entry from the grid. Excluded entries are indicated by a bold line in the grid.
Show Next
Redisplay the first excluded entry below the selected entry. To redisplay all excluded entries, click Refresh.
Show All
Redisplay all excluded entries below the selected entry and above the next visible entry. To redisplay all excluded entries, click Refresh.
Browse Access Definition
Browse the Access Definition used to create the selected Archive File.
Browse Archive File
Browse the contents of the selected Archive File. (Refer to the Common Elements Manual for additional information.)

Command Buttons

Command buttons on the Select Archive File(s) dialog allow you to:

Select
List the selected Archive File names on the Restore Request Editor and close the Select Archive File(s) dialog. Any search criteria are transferred to the Restore Request Editor as Local Selection Criteria. (See Search.) To select a single Archive File and close the Select Archive File(s) dialog, you can double‑click a file name.
Select All
List all Archive Files on the Restore Request Editor and close the Select Archive File(s) dialog. Any search criteria are transferred to the Restore Request Editor as Local Selection Criteria.
Refresh
Clear any Archive File Filters in the Select Archive File(s) dialog and display the original list.
Respecify
Return to the Archive File Filters dialog.
Cancel
Return to the Restore Request Editor.

Search

Using Index Search Selection criteria, you can limit the list to Archive Files that contain specific data.

Depending on the type of media that you want to search, click Search > All Media, Search > Non‑Removable Media, or Search > Removable Media to open the Index Search Selection Criteria dialog.

Index Search Selection Criteria dialog

Use the Index Search Selection Criteria dialog to enter column criteria or SQL statements for listed tables. The criteria are applied to all listed Archive Files, or to listed Archive Files stored on accessible media, depending on your selection from the Search submenu.

Note: In an automated Search and Restore process, selection criteria can be provided from the command line to designate Archive Files and select data from them for Restore processing.

Combine all table criteria with

An option unique to the Index Search Selection Criteria dialog allows you to apply criteria specified on the Index Selection Criteria dialog in one of two ways. Select one of the following:

AND
Find each listed Archive File that includes all tables for which criteria are specified with data that matches the criteria for each table.
OR
Find each listed Archive File that includes at least one table for which criteria are specified with data that matches the criteria for one table.

Criteria entered on the Index Search Selection Criteria dialog apply to files listed on the Select Archive File(s) dialog, while criteria entered on the Global Selection Criteria or the Local Selection Criteria dialog apply to files listed on the Restore Request Editor. In other ways, the Index Search Selection Criteria dialog resembles the Global Selection Criteria dialog and criteria are defined in the same way on the dialogs. (See Search and Selection Criteria for more information.)

Begin the Search

To begin the search, close the Index Search Selection Criteria dialog. The search proceeds as follows:

  • If the Only Use Index to Perform Search check box on the Archive tab in Personal Options is cleared, the Archive Index for each listed file, if one exists, is matched against the criteria. If information in the Index is not sufficient to satisfy the search, data in each Archive File is searched for possible matches to the specified criteria.
  • If the Only Use Index to Perform Search check box is selected, Archive Indexes are searched for possible matches to the specified criteria. If Archive Index information is insufficient to establish a full match (for example, data is indexed but the column for which you provide criteria is not), the Status is shown as Indeterminate. You can right-click and click Resolve or Resolve All from the shortcut menu to search the Archive File for data that matches the criteria.

Archive File Filters

You can use Archive File Filters on the Select Archive File(s) dialog to refine the list of Archive Files.

Initially, each filter contains default wildcard patterns. For example, File Name, Server Name, Group, Creator, Table Name, and Description contain default wildcard patterns. To limit the list of Archive Files in the Select Archive File(s) dialog, enter appropriate patterns (using the % (percent) symbol and the _ (underscore) as wildcards) and text for one or more filters.

To select from values for all listed files, click the arrow in a filter box. If desired, you can edit a selected value. You can also enter a date range to limit the list to Archive Files created within a specific time frame. After specifying the appropriate filters, click one of the following command buttons to proceed:

Select Matching
Apply the specified Archive File Filters to the list in the Select Archive File(s) dialog, add matching Archive Files to the list in the Restore Request Editor, and close the Select Archive File(s) dialog.
Display
Apply the Archive File Filters to the list in the Select Archive File(s) dialog. To redisplay the original list, click Refresh.