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, 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.
References of a generated file
If you started the subreference search from the generated
COBOL file of a Program, Screen, or Server (.cbl file),
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 (available from
Rational Programming Patterns V9.0.1),
- The Data Elements that are inserted manually in the code of the PROCEDURE
DIVISION (available from Rational Programming Patterns V9.0.1).
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 displayed 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 (available from Rational
Programming Patterns V9.0.1). 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: