-D Lines Definition

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

In the -D Lines tab, you enter the characteristics of categories and edition lines. You can enter the information in the Category definition and Edition Line Definition sections for each line inserted in the table or you can enter the information directly in the table. Some of the fields in the table offer values in a list. When you move your cursor on a value of the list, the label 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 alphanumeric characters from AB to ZY (ZZ is prohibited). The code value is used to differentiate categories from one another.
Report lines are grouped according to the conditions under which they will be printed (totalled lines, detail lines). Leaving gaps in the category sequence will facilitate future modifications.
The categories used for the lines containing the totals (Type of total => Total (with a break level from 1 to 9)) have the following characteristics:
  • They cannot have a detail line
  • They can contain several total lines
  • They cannot be repetitive
  • They can contain other ordinary lines
The categories containing a detail line with elements to be totalled (Type of total => 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 type of category: standard, header, repetitive or footer. Three options are presented in the following table:
Table 1. Type of category
Values Comments
Standard This 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 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 This indicates the first line of a category printed several times (repetitive category). This value causes the generation of a subscript that 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
The comments entered in this field refer to the category to be printed. The comments display with the code of the category in the list of categories. In the Comments field, you can indicate the nature of the category: header, footer, repetitive as an example.
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 value.
  • For a variable number, enter the three-character code for use of a subscript field, defined in the WORKING-STORAGE SECTION of the Program that calls the Report (the values are specified in the Program -CD Lines tab) or use the standard jrrrcc Pacbase index generated for the category:
    • rrr being the Report code
    • cc being the category in the Report (iterative).
    The code is required before printing.
Condition
This field indicates the conditions relevant for the execution of the Report. For IF conditions use the COBOL format but omit the IF. For AND, OR... use the COBOL format. The dot is automatically generated and therefore should not be entered.
Preview
Clicking the Preview button displays a window where you can view the edition lines of the selected Category, before printing.
The Comment and Category identifier values you enter in this section display 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 before printing, the type of lines with fields to accumulate in a Report total, and the totalling structure Report field.

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. 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. 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 the Remove button 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 up and displays the list of the labels 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 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 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.
Options Comments
No total  
* : 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 has the following characteristics:
  • It cannot contain other detail lines,
  • It cannot contain a total line,
  • It can include other ordinary lines.
0: global total This option indicates that a line will display the result of accumulated totals.
Options from 1: total (break level 1) to 9: total (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 subfunction, which must be performed before the structure number indicated on this line is processed, and before the WRITE command. The code comprises four characters.
The same structure number may be used in several categories. In this case the PERFORM will take place 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. In cases where several functions are to be performed with the same structure, the execution sequence may be problematic.
For the lines without a specified structure number, the function will be performed only once, before the structures processing is completed, and just before the WRITE command. 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 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