File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-7
ALLOCATE Examples
For nonpartitioned files and partitioned files that are not key sequenced, it is the
total number of extents to be allocated to the file.
An example is trying to allocate 12 additional extents to a nonpartitioned file that
already has four extents allocated and trying to allocate 12 additional extents for
the primary partition of a key-sequenced file that already has four extents
allocated. Although you need to specify 16 for num-extents in both instances,
you must include the PARTONLY option with the key-sequenced file specification
so that the 12 extents are allocated only to the primary partition.

The ALLOCATE command cannot handle SQL files that are not SQL object files.
You must use the SQLCI CREATE and SQLCI ALTER commands.

To allocate volume directory extents for fileset-list, you must use this file
name syntax:
$volume.SYS00.DIRECTRY

For an enhanced key-sequenced file, the ALLOCATE command assigns specified
extents for secondary partitions, but the extents of the primary partition remain
unchanged.

ALLOCATE command with PARTONLY option and fileset-list as primary
partition of an enhanced key-sequenced file is executed, but the extents of the
primary partition remain unchanged.

ALLOCATE command allocates the specified extents for all partitions of a key-
sequenced file with increased limits (LKS2 file with increased limits).

ALLOCATE command allocates the specified extents for the secondary partitions
of a key-sequenced file with increased limits (EKS file with increased limits).
However, the extents of the primary partition remains unchanged.

ALLOCATE command when executed with fileset-list as primary partition of
a key-sequenced file with increased limits (EKS file with increased limits) and
PARTONLY option, does not change the extents of primary partition.
ALLOCATE Examples
To create an unstructured file and allocate 10 file extents for it:
1. Create an unstructured file when the default file-creation attributes are enabled:
-CREATE YRFILE
2. Use the FUP INFO, DETAIL command to see that no file extents are initially
allocated for the file:
-INFO YRFILE, DETAIL
$BOOKS1.COMLANG.YRFILE 14 April 2001, 9:00
Note. You can allocate more than 16 extents on the last partition only when you use the
PARTONLY option with the ALLOCATE command.