Control Statements and Tables › CA JARS Control Statements › CRITERIA Statement

CRITERIA Statement

The CRITERIA statement is optional. It provides a mechanism for selecting or rejecting input accounting records during a CA JARS run. This is accomplished by coding appropriate values in one or both of two 22-character fields. Each field has the format kifs , where:

k

is a four-character keyword, either DATE or PART. DATE implies comparison against the SMF reader start date, or DOS run date. PART is used only with DOS input data and implies comparison against the DOS partition ID.

i

is a one-character code specifying record selection ( ), or record rejection (1) when the record meets the specified criteria.

f

is an eight-character field defining the lowest date, or the DOS Partition-ID which meets the criteria.

s

is an eight-character field defining the highest date which meets the criteria.

Both fields cannot contain the same keyword. If both fields are specified, and DOS data is present, Partition-ID is evaluated first, and then if not rejected, start date is evaluated. Date information is coded in the format mm/dd/yy or dd/mm/yy, depending on the contents of the date format indicator. See the PARMS Statement section later in this chapter for more information.

The CRITERIA statement selects or rejects dates according to the READER start date(s). If you want to report on jobs processed by Run Date, the GROUP and GROUPC statements are required.

The following is an example of a typical CRITERIA statement setup:

position   1         2         3         4                       8
  1........0.........0.........0.........0............        ...0
   CRITERIADATE 06/01/9806/30/98 PART1F1

This statement selects and rejects certain SMF and DOS job accounting records based on the defined criteria. Any input records containing a date other than June 1998, or processed under DOS in the Foreground 1 (F1) partition are rejected. All other records are selected.

If the CRITERIA statement is omitted, all input records are selected. When using the DATE keyword, the upper limiting criteria defaults to the lower limiting criteria value when omitted. The following is an example of a typical CRITERIA statement designed to select only one day (June 1, 1998) from all available input:

position   1         2         3         4                       8
  1........0.........0.........0.........0............        ...0
   CRITERIADATE 06/01/98

An extension to the record selection/rejection capability at the report level is available through the use of the grouping feature. This function is controlled by the GROUP

SMF Type 30 records are selected based on their SMF recording stamp.

Criteria Statement Layout:

Criteria Table:

* Dates must conform to Date Format Indicator on PARMS statement, either mm/dd/yy or dd/mm/yy.