This view displays the results of the reference search
for the instance that is selected in the Design Explorer view
or the result view of a Design Search. This
search was requested from the References choice
of the instance contextual menu.
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 tree, you can perform the following
actions:
- Open the instance in its design
editor
- Open the instance in its
COBOL editor if the entity contains a COBOL description. Other editors
are also proposed.
- Search for its own super references or subreferences,
which are then in turn displayed in the References view.
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. When you click OK in
the dialog box, you switch to the Usage Search view
where the results of each usage are displayed.