The purpose of this tab is to call one or more Macros into
a batch or online program. If these Macros are parameterized, you
must also specify the values of their parameters. Each occurrence
of the parameter in the original Macro is then replaced by the value
that is entered for this particular program.
It is constituted of two parts:
- A table that contains the Macros that are called in the program.
Each
line corresponds to a Macro call.
If the called Macros contain
parameters, each parameter is followed by its value in the program.
You
can double-click a Macro to open it in the Macro editor in the context
of its call.
To complete or modify the table, you can use the
associated buttons, or right-click to display the contextual menu.
You can do the following actions:
- Add a Macro call.
- Remove a Macro call.
- Replace a Macro call. The line number and the parameters of the
initial Macro are kept. This action is not recommended because it
can cause inconsistencies when the program is generated again. However,
if you must do it, you must select a new Macro whose content is close
to the content of the initial Macro. You must always verify the generated
code after the replacement.
- Reorder the Macro calls in the table.
- The Macro call section. To display the
content of this section, you must select a Macro call in the table.
This sections contains the following elements:
- The line number.
It is constituted of two numeric
characters. When a Macro is parameterized, it is used to call it more
than once into the same program.
- An Add button that you can click to add
10 parameters to the first 10 parameters that are initially displayed.
- A table that displays all the possible parameters, and their corresponding
values for the parameters that are called in the Macro. There are
two types of values:
- A simple character string. In this case, enter the value in the Value column.
The number of characters that is used for each parameter value corresponds
to the appropriate field length for the parameterized element. For
example, if $1 is used as a function code,
the value must be 2 characters long.
- A Data Element, a Data Structure, or a Segment. In this case,
click the Linked entity column and click the
selection button that is displayed then. Select the instance in the
selection wizard. The instance name is automatically displayed in
the Value column, preceded by E= (for
a Data Element), D= (for a Data Structure),
or S= (for a Segment). When the program is
generated, the parameter is replaced by the instance name and references
are automatically created.
Note: The parameter values can be modified in a centralized way
from the Macro cross-references view for all
the instances that call the Macro.
- Buttons that represent the Macro editor tabs. Click them to open
the corresponding tabs.