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.

Display of the results in the view

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 main characteristics of the search and the number of the instances found.

You can complete the following actions from the toolbar:
  • Expand all (Expand all). This command expands every tree item in this view.
    Note: This choice is reserved for a display in Hierachy mode.
  • Collapse all (Collapse all) This command collapses every tree item in this view.
    Note: This choice is reserved for a display in Hierachy mode.
  • 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.
  • Modify the display mode of the search results. Two display modes are available:
    • Hierarchy (Hierarchy).

      The highest branches are constituted of the selected top-level element: entity, project, or package (irrelevant for the maintenance of a Pacbase application).

      If the view displays the results of an advanced design search, an additional element can be displayed between parentheses after the instance name, according to the search implementation.

    • Flat (Flat).

      From the header of any column, you can modify the display of the search results. By clicking a header, you can display the search results according to the ascending or descending order of the column content. By selecting a header and dragging it, you can move the column.

      If the view displays the results of an advanced design search, the column that corresponds to the specific criterion of the advanced search is added to the standard columns. A Transaction code column is added for a search on Screens by transaction codes, a Format column is added for a search on numeric Data Elements or Data Elements by format, and a Relational Name column is added for a search on Data Elements by relational name. For user search patterns, the specific columns vary according to the search implementation.

  • 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 projects, or the packages (irrelevant for the maintenance of a Pacbase application).
    Note: This choice is reserved for a display in Hierachy mode.
  • Sort to specify a new sort criterion for the display of the results. For a display in Flat mode, you can select any standard column as the sort criterion, whereas in Hierarchy mode, the sort is limited to the names or projects (or packages).
  • 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. In the Flat mode, you can choose to display all the standard columns ; the specific columns are always displayed. In the Hierarchy mode, you can display projects and labels (or package) only.
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.

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.
  • Compare the instance with the same instance from another workspace or stream. Selecting this choice opens the standard Rational Team Concert™ wizard where you can select the workspace or the stream of this instance.
  • 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.

Feedback