Previous Topic: VM Accounting Record

Next Topic: Preparing Control Statements


User-Defined Reports

The output report formats vary from user to user, depending on the report control statements used. This section discusses features common to all user-defined reports. Refer to the report below for an example printout.

All user-defined reports formatted by the Report Writer contain three (3) parts:

                         A --> V M   T O T A L   C H A R G E   S U M M A R Y                                         B Y   U S E R   AND   D A T E  BEGIN DATE - 01/14/97  <--B                                                    C -->  RUN DATE - 02/01/94  END DATE   - 01/22/97  <--D                                                                E -->  PAGE   2            VM            CONNECT      PROCESS          I/O          U/R       SETUP         TOTAL   PERCENT            USERID         CHARGE       CHARGE       CHARGE       CHARGE      CHARGE        CHARGE     TOTAL F-->DATE 970115          $10.54       $31.29       $90.47      $148.91       $5.00       $286.21     3.380 F-->DATE 970121          $26.18       $12.72      $514.60         $.00     $5.00       $558.50     6.595  USERID A42MAINT <-- G    $36.72       $44.01      $605.07      $148.91      $10.00       $844.71     9.975      DATE 970118           $3.33         $.77         $.00         $.00        $.00         $4.10      .048      DATE 970121         $110.51        $6.31      $206.79       $12.53        $.00       $336.14     3.969      DATE 970122          $58.70         $.02      $117.45         $.00        $.00       $176.17     2.080  USERID CMSGXB           $172.54        $7.10      $324.24       $12.53        $.00       $516.41     6.097      DATE 970118           $3.33         $.00         $.00         $.00        $.00         $3.33      .039      DATE 970121          $50.76       $44.78      $119.32        $4.86        $.00       $219.72     2.595      DATE 970122          $41.92       $27.64      $131.89       $26.14        $.00       $227.59     2.686 <--H  USERID CMSPLM            $96.01       $72.42      $251.21       $31.00        $.00       $450.64     5.320 <--I                        $2,680.06      $880.22    $4,523.90      $318.82      $65.00     $8,468.00    99.958 <--J

This report is described in detail on the next two pages.

Report Header Lines

The report header consists of eight to ten lines of information in a standard format for all reports. Item A is introduced through the use of the HEADER statement. Items B, C, and D are introduced through the use of the PARMS statement. The items on the left, B and D, start in the first print position. The items on the right, C and E, adjust automatically to the computed print line length. The line length is based on the field length of the selected data elements and the number of blanks preceding each element.

Header Line Number

Description

1

The top-of-page header line displays the report title for a given report as indicated by A. The Title Column of starting position for the report title is defined by the user.

2

The third line displays the Report Begin Date and Run Date, items B and C, respectively.

3

The fourth line displays the Report End Date and the Report Page Number, items D and E, respectively. The page number is a four-digit, zero-suppressed value.

4 and 5

These lines are intentionally blank on every report.

6 and 7

These lines display the titles of the selected output data elements fields at the print positions defined by the user. The titles do not exceed the individual field lengths.

Detail Lines

The detail line information may be optionally displayed for each accounting record, item F.

For comparison to CA JARS reports on z/OS accounting data, each type 01 VM record is treated like a one step job.

Summary Lines

Summary line information is displayed for each change of data in a user sort control field at each of up to five summarization levels, items H and I, respectively.

The action taken after printing each summary line such as double-spacing, ejecting to a new page, and so forth, is specified in the Summary Print Option at each sort level.

Description and Control fields are associated with each summarization level. You can elect to display these fields and associated personalized descriptive header information with the summary lines. This is accomplished by using DESCRIPT statements.

In addition, the Control field and Summarization Description can be displayed as headers to signal the beginning of a new summarization level as illustrated by item G. No other information appears on this line. Note that the descriptions have been staggered to present a more meaningful relationship between the different summarization levels. This is accomplished by appropriately spacing the Summarization Description in the field when preparing DESCRIPT statements.

An additional final summary line, item J, is automatically displayed at the end of each report. All information that can logically be accumulated is presented as a final total on this line. If page ejection has been specified for the highest (major) summarization level, this line will print on a separate page.

More information:

HEADER Statement

DESCRIPT Statement