Rational Developer for System z, Version 7.6

Additional controls for the selected field

This section refers to a field already called in the Screen. To display its contents, you must select a field call line and click the Add Additional controls for the field button, or unfold a field call line and select the nested control line(s) (if any).

Presence check
Values Comments
: Optional Data Element  
R: Required Data Element Must be entered when creating the Segment and cannot be deleted upon a modification.
S: Required, without Data Element own value check Same as R: Required Data Element, but the -D Lines of the Data Element are not used for the value check
P: checked when present Optional Data Element. The check is conditioned by the presence of the Data Element.
F: checked when present, without Data Element own values Same as P: checked when present, but the -D Lines of the Data Element are not used for the value check.
N: Check without Data Element own values Inhibits the value checks entered on the -D Lines of the Data Element. Only the value checks specified in the-CE Lines of the Screen are taken into account.
E: PFKEY branching values checking Associated to a PFKEY, validates the Screen branching values in the generated program.
Action
Here you select the condition required for the controls of the Data Element. This field has three different uses:
  • Declaring the Data Element as the operation code in the Screen.
  • Declaring the Data Element as the action code for the category.
  • Specifying under which conditions to execute validation and transfers of the Data Element.
Values Comments
: Always Validate Validate under all conditions
O: Operation code The Data Element is identified as the operation code.

The automatic processing of 6 standard operations (display, update, screen branching, end of conversation, same screen, call of another screen) is generated according to the values of the internal operation code (OPER variable, positioned in F0520 and managed in F40).

The Data Element must be a variable field.

The correspondence between the Data Element values and OPER is set:
  • In the -D Lines tab of the Data Element, on an O-type line.
  • Or in the -CE Lines tab of the Screen, with an Update Option set to V: Value to validate for this Data Element: the OPER value is indicated in the Update Segment, Data Element / Value / Subfunction field, and the Data Element value is indicated in the Display Segment, Data Element / Value / Intermediate zone field.
I: Action code The Data Element is identified as the action code.

Four action: types (create, modify, delete, create/modify) can be defined as appropriate and the associated processing is automatically generated according to the values of the CATM internal action code. CATM is a variable, positioned in F15, which conditions the reception accesses in F25 and the updates in F35

The Data Element must be a variable field.

The correspondence between the Data Element values and CATM is set:
  • In the -D Lines tab of the Data Element, on an O-type line.
  • Or in the -CE Lines tab of the Screen, with an Update Option set to V: Value to validate for this Data Element: the CATM value is indicated in the Update Segment, Data Element / Value / Subfunction field, and the Data Element value is indicated in the Display Segment, Data Element / Value / Intermediate zone field.
T: Validate when creating, modifying, deleting  
X: Validate when creating or modifying  
A: Validate when not updating Validates on all conditions, but does not update the Segment.
Update option
Here you select the update type which will be performed from the processed Data Element.
Values Comments
: Update by substitution  
S: Simulate screen branching Simulates the branching to the Screen indicated in the Screen field, as specified by the Operation Code (OPER).
G: Generate screen branching Generates (and simulates) the branching to the Screen indicated in the Screen field, as specified by the Operation Code (OPER).
Note: If no Screen is entered in the Screen field, the dialog is ended.

The value G: Generate screen branching may be used with delayed branching (See description of the Source type field).

M: Update by substitution Updates the Segment specified in the Update Segment, Data Element / Value / Subfunction field by substitution (MOVE).
Note: Updates are executed only if no error is found on the Screen.
+: Update by addition Adds the contents of the Data Element to the Data Element specified in theUpdate Segment, Data Element / Value / Subfunction field.
Note: Updates are executed only if no error is found on the Screen.
- Update by subtraction Subtracts the contents of the Data Element from the Data Element specified in theUpdate Segment, Data Element / Value / Subfunction field, and stores the result in this field.
Note: Updates are executed only if no error is found on the Screen.
P: Perform the standard validations Performs the standard validations on the Data Element, and then performs additional validations as indicated in the subfunction specified in the Update Segment, Data Element / Value / Subfunction field, using the Data Element indicated in the Display Segment, Data Element / Value / Intermediate zone field (the Data Element must be a standard field: the Source Type field must be set to Data Element or standard navigation).
Note: If there is a class or presence error, the subroutine will not be performed. However, for Data Elements that fail the content validation (the valid values of the Data Element as specified on the Data Element -D Lines tab), the subroutine will be performed.
V: Value to validate Comes as a complement to a Data Element's Description lines in order to indicate additional values to be validated, or to specify the internal values of the operation code (OPER) or action code (CATM) (with value O: Operation code or I: Action code in the Action field).

