Previous Topic: DISPLAY Statement

Next Topic: EXITS Statement

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

EDIT Statement

The EDIT statement is optional. It alters the way in which output data elements are edited for printing, and/or the logic applied at control breaks (summary lines).

Alternate edit and/or summary option codes may be specified for up to fifteen output data elements. The specification of an edit or summary option that is not applicable to a particular type of output data element is ignored, and the default options are be used. One EDIT statement can be used globally, (with a blank set code), and this statement may be overridden for any individual report by an EDIT statement with a nonblank set code. The relative order of the statements in the input stream has no effect on this logic.

Only one edit and summary option may be in effect for an output data Element even if it is specified more than once on either a DISPLAY statement or EDIT statement. If specified more than once on an EDIT statement, the last (rightmost) set of options applies. An exception to this is the use of the S (Sign) or E (Currency Symbol) which are additive, and may be specified in addition to a formatting-type edit option.

The calculation of utilization rate and index data elements is handled as a special case by CA JARS and the specification of alternate summary options for these types of output data elements is not recommended. If this is done, the summary option is applied to the calculated value which is contained in the basic account record. For example, if a summary option of T is specified for the DE ID 78 (I/O index), the result at each control break is the display of the total of all calculated I/O index values from each basic account record within that control break. It is unlikely that this particular number would be of much interest, but there may well be valid applications for the use of the minimum, maximum or average type summary options with these types of output data elements. Since the effect of several of the summary options is to significantly alter the interpretation of the displayed data elements, it is suggested that appropriate titles also be specified.

Position

Field Length

Field Name

Notes

1

1

Set Code

Optional

2-9

8

Statement Type

EDIT

10-69

4
.
.
.
repeated 14
times

Option Specification

nnes where:
nn: Output Data Element ID (See Sequenced Output Data Elements Table)
e: Data Element Edit Option Code
s: Summary Option Code

70-80

11

Reserved

Not used

Data Element Edit Option Codes:

Option Code

Description

0

Edit numbers as integers (i.e., zero decimal positions)

1

Edit numbers with one decimal place

2

Edit numbers with two decimal places

3

Edit numbers with three decimal places

4

Edit numbers with four decimal places

5

Edit numbers with five decimal places

H

Edit time fields at hhhh.mm.ss or hhhhhhh.mm

D

Edit dates as dd/mm/yy

M

Edit dates as mm/dd/yy

Y

Edit dates as yy/mm/dd

C

Edit character data - normal default for most non-numeric data elements

S

Reserve low-order position for sign: : positive, -: negative*

E

Add currency symbol if space is available and not suppressed via PARMS statement

 

Leave blank. This allows default option to remain in effect.

* May be used in combination with other option specifications for the same output data element.

Summary Option Codes:

Option Code

Note

Description

T

 

TOTAL: Normal default for most numeric output data

A

1

AVERAGE: Total divided by number of jobs

S

2

AVERAGE: Total divided by number of steps

H

3

HIGHEST value encountered since last control break

L

3

LOWEST value encountered since last control break

D

3

DISPLAY edited value from last account record before a control break

N

3

NO-OP: Do not display anything - default for character fields

B

4

BREAK-AVERAGE: Total divided by number of control field changes at next lower summary level

U

2

USER-AVERAGE: Total divided by accumulation of user-count-field

I

2

INDEX: Total divided by accumulation of CPU time (in seconds)

E

2

ELAPSED-INDEX: Total divided by accumulation of elapsed-time (in minutes)

 

 

Leave blank. Allows default option to remain in effect
  1. Interpreted as S if only step-records are selected.
  2. Operative at job/step detail-level, as well as each summary level.
  3. Only options allowable for non-numeric data-elements, which includes dates and times-of-day.
  4. Example: Sort Field 1: Program Name, Sort Field 2: Run Date Result at second summary level is daily total, at first summary level is average per day, at grand total is average per different program name. See references to DE ID F7 (control break count).