-CP Lines tab

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.

Feedback