Result view of a server design search

This view displays the results of the instance search that is requested from the Server Design Search or Server Advanced Design Search tab (opened with the Search button in the toolbar or the Search menu). You can load your local workspace from the search results.

The search results are the same whatever the content of your workspace because the search is run on the server.

The view title and its associated tooltip display the name and project of the instance that was the origin of the search.

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 do the following actions:
  • Open the instance in its design editor in a read-only mode. The editor displays the same information as it would if the instance was present in the local workspace. You can navigate through the instances. For example, you can open the editor of a Data Element from the CE Lines tab of a Segment.
  • Open the instance in another editor in a read-only mode. You can also open it in its COBOL editor in a read-only mode if it contains a COBOL description.
  • Show the history of the instance. This choice opens the History view where the change history of the instance is displayed.
  • Load the artifacts. Only the instances from which you have selected this choice are loaded into the local workspace.
  • Load the required artifacts. You can select this choice from one of the following line types:
    • One or more design files. If the design file is a Program, Screen, or Server instance, a dialog box asks you whether you want to load the associated generated source file. This file is not required but its loading makes the product easier to use.

      A specific loading wizard opens. It displays the selected files and their required artifacts that were detected by following the subreference links. All these files are loaded into the local workspace, where they constitute a consistent set of data.

    • One or more source files or maps (for Screens). The links are automatically explored to find all the required artifacts. All these artifacts are loaded into the local workspace.

    For explanations, see Loading the local workspace.

  • Load the required projects for this instance. You can then limit the number of the components to be loaded into your local workspace in order to be able to work on the instance.
  • Go to the next match to select the next search result in the list (also available with Next match in the view toolbar).
  • Go to the previous match to select the previous search result in the list (also available with Previous match in the view toolbar).
  • Remove the selected matches to remove all the selected search results from the view (also available with Remove selected matches in the view toolbar).
  • Remove all matches to remove all the search results from the view (also available with Remove all matches in the view toolbar).
  • Search for the Server references of the instances. These references are then displayed in the Server References view
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.
Note: If you start the search from the results of a server design search, all the cbl files of the stream are proposed by default. However, if you start the search from the results of a server subreferences search, the cbl file from which the reference search was run is proposed by default.
When you click OK in the dialog box, you switch to the Server Usage Search view where the results of each usage are displayed.

Toolbar

You can complete 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 to display the removed search results again or to apply the changes.
  • Cancel the current search (Cancel current search).
  • Show the previous searches (Show previous searches). Select this command to see the previous searches and to 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 result or to remove it from the history. You can also configure the number of the previous searches that are displayed in the history.
    • If you select Clear History, all the previous searches are removed from the history.
  • Export the query result (Export the query result) in a CSV format that can be used in a spreadsheet program.
You can modify the display by clicking the triangle (View menu) of the view toolbar and selecting 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. The element type can be the folders (default value, which represents the entity types), the instance names, the projects, or the 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 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