Additional controls for the selected field
This section is related to a field that is 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 Blank: Optional Data Element R: Required Data Element Must be entered when the Segment is created. It 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 that are entered on the -D Lines of the Data Element. Only the value checks of the -CE Lines of the Screen are recognized. E: PF key branching values checking Associated to a PF key, validates the Screen branching values in the generated program.
- Action
- Select the condition that is required for the Data Element controls. This field has the
following uses:
- Declaring the Data Element as the operation code in the Screen
- Declaring the Data Element as the action code for the category
- Specifying the conditions for the validation and transfers of the Data Element
Table 2. Specification of the Data Element validation and use Values Comments Blank: Always validate The Data Element is to be validated 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. The operation code is the OPER variable, which is set 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 either one of the following tabs:- In the -D Lines of the Data Element, on an O-type line.
- In the -CE Lines 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 necessary and the associated processing is automatically generated according to the values of the CATM internal action code. CATM is a variable, which is positioned in F15. It 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 either one of the following tabs:- In the -D Lines of the Data Element, on an O-type line.
- In the -CE Lines 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 The Data Element is to be validated but the Segment is not updated.
- Update option
- Select the update type to be run from the processed Data Element.
Table 3. Specification of the update option Values Comments Blank: Update by substitution S: Simulate screen branching Simulates the branching to the Screen that is indicated in the Screen field, according to the operation code (OPER). G: Generate screen branching Generates (and simulates) the branching to the Screen that is indicated in the Screen field, according to 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 that is specified in the Update Segment, Data Element / Value / Subfunction field by substitution (MOVE). Note: Updates are effective 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 effective only if no error is found on the Screen.-: Update by subtraction Subtracts the contents of the Data Element from the Data Element that are specified in the Update Segment, Data Element / Value / Subfunction field. It also stores the result in this field. Note: Updates are effective only if no error is found on the Screen.P: Perform the standard validations Completes the standard validations on the Data Element, and then completes other validations according to the subfunction that is 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 a class or presence error is detected, the subroutine is not run. However, for the Data Elements that fail the content validation (the valid values of the Data Element as specified in the Data Element -D Lines), the subroutine is run.V: Value to validate Comes as a complement to a Data Element description lines. It indicates other 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 that is used as the operation code (OPER), it uses the value from 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
- Update Segment, Data Element / Value / Subfunction
- In the generated program that is associated with the Screen, this field contains the Segment of
the Data Element to 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.
A free reference is set when you indicate a Data Element in this field.
Content assist is available on this field, as shown by the symbol
in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.
If you put the cursor from the first to the fourth position of the field, the content assist wizard first displays the list of Segments. Select one of them, then click the field again and press Ctrl+Space again. The content assist then displays the list of Data Elements. Select one of them.
Associated with an Update option set to P: Perform the standard validations, this Data Element contains the called subfunction.
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 select 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 change the Screen that is already inserted, click Change.
You can also do the same actions directly from the Screen column of the table.
Two methods are possible:- Place the cursor in the column and enter the name directly. To make the input easier, you can open a content assist wizard by clicking Ctrl and the space bar simultaneously. If you start entering a name, the content assist displays the instances that start with this input. If you enter the name of an instance that does not exist and if you validate, the input is discarded.
- Click the button that appears when you set your cursor in the column. In the selection wizard that opens, select an instance.
- Source type
-
Table 4. Specification of the source type Values Comments : Data Element or standard navigation Specifies the content of the source field that is used to enter a display Data Element. The source field is a standard field.
*: Not standard Specifies the content of the source field that 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. This source field will be retrieved as is 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 occurs after all validations and updating of the reception part of the program are completed. It corresponds to 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 that corresponds to the COND parameter in the LPAGE Macro.
- Display Segment, Data Element / Value / Intermediate zone
- In the generated program that is associated with the Screen, this field contains the Segment of
the Data Element that updates the Data Element on the Screen. You usually indicate the Segment and
the Data Element (only if the Data Element that is 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.
A free reference is set when you indicate a Data Element in this field.
Content assist is available on this field, as shown by the symbol
in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.
If you put the cursor from the first to the fourth position of the field, the content assist wizard first displays the list of Segments. Select one of them, then click the field again and press Ctrl+Space again. The content assist then displays the list of Data Elements. Select one of them.
The following values are specific to IMS:- OLP for the logical paging operator,
- COND for the field that corresponds to the COND parameter in the LPAGE Macro.
The value that you enter in this field depends on the value of the Update option:- If the Update option is 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.
- If the Update option is V: Value to validate and the Action is 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.
- If the Update option is P: Perform the standard validations, this field must contain the code of the field that is used to temporarily store data from the input field before the 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 that is 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.