CA-GSS Statements and Commands › Code Batch Maintenance Commands › ALLOC_DSN

ALLOC_DSN

Use the ALLOC_DSN command to create a sequential file or a new PDS.

Syntax

Use this format for the ALLOC_DSN command:

ALLOC_DSN DSNAME dsname UNIT unit [VOLUME volume] [DDNAME ddname]
 
  SPACE {blk|CYL|TRK},prim[,sec[,dir] [RECFM recfm] [LRECL lrecl]
 
    [BLKSIZE blksize]

Parameters

The ALLOC_DSN command takes these parameters:

dsname

Name of the data set to be allocated. This parameter is required.

volume

Unit address or symbolic name of the device where the data set is to be allocated. This parameter is required.

ddname

DDname assigned to the newly allocated data set. If specified, this value may be used by the SRVMAINT program to direct output to the new data set.

SPACE

The values that follow this required parameter determine how much space is reserved for the data set.

blk

Indicates that the values specified for prim and sec are for data blocks of the size blk.

CYL

Indicates that the values specified for prim and sec are in cylinder increments.

TRK

Indicates that the values specified for prim and sec are in track increments.

prim

Amount of space initially reserved for the data set.

sec

If specified and not zero, specifies a secondary amount of space that is allocated whenever the data set is full.

dir

If specified and not zero, specifies the number of 256-byte blocks reserved for a PDS directory. A non-zero value for dir allocates a PDS.

recfm

Record format to be assigned to the data set. Permitted values are: F, FA, FM, FB, FBA, FBM, V, VA, VM, VB, VBA, VBM, and U. The default is FB.

lrecl

Logical record length assigned to the data set. The default is: 80 for RECFM=F; 255 for RECFM=V; 0 for RECFM=U

blksize

Block size assigned to the data set. The default is lrecl X 10.

Usage Note

There are many additional attributes that you may assign to a data set. If you require any of these, you should use a JCL allocation strategy.