Rational Developer for System z, Version 7.6

Field definition

To display the contents of this section, you must click the Add Data Element call button or select a Data Element call line in the tree. If you add a Data Element call, you are requested to select a Data Element among those already present in the current location, or define a new one. In this section, you must give the characteristics of the Data Element call

The fields with variable contents correspond to Data Elements that are described and processed in the program associated with the Screen. You must give them a nature (input field, protected field, etc.), and optionally provide:
  • A position in the Screen,
  • An option defining the associated label type,
  • A set of attributes,
  • The number of horizontal repetitions,
  • The number of vertical repetitions,
  • Associated processing options.

In this section, you can also define special Data Elements: Function keys, passwords and Error messages

Field Type
You select here the type of the variable field in the Screen:
  • Defined Data Element:
    The default is the conversational format defined in the Repository. If none has been defined:
    • A displayed and protected Data Element will be in output format.
    • An unprotected Data Element will have an extended internal format, possibly including one or two additional positions for a sign and/or a decimal point.
    Note: You cannot call a 'Unicode'-type Data Element in the Description of a Screen.
  • PFKEY: Function Key
    A PFKEY is a programmable function key which may be used to:
    • Branch to another Screen. The Screen to which the Dialog branches and the PFkey 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 PFkey number are indicated in the Additional controls for the selected field section.
    PFKEY can be positioned anywhere on the Screen. In the generated program, it will be processed in:
    • F0520 in order to initialize the operation code of the Screen,
    • F20 in order to ensure branching to a subsequent Screen. In this case, PFkeys 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.
    • CICS: The following values may also be used:
      • A1 : PA1 key
      • A2 : PA2 key
      • EN : ENTER key
      • 00 : CLEAR key
    • TANDEM: Only PFKEY values ranging from 01 to 32, corresponding to keys 'F1' to 'SF16', are taken into account.
    • DEC/VAX: Values 01, 02, 03, 06 to 11 and 14 to 20 may be used for the PFkeys.
    • MICROFOCUS: Values ranging from 01 to 24 may be used for the PFkeys.
    • HP3000: Values ranging from 1 to 8 may be used for the PFkeys.
  • *PASSWD: Password (IMS)

    On IMS, this value enables you to set a password on a specific Screen (generation of the PASSWORD Macro at the MID level).

    This Data Element must be described in the Repository and its length cannot exceed 8 characters.
    Notes on logical paging:
    • In order to distinguish the various LPAGE of the MOD, you must define, for the COND parameter used in the LPAGE Macro, a Data Element which will receive 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.
    • Logical paging operator: This Data Element must have been previously defined in the Repository 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 may be vertically repeated.

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

    The selected type must be P: Protected field.

Type
You select here the nature of the Data Element to be displayed on the screen:
  • 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
You select here the Data Element you want to call.

If no Data Element is displayed or if you want to modify the Data Element displayed, click the Change... button. A wizard displays the instances already present in the current location. Select an instance or create an instance and click OK.

Position

Position type
In this field, you specify the positioning of the Screen element:
  • Relative positioning
    The specified line and column numbers correspond to a move from the Data Element located just before in the list. The calculation of the positioning from the preceding Data Element is of two types, according to the nature of this field:
    • Data Element call (for an elementary or repeated Data Element, whatever its presentation): The starting point of the positioning is calculated from the top right-hand corner of the contents (and not the label) of the previous Data Element.
    • Screen calls: The positioning is calculated from the lower right-hand 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 defined by the position type, the line and column numbers is that of the first character of the:
  • Contents if the presentation type is: Data Element only, or Data Element with a column label.
  • label otherwise.
Line
In this field, you specify, on two numeric characters, the line number which determines the position of the element
  • In a relative positioning, this 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, this 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 positioned on the next tabulation point available.

Column
In this field, you specify, on three numeric characters, the column number which 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 positioned on 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 may contain several lines, are repeated vertically. Column headings appear only once.

Data Element attributes

You select here the presentation attributes for the content of the Data Element displayed on the Screen.

Intensity
Select here its intensity attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • N: Normal: Default value at the Dialog level
  • B: Bright: It will be highlighted.
  • D: Dark: It will be hidden.
Presentation
Select here its presentation attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • N: Normal: Default value at the Dialog level
  • B: Blinking
  • R: Reversed video
  • U: Underlined
Color
Select here its color attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • W: Normal: Default value at the Dialog level
  • B: Blue
  • R: Red
  • P: Pink
  • Y: Yellow
  • G: Green
  • T: Turquoise

Label attributes

You select here the presentation attributes for the label of the Data Element displayed on the Screen.

Intensity
Select here its intensity attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • N: Normal: Default value at the Dialog level
  • B: Bright: It will be highlighted.
  • D: Dark: It will be hidden.
Presentation
Select here its presentation attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • N: Normal: Default value at the Dialog level
  • B: Blinking
  • R: Reversed video
  • U: Underlined
Color
Select here its color attribute, among the following ones:
  • Default value: Defaults to the Dialog Definition
  • W: Normal: Default value at the Dialog level
  • B: Blue
  • R: Red
  • P: Pink
  • Y: Yellow
  • G: Green
  • T: Turquoise

Presentation

Presentation
This field enables you to select the label associated with each Data Element on the Screen.
There are four possible labels:
  • The long label (36 positions), entered on the Data Element Definition tab.
  • The short label (18 positions), entered on the Data Element -D Lines tab.
  • The relational label (18 positions), entered on the Data Element -D Lines tab.
  • The column heading label, 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 (left-justified...).

You must select a value among the following ones:
Value Comment
Default value Defaults to the value specified in the Dialog.
F: Data Element only  
L: Data Element with long label, left-justified The Data Element is preceded by the Data Element label, left-justified, on 36 positions.
M: Data Element with long label, right-justified The Data Element is preceded by the Data Element label, right-justified, on 36 positions.
N: Data Element with long label, left-justified, trimmed right The Data Element is preceded by the Data Element label, left-justified with suppression of blanks on the right.
R: Data Element with long relational label, left-justified The Data Element is preceded by the relational label, left-justified on 18 positions.
S: Data Element with short label, left-justified The Data Element is preceded by the short label, left-justified, on 18 positions.
T: Data Element with short label, right-justified The Data Element is preceded by the short label, right-justified, on 18 positions.
U: Data Element with short label, left-justified, trimmed right The Data Element is preceded by the short label, left-justified, with suppression of blanks on the right.
1: Data Element topped by a single line column label  
2: Data Element topped by a 2–line column label  
3: Data Element topped by a 3–line column label  
Note: The ':' character is generated for the Data elements preceded by a long, short or relational label. For the Data elements topped by a column label, the greatest length of the Data Element's label and content is taken into account for the relative positioning in the Screen.
Cursor
The checkbox has a twofold purpose. If you check it, you
  • Specify the Data Element on which the cursor will be positioned by default when the Screen is initially invoked.

    In an IMS configuration, if no cursor is specified, the cursor is positioned on the first Data Element of the Screen; except in the case of LOGICAL PAGING (LPAGE option selected in the Dialog Complement) where the cursor is positioned at the top of the Screen.

  • Override the default option (automatic skip of the cursor in case of protected field).
Simulation value
This field is optional. It will be used to valorize 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.


Terms of use | Feedback

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