Rational Developer for System z, Version 7.5

Label definition

To display the contents of this section, you must click the Add Label button or select a label call line in the tree. In this section, you must give the label its type, position and presentation attributes.

The fields are available or not in this section, depending on the label type you select.

For example, if you select a Fixed label or a Screen title type, the Presentation field is not available because it is relevant only for a Data Element label.

Type
In this field, you specify the type of label to be inserted in the layout. There are three types of labels in a Screen:
  • Fixed label.
  • Screen title. This is often used on a menu-type Screen to allow the selection of the Screen by its title. It will display the title of the Screen whose name is displayed in the Screen field located below the Type field.
  • Data Element label. This will display the label of the Data Element whose name is displayed in the Data Element field located below the Type field.
Data Element
This field is available only if you have selected a Data Element label type. 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.
Screen
This field is available only if you have selected a Screen title label type. If no Screen is displayed or if you want to modify the Screen 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:
  • For Data Elements with column labels, the starting position is the first character of the field.
  • For Data Elements with labels, the starting position is the first character of the label.
  • For Data Elements without either, the starting position is the first character of the Data Element itself.
  • The elements which identify Screen group categories have a position. The first element within the category is therefore positioned relatively to the beginning of this category.
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 Data 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. The line overflow is automatically controlled.

If the line and column numbers are both equal to zero, the Data 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 Data 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 Data 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 the line and column numbers are both equal to zero, the Data Element is automatically positioned on the next tabulation point available.

Presentation
This field can be edited only if you have selected a Data Element label type.

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 for the label type 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:
Values Comments
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 position
T: Data Element with short label, right-justified The Data Element is preceded by the short label, right-justified, on 18 position
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 2–line column label  
3: Data Element topped by 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 contents is taken into account for the relative positioning in the Screen.

Presentation

This presentation is not available if you have selected a Screen title label.

It allows to specify:
  • Either the character to be repeated and the number of repetitions,
  • Or the label itself.
Label
In this field, you enter the label which will be displayed on the screen.

The label must not exceed 30 characters and can be edited only if you have chosen the repetition of a character.

At the end of the label, you must enter a slash ('/'), which serves as the delimiter. You can however include slashes in the label; the last slash will then be considered as the delimiter. If you do not enter the delimiter, errors may occur upon the Screen compilation.

Repetitions
In this field, enter the number of repetitions for the 'repeated character' .

This field cannot be edited if the 'Label' field for a new label call or the 'Simulation value' for a new Data Element call are valorized.

If you enter a character in this field, you must also enter the repeated character.

Repeated character
In this field, you specify the character to be repeated.

This field cannot be edited if the 'Label' field for a new label, and the 'Initial value' field for a new Data Element call are valorized.

Presentation attributes

Here you select the presentation attributes of the label.

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

Terms of use | Feedback

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