STACK_NAME

Use the STACK_NAME keyword to specify a name for a group of output data sets. The data sets in a group are written serially, as multiple files on one or more tape volumes.

When the STACK_NAME keyword is specified, the following rules apply:

The DDNAME keyword is not allowed.
The DSNAME keyword is required.
The UNIT keyword is required, and must refer to a tape device.

When a new (unique) value for the STACK_NAME keyword is encountered, the product constructs a data set stack registry. The values of the following keywords from the same subcommand are saved as part of the stack registry, and apply to the allocation of the stack group:

EXPTD
RETPD
UNIT
VOLCNT
VOLSER

The values of these keywords specified on any subsequent usage of the same stack name have no effect. All other keywords on the subcommand refer to the individual output data set.

When the first output data set written to the stack group is opened, the product will dynamically allocate the data set using the registered stack parameters. This data set is written as file sequence number 1. Subsequent output data sets use the same allocation, and are written as file sequence number 2, 3, etc.

Use

STACK_NAME is an optional keyword for the IC subcommand.

Related keywords

DDNAME
DISP
DSNAME
EXPT
RETPD
UNIT
VOLCNT
VOLSER

Syntax

STACK_NAME=parameter

Parameters

Specify a 1-character to 8-character name.

Default

None

Alias