Rational Developer for System z, Version 7.5

Create/update dialog sub-functions wizard

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 skelton 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.

Dialog window used to create a new dialog sub-function

Function choice

Depending on the Function choice selected in this field, other parameters are displayed in the dialog window and must be completed.
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 Start
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.
Related tasks
Modifying a Macrostructure (no skelton view)
Modifying a macrostruture in a skelton view

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)