Introduction › How to Proceed › User-Defined Reports

User-Defined Reports

The following report sample shows the general format used for all User-Defined Reports.

Note: See the "User-Defined Reporting and the Report Writer" chapter to learn about the basics of generating reports using the JARS report writer. It shows you how to generate reports using three increasingly informative examples.

                                   M V S   P E R F O R M A N C E   G R O U P   S U M M A R Y
 BEGIN DATE - 02/02/98                                                                                      RUN DATE - 02/13/98
 END DATE   - 02/10/98                                                                                                 PAGE   1
 
 
 
  PERFORM   NBR     NBR     SERVICE  SERV      SWAP       TCB       SRB       CPU     ACTIVE   RESIDENT  CPU  T-AROUND PERCENT
    GROUP  JOBS  SESSNS       UNITS  RATE     COUNT      TIME      TIME      TIME       TIME       TIME  IDX  TIME-AVG     CPU
 
0            14       0      83,007   178       114  00:01:21  00:00:01  00:01:22   00:07:46   00:07:31    2  15:31:49   1.289
1           144       0   3,348,104   364        17  00:29:56  00:02:13  00:32:09   02:33:29   02:33:14    7  00:06:31  30.291
2             0      51   1,343,566   149     4,612  00:14:10  00:01:42  00:15:53   02:29:52   02:26:20   11  00:00:00  14.968
.
.
.

Each user-defined report has two sections:

• standard report header
• report body

The first 8-10 lines of every report are the standard report header that cannot be suppressed. The elements of the standard header are introduced by the following control statements:

• Name - description:

  The report title is generated by the HEADER statement. The positioning of the title is also coded on the HEADER statement. The HEADER in the example provided above is: MVS PERFORMANCE GROUP SUMMARY

• Dates:

  The Begin Date, End Date, and Run Date are all determined by fields on the PARMS and CRITERIA statements or, by default, the data read into CA JARS. The example has:

  BEGIN DATE  - 02/02/98      ...      RUN DATE  - 02/13/98
  END DATE    - 02/10/98
  

• Operating Cost (Not shown on this report, but shown when used):

  The PARMS statement is used to introduce a cost figure that is distributed to all cost centers. This is one chargeback technique. The example provided does not reflect the use of this feature. However, when implemented, the OPERATING COST and amount display above the RUN DATE on the reports.

• Spacing:

  Two blank lines separate the heading from the body of each report.

• Column titles:

  All data element titles are determined by the Title Table coded on the DISPLAY statement. The column titles in the example are:

  PERFORM    NBR     NBR     SERVICE  SERV   . . .  PERCENT
    GROUP   JOBS  SESSNS       UNITS  RATE              CPU
  

The content of the body of each report is determined from the specification of certain fields on the SORT and DISPLAY statements. There are three types of lines that can be generated in every report:

• Detail lines
• Summary lines
• Grand total line

Detail lines

The detail line information may be optionally displayed for each accounting record at the job and job-step level. Check the Output Data Elements Table in the "Control Statements and Tables" chapter to ensure that an item(s) to be displayed is available at the detail or summary level.

• Job lines:

  You may elect to display the selected output data elements (DE IDs) for each job for a given report. The job information is a summary of pertinent data for all the steps within that job.

• Step lines:

  You may display the selected output data elements for each job-step for a given report. The pertinent data at each step level for a given job creates the step level information.

Summary lines

A summary line is optionally generated, based on the individual field specifications on the SORT statement. Five summarization levels are possible. The summary line displays information that can be logically accumulated for each change of data in the user-specified sort control field. Positioning of the summary line is determined by the Summary Print option on the SORT statement.

Grand total line

A Grand Total line is automatically produced on every report. All elements that can be logically accumulated display on the final summary line.

The maximum number of lines to be printed on a page is controlled by a field on the PARMS statement.

Figures are normally displayed with commas marking the thousands, millions and billions places. If a number does not fit the space available, the commas are dropped. Right-hand decimal places are the next characters dropped--two at a time. If the number is so large that even the rounded integer does not fit, the number is rounded further, the rightmost 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.