SMFDLS Control Statement Reference › The SMFDLS Driver › CASFDUML Example Procedure

CASFDUML Example Procedure

//CASFDUML PROC LS=JCL.ERROR,A=A
//********************************************************************
//* CASFDUML - Logstream Dumping Procedure
//*
//* If automated dumping of SMF data recorded to logstreams is
//* being performed, modify a copy of this procedure and copy it
//* to a PROCLIB that contains started tasks.
//*
//* Modifications to be made (see notes in parentheses in the JCL):
//*
//* (1) Change the DSN to your Authorized CA SMF Director Load
//*     Library
//*
//* (2) The SMFDOUT DD is needed to drive the user exits used by
//*     the SMFDLS wrapper in the IFASMFDL utility.  While the
//*     default is to set the DD up as a DUMMY, it can also be
//*     allocated to a disk or tape output dataset at your
//*     discretion.
//*
//* (3) Change the DSN to the name of your SMF Control Data Set
//*     (SCDS)
//*
//* (4) Change the dataset name and member name to point to the
//*     required CA SMF Director Control Statement File. The
//*     shipped default contains the following statement:
//*
//*     DUMP.
//*
//* (5) Change the dataset name and member name to point to the
//*     required CA SMF Director logstream dump utility control
//*     statement file. The shipped default contains the following
//*     statements:
//*
//*        UNIT(SYSDA)
//*     *  STORCLAS(TEMP)
//*        JCL
//*
//*       Note: In the above example STORCLAS is a comment.
//*
//* (6) Change the value of UNIT to indicate a temporary DASD
//*     location, or, if SMS is in use, change the UNIT parameter
//*     to STORCLAS and indicate a temporary DASD location
//*
//*
//********************************************************************
//DUMP    EXEC PGM=SMFDLS,REGION=0M,TIME=1440
//STEPLIB  DD  DISP=SHR,DSN=CASFLOAD                  (1)
//SMFDLSPR DD  SYSOUT=&A.                **PRINT FROM SMFDLS
//SYSPRINT DD  SYSOUT=&A.                **PRINT FROM IFASMFDL
//CAIPRINT DD  SYSOUT=&A.                **PRINT FROM SMFD
//SYSXDIAG DD  SYSOUT=&A.
//SMFDOUT  DD  DUMMY                                  (2)
//SCDS     DD  DISP=SHR,DSN=CORP.CASMF.SCDS           (3)
//CAIIN    DD  DISP=SHR,DSN=CORP.CASMF.CNTL(SMFDDUMP) (4)
//SMFDLSIN DD  DISP=SHR,DSN=CORP.CASMF.CNTL(SMFDIN)   (5)
//CAILSNM  DD  DISP=(NEW,DELETE),SPACE=(TRK,1),       (6)
//             UNIT=SYSDA,DSN=&LS.

A copy of the CASFDUML procedure is provided in the CASFPROC target library. It is set up so that a start command can be issued to select an appropriate set of control statements, based on the logstream that is to be dumped from. CASFPARM target library member SMFDDUMP contains the DUMP control statement for SMFD, as well as any SPLIT statements that are required. See the Systems Programmer Guide for more information about setting up automated dumping with CASFDUML.

The SMFDOUT DD is required for processing since this is the ddname in the generated statements that are passed to IFASMFDL. SMFDOUT can also be an allocated DASD or tape data set, if an additional copy of the records is desired.

The CAILSNM DD is optional. It gives the name of the logstream containing the records to be dumped. By placing this ddname in the procedure, and adding a JCL control statement in the CAIIN control statements, the logstream name is passed to SMFDLS outside of the control statements. That way, there is no need to have a separate set of SMFDLS control statements for each logstream.