Sample Usage › JARSWZ03: Control Breaks and Calculations › JARSWZ03 Execution Description

JARSWZ03 Execution Description

The INPUT, SELECT, and SORT statements function as described previously. Other control statements function as follows:

BREAK

The BREAK statement defines logical groups of records. The group defined in this example is comprised of records with the same job name. A control break is performed with each change in the JOB/NAME field. Control break totals are provided for the records in each control group. The control break that occurs on changes in JOB/NAME is referred to as the lowest, or first level control break. In this example the JOB/NAME break is also the highest level control break because it is the only control break.

When using the BREAK statement in a CA JARS Wizard run, you:

• must include a SORT statement in the run. Fields that are not listed in the SORT statement may not be specified in the BREAK statement.
• must list the BREAK statement fields in the same order as they are listed in the SORT statement.
• must not list more fields in the BREAK statement than are given in the SORT statement. (The BREAK statement may, however, include less fields than the SORT statement).

COMPUTE

In this example, the COMPUTE statements convert ELAPSED/TIME/HRS, ACTIVE/TIME/HRS, and CPU/TIME/HRS from hours to seconds. This is done as a preliminary step to displaying each of these fields in HH.MM.SS format on the report. To display a time field in HH.MM.SS format, the (HS) suffix code is appended to the field in the LIST statement. However, the (HS) suffix requires that the time field data be stored in seconds.

LIST

LIST defines the fields to be included in the printed output line.

In conjunction with the BREAK statement, the LIST statement causes CA JARS Wizard to perform automatic computations. It adds all numeric fields specified in the LIST statement and maintains an accumulator for each control level group. In this example, CA JARS Wizard maintains a job name accumulator and a grand total accumulator for each of the numeric fields defined in the LIST statement. The contents of these accumulators are printed at the designated control break.

Some reports may contain fields that do not have meaningful accumulated totals. This is true in our example for PER/GRP and CL. For these fields control break totals can be suppressed using the (NT) suffix. This suffix can be specified in the glossary for the particular field definition, or as a suffix to the field name in the LIST statement.

CA JARS Wizard provides automatic control break headings. The general form of control break headings is: field name TOTAL. In this example, the control break heading is JOB NAME TOTAL. You can override these control break headings. See the discussion of the BREAK statement in the "Control Statements" chapter.