Insertion relative to the automatic functions of a standard or client Dialog

You must enter information to insert the created subfunction relatively to the automatic functions and subfunctions of the model. This information varies according to the automatic function.

Data Element code
This field is specific to function 20. This function contains a subfunction for each Data Element of the Screen to be checked.

For an insertion in a Macro, select a Data Element in the list that opens when you click the button that is associated with the field. In the Macro code, this piece of information is identified as REF=delco, where delco is the code of the selected Data Element.

For an insertion in a Screen, first check which Data Elements are called in the -CE Lines tab of the Screen. In the subfunction creation wizard, press the button that is associated with the Data Element code field. Select one of the Data Elements that are called in the Screen. In the Screen code, this piece of information is identified as F20C-delco, where:
  • F20 is the automatic function code;
  • C is the category of the Data Element call in the -CE Lines tab of the Screen: A for the header, R for the repetitive part, or Z for the screen bottom,
  • delco is the code of the selected Data Element.
Segment code
This field is specific to the following functions:
  • 25, 35, and 60: These functions contain a subfunction for each Segment accessed. The subfunction that contains the specific processing is then identified by the Segment code that it processes. This code must be complemented with the category if the same Segment is used in several categories.
  • 80: This function contains a subfunction for each type of access to each Segment. You can replace an access only or all the accesses that are generated for a Segment.

For an insertion in a Macro, select a Segment in the list that opens when you click the button that is associated with the field. In the Macro code, this piece of information is identified as REF=segm, where segm is the code of the selected Segment.

For an insertion in a Screen, first check which Segments are called in the -CS Lines tab of the Screen. You must also note their use (reception for example) and their category (repetitive category for example) in the Screen. In the subfunction creation wizard, press the button that is associated with the Segment code field. Select one of the Segments that are called in the Screen. Its use must correspond to the automatic function you selected on the first page of the wizard. For example, you can insert a specific subfunction in the 25 automatic function only if a Segment is used in reception in the Screen.

Category
This field is specific to the following functions:
  • 25, 35, and 60: If the Segment is called in several categories, you must differentiate the calls by specifying the category.
  • 30 and 65: These functions contain a subfunction for each access to a category. The subfunction in which the specific processing is to be inserted is identified by the category code.
You must select one of the following values:
  • A: Header category
  • R: Repetitive category
  • Z: Screen bottom category

In the Macro code, this piece of information is identified as REF=segm cat, where segm is the code of the selected Segment and cat is the category.

For an insertion in a Screen, you must select the same category as the category that is indicated for the Segment in the -CS Lines tab of the Screen.

Standard access
This field is specific to function 80.

When it is generated, this function contains a subfunction for each type of physical access to a Segment. You can replace a physical access only or all the physical accesses that are generated for the selected Segment.

If you select an access, only the subfunction that corresponds to this access is to be replaced. However, if you do not select any access, all the access functions to the Segment are to be replaced.

For the SQL accesses that are customized in the GG Lines of the selected Segment, the input in this field varies according to the access type in the following way:
  • Customized standard accesses are automatically generated with the customization that is entered on the Segment. However, if you want to ignore the customization, you must specify it by selecting the standard access in this field.
  • Nonstandard accesses are not automatically recognized. You can take them into account in one of the following manners:
    • If you select a standard access in this field and if you enter a nonstandard access in the code after this standard access, the customized nonstandard access will be recognized. It will be generated in the standard processing of function 80.
    • If you do not select any standard access in this field and if you enter a nonstandard access in the code, the customized nonstandard access will be recognized. It will be generated in a specific subfunction of function 80. It will constitute a user function that is unknown to the generator. You must then describe and manage it entirely with specific code.
    • f you select a standard access in this field and if you enter, before it, a nonstandard standard followed by the = sign in the code, the customized nonstandard access will be recognized. It will be completed by the processing that is automatically generated for the standard access in function 80.
Note: SQL accesses are documented in the Principle of customized SQL accesses page and its associated links.

In the Macro code, this piece of information is identified as REF=segm acc, where segm is the code of the selected Segment and acc is the access, if any.

In the Screen code, this piece of information is identified as F80-segm-acc where segm is the code of the selected Segment and acc is the customized access, if any.

Action type
In this field, you specify how the new subfunction is to be inserted relatively to the automatic subfunctions.

For function 80, the only possible value is Replace.

For functions 25, 35, and 60, you must select one of the following values:
  • Insert before: The subfunction is inserted before the automatic subfunction that is identified by the Data Element or Segment it processes.

    In the Macro code, this insertion type is identified by ACTION=*A. In the Screen code, it is identified as @BEFORE.

  • Insert after: The subfunction is inserted after the automatic subfunction that is identified by the Data Element or Segment it processes.

    In the Macro code, this insertion type is identified by ACTION=*P. In the Screen code, it is identified as @AFTER.

    Note: The condition of an automatic subfunction automatically applies to the inserted subfunction if the level of the inserted subfunction is greater than the level of the automatic subfunction.
  • Replace: The subfunction replaces the automatic subfunction that is identified by the Data Element or Segment it processes.

    In the Macro code, this insertion type is identified by ACTION=*R. In the Screen code, it is identified as @REPLACE.

    Note: The condition of an automatic subfunction does not apply to the replaced subfunction.

Feedback