Rational Developer for System z, Version 7.6

The References view

This view displays the results of the reference search requested for the instance currently selected in the Design explorer view. This search was requested from the selected instance, via the References choice of its contextual menu.

The search follows the composition links of the instance. The view title indicates which type of references is currently displayed, according to your search request:
  • The super-references, i.e. the instances which reference the current instance,
  • Or the sub-references, i.e. the instances which are referenced by the current instance.
Example: If you search for a Program's sub-references, you will see all the instances that this Program calls, down to the finest level: Data Structures, Segments and Data Elements. Moreover, the sub-referrences always include the Library which contains the generation parameters of the instance.
Example: If you search for a Data Element's super-references, you will see all the instances which call this Data Element, up to the highest level: Segments, Data Structures, and Programs.
If you right-click on an instance in the reference tree, you can:
  • Open its editor.
  • Search for its own super-references or sub-references, which will then in turn be displayed in the References view.
The References view contains a toolbar on the upper right-hand corner, which enables you to:
  • Cancel the current search (Cancel current search button).
  • View the previous reference searches (Show previous reference searches button). Click on the arrow next to the icon to display a menu which contains:
    • The previous instances from which you requested a reference search. Select one of these instances to see its references in the view.
    • The History choice. This choice opens a window which shows the previous instances from which you requested a reference search. From this window, you can:
      • Select an instance and display its references (Open or Open in new view button) or remove this instance from the history (Remove button),
      • Change the number of instances displayed in the history (10 is the default) by clicking the Configure link.
    • The Clear History choice, to remove all the previous searches from the history.
  • Switch from the super-references to the sub-references of the current instance (sub-references button),
  • Switch from the sub-references to the super-references of the current instance (super-references button).
  • Modify the way the instances are shown in the References view. Click the white upside-down triangle icon and select:
    • Top Level Elements to indicate which element type will constitute the top of the hierarchy in the tree: folders (default. These are represented by the entity types), packages or projects.
    • Sort to specify a new sort criterion: by name, package or project.
    • Display to display additional information on each instance line in the tree: package, project, label and/or relation. You can combine the four choices. If you want to remove one of the selected information from the line, just select it again in the menu.
      Note: The relation is the name of the link between the source instance and the target instance. If this link occurs more than once (eg: if a Program calls the same Segment several times), the occurs number is displayed in parentheses, next to the relation name.
    This new setting will then automatically be saved and associated with the References view, until you change it again.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)