VOLSER_FIRST

The VOLSER_FIRST keyword specifies a volume serial number of the first volume of the data set.

Syntax

Read syntax diagramSkip visual syntax diagramVOLSER_FIRST=(,volseruser_var$NULL,op)

VOLSER_FIRST=(volser|user_var|$NULL, volser|user_var|$NULL,…,op)

Where:

volser is the 1 - 6 character volume serial number. Wildcard characters are permitted.

Notes:
  1. For non-SMS non-VSAM data sets, the volume serial number must be specified in the JCL (or dynamic allocation) for the VOLSER_FIRST selection criterion to match for the PRIM_REDUCE function on the first volume.
  2. For non-SMS VSAM data sets, the first volume serial number in the DEFINE for the data set (in the index or data component) is used for matching purposes for the PRIM_REDUCE function on the first volume.
  3. For SMS VSAM and non-VSAM data sets, because the volume serial number is not yet chosen by the system at PRIM_REDUCE time, if VOLSER_FIRST is specified in the selection criteria, the rule definition statement is considered not to match for the PRIM_REDUCE function on the first volume.

Default

None.

Environments

ALLOCATE, EXTEND, UNALLOCATE, STOW, and CATCHECK.

JCL equivalent

DD01 DD VOL=SER=BIG001

IDCAMS equivalent

DEFINE CLUSTER(VOLUMES(BIG001 ...) ...)

Examples

VOLSER_FIRST=SMS001
VOLSER_FIRST=&VNUMS
VOLSER_FIRST=(NS1600,NS1700,NS1800,NE)