Rational Developer for System z, Version 7.5

-D Lines Definition

The purpose of the -D tab is to create and describe the composition of a layout for the current report, especially its categories and edition lines.

Category Definition

A category is defined by its code, its type, the conditions of Report execution and a comment that is displayed in the list of categories with the code of the category.

Category identifier
Enter the code of the category, it consists of a two-alphanumeric characters string from AB to ZY (ZZ is prohibited). The code value is used to differentiate categories from one another.
Report lines are grouped together according to the conditions under which they will be printed (totaled lines, detail lines...). Leaving gaps in the category sequence will facilitate future modifications. Categories used for the lines containing the totals (Type of totalisation=> Totalisation (with a break level from 1 to 9)), can contain several total lines, cannot have a detail line, cannot be repetitive, can contain other ordinary lines.
Categories containing a detail line with elements to be totaled (Type of totalisation => editable or non editable detail lines on the Edition Line section), can only contain one detail line, cannot contain a total line, cannot be repetitive, can contain other ordinary lines.
Type
This field is used to identify the type of category: standard, header, repetitive or footer.
Values Comments
Standard

This is the default option.

A: Header

This value applies to repetitive categories only and indicates the first line of a top-of-page category (header).

Headers are automatically printed at the top of each page of a report. They are also printed when the repetitive category lines exceed the number of lines per page allowed for the report, causing a new page to be printed.

I: Repetitive

Indicates the first line of a category printed several times (repetitive category). This value causes the generation of a subscript which controls the number of repetitions. This number may be fixed or variable.

Z: Footer

This indicates the first line of an end-of-page category.

Footers are automatically printed when the repetitive category lines exceed the number of lines per page allowed for that report.

Comment
Comments entered in this field refers to the category to be printed. The comments are displayed with the code of the category in the list of categories. You can indicates in the 'Comments' field the nature of the category: header, footer, repetitive... as an example.
Repetition
This field must be completed if the type of category is repetitive so that a subscript, which controls the number of repetitions, is being generated.
This value may be a fixed number or a variable number of repetitions:
  • For a fixed number of repetitions, enter an absolute number value.
  • For a variable number, enter the three character code for use of a subscript field, defined in the 'Working Storage' tab of the Program which calls the Report (Values are specified in the Program 'Source' tab.) or use the standard VisualAge Pacbase index (jrrrcc) generated for the category:
    • .rrr = Report code
    • .cc = Category of Report (iterative)
    The code is required before printing.
Condition
This field indicates the conditions relevant for the execution of the Report. Format of entry: For IF conditions, use COBOL format but omit the 'IF'. For AND, OR etc., use COBOL format. The period (full stop) is generated automatically and therefore should not be entered.
Preview
Clicking the Preview button displays a window where you can view the edition lines of the selected Caterory, before printing.
The Comment and Category identifier value entered in this section are displayed on the Category line in the -D list, just after the category icon.

Edition Line Definition

In this section, you modify or enter the definition of an edition line selected/created in a category of the layout, the type of jump, the number of lines to skip, or the absolute line number, the function to be performed prior to print, the type of lines with fields to accumulate in a Report totalisation, and the totaling structure Report field.

Structure
This field displays the Structure identifier which is the structure code followed by the name of the label(s). The structure identifier starts from '1' up to '99'. Each structure identifier has at least one corresponding line on the layout. The identifiers are automatically calculated but they can be modified. For a new edition line created, there is no structure.
Clicking the Change... button opens a dialog box where you can select a structure identifier already defined in the layout. Once the structure identifier has been selected, the structure identifier value and label(s) names are being displayed on the Edition line in the -D list and in the structure field as a link. clicking the link switches to the -CE Lines tab, on the Structure Definition section.
Clicking the Remove... button deletes the structure identifier code and label(s) calls from the Structure field.
Label identifier
This field displays the label identifier. You can modify this label by clicking on the Change... button. A dialog box opens up and displays the list of labels already defined in the layout. Select a label and then click on OK to validate your selection. Then, the label identiifer is being displayed on the Edition line in the -D list and in the label field as a link. clicking the link switches to the -L Lines tab, on the Label Definition section.
Clicking the Remove... button deletes the label identifier call from the label field.
Jump
This field indicates the number of lines to skip if the line is not the first one in the category.
Type of jump
In this field, you select the type of skip to be inserted before generation. The default option is 'Line skip', otherwise, you can insert a page break.
Type of totalisation
Many Reports display after the header, a series of detail lines. Some of these detail lines contain fields that are to be totaled. Other lines contain fields that are used to display the totals. This field with the Foreign total structure field are then used to identify all these lines.
Options Comments
No totalisation  
*: detail editable

This indicates a detail line containing fields whose values are to be accumulated for totalling. The lines will be printed in the report.

The logic for Data Elements to be totalled is generated only if the edition conditions specified for the category containing the detail line are met. There is a maximum of 6 such editable lines in a program.

T: detail not editable

This indicates a detail line containing fields whose values are to be accumulated for totalling but the line is not to be printed in the report.

There is a maximum of 6 such non-editable lines in a program. A category containing a detail line:
  • can contain only one detail line,
  • cannot contain a total line,
  • can include other ordinary lines
0: global totalisation

This option indicates that a line will display the result of accumulated totals.

options from 1: totalisation (break level=1) to 9: totalisation (break level=9) Each of these options indicates a line for totalling at the control break level corresponding to a value from 1 to 9.
Function to perform
Enter the code of the function and sub-function which must be performed before the processing of the structure number indicated on this line, and before the WRITE command. The code is four characters long.
The same structure number may be used in several categories. In this case thePERFORM will take place each time through the processing loop for that structure. It is not necessary to enter the function or sub-function code on the first category that uses that structure
A function should not be mentioned more than once for the same structure. In cases where several functions are to be performed with the same structure, the execution sequence may be problematic.
For lines without a structure number specified, the function will be performed once only, preceding the completion of processing of the structures, and just prior to the WRITE. This function is performed according to the positioning of the associated structure and thus to the type or condition of the category in which the structure is called.
Foreign total structure
Enter the structure number on a line that has fields to be totalled or on a 'totalisation' line, which has a detail line described in a another Report. Some detail lines may be defined in a different Report, for example, a summary Report based on accumulations from other Reports may be needed. Only the totalled Data Elements will be printed, at the designed control break level.
Related tasks
Specifying Edition Lines on a Report
Related reference
Report Overview tab
Report Definition tab
-CE Lines definition
-L Lines Definition
-G Lines
Keywords tab
Documentation tab

Terms of use | Feedback

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