Using JCL

Generating CA Earl Reports on z/OS and OS/390 › Using JCL

Using JCL

Use standard Job Control Language (JCL) to invoke the ACFRPTPP utility and the CA Earl facility. We supply sample JCL in the form of two inline procedures (PROCs) contained in a job stream named EARLRUN. Usually, EARLRUN is loaded into the SAMPJCL data set when you install CA ACF2. Check with your local CA ACF2 maintenance person if you cannot locate this data set.

The PREPROC Procedure

The first procedure in EARLRUN is named PREPROC. This procedure executes the CA ACF2 SMF Record Preprocessor utility (ACFRPTPP). You must specify the following JCL parameters when invoking PREPROC:

FLT (CA Earl Sequential File): Name of an output data set to contain the sequential format SMF records ACFRPTPP creates.
SMFDS (SMF Input File): Name of the data set that contains the CA ACF2 SMF data that is input for the CA Earl report. Usually, these are SYS1.MAN1, SYS1.MAN2, and so on. However, other data sets can be used. For example, the backup copies of SMF data sets stored on magnetic tape volumes.

The EARL Procedure

The second procedure in EARLRUN is named EARL. This procedure invokes the CA Earl program to generate a report. You must specify the following JCL parameters when invoking the proc EARL:

FLT (CA Earl Sequential File)

The name of the input data set that contains the sequential format SMF records ACFRPTPP creates. Specify the same data set name you specified for the FLT parameter in the PREPROC previous procedure.

EARL (CA Earl Program Source Data Set)

The data set name (and member name if the data set is a PDS) that contains the CA Earl program source statements. By default, the CA Earl sample programs are placed in a library named CAI.CAIMAC when you install CA ACF2. Check with your local CA ACF2 maintenance person if you are not sure about this data set name.

See the "Sample Reports" chapter for a complete list of the CA Earl reports that CA ACF2 supplies. Also, remember that you can specify the name of one of your own custom reports.

ELIB (CA Earl Macro Library)

The name of the data set library that contains copy members that the CA Earl source program requires. By default, some standard copy members that you may need are placed in a library named CAI.CAIMAC when you install CA ACF2. Check with your local CA ACF2 maintenance person if you are not sure about this data set name. A sample of the EARLRUN job stream follows. You can, of course, modify this job stream to suit your site's needs.

//EARLRUN JOB 1,'ACF2 REPORTS',MSGCLASS=A,TYPRUN=HOLD
//********************************************************************
//*
//*  THE FIRST PART OF THIS JOB PRODUCES THE FLAT FILE INPUT
//*  TO CA‑EARL ACF2 REPORTS
//*
//*  THE SECOND PART RUNS THE CA‑EARL JOB
//*
//********************************************************************
//*
//PREPROC PROC SMFDS=,
//             FLT=
//DELETE  EXEC PGM=IEFBR14
//FILE1    DD DSN=&FLT,DISP=(MOD,DELETE),
//          UNIT=SYSDA,SPACE=(TRK,1)
//*
//PRESCAN EXEC PGM=ACFRPTPP,REGION=384K
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//RECMAN1  DD DSN=&SMFDS,DISP=SHR
//SMFFLT   DD DSN=&FLT,SPACE=(CYL,(1,1)),DISP=(,CATLG),UNIT=SYSDA,
//            DCB=(RECFM=VB,LRECL=23756,BLKSIZE=23760)
//        PEND
//*
//EARL    PROC UNIT=SYSDA,
//             EARL=,
//             FLT=,
//             ELIB=
//EARL     EXEC PGM=EARL
//SORTLIB  DD   DSN=SYS1.SORTLIB,DISP=SHR
//EARLLIB  DD   DSN=&ELIB.,DISP=SHR
//EARLOBJ  DD   UNIT=&UNIT.,SPACE=(TRK,(14,1))
//SYSUT1   DD   UNIT=&UNIT.,SPACE=(TRK,(5,1))
//SYSUT2   DD   UNIT=&UNIT.,SPACE=(TRK,(1,1))
//SYSUT3   DD   UNIT=&UNIT.,SPACE=(TRK,(1,1))
//SYSUT4   DD   UNIT=&UNIT.,SPACE=(TRK,(2,1))
//SYSUT5   DD   UNIT=&UNIT.,SPACE=(TRK,(17,1))
//SYSUT6   DD   UNIT=&UNIT.,SPACE=(TRK,(5,1))
//SORTIN   DD   UNIT=&UNIT.,SPACE=(TRK,(17,1))
//SORTOUT  DD   UNIT=&UNIT.,SPACE=(TRK,(17,1))
//WORK1    DD   UNIT=&UNIT.,SPACE=(TRK,(17,1),RLSE)
//SORTWK01 DD   UNIT=&UNIT.,SPACE=(TRK,(17,1),RLSE)
//SORTWK02 DD   UNIT=&UNIT.,SPACE=(TRK,(17,1),RLSE)
//SORTWK03 DD   UNIT=&UNIT.,SPACE=(TRK,(17,1),RLSE)
//SYSUDUMP DD   SYSOUT=A
//SYSPRINT DD   SYSOUT=A
//SYSOUT   DD   SYSOUT=A
//SYSIN    DD   DSN=&EARL,DISP=SHR
//ACFFLT   DD   DSN=&FLT,DISP=SHR
//      PEND
//*‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
//*  SPLIT THE SMF INPUT FILE(S) INTO FLAT FILE
//*  FILL IN SMF INPUT FILE NAME AND FLAT FILE OUTPUT NAME
//*‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
//STEP1 EXEC PREPROC
//*‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
//*  RUN EARL
//*  FILL IN EARL SOURCE DSN NAME
//*  AND FILL ELIB PARM WITH NAME OF INSTALLATION ACF2 MACLIB
//*‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
//STEP2 EXEC EARL,
//         FLT='USER01.SMFFLT',
//         ELIB='CAI.CAIMAC',
//         EARL='CAI.CAIMAC(RPTPW)'

Be sure to provide values for the FLT, SMFDS, ELIB, and EARL parameters when you submit the EARLRUN job stream. Notice the values given to these parameters in the previous example. Depending on how CA Earl is installed in your system, you may need a STEPLIB DD statement in STEP2 to specify the CA Earl load library. The default name for the CA Earl load library is CAI.CAILIB. Check with your systems programmer for additional information and assistance.