Space announcement This space now contains the documentation for all the following components:
  • CHANGE ACCUMULATION PLUS
  • IMAGE COPY PLUS
  • RECOVERY MANAGER for IMS
  • RECOVERY PLUS for IMS
We are no longer updating the individual documentation spaces for these components.

EXCLUDE keyword


Use the EXCLUDE keyword to bypass recovery processing for one or more data set groups (DSGs) that have been selected for processing because they are included in the group that is identified by the immediately preceding GROUP statement.

Related topics


Important

The EXCLUDE keyword provides a technique for excluding a small number of DSGs in special cases and is not intended to be a general technique for selectively tailoring the list of members in the group. If you find that you need to exclude more than a few DSGs, you should modify the group or build a new one that more exactly meets the needs of the situation.

You can specify the EXCLUDE(Y) keyword on a REC or AREC control statement to bypass processing for the DSG that is identified with the DBD and DDN keywords on the REC or AREC command. The Recovery utility bypasses processing for the specified DSG if it is included in the group that is identified with the GROUP statement that immediately precedes the REC or AREC command. The GROUP statement can identify a change accumulation group (by using the CAGRP keyword), a database data set group (by using the DBDSGRP keyword), or a Recovery Manager (RMGR) group (by using the IRMGRP keyword). RMGR groups are managed with the Recovery Extensions feature.

The EXCLUDE keyword operates only on the specific DBD and DDN for which the REC or AREC statement is overriding the GROUP statement. No related database data set (such as an index data set or indirect list data set) is implicitly excluded. You must specify a REC or AREC statement to exclude a related data set if it is explicitly defined as a member of the group. If you do not exclude a related data set, it is processed according to the applicable values of the FUNC, BLDINDEX, or BLDILDS keyword.

For example, if you exclude an index but you do not exclude its target database and BLDINDEX(Y) is specified, the excluded index is rebuilt. To avoid unintended results, exclude a target database and all related indexes.

The EXCLUDE keyword can be used with the TYPERUN(SIMULATE) keyword and with the Automatic Restart feature. Remember that you cannot change control statements between a recovery job step failure and an automatic restart.

Uses

EXCLUDE is optional on the following control statements:

  • AREC
  • REC

Related keywords

Refer also to the following keywords:

  • CAGRP
  • DBD
  • DBDSG
  • DDN
  • IRMGRP

Syntax

EXCLUDE(value) or EX(value)

Values

Specify one of the following values:

  • N —Perform processing for the indicated DSG as normal.
  • Y —Bypass processing for the indicated DSG.

Default

EXCLUDE(N)

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*