ODATE date

Date reference for use by the FROMDATE or TODATE parameter, or both. Mandatory if a relative date is specified for either the FROMDATE or TODATE parameter; otherwise, optional.

The date specified for this parameter can be a specific date (in mmddyy, ddmmyy, or yymmdd format, depending on the site standard) or an AutoEdit variable that resolves to a specific date.

FROMDATE date

Date from which to accumulate statistical data from the IOA Log file. Mandatory if the TODATE parameter is specified.

The date can be a specific date (in mmddyy, ddmmyy or yymmdd format, depending on the site standard), or a relative negative number (including –0) of days from the date specified in parameter ODATE.

TODATE date

Date until which to accumulate statistical data from the IOA Log file. Mandatory if the FROMDATE parameter is specified.

The date can be a specific date (in mmddyy, ddmmyy or yymmdd format, depending on the site standard), or a relative negative number (including –0) of days from the date specified in parameter ODATE.

INCLUDE job_status mem_name

Criteria to include additional jobs in the Statistics file in addition to jobs that ended OK. This parameter consists of the following subparameters:

• job_status – include jobs with the following statuses in the statistical accumulation:

  - NOTOK – jobs that ended NOTOK

  - DUMMY – dummy jobs

• mem_name – jobs whose member name matches mem_name with type job_status are to be included in the statistical accumulation.

CLEANUP date MEM mem_name GRP grp_name CPU cpu_id JNO jes_job_id STD std_dev_mult TYP job_type

Criteria used to delete records from the Statistics file or specific occurrences of job executions within a statistical record. This parameter consists of the following subparameters:

• records, all of whose job occurrences have run dates prior to the specified date, are deleted from the Statistics file. The value can be an absolute date (in mmddyy, ddmmyy or yymmdd format, depending on the site standard, or an AutoEdit variable that resolves to a specific date), or a relative negative number (including –0) of days from the date specified in the ODATE parameter. Optional, if any or all of MEM, GRP, and CPU are specified.
• records whose member names match mem_name are deleted from the Statistics file. Optional.
• records whose table names match grp_name are deleted from the Statistics file. Optional.
• records whose CPU IDs match cpu-id are deleted from the Statistics file. Optional, 1 or 2 digit number.
• jes-job-id—job occurrences whose JES job ID matches jes-job-id are deleted from the Statistics record. The Statistics record is not deleted unless all its job occurrences have been deleted. Either MEM or GRP, or both, must also be specified. Optional, 1 to 7 digit number.
• std_dev_mult—job occurrences whose elapsed time falls outside the range of the job record's elapsed time standard deviation, multiplied by std_dev_mult (on either the high or low side), are deleted from the Statistics record. The Statistics record is not deleted unless all its job occurrences have been deleted. Either MEM or GRP, or both, must also be specified. Optional, 1 to 255 numeric characters. Default: 1.
• job_type—job occurrences whose job type and/or status match job_type are deleted from the Statistics record. The Statistics record is not deleted unless all its job occurrences have been deleted. Valid values for job_type are the job type DUMMY, or the ending statuses OK and NOTOK. Either MEM or GRP, or both, must also be specified. Optional.

Notes:

• Multiple CLEANUP statements may be specified.
• The subpar a meters of the CLEANUP statement are implicitly related via an AND relationship, that is, a job record or occurrence is not deleted unless they are all satisfied.
• If any job occurrence has a date later than the CLEANUP date, then the entire statistics record (containing all the earlier occurrences) is NOT deleted.
• Masking may be used for the values mem_name and grp_name of the MEM and GRP subparameters, and in the INCLUDE statement.
• Either the FROMDATE and TODATE pair of parameters, or the CLEANUP parameter, must be specified.
• The Elapsed time standard deviation is defined by the following mathematical formula:

  Standard-deviation = SQRT(1/n * Summation[i=0 to n] (job-elapsed-time[i] - average-elapsed-time)**2)

  where n is the number of job occurrences in the Statistics record, SQRT is the square-root function and '**' represents 'raising to the power' function.