The Create/update a subfunction which is specific to a
dialog or client, a wizard is used either to insert specific procedures
into the automatic functions (F20, F25, F30, F60, F65, and F80) or
to modify the parameters of one of these subfunctions selected in
the tags tree. This window opens from the Macro tags tree in a skeleton
view or in a standard view (in a Macro editor with a dialog or client model).
Creation context
The following window is displayed in the tags tree of a Macro
opened from a dialog Macro editor.
To create subfunction specific
to a dialog or client, you select the
Create specific dialog
subfunction choice in the pop-up menu.
Figure 1. Create specific dialog or client
subfunctions
Function choice
Depending on the function choice
selected in this field, other parameters are displayed in the window
and must be completed.
- If you check the function choice 25 (F25), 35 (F30)
or 60 (F60), you must complete the Category field
and Segment code field:
Figure 2. Create a function F25
- If you check the function choice 30 (F30)
or 65 (F65), you must select a Category in
addition to the standard Subfunction code and Level fields.
- If you check the function choice 20 (F20),
you must enter a Data Element code in addition
to the standard Subfunction code and Level fields.
- If you check the function choice 80 (F80),
the Segment code and Access type are
required in addition to the standard subfunction code and level parameters:
Figure 3. Create a function F80
- Function code
- This field is automatically filled with the code of the function
selected in the tree. However if you select another function code
in the check boxes, the code is automatically displayed in this field.
- Subfunction code
- A value is required here. It must be two characters long. It
is recommended to systematically use an alphabetic subfunction ('sf')
code for the procedures to be inserted.
- Level
- The level value is optional. It must be two characters long. Numeric
characters are required only if the level starts with the $ value.
If no value is entered in this field, it is automatically set to 10.
- Category
- Option available for functions F20, F25, F30, F35, F60, and F65.
Functions
F25, F35, and F60 contain a subfunction for each accessed Segment. The
subfunction into which the specific procedures are to be inserted
is identified by the code of the corresponding Segment, followed by
the code of the category, if the same Segment code is to be used in
several categories.
Functions F30 and F65 contain a subfunction
for each processed category. The subfunction into which the specific
procedures are to be inserted is identified by the code of the corresponding category.
In
the drop-down list, select one of the options:- A: Top category
It is used for the insertion
of the subfunction before the automatic subfunction.
- R: repetitive category
It is used to replace
an automatic subfunction. The condition of the automatic subfunction
does not apply to the replaced subfunction.
- Z: Bottom category
It is used for the insertion
of the subfunction after the automatic subfunction. The condition
of the automatic subfunction applies to the inserted subfunction if
the line number of the inserted subfunction is greater than that of
the automatic subfunction.
- Segment code
- Option available for functions F25, F35, F60, and F80 only. Enter
the code of the Segment called in the function.
- Function F80, when generated, includes a subfunction for each
type of access of a given Segment. It is possible to override one
particular generated access, or override all the generated accesses
of a given Segment.
- Data Element code
- Function F20 contains a subfunction for each edited Data Element.
The subfunction into which the specific procedures are to be inserted
is identified by the code of the corresponding Data Element. So, enter
the Data Element code for a F20 function.
- Access type
- For F80, the Segment code is followed by the type of physical
access to be replaced:
Table 1. Access type valuesOptions |
Descriptions |
CL |
Close cursor (standard access) |
D |
Delete |
OP |
Open cursor (standard access) |
P |
Open cursor |
R |
Read for check |
RN |
Read of next record (if selection implemented) |
RU |
Read for check before update |
RW |
Modification (rewrite) |
UN |
Unlock of record read in RU |
W |
Creation (write) |
Action type
The following options are automatically
selected depending on the function choice you have selected.
- Insert before
- Insertion of a subfunction before an automatic subfunction identified
by the Data Element or the Segment it processes.
- Insert after
- Insertion of a subfunction after an automatic subfunction identified
by the Data Element or the Segment it processes. The condition of
the automatic subfunction applies to the inserted subfunction if the
level number of the inserted subfunction is greater than the automatic subfunction's.
- Replace
- Replacement of an automatic subfunction identified by the Data
Element or the Segment it processes. (The condition of the automatic
subfunction does not apply to the replaced subfunction.)
For an F80 function, if the access type is not indicated,
all the access functions to this Segment are replaced.
Modification context
To update the parameters
of a subfunction that is already created and selected in the tags
tree, you select the
Update parameters (dialog specific) choice
in the pop-up menu. The same window opens but only the fields that
can be updated are active:
- For an F20 function selected in the tags tree, you can modify
the Data Element code ,
- For F25 and F60 functions selected in the tags tree, you can modify
the category, Segment code and action
type parameters,
- For an F30 function selected in the tags tree, you can modify
the category only,
- For F30 and F65 functions selected in the tags tree, you can modify
the category parameter only,
- For an F80 function selected in the tags tree, you can modify
the Segment code and access type parameters.
Note: All the authorized values and details on these fields
are indicated in the Creation context section in this
page.