Default language.

Searching z/OS datasets


Host Explorer allows users to perform a basic text-based search through z/OS PDS/PDSE, sequential, and generation data group (GDG) dataset contents.

Important

This functionality does not include searching the catalog for dataset names.


Important

If File-AID is configured on the host port, the Search dialog box contains a File-AID Search/Update tab that allows additional capabilities for searching and globally updating mainframe datasets including VSAM files with complex search criteria. Refer to the File-AID Search Update section of the Topaz Workbench File-AID/Eclipse User Guide for detailed information.

To perform a search

  1. Do one of the following:

    • From the Search menu, select Search.
    • From the main window's toolbar, click search.gifbutton_menu.gif and then select host_explorer_search.png Host Explorer Dataset Search.
    • Click Ctrl + H.
    • In the Host Explorer tree view, right click a PDS or sequential dataset and select Search.
    • In the Host Explorer tree view, right-click a dataset filter and select Search.

    The Search dialog box appears.

  2. Select the Host Explorer Dataset Search tab.
  3. In the Search for text field, enter the text to be searched for or, from the drop-down list, select one of the previous 15 searches. No wildcards are supported.
  4. Select the Case sensitive check box to make the text search match the case entered in the Search for text field, or clear the check box to perform a case-insensitive search.
  5. In the Host field, select the host that contains the datasets to be searched. If only one host is configured or the Search dialog box was accessed from a context-specific method that predetermines the host, the Host field is disabled and prepopulates with the host being used. Click Configure if you want to configure a new host connection.
  6. In the Datasets (PDS, sequential, or GDG) box, use the Add, Edit, Remove, and Remove All buttons to select the datasets to be searched. The last character of member names can be wildcarded using the asterisk (*) character, as in USER.PDS(A*).

    • Click Add to open the Add Datasets dialog box and type or browse to datasets to be added to the Search dialog box.
    • Select a dataset and click Edit to edit the name of the dataset.
    • Select a dataset and click Remove to remove the dataset from the search.
    • Click Remove All to remove all datasets from the search.

    Important

    At least one dataset must be specified to enable the Search button.

  7. Optionally, click Preferences to open the Search page of the Preferences dialog box and set search preferences.
  8. Click Search to perform the search. After the search runs, the results appear in the Search view. The Search view, if not visible, can be opened from the Window menu by selecting Show View>Other>General> Search. Refer to the Eclipse documentation at www.eclipse.org for information on the Search view.
  9. Optionally, double-click a record in the Search view to browse or edit the file in the default editor.

    • To select the pages to be shown in the Search dialog box, click Customize and complete the Search Page Selection dialog box.
    • To set whether editors are reused when records are opened, from the Window menu, select Preferences and then, from the navigation tree, select General>Search. Select or clear the Reuse editors to show matches check box.

To show previous searches

With the desired search appearing in the Search view, click host_explorer_search.png. The Search dialog box appears showing the corresponding search criteria.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*