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 search. This reference search was requested
from the References choice of the instance
contextual menu.
The tooltip that is associated with the view title describes
the search whose result is displayed in the view. You can then easily
differentiate the various result views.
The instances that are found by the reference search are
preceded by their icons. The associated tooltip displays the entity
type.
References of an instance
The
search follows the composition links of the instance. There are two
reference types:
- 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,
such as the 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,
such as the Segments, Data Structures, Programs, Screens, and Database
Blocks. Moreover, if the Data Element is a parent Data Element, you
also see its child Data Elements.
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 in micropatterns. The Data Elements
that are called in micropatterns WF, WE, WI,
and WS are then displayed.
- 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 tree, you can do 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.
- Generate the
instance. If you have updated the
design of a Program, Screen, or Server, the newly generated code will
integrate the changes in the design, while keeping any specific changes
in the code.
The preference Structure
checking before generation management, which is available
from , checks that the nesting of subfunctions
in the COBOL code is correct before the generation. By default, it
blocks the generation if structuring errors are detected.
- Search for its own super references or subreferences,
which are then in turn displayed in the References view.
- Publish the instance (Pacbase facet). A multiple
selection is possible.
- Add the instance to the publish session (Add
to session choice in the Pacbase facet). A multiple
selection is possible.
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. When you click OK in the dialog
box, you switch to the Usage Search view where
the results of each usage are displayed.
Toolbar
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.