Rational Programming Patterns for System z

-CE Lines in a Report

The purpose of this tab is to 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 in which you enter the elements which 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. Otherwise, you must use the definition sections which open up when you enter or select a line in the table. The type of section depends on the type of line selected. For a line containing a structure, this is the Structure definition section which opens up, and so on, for each type of call line. The sections contain fields in which you can enter the required values. They are 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: For more information on how to enter information in the table, click the link in 'Associated task' at the end of this help page.
Figure 1. -CE Lines tab-CE Lines tab in the Report editor

Structure Definition

The Structure definition opens when a structure call is inserted or selected in the -CE lines. It gives information about the structure:
Structure identifier
It is a pure numeric field. Enter two 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 which is displayed just after the structure icon. The authorized values are presented in the Table 1 table.
  • Example:

    Structure identifier value Structure identifier value: (Data Element codes called in the structure, formats...)

Table 1. Structure identifier
Options Description
01 to 98 The structure number sequence must start from 01 (or 00) and contain no gaps. This value becomes a subscript for a table containing all the structures.
00 This value is used to identify the fields required for user-defined spooling.

The Data Elements belonging 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.

At generation, structure '00' is taken into account only if the
USAGE OF DATA STRUCTURE = 'J'.

Data Element call

The Data Element call opens when a Data Element call is inserted or selected in the -CE lines. It gives information about the selected Data Element:
Data Element
This field displays the name of the Data Element called in the Report. You can change this Data Element call by clicking Change. In the wizard which opens up, you can either select a new Data Element in a list, or define a new Data Element. To create a Data Element, click Add Data Element.
Column
Enter the column number in which the Data Element field begins. It is required in a creation context. It is a pure numeric field, on three digits maximum. The value entered here is displayed on the Data Element call line just after the Data Element name. When the value is updated in this field, click the Data Element call line. The column value is instantly updated on the line: Data Element Data Element name, column value.

Click Overview, Definition or Keywords to access the information entered in the editor of the selected Data Element. The information can be updated directly in the editor.

Undefined Data Element

An 'undefined Data Element' is a Data Element which is not defined in the repository but which 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. It gives information about the selected Data Element:
Column
Enter the column number, in which the Data Element field begins. A numeric value is required, with a three digits length maximum.
Name
Enter the mnemonic code which references the Data Element independently of any Data Structure, Report, or Screen to which the Data Element might belong. Including a Report, Screen, or Segment code in the Data Element code is not necessary since it is automatic. This code consists of alphabetic or numeric characters only.
Output format
This field is used to specify the output format of the Data Element which is not defined in the repository, using the COBOL syntax. It can be modified. Its length is 14 characters maximum.
Blank when zero
Click this field to ask for the generation of the BLANK WHEN ZERO clause.
Note: When all the required fields are entered, click the 'undefined Data Element' call in the table to refresh. The default values are thus replaced by the code of the Data Element, followed by its output format and then the column number: undefined Data Element Data Element name, Output format, column number.

Structure definition

This section opens when you enter or select a source line in the table. Here, you define the source of the data and the condition under which the source is to be transferred to the target Data Element.

Cont
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 field. It can be an arithmetic instruction with operators such as add, subtract, divide, multiply, rounded operator, or other operators used to total up, to move a source field, modify a date format, or transfer data with a procedure defined by the user. The operators are presented in the Table 2 table.
Table 2. Type of operation
Values Comments
M This default value is for Move. This option is used to transfer the source data to the Data Element.

+

-

x

/

Add.

Subtract

Multiply

Divide

COMPUTE is generated.

R

This option provides a rounded result on the calculation.

D

Date format XX/XX/XX. This option prints a date in extended format XX/XX/XX. The target Data Element must be 8 characters long, and the source, 6 characters.

P

Inverted date format. A date with a format XXYYZZZZ becomes YY/XX/ZZZZ. Be sure that the target Data Element field is 8 characters long and the source Data Element is 10 characters long.

C

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

0

19 as century.

1

'19' as century if year < ref. year; '20' otherwise

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

'20' as century if year < ref. yr; '19' otherwise

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

Date 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. When the type of line in the Report is:
  • Detail editable or Detail not editable, the values indicated in the fields of the Source Definition in the -CE Lines tab are added to the value entered in the Data Element code field and moved into the latter Data Element.
  • Totalization with a break level from 1 to 9, the value indicated in the fields of the Source Definition in the -CE Lines tab are accumulated in either the intermediate totals accumulators, or in the grand total accumulator. When the appropriate break level is attained, 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 only printed under certain conditions, these conditions also apply to the totaling. The total itself is only be printed on a line 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 with the same name. Table search can only be performed from a non-repetitive field which 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. The authorized values are presented in the Table 3 table.
Table 3. Values for the WS prefix
Values Comments

*

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

blank

Read area of a file, as 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 directly related to the Report itself, like record counter fields, 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 is limited to 13 characters if the selected WORKING-STORAGE SECTION prefix is a data name, and 11 characters if it is a literal. You enter different types of values in this field:
  • For sources that are Data Elements:
    1. Enter the name of the Data Structure in the Program (two characters), which is the Data Structure containing the source Data Element,
    2. Then enter the name of the Segment (two characters) containing the source Data Element, for sources that are Data Elements,
    3. Enter the name of the source Data Element (six characters).
    4. Enter the numeric value which identifies an Index (three characters). The authorized options for an index are presented in the table Table 4.
  • For sources that are literals, enter the literal (starting and ending with a quotation mark). 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.
Table 4. Values for an index
Values Comments
Blank No Index
001 to 999 A numeric value variable is used as the index for a table.
nnn Name of an index defined by the user
I** The 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.
Condition
This field is used to indicate the conditions under which the source is to be transferred to the target.
Input format:
  • For IF conditions, use the COBOL format but omit the 'IF'.
  • For AND, OR... use the COBOL format.
    Note: The dot is automatically generated and therefore must not be entered.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)