Rational Developer for System z, Version 7.5

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 via the contextual menu of the selected instance.

The search follows the composition links of the instance. Depending on your request, you will see the instances which reference the current instance (its super references) or the instances which are referenced by the current instance (its sub references).

Example: If you search for a Program's sub references, you will see the Data Structure, if any, and then the Segments called in the Program, and the Data Elements called in these Segments. Since a Program always calls the generation parameters of a Library, you will also this Library.
Example: If you search for a Data Element's super references, you will see all the Segments which call this Data Element, the corresponding Data Structures, and the Programs in which those Data Structures/Segments are called.
If you select an instance in the reference list and right-click, you can:
  • Open its editor.
  • Search for its own super or sub references, which will then be displayed in the 'References' view.
This view contains a toolbar on the upper right-hand corner. Clicking on its buttons enables you to:
  • Cancel the current search (Cancel current search icon).
  • View the previous reference searches (Show previous reference searches icon). Click on the arrow next to the icon to display the previous searches (10 maximum but you can change this number in the window you open by selecting the History choice).
    • If you select a previous search, its result will be displayed in the view.
    • If you select the History choice, you open a window which shows the 10 previous searches. In this window, you can select a previous search to view its results or remove it from the history, or configure the number the previous searches displayed in the history.
    • If you select Clear History, all the previous searches will be removed from the history.
  • Switch from the super references to the sub references of the current instance (sub references icon),
  • Switch from the sub references to the super references of the current instance (super references icon).
  • Modify the way the instances are shown in the 'References' view. Click the white upside-down triangle icon and select:
    • Sort to specify a new sort criterion: by name, package or project.
    • Display to specify a new display criterion: by package, project, label or relation.
      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, right after the relation name.
    This new setting will then automatically be saved and associated with the 'References' view, until you change it again.
Related tasks
Searching for the references to an instance

Terms of use | Feedback

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