-CE Lines in a Report

In this tab, you describe the Data Elements of each Report. You must call Data Elements and identify their position on layout lines, the source of the data, and the conditions under which the data is to be moved into the Data Element.

The -CE Lines tab consists of an editable table where you enter the elements that compose the Report. For each element call in the table, you must enter specific values. You can enter these values directly in the table if you are familiar with the -CE of a Report. Some of the fields in the table display values in a list. When you move your cursor on a value of the list, the label that is associated with the value is displayed in a tooltip. You can also use the definition sections that open when you select a line in the table. The type of section varies according to the type of element call that is selected in the table. For example, for a line that contains a structure, the Structure definition section opens. The sections contain fields where you can enter the values. The values are then automatically displayed in the column cells of the table. This page gives you details on the fields and the authorized values for each section.
Note: The possible actions with the buttons are also available in the contextual menu of the table.

Structure Definition section

The Structure definition section opens when you insert or select a structure call in the -CE Lines.
Structure identifier
It is a pure numeric field. Enter 2 digits maximum. The default value is 0. When the structure identifier is entered, click the structure in the table. It updates the structure identifier value that is displayed after the structure icon. The authorized values are presented in the following table.
Table 1. Structure identifier
Options Description
01 - 98 The structure number sequence must start from 01 (or 00) and contain no gaps. This value becomes a subscript for a table that contains all the structures.
00 This value is used to identify the fields that are required for user-defined spooling.

The Data Elements that belong to this structure are positioned relatively to the beginning of the record, and not to the beginning of the line, as is true of all other structures.

Upon generation, the structure 00 is recognized only for a Data Structure with a usage that is set to J.

Data Element call

The Data Element call section opens when a Data Element call is inserted or selected in the -CE Lines.
Data Element
This field displays the name of the Data Element that is called in the Report. The Data Element name is followed by the Data Element output format.

You can change the Data Element call by clicking Change. In the wizard that opens, you can select a new Data Element in the list, or create a Data Element by clicking Add Data Element.

This wizard displays the three Data Element formats in the following order: internal format, input format, and output format.

You can select contiguous instances in the selection wizard. To select noncontiguous instances, select Multi-selection. Select each instance, with the help of the filtering pattern if necessary. Then, click Add to selection list. You can also double-click each instance to add it to the list. To remove an instance from the selection list, select the instance in the selection list and click Remove from selection list before you close the selection wizard.

Column
Enter the column number that corresponds to the beginning of the Data Element field. It is required in a creation context. It is a pure numeric field, on 3 digits maximum. The value that is entered in this field is displayed on the Data Element call line just after the Data Element name.

Click Overview, Definition, or Keywords to access the information that is entered in the editor of the selected Data Element.

Undefined Data Element

An undefined Data Element is a Data Element that is not defined in the repository but that you define in the -CE Lines tab of the Report editor. The fields of the Undefined Data Element section are displayed when an undefined Data Element call is inserted or selected in the -CE lines.
Column
Enter the column number where the Data Element field begins. A numeric value is required, on 3 digits maximum.
Name
Enter the mnemonic name that references the Data Element independently of any Data Structure, Report, or Screen that the Data Element might belong to. Including a Report, Screen, or Segment in the Data Element name is not necessary because it is automatic. This name consists of alphabetic or numeric characters only.
Output format
Indicate the output format of the undefined Data Element according to the COBOL syntax. Its length is 14 characters maximum.
Blank when zero
Click this box for the generation of the BLANK WHEN ZERO clause.

Structure definition

This section opens when you enter or select a source line in the table.

Continuation
Describing the source or the condition of a Data Element can take more than one line. So enter a blank in this field to identify a first description line, or * to identify a continuation line.
Operation
You indicate the type of operation to be performed on the source Data Element.
Table 2. Type of operation
Values Comments
M Move of the source to the Data Element.

+

-

x

/

Add.

Subtract

