Field definition

You must give the characteristics of the Data Element call.

To display the contents of this section, you must select a Data Element call line in the table or click Add Data Element call.

The fields with variable contents correspond to Data Elements that are described and processed in the program associated with the Screen. A field description includes the following elements:
  • A type (such as an input field or a protected field)
  • A position in the Screen
  • An option that defines the associated label type
  • A set of attributes
  • The number of horizontal repetitions
  • The number of vertical repetitions
  • Associated processing options

You can also define special Data Elements: PF keys, passwords, and error messages

Field Type
Select the type of the variable field in the Screen.
  • Defined Data Element.
    The default is the defined conversational format. If none is defined, the Data Elements have the following formats:
    • A displayed and protected Data Element has an output format.
    • An unprotected Data Element has an extended internal format, possibly including 1 or 2 extra positions for a sign and a decimal point.
    Note: You cannot call a Unicode-type Data Element in the -CE Lines of a Screen.
  • PFKEY: function key.
    A PF key is a programmable function key that can be used to program one of the following actions:
    • Branch to another Screen. The Screen that the Dialog branches to and the PF key number are indicated in the Additional controls for the selected field section.
    • Initialize the Screen operation code (OPER variable). The initialization character of the OPER variable and the PF key number are indicated in the Additional controls for the selected field section.
    The PF key can be positioned anywhere on the Screen. In the generated program, it is processed in the following functions:
    • F0520 to initialize the operation code of the Screen,
    • F20 to branch to a subsequent Screen. In this case, PF keys are processed according to their display order in the Screen.
    The value of this function key depends on the generation variant. It is generally numeric and corresponds to the number of keys available on the keyboard.
    • For CICS, the following values can also be used:
      • A1 for the PA1 key
      • A2 for the PA2 key
      • EN for the ENTER key
      • 00 for the CLEAR key
    • For TANDEM, only PF key values that range from 01 to 32 are recognized. They correspond to keys F1 to SF16.
    • For DEC/VAX, the values 01, 02, 03, 06 to 11 and 14 to 20 can be used for the PF keys.
    • For MICROFOCUS, the values that range from 01 to 24 can be used for the PF keys.
    • For HP3000, the values that range from 1 to 8 can be used for the PF keys.
  • *PASWD: Password (IMS).

    In IMS, you can set a password on a specific Screen (generation of the PASSWORD Macro at the MID level).

    This Data Element must be described and its length cannot exceed 8 characters.
    Notes on logical paging:
    • To distinguish the various LPAGE of the MOD, you must define, for the COND parameter of the LPAGE Macro, a Data Element that receives the last 4 characters of the called Screen. This Element must be called in the Screen. Its type is automatically set to P: Protected field.
    • For the logical paging operator, the Data Element must have been previously defined with a maximum length of 5 characters.
    • For the management of the Logical Paging, the LPAGE option must be selected in the Dialog Complement tab.
  • ERMSG: Error message (English) or LIERR: Error message (French).

    It is used to reserve the location of the error messages. It can be repeated vertically.

    Its default length is 72 characters and it can be modified if ERMSG is defined with a different format.

    The selected type must be P: Protected field.

Type
Select one of the following natures for the Data Element to be displayed:
  • F: Protected and received field.

    The Data Element is displayed and protected on the screen but received by the program.

    If the Data Element does not have a conversational format, it is displayed with its output format.

  • P: Protected field.

    The Data Element is displayed and protected on the screen but not received by the program.

    If the Data Element does not have a conversational format, it is displayed with its output format.

  • V: Variable field.

    The Data Element is displayed and not protected on the screen. It can be edited and is received by the program.

    If the Data Element does not have a conversational format, its extended internal format is used instead (including the sign and decimal point if relevant).

Data Element
If the called Data Element is standard, it is displayed as a link. To change it, click Change. A wizard displays the available Data Elements (standard or not standard). Select a Data Element and click OK.

This wizard displays the three Data Element formats in the following order: internal format, input format, and output format.

You can select contiguous instances in the selection wizard. To select noncontiguous instances, select Multi-selection. Select each instance, with the help of the filtering pattern if necessary. Then, click Add to selection list. You can also double-click each instance to add it to the list. To remove an instance from the selection list, select the instance in the selection list and click Remove from selection list before you close the selection wizard.

You can also indicate a Data Element directly from the Data Element 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.

If the Data Element is not standard (such as *PASWD and PFKEY), no Data Element is displayed.

Position

Position type
In this field, you select one of the following positioning values for the Screen element:
  • Relative positioning.
    The specified line and column numbers correspond to a move relatively to the Data Element that is located just before in the list. The positioning of the preceding Data Element is calculated according to the nature of this field.
    • For a Data Element call (elementary or repeated Data Element, whatever its presentation), the starting point of the positioning is calculated from the upper right corner of the contents (and not the label) of the preceding Data Element.
    • For a Screen call, the positioning is calculated from the lower right corner of the called Screen in the calling Screen.
  • A: Absolute positioning. In this case, the line and column numbers correspond to the absolute address of the element on the Screen.
Notes on position: The position that is defined by the position type, line, and column numbers, is the position of the first character of the contents (if the presentation type is Data Element only, or Data Element with a column label), or of the label for the other presentations.
Line
Enter two numeric characters to specify the line number that determines the position of the element.
  • In a relative positioning, it is the number of lines between two elements. If the presentation type corresponds to a column heading, the number of lines in the column heading is automatically added, upon generation, to the indicated number.
  • In an absolute positioning, it is the line number on the Screen.

