Rational Programming Patterns

Macro Overview tab

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 that are assigned to the Macro.
Note: To indicate internal resources, you must specify micropatterns directly in the generated COBOL file.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)