Previous Topic: APTALLOC (Dynamic Allocation Command)Next Topic: Return Codes


Parameters

APTALLOC uses a subset of the TSO ALLOCATE command's parameters. With the exception of the DATASET and VOLREF parameters, the APTALLOC parameters use the same syntax and provide the same function as the parameters of the ALLOCATE command.

The following list shows the parameters supported by the APTALLOC command:

Avblock	Old
Blksize	Position
Catalog	Recfm
Cylinders	Release
Dataset	Retpd
Delete	Reuse
Expdt	Shr
File	Space
Keep	Tracks
Label	Uncatalog
Like	Unit
Lrecl	Using
Mod	Volume
New	Vseq

Parameters File, Dataset, and one of Old, Shr, New, or Mod are required; all others are optional.

The Dataset parameter is slightly different in syntax from the ALLOCATE command. Any Dataset parameter that can be specified by ALLOCATE can also be specified to APTALLOC, except an * (indicating allocation to a terminal) is not supported, and passwords are not used. Like the ALLOCATE command you can also concatenate data sets. In addition, a relative GDG generation can be specified in parentheses following the data set name. A minus generation is specified by entering M# preceding the generation, a positive generation is specified by entering a P# preceding the generation. For example, to allocate the -1 generation of GDG PAYROLL.BACKUP you would specify the parameter DATASET('PAYROLL.BACKUP(M#1)').

The VOLREF parameter is unique to APTALLOC. It can be used to specify a volume reference to an existing cataloged data set, and would typically be used when you want different data sets to reside on the same tape. It provides the same function as VOL=REF in JCL. The argument for the VOLREF parameter is a data set name.