Rational Programming Patterns

References view

This view displays the results of the reference search requested for the instance that is currently selected in the Design Explorer view. This search was requested from the selected instance with 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: the instances that reference the current instance,
  • The subreferences: the instances that are referenced by the current instance.
Example: If you search for a subreference of a Program, you see all the instances that this Program calls, down to the finest level: Data Structures, Segments, and Data Elements. Moreover the subreferences always include the Library that contains the generation parameters of the instance.
Example: If you search for the super references of a Data Element, you see all the instances that call this Data Element, up to the highest level: Segments, Data Structures, Programs, Screens, Database Blocks.

The reference search also applies to the generated files. If you search for the subreferences of a COBOL generated file (.cbl file nested under a Program, Screen, or Server) or of a map description file for a Screen (.map, .bms or .mfs file nested under a Screen instance), the References view then displays the instances that are involved in the file generation.

If you right-click an instance in the tree, you can perform the following actions:
  • Open the instance in its design editor.
  • Open with its design editor (default editor) or its COBOL editor (available for Macros only) or three other editors (text editor, system editor, in-place editor).
  • Search for its own super references or subreferences, which are then in turn displayed in the References view.
This view contains a toolbar from which you can perform the following actions:
  • Cancel the current search (Cancel current search).
  • View the previous reference searches (Show previous reference searches). Click the symbol that is associated with the icon to display a menu that 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 that shows the previous instances from which you requested a reference search. From this window, you can carry out the following actions:
      • Select an instance and display its references (Open or Open in new view) or remove this instance from the history (Remove),
      • Change the number of instances that are 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 subreferences of the current instance (subreferences),
  • Switch from the subreferences to the super references of the current instance (super references).
  • Modify the way that the instances are shown in this view. Click the upside-down triangle icon (View menu) and select one of the following choices:
    • Top-level elements to indicate which element type is to constitute the top of the hierarchy in each location tree: folders (default value, represented by the entity types), projects, or packages (irrelevant for the maintenance of a Pacbase application).
    • Sort to specify a new sort criterion.
    • Display to display more information for each instance line in the tree: To remove some additional information from the line, 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 (for example: if a Program calls the same Segment several times), the repetition number is displayed in parentheses, next to the relation name.
    This new setting is then automatically saved and associated with this view, until you change it again.

Terms of use | Feedback

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