The Create/update a dialog sub-function wizard is used
either to insert specific procedures into the automatic functions:
F20, F25, F30, F60, F65 and F80 or to modify parameters of one of
these sub-functions selected in the tags tree. This dialog window
opens from the Macrostructure tags tree in a skeleton view or in a
standard view (in a macro editor with a dialog model).
Creation context
The following dialog window displays in the tags tree of
a macrostructure opened via a dialog macro editor.
To create a
dialog sub-function, you select the Create specific dialog
sub-function choice in the popup menu.
Function choice
Depending on the Function choice
selected in this field, other parameters are displayed in the dialog
window and must be completed.
- If you check the function choice 25 (F25), 35 (F30) or 60 (F60), you need
to fill in the Category field and Segment code field that display:
- If you check the function choice 30 (F30)
or 65 (F65), you only have to select a Category in addition to the standard Sub-function
code and Level fields.
- If you check the function choice 20 (F20),
you only have to enter a Data element code in
addition to the standard Sub-function 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 sub-function code and level
parameters:
- Function code
- This field is automatically filled with the code of the function
selected in the tree but if you select another function code in the
check-boxes, the code will automatically display in this field.
- Sub-function code
- A value is required here, it must be two characters long. It
is recommended to systematically use an alphabetic sub-function ('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 function F20, F25, F30, F35, F60 and F65.
Functions F25, F35 and F60 contain a sub-function for each accessed
Segment. The sub-function 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 sub-function for each processed category. The sub-function into
which the specific procedures are to be inserted is identified by
the code of the corresponding category.
In the dropdown list,
select one of the options:- A: Top category
This category code is used
for the insertion of the sub-function before the automatic sub-function.
- R: repetitive category
This category code
is used to replace an automatic sub-function. The condition of the
automatic sub-function does not apply to the replaced sub-function.
- Z: Bottom category
This category code is
used for the insertion of the sub-function after the automatic sub-function.
The condition of the automatic sub-function applies to the inserted
sub-function if the line number of the inserted sub-function is greater
than that of the automatic sub-function.
- Segment code
- Option available for function F25 and F35, F60 and F80 only. Enter
the code of the Segment called in the function.
- Function F80, when generated, includes a sub-function for each
type of access of a given Segment. It is possible to override one
particular generated access, or override all generated accesses of
a given Segment.
- Data element code
- Function F20 contains a sub-function for each edited Data Element.
The sub-function 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:
Options |
Descriptions |
CL |
Close Cursor (standard access) |
D |
Deletion (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 sub-function before an automatic sub-function
identified by the Data Element or the Segment it processes.
- Insert after
- Insertion of a sub-function after an automatic sub- function identified
by the Data element or the Segment it processes. (The Condition of
the automatic sub-function applies to the inserted sub-function if
the level number of the inserted sub-function is greater than that
of the automatic sub-function.)
- Replace
- Replacement of an automatic sub-function identified by the Data
Element or the Segment it processes. (The Condition of the automatic
sub-function does not apply to the replaced sub-function.).
For a F80 function, if the access type is not indicated, all
the access functions to this Segment will be replaced.
Modification context
To update the parameters
of a sub-function that is already created and selected in the tags
tree, you select the
Update parameters (specific dialog) choice in the popup menu. The same dialog window opens but only
the fields that can be updated are active:
- For a 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 F30 function selected in the tags tree, you can modify the category only,
- For a F30 and F65 functions selected in the tags tree, you can
modify the category parameter only,
- For a F80 function selected in the tags tree, you can modify the Segment code and access type parameters.
Note: All the allowed values and details on these fields
are indicated in the Creation context section above in
this page.