Purpose
Defines optional selection criteria
for the journal records to be unloaded or loaded by the preceding
UNLOAD or LOAD batch command.
If you omit CRITERIASET, all
journal records are selected.
You can specify multiple
CRITERIASET commands, each defining one or more conditions. Conditions
within a CRITERIASET are implicitly combined by a logical AND operator.
Multiple CRITERIASET commands are implicitly combined by a logical
OR operator.
Figure 1. Defining
optional selection criteria for unloading or loading journal records
Format

.-,----------------------.
V |
>>-CRITERIASET----COND=(-| Condition |-)-+---------------------><

Condition
|--+---API_COMMAND----+-EQ-+--API_command----------+------------|
| '-NE-' |
+-+-CONFIGURATION-+--+-EQ-+--+-masked_value---+-+
| +-CONTEXT-------+ '-NE-' '-specific_value-' |
| '-CSD-----------' |
'-CREATETIME--+-EQ-+--+-yyyy/mm/dd------+-------'
+-NE-+ '-TODAY-+-------+-'
+-GT-+ '--days-'
+-LT-+
+-GE-+
'-LE-'
You must specify at least
one COND parameter in each CRITERIASET. Each COND parameter must appear
on a separate input line, except for the first, which may appear on
the same line as CRITERIASET. To specify comparison operators, you
can use 2-letter codes or signs:
- EQ or =
- Equal to
- GE or >=
- Greater than or equal to
- GT or >
- Greater than
- LE or <=
- Less than or equal to
- LT or <
- Less than
- NE or ¬= or <>
- Not equal to
If you use a 2-letter code, such as EQ, then you must
insert one or more blanks before and after the code. If you use a
sign, such as =, then do not insert blanks before or after the sign.
All parameter values are case-insensitive and are converted to uppercase
prior to processing.
- API_COMMAND
- Specifies an API command name, such as CREATE or MIGRATE, with
no masking allowed. For a list of command names, see Summary of API commands.
- CONFIGURATION, CONTEXT, or CSD
- The CSD value is the fully qualified data set name of a CSD file
without enclosing quotes. The CONFIGURATION value is the name of a CICS® configuration, and the CONTEXT
value is the name of a CICSPlex® SM
context.
You can use either a specific value or a masked value.
The masked value can be either:
- CREATETIME
- Specifies the date that the journal record was created in the
journal. This value is not affected by unloading or loading. You can
specify this date as either:
- A 4-digit year, 2-digit month, and 2-digit day, separated by either
forward slashes (/) or hyphens (-). For example, 2005/04/29 represents
29 April 2005.
or
- The keyword TODAY optionally followed by a hyphen (minus sign)
and a number of days, 0–9999.
For example, CREATETIME GE TODAY-1 selects journal
records created today (the day that you run the journal housekeeping
program) and yesterday. TODAY and TODAY-0 are equivalent: they select
journal records created today.