CRITERIASET (for unloading or loading journal records)

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

Read syntax diagramSkip visual syntax diagram
                .-,----------------------.   
                V                        |   
>>-CRITERIASET----COND=(-| Condition |-)-+---------------------><

Read syntax diagramSkip visual syntax diagram
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:

  • A value with a single trailing asterisk (*), to match all values with those leading characters

    or

  • A value with one or more plus signs (+) to match values with any character in those positions

    You cannot use a combination of * and + masking characters in the same value.

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, 09999. 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.