Previous Topic: Data Element Definitions

Next Topic: Performance Group Summary

Using the Sample Reports

Using the Sample Reports

This chapter explains the report control statements required to produce the Working Set Reports distributed with CA JARS. This chapter:

The comprehensive Working Set Reports allow you to quickly and easily provide information for management and technical personnel responsible for data center functions. It is possible that your reporting needs will extend beyond the reports presented here. These additional requirements can be readily satisfied using the CA JARS reporting component.

Therefore, in addition to explaining how the working set is produced, this is a teaching aid which helps you learn how to produce custom reports using CA JARS. In fact, several reports in the working set will almost certainly have to be customized to be meaningful in most installations. These are reports which are keyed to the job name and accounting data in the job accounting records. Since job naming conventions and job accounting standards vary, use of that data for the SORT control statements, for example, must be tailored for each installation. The same is true of GROUP, GROUPC, DESCRIPT, CREDIT, DEBIT, and BUDGET control statements. Similarly, the RATE, TSORATE, FORMRATE, and RJERATE control statements must be tailored to meet the needs of each installation. By observing and understanding how working set report control statements function, you can modify them or construct new ones.

The control statements which define all of the Working Set Reports, CAJROPTN (WSETJARS), are on the distribution tape and used by the Installation Verification Procedure executed when the product was installed. All control statements with the same character in position 1 apply to the same report. This character is called the set code and is used to identify each report and its corresponding control statements.

//CAIJSCIN  DD DSN=CAI.CAJROPTN(WSETJARS)
//          DD *

          1    1         5
 ....5....0....5....     0....
  SELECT     1            #
                          ▲
                          └────── Set code of report control statement
                                  found in CAJROPTN(WSETJARS)

The sample report layouts included with each report description are meant only to illustrate the appearance of a report based on the formatting and line spacing specifications contained within the control statements. Each report layout is a representative sample of a page selected from a series of reports generated using the control statements in the working set. The majority of the samples were from an artificially created account file which simulates several months of activity with a relatively small amount of data. The remaining reports were created using SMF and/or account files containing data with characteristics appropriate for each report.

All the control statements for the Working Set Reports were installed with this product. Reports generated during the Installation Verification Procedure were from this working set. The following table provides a complete list of all reports included in the working set, the set code that identifies each report and its associated control statements, a brief description of each report, and if the report is covered in detail later in this chapter, 'Yes' is indicated in the * column.

Report Title

Set Code

Description

*

Performance Group Summary

,

A summary of CPU resources used by batch jobs and TSO sessions within performance group.

Yes

Performance Group Profile

)

Profiles job/session activity within each performance group.

 

Service Units Distribution

-

Shows the distribution of resource consumption within each performance group.

 

Performance Objective Summary

;

Associates performance objectives to each performance group and shows resource usage.

 

Performance Group/Priority/Class Profile

<

Shows priority and job class attributes by performance group.

 

Absorption Rate Distribution

'

Shows service level and absorption rate to aid in establishing performance objectives.

 

Resource Requirements Analysis

?

Shows the relationship between the CPU and I/O requirements of the workload.

 

Throughput by Hour

%

Shows jobs per hour, TSO sessions per hour and resource consumption per hour.

 

Service Requirements by Jobname

(

Shows the distribution of resources used by the installation.

 

Data Processing Invoice

0

Provides a complete, itemized statement for each cost center (user, department, etc.)

Yes

Weekday Workload Profile

Q

A summary of utilization which can aid in redistributing workload to improve throughput.

 

Remote Usage Summary

$

A summary of machine usage by remote location.

Yes

I/O Index Distribution

>

A summary of overall I/O activity.

 

CPU Time Distribution

S

Provides CPU utilization by the entire workload.

 

Active Time Distribution

T

A profile of the entire workload by active time, useful in determining the effects of configuration changes on system throughput.

 

Weekday Workload Profile by Hour

B

A detailed profile of daily workload to aid in scheduling work.

 

Remote Input Log

|

Identifies which jobs ran and when.

 

Job Resource Utilization

D

Quantifies the resource requirements of each job and provides an audit trail for scheduling.

Yes

Tape Allocations by Job Name

E

Provides tape drive utilization for job.

 

Abnormal Terminations by Cancel Code

F

Identifies the type of ABENDs that terminated steps.

Yes

Class/Priority
Turnaround Analysis

N

Shows turnaround statistics by priority and job class.

 

Job Turnaround Analysis

O

A detailed look at each job from the time it entered the system until the last output data set was purged.

 

Computer Utilization Log

P

A chronological listing of all jobs to aid in pinpointing bottlenecks.

 

Peak Tape Drive
Utilization Periods

U

Analyzes, by hour and shift, tape drive utilization and allocation.

 

Tape EXCP Summary by
by Day

V

Depicts usage of tape subsystem by the entire workload.

 

Data Processing Invoice

0

Provides sample invoices.

*

Invoice Ledger

1

Provides a concise report on the distribution of operating costs to cost centers.

Yes

Monthly Utilization
Summary by Cost Center

2

Tracks key cost and utilization measures by cost center.

 

Data Center Cost Recovery

3

Compares charges computed by the billing algorithm to operating costs. Allows management to tune the billing algorithm for cost recovery.

 

Job Charge Summary

4

Shows cost and individual job executions by job name for each user; provides supporting details for user billing.

 

Detail Charge Audit

5

Details resource utilization by job.

Yes

Cost Recovery by Job Class

6

A summary by job class of job charges and utilization.

 

Abnormal End Cost Analysis

7

Summarizes computer activity which results in abnormal terminations.

 

TSO User Charge Summary

8

A detailed report of TSO charges by user.

 

TSO Session Analysis

*

A detailed report of every TSO session by user.

Yes

Hourly Turnaround Analysis

C

Highlights peak loads by showing the relative amount of work processed by hour.

Yes

CPU Page Rate Distribution

A

An analysis of paging activity based on program performance.

 

Peak Paging Periods

M

An overview of system paging activity.

 

Resource Consumption Summary by Day

K

A comprehensive summary combining utilization measures for major resources.

Yes

Class Structure Analysis

L

An analysis of resource utilization by Job Class.

Yes

Requeued Jobs Log

R

A listing of all jobs that were restarted.

 

Disk EXCP Summary by Day

W

Depicts usage of the disk family.

 

Utilization Summary by Job

G

Shows jobs with highest accumulated activity (percent CPU) for analyzing efficiency.

 

Utilization Summary by Program

H

A summary of resources used by each program.

 

Program Paging Profile

I

Isolates programs that cause high system paging rates.

 

Abnormal Terminations by Program Name

J

Identifies programs which terminate abnormally and the frequency and cause of termination.

 

Abnormal End Profile (Programmer Name)

.

Abnormal terminations by specific user.

 

Calendar of Computer Utilization

X

Provides overall system utilization and performance each month.

 

Workload Trend Analysis

Y

Shows monthly and year-to-date utilization and performance figures.

 

Application Trend Analysis

Z

Helps identify workload increases, new applications, by user and/or cost center.

 

Printer Device Utilization by Day

:

Standard and special lines printed by device.

Yes

Special Forms Utilization by Month

#

Forms utilization and charges.

Yes

RJE Impact Summary by User Department and Remote Line

+

Shows resource consumption by remote line number/user.

 

RJE Session Analysis

@

Shows usage statistics for each line.