This view displays the results of the reference search
that was requested for the selected instance or file. This search
was started from the or choice of the instance or file contextual menu. It
was performed directly on the Rational Team Concert™ server.
References of an instance
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 the subreferences of a Program (Pacbase facet), 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 (Pacbase facet), you see
all the instances that call this Data Element, up to the highest level:
Segments, Data Structures, Programs, Screens, Database Blocks.
References of a generated file
If you started the subreference search from a generated file
(.cbl file of a Program, Screen, or Server in
the Pacbase facet),
the result view displays the instances that were involved in the file generation.
For the
.cbl files, the following
information is displayed:
- The design instance that constituted the entry point to generate
the COBOL file,
- The instances that are called with micropatterns,
- The Data Elements that are inserted manually in the code of the PROCEDURE
DIVISION. The number of usages of each Data Element in the
COBOL file is indicated with usage(n), where n is
the number of usages of the Data Element.
You can expand the subreferences down to the finest level.
Possible actions on the references
If you
right-click an instance in the reference tree, you can perform the
following actions:
If you right-click a Data
Element, you can select
Usage search. This
search detects the Data Element usages in the code that is entered
manually in the
PROCEDURE DIVISION of Programs, Screens,
or Servers (files with a
cbl extension). Selecting
Usage
search opens a dialog box where you can filter the
cbl files
on which the search is to run.
Note: If you start the search from
the results of a server design search, all the cbl files
of the stream are proposed by default. However, if you start the search
from the results of a server subfreferences search, the cbl file
from which the reference search was run is proposed by default.
When
you click
OK in the dialog box, you switch
to the
Server Usage Search view where the results
of each usage are displayed.
Toolbar
This view contains a toolbar that
can be used to perform the following actions:
You can also 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.