Rational Programming Patterns for System z

Create specific dialog or client subfunctions

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
Wizard used to create a dialog or client function/subfunction

Function choice

Depending on the function choice selected in this field, other parameters are displayed in the window and must be completed.
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 values
Options 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.

Terms of use | Feedback

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