Rational Developer for System z, Version 7.6

Category definition

To display the contents of this section, you must click the Add Category button or select a category line in the tree. In this section, you must specify its type, position, presentation and repetitions.

A category is a group of consecutive Data Elements, Screen calls and/or labels in the list defining the Screen. These elements can be positioned in any manner, corresponding to the overall logic of processing.

A Screen can be made up of three categories:
  • The heading of the Screen (Screen-top category), initialized when the Screen is created.
  • The repetitive section of the Screen (repetitive category), optional.
  • The bottom of the Screen (Screen-bottom category). optional.

Each category can be defined only once in a given screen.

For each category, you can define:
  • A position,
  • A presentation option which applies by default to all the elements of the category,
  • For the repetitive category, a repetition number and the number of lines for each instance in the repetition.

The presentation of the Screen is defined by the distribution of the Data Elements within the different categories

The distribution also gives the processing order of the Data Elements in the generated program (Screen-top Data Elements; the Data Elements from the repetitive section, as many times as they are repeated; and the Screen-bottom Data Elements).

Type
You select here the category type:
  • Top category (required)
  • R: Repetitive category (optional)
  • Z: Bottom category (optional)
Code
In this field, you enter a code, on 6 characters, for the category. It will indicate the beginning of the category and will be displayed in the call tree on the category line.

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.

Repetitions
In this field, you specify the number of repetitions for the instance.
Lines per repetitions
This field enables you to indicate the number of repetitions for the instance in the repetitive category.
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.

Terms of use | Feedback

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