-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.
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
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.