-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.
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:
- 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
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.
- 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.
- Enter the name of the Segment that contains the source Data Element, then the name of the Data
Element.
- 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.
- For sources that are Data Elements, do the following actions:
- 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
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.