The Overview tab of a Macro displays
the label in a read/write mode. It also displays
information specific to the instance in a read-only mode and provides
access to the other tabs of the instance.
Description of the tab
Three sections
are not tabs. They are displayed in the
Overview tab
only:
Alerts and Action Items,
General
information, and
Generation parameters definition (on
some entities).
All the other sections provide links to the corresponding
editor tabs.
If information is displayed in a section, you
can carry out either of the following actions:
- Click it if it is displayed as a link. You automatically switch
to where the information is specified.
- Click the More button to switch to the
corresponding tab.
If no information is displayed in the section, click
the symbol in front of the section name. It gives you access to the More button.
Click it to access the corresponding tab.
The sections of the tab
- Alerts and Action Items
- Any problem that is related to the current instance is displayed
in this section as a link. If you click this link, you automatically
switch to the Problems view, where the line
that corresponds to the error is highlighted. The error is explained
and you can correct it.
General information displays
the following fields:
- Work context
- The work context is the project from which you open the editor
of the current instance. This project constitutes the starting point
for the resolution of the dynamic links and references between the
instances of the various projects. The projects hierarchy that is
declared in the design build path is explored in an upward direction.
If
you click Hierarchy, you can see a partial
view of the design build path. In this view, the project that constitutes
the work context is the lowest project of the hierarchy.
More
information can be found in the following links: The work context and The design build path.
- Name
- The instance name is displayed in read-only mode. It is entered
when the instance is created, and it cannot be modified later.
- Label
- Enter the label that identifies the instance. It will constitute
a search criterion for a subsequent search.
- Definition
- The Merge priority field applies if Macro
lines with the same code (same function and subfunction codes and
same line numbers) exist in a Program, a Screen, or a Server.
If
you work with Macros that are imported from Pacbase, you must not change
the value that is automatically assigned to this field.
If you
create Macros directly in
Rational Programming Patterns, you must
prioritize the Macro lines:
- The lines from the Macros whose priority is high have priority
over the lines from the Macros whose priority is low.
- The lines from the Macros whose priority is low cancel each other
out.
- It is advised to call only one Macro with a high priority in an
instance. If several Macros with a high priority are called in an
instance, the lines of the last Macro in the alphabetical order have
priority.
The other sections of the
Overview tab
display the information, if any, entered in the corresponding tabs:
- The Comments section displays the documentation
of the Macro parameters.
- The -G Lines section gives access to the -G
Lines tab, where you enter the Macro comments.
- The Keywords section displays the keywords
assigned to the Macro.
Note: To indicate internal resources, you must specify micropatterns
directly in the generated COBOL file.