Use the EXCLUDE command to eliminate specific log records,
after images, from the forward recovery processing, logstreamcopy
processing or journal print processing.
Format

.--------------------------------.
V |
>>-EXCLUDE----+-FILEID--(--id1,id2,...--)--+-+-----------------><
+-TERMID--(--id1,id2,...--)--+
'-TRANSID--(--id1,id2,...--)-'
Keywords
- FILEID(id1,id2,...)
- Specifies that CICS® VR must ignore any log records,
after images, with these file IDs when performing the forward recovery.
If more than one keyword is specified, for example, EXCLUDE FILEID(DD1),TERMID(TST1),
the log record must match both IDs specified for it to be excluded.
- id1,id2,...
- Specifies the file ID defined to CICS.
id1, id2, for example, can be 1-8 characters. Up to 99 IDs can be
specified for one FILEID. If more than one ID is specified on the
FILEID keyword, a log record only needs to match one of the specified
file IDs to be excluded.
- TERMID(id1,id2,...)
- Specifies that CICS VR must ignore any log records,
after images, with these terminal IDs when performing the forward
recovery. If more than one keyword is specified, for example, EXCLUDE
FILEID(DD1),TERMID(TST1), the log record must match both IDs specified
for it to be excluded.
- id1,id2,...
- Specifies the terminal ID defined to CICS.
id1, id2, for example, can be 1-4 characters. Up to 99 IDs can be
specified for one TERMID. If more than one ID is specified on the
TERMID keyword, a log record only needs to match one of the specified
terminal IDs to be excluded.
- TRANSID(id1,id2,...)
- Specifies that CICS VR must ignore any log records,
after images, with these transaction IDs when performing the forward
recovery. If more than one keyword is specified, for example, EXCLUDE
TRANSID(APQ1),TERMID(TST1), the log record must match both IDs specified
for it to be excluded.
- id1,id2,...
- Specifies the transaction ID defined to CICS.
id1, id2, for example, can be 1-4 characters. Up to 99 IDs can be
specified for one TRANSID. If more than one ID is specified on the
TRANSID keyword, a log record only needs to match one of the specified
transaction IDs to be excluded.
Usage Notes
Consider the
following when using the EXCLUDE command:
CICS VR cannot perform a selective
forward recovery using change accumulation data sets. Verify that
the APPLYCA keyword is not specified on the RECOVER command when the
EXCLUDE or INCLUDE command is specified in the same job step.
Examples
EXCLUDE FILEID(DD3) TRANSACTIONID(APQ4) |1|
EXCLUDE TERMINALID(TST2) |2|
Assume the above two EXCLUDE commands are specified
in one job step. The two EXCLUDE commands tell CICS VR
to:
|1| Exclude all records that have both a file id of DD3 and
transaction id of APQ4, or
|2| Exclude all records that have a terminal id of TST2.
INCLUDE FILEID(DD1,DD2) |3|
INCLUDE FILEID(DD3) TERMINALID(TST1) |4|
INCLUDE FILEID(DD4) TRANSACTIONID(APQ1,APQ2,APQ3) |5|
EXCLUDE FILEID(DD3) TRANSACTIONID(APQ4) |1|
EXCLUDE TERMINALID(TST2) |2|
Assume the above five commands are specified in one job
step. Since multiple EXCLUDE and INCLUDE commands are specified in
one step, CICS VR process es a log record against all
EXCLUDE commands before the log record is processed against all INCLUDE
commands.
|1| Exclude all records that have both a file id of DD3 and
transaction id of APQ4, or
|2| Exclude all records that have a terminal id of TST2.
So far, this example is exactly like the previous example.
When the log record has been processed using the exclude criteria,
it is processed using the include criteria. If the log record was
not excluded by the EXCLUDE command:
|3| Include all records that have a file id of DD1
or DD2, or
|4| Include all records that have a file id of DD3
and terminal id of TST1, or
|5| Include all records that have a fileid of DD4 and
transaction id of APQ1, APQ2, or APQ3
Synonyms
The EXCLUDE synonyms table provides
the EXCLUDE commands or keywords along with acceptable synonyms that
can be used in place of the commands or keywords:
Table 1. EXCLUDE synonymsCommand or keyword |
Synonyms |
FILEID |
DD, DDNAME |
TERMID |
TERMINALID |
TRANSID |
TRANSACTIONID |