Multiply

Divide

COMPUTE is generated for these four values.

R

Rounded result of the calculation.

D

Date in extended format XX/XX/XX. The target Data Element comprises a maximum of 8 characters, and the source, 6 characters.

C

A date with a format XXYYZZZZ becomes XX/YY/ZZZZ.

0

The century is 19.

1

The century is 19 if the year is lower than the year of reference. If the year is greater than the year of reference, the century is 20.

2

The century is 20 if the year is lower than the year of reference. If the year is greater than the year of reference, the century is 19.

E

A date with a format XXYYZZZZ becomes YY/XX/ZZZZ.

T

This option is used when Data Elements are to be totaled, and the total is to be printed. See the -D Lines tab, Edition Line Definition section, Type of totalization field.

If the type of totalization is Detail editable or Detail not editable, the specified value is added to the value of the Data Element code field and moved into this Data Element.

If the type of totalization includes a break level from 1 to 9, the specified values are accumulated in the intermediate totals accumulators or in the grand total accumulator. When the appropriate break level is reached and the conditions are true, the total is then moved into the Data Element and the total is printed.

A set of internal accumulators is associated with each Data Element to be totaled. The sum is calculated each time through the processing loop.

If a Data Element is printed only under certain conditions, these conditions also apply to the totaling. The total itself is printed only on a line that is designated for totaling. The maximum number of Data Elements to be totaled is 99 per Program.

S

With this option, the data is transferred after a table search. If the search is successful, the target Data Element receives data from the table Data Element that has the same name. Table search can be run only from a non-repetitive field that has been defined in the standard way.

U

With this option, the data is transferred with user-defined procedures.

WS Prefix
Enter the WORKING-STORAGE SECTION prefix where the source Data Element comes from.
Table 3. Values for the WS prefix
Values Comments

*

This option indicates that the source does not have a standard structure. The 13 characters that follow contain the expression data name to be integrated into the generated source language. No quotation marks are added.

No value

Read area of a file, as it is generated in the FILE SECTION.

1

Normally used for the processing area for files with control breaks and tables.

2

Update area of principal files.

5

Lines that are directly related to the Report itself, like record counter fields or line count fields.

6

This value is used for the output area.

Other numeric and alphabetic values can also be used for user-defined prefixes.

Source/Index
This field must contain the source Data Element or literal. When this field is filled in, the Operation field is automatically set to M if you save with an empty Operation field.
The source length is limited to 13 characters if the selected source is a Data Element, and 11 characters if it is a literal.
  • For sources that are Data Elements, do the following actions:
    1. Enter the name of the Segment that contains the source Data Element, then the name of the Data Element.

      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.

      If you put the cursor from the first to the fourth position of the field, the content assist wizard first displays the list of Segments. Select one of them, then click the field again and press Ctrl+Space again. The content assist then displays the list of Data Elements. Select one of them.

    2. Enter the numeric value that identifies an index (3 characters). The authorized options for an index are presented in the following table.
      Table 4. Values for an index
      Values Comments
      No value No Index.
      001 to 999 Numeric value variable used as the index for a table.
      nnn Name of a user-defined index.
      I** Standard index for search in tables.

      The generated index is formatted as IddssR, where ddss is the Segment name and R is the Search command.

      *cc Standard index for the cc repetitive category. The index is generated as Jddrcc, where ddr is the Report name and cc is the repetitive category.
  • For sources that are literals, enter the literal between quotation marks. The literal can be 11 characters long. For literals longer than 11 characters, you must define a specific VALUE clause in the WORKING-STORAGE SECTION of the Program.
Condition
This field is used to indicate the conditions under which the source is to be transferred to the target.

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.

When you enter the condition, you must conform to the following rules:
  • For IF conditions, use the COBOL format but omit the IF.
  • For AND, OR, use the COBOL format.
    Note: The dot is automatically generated, so omit it from the condition.

Feedback