Line overflow is automatically controlled.

If both the line and column numbers equal zero, the element is automatically moved to the next tabulation point available.

Column
Enter three numeric characters to specify the column number that determines the position of the element.
  • In a relative positioning, if the line number is zero, the column number corresponds to the number of spaces between two elements on the same line. If the line number is greater than zero, the column number corresponds to an absolute positioning.
  • In an absolute positioning, the column number is the address of the element on the line. A zero value corresponds by default to column 2 upon generation (column 1 being reserved for the attribute). If the value is 1, the attribute is on the preceding line.

Any line length overflow and field overlapping are automatically detected. However, the presence of a space in front of each field is not verified.

If both the line and column numbers equal zero, the element is automatically moved to the next tabulation point available.

Horizontal repetitions
This numeric field indicates the number of occurrences of a Data Element on a line.

The Data Element label is repeated only if it is a column heading.

Each occurrence of the Data Element is separated by a space.

This repetition is only possible for an elementary Data Element.

The number of horizontal repetitions of the first Data Element in the repetitive category helps determine the number of lines for each occurrence.

Vertical repetitions
For an elementary Data Element, the number of vertical occurrences can be combined with the number of horizontal repetitions. The Data Element label is also repeated vertically, except if it is a column heading.

All the Data Elements and labels of the repetitive category, which can contain several lines, are repeated vertically. Column headings are displayed only once.

Data Element attributes

Select the presentation attributes for the content of the Data Element that are displayed on the Screen.

Intensity
Select its intensity attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • N: Normal is the default value at the Dialog level.
  • B: Bright means that it is highlighted.
  • D: Dark means that it is hidden.
Presentation
Select its presentation attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • N: Normal is the default value at the Dialog level.
  • B: Blinking.
  • R: Reversed video.
  • U: Underlined.
Color
Select its color attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • W: Normal is the default value at the Dialog level.
  • B: Blue.
  • R: Red.
  • P: Pink.
  • Y: Yellow.
  • G: Green.
  • T: Turquoise.

Label attributes

Select the presentation attributes for the label of the Data Element that is displayed on the Screen.

Intensity
Select its intensity attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • N: Normal is the default value at the Dialog level.
  • B: Bright means that it is highlighted.
  • D: Dark means that it is hidden.
Presentation
Select its presentation attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • N: Normal is the default value at the Dialog level.
  • B: Blinking.
  • R: Reversed video.
  • U: Underlined.
Color
Select its color attribute among the following values:
  • Default value defaults to the Dialog Definition.
  • W: Normal is the default value at the Dialog level.
  • B: Blue.
  • R: Red.
  • P: Pink.
  • Y: Yellow.
  • G: Green.
  • T: Turquoise.

Presentation

Presentation
Select the label that is associated with each Data Element on the Screen.
The following labels are possible:
  • The long label (36 positions), which is entered on the Data Element Definition tab
  • The short label (18 positions), which is entered on the Data Element -D Lines tab
  • The relational label (18 positions), which is entered on the Data Element -D Lines tab
  • The column heading label, which is entered on the Data Element -D Lines tab

The values of the field correspond to the association between the Data Element and the presentation characteristics for these labels.

Table 1. Values for the display of the Data Element label
Value Comment
Default value The default value is specified in the Dialog.
F: Data Element only The Data Element is displayed without any label.
L: Data Element with long label, left-aligned The Data Element is preceded by the Data Element label, left-aligned, on 36 positions.
M: Data Element with long label, right-aligned The Data Element is preceded by the Data Element label, right-aligned, on 36 positions.
N: Data Element with long label, left-aligned, trimmed right The Data Element is preceded by the Data Element label, left-aligned with the deletion of blanks on the right.
R: Data Element with long relational label, left-aligned The Data Element is preceded by the relational label, left-aligned on 18 positions.
S: Data Element with short label, left-aligned The Data Element is preceded by the short label, left-aligned, on 18 positions.
T: Data Element with short label, right-aligned The Data Element is preceded by the short label, right-aligned, on 18 positions.
U: Data Element with short label, left-aligned, trimmed right The Data Element is preceded by the short label, left-aligned, with the deletion of blanks at the end of the string.
1: Data Element topped by a single line column label The Data Element is topped by the column label on one line.
2: Data Element topped by a 2–line column label The Data Element is topped by the column label on two lines.
3: Data Element topped by a 3–line column label The Data Element is topped by the column label on three lines.
Note: A period (.) is generated for the Data Elements that are preceded by a long, short, or relational label. For the Data Elements topped by a column label, the greatest length of the Data Element label and content is taken into account for the relative positioning in the Screen.
Cursor
The check box has a twofold purpose. If you check it, you
  • Specify the Data Element on which the cursor is to be moved by default when the Screen is initially called.

    In an IMS configuration, if no cursor is specified, the cursor is moved to the first Data Element of the Screen. However, if the LOGICAL PAGING (LPAGE) option is selected in the Dialog Complement, the cursor is moved to the top of the Screen.

  • Override the default option (automatic skip of the cursor for a protected field).
Simulation value
This field is optional. It is used to give a value to the Data Element upon a Screen simulation.

You cannot indicate a simulation value if a repetition is specified.

Initial value
You enter here an initial value for the Data Element content. When the Screen is called for the first time, this value is displayed for the Data Element.

You cannot indicate an initial value if a repeated character is specified.


Feedback