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 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
- 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
- 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 (
). 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 (
) in a CSV format that can be used in a spreadsheet program.
Changing the view display
- 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.