Result view of a server Macro cross-references search

This view displays the results of the Macro cross-reference search on the server. This search was started from the References > Server Macro cross-references choice of the Macro contextual menu.

The view title and its associated tooltip display the main characteristics of the search and the number of the instances found.

The cross-references are the instances that call the Macro in the server.

The instances that are found by the search are preceded by the icon that represents their entity type. This entity type can be viewed in the tooltip that is associated with each instance.

The view displays the line number and optional comment as they are entered for each Macro call in the -CP Lines tab of the calling instances. It also displays the values of the parameters for each call. If a comment exists for a parameter in the -CP Lines, it is displayed in the tooltip that is associated with the parameter.

Possible actions on the calling instances

If you right-click an instance that calls a Macro, 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.
  • Search for its own super references or subreferences, which are then in turn displayed in the Server References view.

Toolbar

You can complete the following actions from the toolbar:
  • Run the current search again (Run the current search again). This command refreshes the results of the current search by taking into account the modifications in the -CP Lines of the instances that call the Macro. So, the view displays the new values of parameters, the updated comments associated to the Macro call or to a parameter, and the added or deleted calls to the Macro.
  • 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.

Changing the view display

You can change the view display in the following ways:
  • Click the triangle (View menu) in the toolbar and select one of the following choices:
    • 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.
    • Filters to exclude some entity types from the search results. A wizard opens with all the entity types that you can exclude. If you want to display only some entity types, you must select all the entity types by clicking Select all and clear the types to be kept.

  • 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