-D Lines Definition

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

This tab contains an editable table and definition sections that open when you create or select a line in the table. You can enter the information directly in the table or in the definition sections. Some of the fields in the table display values in lists. When you move your cursor on a value of the list, the label that is associated with the value is displayed in a tooltip.

Category definition

A category is defined by its code, its type, the conditions of the 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 two alphabetic characters from AB to ZY (ZZ is prohibited). The code value is used to differentiate the categories.
Report lines are grouped according to the conditions under which they are printed (totalled lines, detail lines). Leaving gaps in the category sequence facilitates future modifications.
The categories for the lines that contain the totals (Type of totalization set to Totalization (with a break level from 1 to 9)) have the following characteristics:
  • They cannot contain any detail line.
  • They can contain several total lines.
  • They cannot be repetitive.
  • They can contain other ordinary lines.
The categories for a detail line that contains elements to be totalled (Type of totalization set to Editable or non-editable detail lines on the Edition line section) have the following characteristics:
  • They can contain one detail line only.
  • They cannot contain a total line.
  • They cannot be repetitive.
  • They can contain other ordinary lines.
Type
This field is used to identify the category type.
Table 1. Type of category
Values Comments
Standard It is the default option.
A: Header This value applies to the 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 in a Report. They are also printed when the repetitive category lines exceed the maximum number of lines per page for the Report, causing a new page to be printed.

I: Repetitive It indicates the first line of a category that is printed several times (repetitive category). This value causes the generation of a subscript that controls the number of repetitions. This number can be fixed or variable.
Z: Footer It indicates the first line of an end of page category.

Footers are automatically printed when the repetitive category lines exceed the maximum number of lines per page for the Report.

Comment
The comment refers to the category to be printed. It is displayed with the code of the category in the list of categories. In the Comment field, you can indicate the nature of the category like header, footer, or repetitive.
Repetition
Complete this field if the type of category is repetitive so that a subscript, which controls the number of repetitions, is generated.
This value can be a fixed number or a variable number of repetitions.
  • For a fixed number of repetitions, enter an absolute number.
  • For a variable number, enter the three-character code to use a subscript field. It is defined in the WORKING-STORAGE SECTION of the Program that calls the Report. The values are specified in the Program -CD Lines tab. You can also use the standard jrrrcc index that is generated for the category (rrr is the Report and cc is the iterative category in the Report). The code is required before printing.
Condition
This field indicates the conditions that are relevant for the execution of the Report. For IF conditions, you must use the COBOL format but omit the IF. For other conditions (such as AND or OR), you must use the COBOL format. The dot is automatically generated. Therefore, you must omit it.

A free reference is set when you indicate a Data Element in this field.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

The content assist wizard opens if the cursor is placed at the beginning of the field or after a dash (ww00- for example). It displays the list of the Data Elements.

Preview
Clicking Preview displays a window where you can view the edition lines of the selected category before printing.

Edition Line Definition

In this section, you modify or enter the definition of an edition line that is selected or created in a category of the layout.

Structure
This field displays the structure identifier, which is the structure code followed by the name of the labels. The structure identifier ranges from 1 to 99. Each structure identifier has at least one corresponding line on the layout. The identifiers are automatically calculated but they can be modified. A new edition line has no structure.
Clicking Change opens a dialog box where you can select a structure identifier that is already defined in the layout. When the structure identifier is selected, the structure identifier value and label names are displayed on the edition line in the -D lines list and in the structure field as a link. Clicking the link switches to the -CE Lines tab, on the Structure Definition section.
Clicking Remove deletes the structure identifier code and label calls from the structure field.
Label identifier
This field displays the label identifier. To modify this label, click Change. A dialog box opens and displays the list of the labels that are already defined in the layout. Select a label and click OK to validate your selection. The label identifier is then 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 Remove 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 line 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. You can also insert a page break.
Type of totalization
Many Reports display a series of detail lines after the header. Some of these detail lines contain fields that are to be totalled. Other lines contain fields that are used to display the totals. This field, along with the Foreign total structure field, is then used to identify all these lines.
Table 2. Possible values for the type of totalization
Options Comments
No total  
*: Detail editable It indicates a detail line with fields whose values are to be accumulated for totalling. The lines will be printed in the Report.

The Data Elements are totalled only if the edition conditions for the category with the detail line are met. A Program can contain a maximum of 6 such editable lines.

T: detail not editable It indicates a detail line with fields whose values are to be accumulated for totalling but the line is not to be printed in the Report.
A Program can contain a maximum of 6 such non-editable lines. A category with a detail line has the following characteristics:
  • It cannot contain other detail lines.
  • It cannot contain a total line.
  • It cannot be iterative.
  • It can include other ordinary lines.
0: global total It indicates that a line will display the result of accumulated totals.
1: total (break level 1) - 9: total (break level 9) Each of these options indicates that a line for totalling will be printed when the control break level is reached.
Function to perform
Enter the code of the function and subfunction that must be run before the structure number on this line is processed, and before the WRITE statement. The code comprises 4 characters.
The same structure number can be used in several categories. In this case, the function is run each time through the processing loop for that structure. It is not necessary to enter the function or subfunction code on the first category that uses that structure.
A function should not be indicated more than once for the same structure. If several functions are to be run with the same structure, the sequence can be problematic.
For the lines without a specified structure number, the function is run only once, before the structures processing is completed, and just before the WRITE statement. This function is run according to the positioning of the associated structure and thus to the type or condition of the category where the structure is called.
Foreign total structure
Enter the structure number on a line whose fields are to be totalled or on a total line whose detail line is described in another Report. Some detail lines can be defined in a different Report (for example a summary Report based on accumulations from other Reports). Only the totalled Data Elements will be printed, at the appropriate control break level.

Feedback