Previous Topic: Job Control StatementsNext Topic: Batch Processing


Input Parameters

The input parameters to the report program are:

SMFTYPE=nnn

Specifies the value generated by SARINIT for defining user during initialization.

Where
nnn

Specifies the user SMF record number assigned to the metrics function.

This entry is required.

DATE=cyyddd-cyyddd

Specifies a range of dates used to generate reports.

Where

cyyddd-cyyddd

Specifies the startdate-enddate in the format century code, year, day:

c—The century code:
0 = 20th century
1 = 21st century

yy—The year

ddd—The day in the Julian calendar

The default is to process the entire input file.

This entry is optional.

DATE=TODAY(-n)

Specifies the current date minus a number of days to generate a range of dates that is used to produce the reports.

Where

n

Specifies the number of days from 1–366.

For example, if you enter DATE=TODAY(-18), the following is calculated automatically:

113255 (current date) -18 (days) 113237

The date 113237 is used to produce the reports, and generates a range of days activity from the current date back to the date specified by the -nn value.

This entry is optional.

TIME=hhmm-hhmm

Specifies a range of time used to generate reports.

Where

hhmm-hhmm

Specifies the starttime-endtime in the format hour-minute:

hh—The hour in military time, for example, 00–23

mm—The minutes from 00–59

The default is to process the entire input file.

This entry is optional.

RPT=report name

Implies the name of the report.

Where

report name is one of the following:

FILE—Generates SMF output file

ACCS—Access Activity Report

USER—User Activity Report

DELE—Delete Activity Report

LOAD—Load Activity Report

CHNG—Change Archival Date report

This entry is required.

ELAP=nn

The elapsed time in days from the time of the disk delete to the reload of the report.

Where

nn

Specifies the number of days from 00–99.

This entry must be coded for the RPT=LOAD control statement.

Each report is generated based on the control statement that defines that report. You can run multiple reports in the same run, but you must include a separate control statement for each.

Example #1

To generate an Access Activity report for November 08, a User Activity report for November 07 1:00 p.m. to 3:00 p.m., and to output an SMF file for the entire input, code the following:

SMFTYPE=128 RPT=FILE
SMFTYPE=128 DATE=113312-113312 TIME=0000-2359 RPT=ACCS
SMFTYPE=128 DATE=113311-113311 TIME=1300-1500 RPT=USER

Important! If you are generating the SMF output file using RPT=FILE, this control statement must be the first statement in the input file. The reason for this is because CA View reads the SMF input one time and generates the extracted Metrics SMF records, then uses this file as input to the remaining report requests in this execution. This process limits the number of reads of the original SMF input file. A limited number of reads is important because if you extract a time period that does not include subsequent report requests, those reports will be incomplete.

Example #2

The following example only produces an Access Activity report for 113310 from 00:00 to 14:00:

SMFTYPE=128 DATE=113310-113310 TIME=0000-1400 RPT=FILE
SMFTYPE=128 DATE=113310-113310 TIME=0000-2359 RPT=ACCS

Example #3

The following example produces a Load Activity report with an elapsed time of five days from disk deletion to reload:

SMFTYPE=128 DATE=113255-113265
TIME=0000-2359 ELAP=05