Rational Developer for System z, Version 7.6

-CE Lines in a Report

The purpose of this window is to describe the Data elements of each Report. This is achieved by listing the Data elements and identifying their position on layout lines, the source of the data and under what conditions the data is to be moved into the Data element.

Structure Definition

The Structure Definition section opens when a Structure call is inserted or selected in the -CE lines. It gives the following information on the Structure:
Structure identifier
This is a pure numeric field, it is made two digits maximum. The default value is '0'. When the structure identifier is entered, click the Structure call line in the -CE lines list, it updates the structure identifier value which is displayed just after the structure icon.
  • Example:

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

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 fields required for user-defined spooling.

The data elements belonging to this structure are positioned relative 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 consideration only if the
USAGE OF DATA STRUCTURE = 'J'.

Data Element Call

The Data Element Call section opens when a Data Element call is inserted or selected in the -CE lines. It gives the following information on 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 the Change button. In the open wizard, you can either select a new Data Element in a list, or define a new Data Element in a new window that you open by clicking the Add Data Element button.
Column
Enter here the column number, in which the Data Element field begins. (Required in creation). This is a pure numeric field, with three digits maximum. The value entered here displays on the Data Element call line in the -CE lines just after the Data Element name. Once the value is updated in this field, click on the Data Element call line, the column value is instantly updated on the line:
  • Data Element name, Column value.

Click one of the Overview, DefinitionKeywords 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 that you define from the -CE tab of the Report editor. The fields of the Undefined Data Element section are displayed once an 'undefined Data Element' call is inserted or selected in the -CE lines. It gives the following information on 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. There is no need to include a Report, Screen or Segment code in the Data Element code since the System does it automatically. This code consists of alphabetic Repositoryor numeric characters only.
Output format
this field is used to specify the output format of the element not defined in the Dictionary, using COBOL syntax. This can be modified. Its has a 14 characters length maximum.
Blank when zero
Click this field to ask for the generation of the BLANK WHEN ZERO clause.
Note: Once all the required fields are completed in this section, click on the 'Undefined Data Element' call in the list 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:
  • Data Element name, Output format, column number.

More

This pane is common to both Data Element call and Undefined Data Definition. In this pane, you define the source of the data and the condition under which the source should be transferred to the target Data Element.
Note: Double-click on a word to select it, or click on the left margin to select the entire line.
C
Describing the source or the condition of a Data Element may 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 here the type of operation to be performed on the source field. This can be an arithmetic instruction with such operators 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 a data via a procedure defined by the user.
Values Comments
M

This default value is for Move. This option is used to transfer the source data to the data element.

+

-

x

/

add.

substract

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

Inversed 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 turns XX/YY/ZZZZ.

0

19 as century.

1

'19' as CC if year < ref.yr;, '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 CC 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 for Data Elements to be totaled, and the total to be printed. When the type of line in the report (refer to the -D tab, Edition Line Definition section, Type of totalisation field) is:
  • Detail editable or Detail not editable, the values indicated in the fields of the Source Definition in the -CE tabwill be added to the value entered in the Data element code field and moved into the latter data element.
  • Totalisationwith break level from 1 to 9, the value indicated in the fields of the Source Definition in the -CE tab will be 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 desired total will be moved into the data element and the total will be printed.

A set of internal accumulators is associated with each data element to be totalled. The calculation of the sum is made each time through the processing loop.

If a data element is only printed under certain conditions, these conditions will also apply to the totaling. The total itself will 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 selected, the data is transferred after table search. If the search is successful, the target data element will receive 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 via user- defined procedures.

WS Prefix
Indicate in this field the WORKING-STORAGE prefix area where the source data element comes from.
Values Comments

*

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

blank

This is the 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

This is the update area of principal files.

5

These are lines directly related to the report itself like record counter fields, line count fields, etc.

6

This value is used for the output area.

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

Source/Index
This field, is limited to 13 characters when the Working storage prefix selected is data name, and 11 characters when it is Literal. You enter different types of values in this field:
  • For sources that are Data Elements:
    1. Enter first, the name of the Data Structure in the Program (2 characters), which is the Data Structure containing the source Data Element,
    2. then the name of the Segment (2 characters) containing the source data element, for sources that are Data Elements,
    3. Enter the name of the Source Data element (6 characters).
    4. the numeric value which identifies an Index (three characters):
      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 index is generated in the form IddssR, where ddss is the Segment name, and R is the Search command.

      *cc

      It is the standard index for repetitive category cc. The index is generated in the form Jddrcc, where ddr is the Report name, and cc, the repetitive category.

  • For sources that are literals, enter the literal (starting and ending with a quote). The literal can be 11 characters long. For literals longer than 11 characters, you must use the -W Lines tab in the Program editor to define a specific VALUE clause.

Condition
This field is used to indicate the conditions under which the source should be transferred to the target.
Input format:
  • For IF conditions, use COBOL format but omit the 'IF'.
  • For AND, OR etc., use COBOL format.
    Note: The period is generated automatically and therefore should not be entered by the user.

Terms of use | Feedback

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