Control Statements and Tables › CA JARS Control Statements › DISPLAY Statement

DISPLAY Statement

The DISPLAY statement is required. Use it to select the desired data elements for display and define the print line format.

Positions 10-11 on the DISPLAY statement are reserved for the suffix of the desired Title Table module. CA JARS and each interface comes with a preassembled Title Table module, containing the TITLE control statements that explicitly define the data elements for that particular interface or product. The module name is JSIRTTxx, where xx is the suffix as shown below:

01=CA JARS
02=CA JARS/CICS Interface
03=CA JARS/APPC
MA=CA JARS Roscoe Interface
QA=CA JARS ADABAS Interface
VO=CA JARS VM Interface
MS=CA JARS IMS Interface
IS=CA JARS IDMS Interface (optional)
JV=CA JARS VAX Interface  (optional)
DC=CA JARS Datacom DB

The Output Data Elements Table allows you to select as many as 23 data elements from a pool of available elements to display in a given report. The table entries are in the format lnn, where:

l

is a one digit number of leading spaces.

nn

is a two-character code identifying the data element selected for display. This identification corresponds to the DE ID in the Sequenced Output Data Elements Table.

Each DISPLAY statement must have a set code. You can create your own Title Tables, as well (refer to your Systems Programmer Guide). If positions 10-11 are left blank, the report writer assumes suffix 01 and report all data elements with batch titles. The presence of a TITLE statement always overrides the title table entry for that particular data element.

The following example shows a typical DISPLAY statement:

position   1         2         3         4         5             8
  1........0.........0.........0.........0.........0..        ...0
  ADISPLAY   002101504106107512113129142146147

This DISPLAY statement defines the format for Report A as indicated by the set code in statement position 1. The data elements selected, in order, are:

Each of the selected fields were preceded by the following number of spaces, respectively: 0,1,5,1,1,5,1,1,1,1,1. The total print line cannot exceed 132 print positions. By using the indicated output length in the Sequenced Output Data Elements Table, and the number of blanks preceding each selected data element, you can compute the total requested print line length.

In general, all numeric fields are to be right-justified and need not be padded with leading zeros since CA JARS performs this function as part of its routine numeric field editing. The input control statements are never sorted. Generally, the order of the statements is not important. However, in the case of certain statement types, order may have some effect on report results. This effect is noted in the detail description of each statement type.

Note: Figures are normally displayed with commas marking the thousands, millions, and billions places. If a number does not fit the space available, the commas is dropped. Righthand decimal places are the next characters dropped, two at a time. If the number is so large that even the rounded integer doesn't fit, the number is rounded further, the rightmost are places dropped and the remaining numbers are followed by an asterisk and a number indicating the number of places dropped. Thus 386,957 (or 387,000) becomes 387*3. Sign values are always retained.