This view displays the results of the reference search
requested for the instance currently selected in the Design
Explorer view. This search that was started from the choice of the instance menu was performed directly
on the Rational Team Concert™ Server.
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
are the instances that reference the current instance. The subreferences
are the instances that are referenced by the current instance.
Example: If you search for the subreferences
of a Program, you can 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 can 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 COBOL files. If you search for the subeferences
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 Server References view
then displays the instances involved in the file generation.
If
you right-click an instance in the reference tree, you can perform
the following actions:
The
Rational Team Concert Server References view
contains a toolbar that can be used to perform the following actions:
- Cancel the current search (
icon).
- View the previous reference searches (
icon). Click the arrow associated
with the icon to display a menu that contains the following elements: - 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 perform 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 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 (
).
- Switch from the subreferences to the super references of the current
instance (
).
- Modify the way the instances are shown in this view. Click the
white triangle (View menu) in the toolbar and
select: the following choices:
- Top Level Elements to indicate which element
type constitutes the top of the hierarchy in the tree: folders (default.
They 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 about each instance line in the tree:
package, project, label and relation, or relation only. You can combine
the four choices. If you want to remove one of the selected 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. If
this link occurs more than once (for example: if a Program calls the
same Segment several times), the occurred 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.