For the PFKEY Data Element used as the operation code (OPER), it uses the value entered in theUpdate Segment, Data Element / Value / Subfunction field for the value of the operation code (with O: Operation code in the Action field).

F: Reserved to Reverse Screen  
Update Segment, Data Element / Value / Subfunction
In the generated program associated with the Screen, this field contains the Segment of the Data Element which will be updated from the Data Element in the Screen. You usually indicate the Segment and the Data Element (if this Data Element is different from the Data Element called in the -CE Lines), except if the Data Element is protected and cannot be transferred.

Associated with an Update option set to P: Perform the standard validations, this Data Element contains the subfunction called.

Associated with an Update option set to V: Value to validate, the contents of this field vary according to the Data Element type:
  • For a standard Data Element, this field contains the value to be validated, or if the value in Action field is O: Operation code or I: Action code, this field contains the possible values of OPER or CATM.
  • For a PFKEY Data Element, this field contains the possible values of the internal operation code (OPER).
(Undefined) Screen
This field becomes available if you have selected S: Simulate screen branching or G: Generate screen branching as the Update option. It must then contain the code of the called Screen. To specify a Screen, or to change the Screen already inserted, click the Change button.
Source type
Values Comments
: Data Element or standard navigation Specifies the content of the source field which is used to fill in a display Data Element.

The source field is a standard field.

*: Not standard Specifies the content of the source field which is used to fill in a display Data Element.

The source field is not a standard field. In this case, you may indicate any data-name in the source field, which will be taken as such in the generated program.

D: Navigation after validation For Data Elements used as the Operation Code (OPER), with an Update option set to G: Generate screen branching, this value causes a delayed branching to the requested Screen. The branching will occur after all validations and updating of the reception part of the program have been completed (Functions F05 through F3999-FN).

The OPER value is set to O.

M: Navigation after update Same option as D: Navigation after validation, except that the OPER value is set to M.
S: IMS Logical Paging Option Locates the logical paging operator or the field corresponding to the COND parameter in the LPAGE Macro.
Display Segment, Data Element / Value / Intermediate zone
In the generated program associated with the Screen, this field contains the Segment of the Data Element which updates the Data Element on the Screen. You usually indicate the Segment and the Data Element (but only if the Data Element displayed on the Screen is different from the Data Element called in the -CE Lines), except if the Data Element is protected and cannot be transferred.
Particular values for IMS:
  • OLP: Logical paging operator.
  • COND: this value specifies the field corresponding to the COND parameter in the LPAGE Macro.
Associated with an Update option set to:
  • S: Simulate screen branching or G: Generate screen branching, this field must contain the value of the field (or the PFKEY) used to call the requested Screen. You do not need to enter the values between quotes, except if the value is blank.
  • V: Value to validate and the Action field set to O: Operation code or I: Action code, this field must contain the value for the initialization of the operation code (OPER) or action code (CATM). You do not need to enter the values between quotes, except if the value is blank.
  • P: Perform the standard validations, this field must contain the code of the field used to temporarily store data from the input field before branching to the subfunction.
Generation level
This field enables you to indicate, on 2 numeric characters from 06 to 98, the level of the specific procedures generated for the Data Element. (The default hierarchical level is 10).
The following subfunctions are automatically generated in the program associated with the Screen:
  • a subfunction of the F20 function for each Data Element of the Screen to be validated,
  • a subfunction of the F25, F35 and F60 functions for each Segment which is accessed in the Screen.

Terms of use | Feedback

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