Result view of a design search

This view displays the results of the instance search that was requested from the Design Search tab. You opened this tab with the Search button in the toolbar or the Search menu. The search bore on one or more open locations of the Design Explorer view.

The tooltip that is associated with the view title describes the search whose result is displayed in the view. You can then easily differentiate the various result views.

The view contains a tree structure with the instances found.

Possible actions on the instances

If you right-click an instance in the list, you can complete the following actions:
  • Open the instance in its design editor
  • Open the instance in its COBOL editor if the entity contains a COBOL description. Other editors are also proposed.
  • Generate the instance. If you have updated the design of a Program, Screen, or Server, the newly generated code will integrate the changes in the design, while keeping any specific changes in the code.

    The preference Structure checking before generation management, which is available from Window > Preferences > Pattern Driven Programming > Pacbase Patterns, checks that the nesting of subfunctions in the COBOL code is correct before the generation. By default, it blocks the generation if structuring errors are detected.

  • Search for its own super references or subreferences, which are then in turn displayed in the References view.
  • Publish the instance (Pacbase facet). A multiple selection is possible.
  • Add the instance to the publish session (Add to session choice in the Pacbase facet). A multiple selection is possible.
  • Go to the next match to select the next instance in the list (also available with Next match in the view toolbar)
  • Go to the previous match to select the previous instance in the list (also available with Previous match in the view toolbar)
  • Remove the selected matches, to remove all the selected instances from the Design Search view (also available with Remove selected matches in the view toolbar)
  • Remove all matches; that is, remove all search result from the Design Search view (also available with Remove all matches in the view toolbar)

If you right-click a Data Element, you can select Usage search. This search detects the Data Element usages in the code that is entered manually in the PROCEDURE DIVISION of Programs, Screens, or Servers (files with a cbl extension). Selecting Usage search opens a dialog box where you can filter the cbl files on which the search is to run. When you click OK in the dialog box, you switch to the Usage Search view where the results of each usage are displayed.

Toolbar

You can also do the following actions from the toolbar only:
  • Expand all (Expand all). This command expands every tree item in this view.
  • Collapse all (Collapse all) This command collapses every tree item in this view.
  • Run the current search again (Run the current search again). This command runs the current search again, so that removed results are displayed again or changes are applied.
  • Cancel the current search (Cancel current search)
  • Show the previous searches (Show previous searches). This command displays the previous searches. You can run one of them again.
    • If you select a previous search, its result is displayed in the view.
    • If you select the History choice, you open a window that shows the 10 previous searches (by default). In this window, you can select a previous search to view its results or remove it from the history. You can also configure the number of the previous searches that is displayed in the history.
    • If you select Clear History, all the previous searches are removed from the history.
You can modify the display. To do so, click the triangle (View menu) of the view toolbar and select one of the following options:
  • Top-level elements to indicate which element type is to constitute the top of the hierarchy in each location tree: folders (default value, that represents the entity types), projects, or packages (irrelevant for the maintenance of a Pacbase application).
  • Sort to specify a new sort criterion.
  • Display to display more information about each instance line in the tree. If you want to remove some of the selected information, select it again in the menu.
This new setting is then automatically saved and associated with this view until you change it again.

You can also filter the results by selecting a project in the Context field and by clicking one of the buttons that represent a hierarchic view of the projects in the design build path. Context only is selected by default. It means that only the instances that are found in the selected project are displayed. However, you can select another hierarchy (upper, lower, or whole) to display the instances that are found in the selected project and in the projects that are hierarchically higher or lower, or in all the projects of the hierarchy.


Feedback