NOTCAT2_CHECK

The NOTCAT2_CHECK keyword specifies when the detection of the duplicate data set name occurs.

Syntax

Read syntax diagramSkip visual syntax diagramNOTCAT2_CHECK=STEPTERM ALLOCATION

NOTCAT2_CHECK=ALLOCATION|STEPTERM

Operands

Specify one of the following operands:

ALLOCATION
The detection of the duplicate data set name occurs during the initial allocation of the data set before the step is performed.
Note: The ALLOCATION option is available for SMS and non-SMS-managed data sets.
STEPTERM
The detection of the duplicate data set name occurs at step termination (during data set disposition processing, and after detection of the IEF287I NOT CATLGD 2 message for the data set).
Notes:
  1. The STEPTERM option is ignored for SMS-managed data sets because SMS detects duplicate data set names during allocation. SMS issues the IGD17101I message upon detection of the duplicate data set name, which causes the current and subsequent steps to be flushed.
  2. If you use NOTCAT2 at step termination time, IEF253I and IGD17001I duplicate data set name messages are visible if the new data set is allocated to the same volser as the old data set. This situation occurs because you cannot have two data sets with the same name in a single VTOC. Therefore, the step never reaches the step termination phase because it fails during allocation. (This situation should occur only if you use an explicit volser for a non SMS-managed data set. If you allow the system choose a volser, it attempts to choose a volume that does not already have the data set on it.)

Default

STEPTERM

Environments

CATCHECK

Related keywords

NOTCAT2, NOTCAT2_DYNAL, NOTCAT2_QUALIFIER, NOTCAT2_QUALIFIER_POSITION, and NOTCAT2_SUFFIX.

Example

In the following example, the detection of the duplicate data set name occurs during the initial allocation of the data set before the step is performed:

NOTCAT2_CHECK=ALLOCATION