Special Usage Considerations › The JSMFANAL SMF Analysis Program › JSMFANAL Selection Options

JSMFANAL Selection Options

JSMFANAL selection options allow you to control the range of SMF data chosen for analysis. You can include or exclude specific classes and jobs from the analysis or ignore specific programs for flushed-step processing. The syntax of the INCLUDE, EXCLUDE, and IGNORE statements is as follows:

INCLUDE    [CLASS=(a,b,c,d,e,f,g,h,i,j)]
           [JOB=nnnnnnnn]
EXCLUDE    [CLASS=(a,b,c,d,e,f,g,h,i,j)]
           [JOB=nnnnnnnn]
IGNORE  PGM=nnnnnnnn

INCLUDE/EXCLUDE

Include or exclude the stated job or classes. Use these statements to exclude jobs routed to another CPU, so that their SMF type 26 records are not counted as JCL errors, or to include specific jobs in classes that have been excluded (JOB has priority over CLASS).

IGNORE

Do not count the specified program in the flushed-step statistics, and do not print it on the detail report. Use for programs, like the Linkage Editor, that are expected to flush if the preceding step's return code dictates.

Each INCLUDE/EXCLUDE statement can contain only one of the subparameters JOB or CLASS. You can specify up to ten classes on one statement. You can only use one CLASS statement. If you only code one class, the parentheses are not required. You must specify the TYPE30 option of the PROCESS statement when you specify inclusion or exclusion by class. You can have an unlimited number of INCLUDE or EXCLUDE statements for the JOB subparameter, however, the INCLUDE and EXCLUDE statements are mutually exclusive. Do not specify both with the JOB subparameter in the same run. You can only have one job name per statement. You can also have an unlimited number of IGNORE statements, with one program name per statement.

You can make the job and program names up to eight characters long and specify them as masks. A question mark (?) signifies a single mask character for the corresponding position. An asterisk (*) indicates that all characters beginning at the corresponding position are masked, until the next non-mask character.

//SYSIN DD *
PROCESS (DETAIL,TYPE30)
EXCLUDE CLASS=A
INCLUDE JOB=RSCS1??A
INCLUDE JOB=TBSC905*
IGNORE PGM=?EWL
/*

This example produces a detail report, using SMF type 26 and 30 records as input. No jobs from class A are processed except those that begin with RSCS1 if they end with the letter A, and those that begin with TBSC905. Both Linkage Editor programs IEWL and HEWL are ignored if they are flushed.

//SYSIN DD *
PROCESS (LISTEXCP)
EXCLUDE JOB=ZC706*
EXCLUDE JOB=TBSC*
EXCLUDE JOB=TST*1
/*

This example produces a report showing EXCPs, using SMF record types 4, 5, and 26 as input. Any jobs having names beginning with ZC706 or TBSC are to be excluded from processing, regardless of the job name length (up to eight characters). Jobs with names starting with TST and ending with 1, such as TST01 and TSTAFC1, are excluded. In a networking environment, where jobs are routed through one system on their way to the system on which they execute, it is advisable to exclude the transient jobs to prevent their type 26 records (job purge) from counting as JCL errors.

Note: JSMFANAL does not support direct input from the VSAM MAN1/2 data sets on MVS/SP systems as the SMFIN file. Use the tape file created by the SMF dump utility. See AZ1SMFA in CAZ2JCL for execution JCL.