EXEC statement

The EXEC statement starts the DAPUSMF1 utility.

DAPUSMF1 EXEC statement syntax

 //stepName EXEC PGM=DAPUSMF1 [,PARM=parms]

PGM=DAPUSMF1 specifies that you want to run the DAPUSMF1 utility program.

The PARM parameter enables you to specify keywords to DAPUSMF1. You can specify multiple keywords in any order. Separate keywords with a comma. In standard JCL, the PARM parameter is limited to 100 characters. If the PARM parameter is invoked from a program, it is limited to 256 characters.

Keyword parameters identifies keyword parameters that can be used in the EXEC PARM= statement.

JOBNAME, JOBSTEP, and PROGRAM have the following wildcard characters available:

Character

Use

%

A percent sign represents any single character.

For example, specifying JOBNAME=A%M matches names such as ASM, ADM, and AJM.

*

A single asterisk represents zero or more characters

For example, specifying JOBNAME=A*D matches names that start with A and end with D, such as ASD, ADD, ASDD, A5TYD, and so on.

Keyword parameters

Keyword

Definition

FROMDATE= mm/ dd/ yyyy

Default: 01/01/1900

Selects a starting date of records for reporting

All SMF records written by Data Optimizer before the specified date are ignored by the reporting program.

FROMTIME= hh: mm: ss

Default: 00:00:00

Selects a starting time of records for reporting

All SMF records written by Data Optimizer before the specified time are ignored by the reporting program.

TODATE= mm/ dd/ yyyy

Default: 12/31/2039

Selects an ending date of records for reporting

All SMF records written by Data Optimizer after the specified date are ignored by the reporting program.

TOTIME= hh: mm: ss

Default: 23:59:00

Selects an ending time of records for reporting

All SMF records written by Data Optimizer after the specified time are ignored by the reporting program.

JOBNAME= nnnnnnnn

Default:( *)

Selects records that pertain to jobs with specific names or generic name patterns (where nnnnnnnn is a specific job name or generic job name pattern that contains (%) or (*))

Example

JOBNAME=(A*) or JOBNAME=(B%L)

JOBSTEP= nnnnnnnn

Default:( *)

Selects records that pertain to job steps with specific names or generic name patterns (where nnnnnnnn is a specific job step or generic job step pattern that contains (%) or (*))

Example

JOBSTEP=(SMF*) or JOBSTEP=(B%L)

PROGNAME= nnnnnnnn

Default: (*)

Selects records that pertain to programs with specific names or generic name patterns (where nnnnnnnn is a specific program or generic program pattern that contains (%) or (*))

Example

PROGNAME=(IEF*) or JOBSTEP=(IEF%14)

DSNAME= n . . . n

Default: * or ** (all dsnames)

Selects records that pertain to specific data set names or generic name patterns (where n . . . n is a specific dsname or generic pattern that contains (%) or (*))

Example

DSNAME=RWG* lists all entries that start with RWG and have two qualifiers.

DSNAME=RWG.** lists all entries that start with RWG regardless of the number of qualifiers.

RECTYPE= nnn

Default: 241

Identifies the SMF record type of the records written by Data Optimizer

The value specified must correspond to a value specified by the SMF record type option.

RPTTYPE=(STATS, CAT, DSINFO, OPTIONS)

or

RPTTYPE=ALL

Default: ALL

Selects SMF reports that can be obtained and includes the following values:

STATS reports on VSAM/NONVSAM statistics.
CAT provides catalog information on VSAM.
DSINFO provides general data set information.
OPTIONS provides data set options regarding the data set being processed.
The ALL keyword specifies STATS, CAT, DSINFO, and OPTIONS.
If nothing is specified, a summary report is generated.

DSTYPE=(VSAM, NONVSAM)

or

DSTYPE=ALL

Default: ALL

Selects which data set type to include in the report

The ALL keyword specifies VSAM and NONVSAM.

LC= nnnn

Default: 55

Specifies the line count per page

LIST=(PARMS, NOHDRS, SUM)

or

LIST=ALL

No default

Specifies further reporting options

PARMS lists the keywords that are in effect for this run.
NOHDRS omits page headers.
SUM prints out the Performance Summary Report.
ALL selects all of the reporting options.

OPTION=(COPY, CSV, NOATOD, HELP)

No default

Specifies additional actions to perform on the input data set (SMFFILE)

COPY writes selected MainView Batch Optimizer SMF records to SMFOUT.
CSV creates comma-separated value data sets that show statistics.
Note

The CSV option cannot be included in combination with the COPY option.
NOATOD does not adjust the time of day, which affects the OPEN/CLOSE DATE/TIME that are shown on the report.
HELP prints out the available keyword parameters.

DSTT=loadModuleName

Default DAPUDSTT

Specifies the Daylight Saving Time Table load module name

COUNT=nnn

Provides a count of how many MainView Batch Optimizer SMF records to process

Note

This keyword applies only to SMF records written by MainView Batch Optimizer 2.3 or earlier.

SKIP=nnn

Provides a count of how many MainView Batch Optimizer SMF records to skip before processing

OPTMODE=(BASIC, ADVANCED)

or

OPTMODE=ALL

Enables filtering of the Optimization mode

For example, if you specify BASIC, you will only get BASIC Optimization mode SMF records for data set information on SYSPRINT or copied to SMFOUT for OPTION=COPY.

OUTMODE=(BASIC, ADVANCED, NONE)

or

OUTMODE=ALL

Enables filtering of the output Optimization mode

For example, if you specify BASIC, you will get only BASIC output Optimization mode SMF records for data set information on SYSPRINT or copied to SMFOUT for OPTION=COPY.

EXEC statement

Comments