Rational Programming Patterns

Additional controls for the selected field

This section is related to a field already called in the Screen. To display its contents, you must select a field call line and click Add Additional controls for the field or expand a field call line and select the nested control lines, if any.

Presence check
Table 1. Specification of the 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: PF key branching values checking Associated to a PF key, validates the Screen branching values in the generated program.
Action
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
Table 2. Specification of the Data Element validation and use
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 No comment
X: Validate when creating or modifying No comment
A: Validate when not updating Validates on all conditions, but does not update the Segment.
Update option
Select the update type which is to be performed from the processed Data Element.
Table 3. Specification of the update option
Values Comments
: Update by substitution No comment
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 can be used with a 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 performed 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 the Update Segment, Data Element / Value / Subfunction field.
Note: Updates are performed 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 the Update Segment, Data Element / Value / Subfunction field, and stores the result in this field.
Note: Updates are performed 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. It uses the Data Element indicated in the Display Segment, Data Element / Value / Intermediate zone field. This 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 description lines. It indicates additional values to be validated, or specifies 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 PF key Data Element used as the operation code (OPER), it uses the value entered in the Update Segment, Data Element / Value / Subfunction field for the value of the operation code (with O: Operation code in the Action field).

F: Reserved to PacReverse Screens No comment
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. 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 PF key Data Element, this field contains the possible values of the internal operation code (OPER).
(Undefined) Screen
This field becomes available if you 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
Table 4. Specification of the source type
Values Comments
: Data Element or standard navigation Specifies the content of the source field which is used to enter a display Data Element.

The source field is a standard field.

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

The source field is not a standard field. In this case, you can 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 (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 PF key) used to call the requested Screen. You do not need to enter the values between quotation marks, 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 quotation marks, 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
Enter, on two 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 that is accessed in the Screen

Terms of use | Feedback

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