What Reports can I Generate from the Roscoe Accounting Files and how do I do This?

Products

• Roscoe

Issue/Introduction

 EARL is a free common component that is installed with Roscoe that will allow you to generate reports from the Roscoe Accounting Files. 7 Sample Earl reports are provided that cover 7 different areas.

 

Environment

Release: 6.0
Component: ROSCOE

Resolution

To produce reports from the Roscoe Accounting records, use the EARLJOB JCL, supplied in the Roscoe SAMPJCL dataset and customize it and run it with one of the supplied EARL sample jobs.

There is a list all the sample EARL reports supplied with  Roscoe. They are in the SAMPJCL dataset.

1. AWS statistics (EARLAWS)
2. CA Roscoe component statistics (EARLRSR)
3. CA Roscoe usage activity information (EARLROSC)
4. Monitor command and ETSO usage information (EARLMON)
5. RPS (CA-Roscoe Printing Services) usage information. (EARLRPS)
6. RTM (Response-Time Monitor) statistics (EARLRTM)
7. RPF (CA-Roscoe Programming Facility) program execution Statistics (EARLRPF)

NOTE: The actual names of the reports are in parenthesis

Instructions:

• In the STEPLIB, specify both the  Earl and  Roscoe load libraries. (The Roscoe load library contains ROSEARL which is a required Earl input exit.)
• Execute ACCTDUMP to produce the OUTPUT1 file which is then input into the EARLROSC step. This is specified as the ROSFILE DD as seen in the JCL below.
• In the EARLJOB JCL, replace

//SYSIN    DD  *
  Place the EARL accounting program here...

with

//SYSIN    DD  DISP=SHR,DSN=ROSCOE.SAMPJCL(REPORTNAME)

SAMPLE EARLJOB JCL

//EARLJOB  JOB (ACCOUNTING),'ROSCOE'
//*-------------------------------------------------------------------*
//*    Sample JCL to produce ROSCOE accounting reports using          *
//*    EARL.                                                          *
//*-------------------------------------------------------------------*
//EARL     EXEC PGM=EARL
//STEPLIB  DD  DSN=xxx.RO60LIB,DISP=SHR
//         DD  DSN=xxx.CAILIB,DISP=SHR
//EARLLIB  DD  DSN=xxx.RO60.SAMPJCL,DISP=SHR
//EARLOBJ  DD  UNIT=DISK,SPACE=(CYL,(1,1))
//ROSFILE  DD  DSN=ROSCOE.OUTPUT1,DISP=SHR
//SORTLIB  DD  DSN=SYSx.SORTLIB,DISP=SHR
//SORTIN   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SORTOUT  DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT1   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT2   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT3   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT4   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT5   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUT6   DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SORTWK01 DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SORTWK02 DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SORTWK03 DD  UNIT=DISK,SPACE=(CYL,(1,1))
//SYSUDUMP DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//SYSIN    DD  *
  Place the EARL accounting program here...
/*

 

Additional Information

If you need information that is not in one of the supplied reports, you will need to create your own report starting with one of the sample EARL reports and referring to EARLDEF in SAMPJCL which defines the layout of the Roscoe accounting records that are used as input to  Earl.

For more information, see Chapter 2. Accounting Maintenance Programs, of the  Roscoe Program and Utilities Guide r6 and the Earl Reference Guide.