Result view of a Macro cross-references search

This view displays the results of the Macro cross-reference search for the instance that is selected in the Design Explorer view or the result view of a search. The reference search was requested from the References > Macro cross-references choice of the Macro contextual menu.

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

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

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.
  • Open the instance in another editor. You can also open it in its COBOL editor if the entity contains a COBOL description.
  • Generate the instance. If you have updated the design of a generatable instance (Program or Screen for example), 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 structure 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.

Toolbar

This view contains a toolbar from which you can complete the following actions:
  • Edit the parameters of the Macro call (Edit the parameters) if the design editors of all the instances that are listed in this view are closed.
  • Save the parameters that have been edited (Save the parameters) if the design editors of all the instances that are listed in this view are closed.
  • Export the query result (Export the query result) in a CSV format that can be used in a spreadsheet program. In the export wizard, you must select a file with a .CSV extension. Then, if you click Next, you can select the data to be exported.

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.
    • 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.
    • 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