Selective Processing of SMF Data › Creating Extract Files (CASFXSMF)

Creating Extract Files (CASFXSMF)

You may retrieve SMF data from history files by specifying the EXTRACT or PRINT commands with the CASFXSMF procedure, shown later in this chapter. The operands for these commands specify the type, quantity, and time period of the records to be retrieved.

In addition, the EXTRACT command has operands specifying:

• where the records are to be written
• whether or not SMF type 110 records that are compressed should be expanded in the output SMF file
• the name of an exit that must be called to process them before they are written

In a single run, you may code multiple EXTRACT/PRINT statements. Each EXTRACT statement normally creates a separate output file, although with a user exit, more than one output file can be created by a single EXTRACT statement.

A single SMF record may be routed to a number of destinations; however, it will never be written to the same destination more than once.

The EXTRACT control statement can also be used to rebuild split files in the event that a split file was not generated properly during a dump process. To facilitate application processing that uses the split file index, the EXTRACT process can also update a split file index. Because of this, applications can run unchanged whether the SMF data is in a split file or in an extracted file.

When SMF data is coming from history volumes that contain more than one SMF ID (SID), logstreams, or substreams:

• the SIDs are processed one at a time
• logstreams or substreams, if in use, are processed one at a time within a selected SID
• records within a SID appear in the output in chronological order if logstreams and substreams are not in use
• records within each logstream or substream appear in the output in chronological order within the logstream or substream
• if you use the SOURCE command, CA SMF Director outputs all data in input sequence

The following illustrates the JCL procedure CASFXSMF:

//   JOB (ACCTINFO),PGMR,CLASS=A,MSGCLASS=A
//*
//*
//CASFXSMF PROC A='*',                   /* SYSOUT CLASS
//         SCDDSN='CAI.JSMF.SCDS',       /* SCDS DSNAME
//         STEPLIB='CASFLOAD',           /* LOAD LIBRARY DSNAME
//         PRIUNIT=DUMMY,                /* PRIMARY POOL DEVICE
//         ALTUNIT=DUMMY                 /* ALTERNATE POOL DEVICE
//******************************************************************
//* PROCEDURE CASFXSMF - CA SMF Director DATA EXTRACT PROCEDURE
//*                      USED TO EXTRACT SMF DATA.
//*
//* NOTES:
//* (1) THIS PROCEDURE HAS BEEN SETUP WITH THE DYNAM OPTION OF
//*     CA SMF Director ENABLED,  WHICH  IS RECOMMENDED.  IF  THIS
//*     OPTION  IS NOT  USED,  CHANGE  PRIUNIT AND/OR ALTUNIT
//*     TO 'UNIT=(XXXX,,DEFER)' WHERE XXXX IS THE UNIT
//*     OR  DEVICE  NAME  (E.G. SYSDA, DISK, TAPE, CART).  FOR
//*     FURTHER DETAILS,  REFER TO THE CA SMF DIRECTOR SYSTEMS
//*     PROGRAMMER GUIDE OR THE USER GUIDE
//*
//* NOTE: AFTER MODIFICATION, THE PROC CAN BE COPIED INTO A
//*       PROCLIB OF YOUR CHOICE, USED INSTREAM, OR THE CAI
//*       COMMON PROCEDURE LIBRARY CAN BE ADDED TO THE SYSTEM
//*       PROCLIB CONCATENATIONS.
//*
//* REFERENCE: DSN=CASFPROC(CASFXSMF)
//******************************************************************
//EXTRACT EXEC PGM=SMFD,REGION=2048K
//STEPLIB  DD  DSN=&STEPLIB.,DISP=SHR
//SYSPRINT DD  SYSOUT=&A.
//SYSXDIAG DD  SYSOUT=&A.
//SCDS     DD  DISP=SHR,DSN=&SCDDSN.
//HISTORY1 DD  &PRIUNIT.,DISP=OLD
//HISTORY2 DD  &ALTUNIT.,DISP=OLD
//*
//    PEND
//*