Rational Programming Patterns for System z

Adding -CE lines in a Report

From the -CE Lines tab of the Report editor, you can call Data Elements, describe the Data Element call, create structure calls, create, and define new Data Element calls.

About this task

The -CE Lines tab is constituted of an editable table, buttons associated with the table and sections which can be used to complete the information required for each element added to the Report. If you are familiar with the -CE of a Report, you can complete directly the columns of the table, otherwise you can complete the fields in the definition sections which display when you enter or select an element in the table. You must first call a structure in a Report, then you can add a Data Element or a continuation line, which will be embedded in the structure.

Procedure

  1. To insert a structure in the -CE lines list, complete the following steps:
    1. If there is no call line (the table is empty), click Add structure.
    2. To create a structure after an existing call line, set your cursor on a line of the table to indicate the position of the structure, then click Add structure. A new structure call line is created identified by Structureand an identifier whose default value is 'zero'. You can modify this value in the Structure Definition section that opens at the bottom of the window once the structure call is created, or enter a new value in Structure column in the table directly.
  2. In a structure, you call Data Elements. To create Data Elements call:
    1. Set your cursor on a structure, click Add Data Element.
    2. In the dialog box that opens up, you find the list of the available Data Elements. Select one of them and press OK. If you call an instance which does not exist yet, click New Data Element. In the creation wizard which opens up, enter the name and label and click OK. The new Data Element is then displayed in the selection list. If you select it and click OK, it is called in the -CE lines, under the selected structure it belongs to.
    In the -CE lines, the Data Element is identified by the Data Element icon, and a name. Double-clicking on the Data Element call line switches to its editor where you can read or modify the Data Element characteristics such as its format. You can change for another Data Element call in the table, to do so, you can either click in the cell where the name of the Data Element is displayed, a dialog box opens up, in which you can select another Data Element. You can do the same in the dedicated field in the Data Element call section but here you click Modify. The other attribute you can modify for a Data Element call in a Report is the column number in the column editable field.
  3. You can also create call lines for new Data Elements which are not declared in the location:
    1. Set your cursor on a structure and click Add undefined Data. A new call line is created under the selected structure, Unnamed Data Element defined by default with a value 1 for the column number.
    2. Enter the Data Element properties that identify the Data Element that is to say, the column, name, output format and the 'blank when zero' generation clause. The values can be entered in the column cells or in the dedicated fields of the Undefined Data Element Definition section, at the bottom of the window. The 'blank when zero' option can be checked in the table or in the section too.
  4. You can create continuation lines in the table after a Data Element line. To do so, set your cursor in a line containing a Data Element call and click Add a source line. A continuation line is created and embedded in the Data Element structure. You must then complete the columns dedicated to this line, and can help with the fields in the Structure definition section.
  5. Organizing the call lines in the table:
    1. You can delete instance calls. To do so, select one of them and click Remove. When you delete a Data Element, its dependent source is deleted too. A structure cannot be deleted globally. It must be deleted Data Element by Data Element.
    2. You can copy one or more call lines and paste them anywhere in the list. These choices are available from the menu (right-click the selection). Only Data Elements with the same level of indentation can be copied and pasted.
    3. You can change the sequence order of Data Elements within a structure or the order of structures in the -CE lines with Up and Down . A structure is moved with all the Data Elements it contains. The same applies to a Data Element, which is moved with its source.
  6. Modify the display:
    1. The table is minimized by default, so you can have the definition sections available below the table. Click Maximize to display only the table, in a full screen.
    2. All the table columns are displayed by default. To reduce the number of columns, right-click in the table and select Show columns > Select.
  7. Navigating in the table:
    1. When the focus is put in the table, press the up or down arrows to move to the previous or next line,
    2. Put the focus in a line and press the Alt key or Right arrow key to move to the next editable cell where you can enter values,
    3. Press the Left arrow key or Shift+Tab key to move to the previous editable cell.
    4. Press the Enter key to toggle between the editable cells in the same column and keep the edition mode.
    5. Press the escape key to leave the edition mode.
  8. To edit the column cells in the table, you need to double-click or press F2, then you can enter the appropriate values directly in the cell or use a check box or dialog box when available to select a value. The input mode in a column cell depends on the type of element entered in the table. In the Name column cell of a Data Element, you can use a dialog box to select a Data Element, whereas a check box is made available in the table to select the 'blank when zero' generation clause.

Terms of use | Feedback

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