File Utility Programming (FUP) Reference Manual

FUP Commands

File Utility Program (FUP) Reference Manual—523323-015

2-17

ALTER Parameters for Partitioned Files

These alter-option parameters are available for partitioned files:

PART ( sec-partition-num , [\node.]$volume

[ , pri-extent-size [ , sec-extent-size ] ] )

PART

alters secondary partition specifications for partitioned files. You can specify extent

sizes if you are adding a new partition or if you are altering an existing partition of a

key-sequenced file. You must specify each secondary partition separately.

ALTER command with PART option: when the volume-name of the secondary

partition is altered to new-volume, then the file must be created manually in the

new location.

If the sec-partition-num already exists, for all file types, you can change

volume.

You can redefine the extent sizes for key-sequenced files only. If the partition

contains data, you must perform additional operations on the partition to complete

the extent-size change.

You can add a new, additional partition to any files that are not key sequenced. You

cannot add partitions to key-sequenced files.

sec-partition-num , \node.$volume

names the volume where this secondary partition is to reside. Specify

sec-partition-num as an integer from 1 through 15 to designate the

secondary partition. For an enhanced key-sequenced file, specify sec-

partition-num as an integer from 1 through 63 to designate the secondary

partition. For a key-sequenced file with increased limits, specify sec-

partition-num as an integer from 1 through 127 to designate the secondary

partition.

Specify node and volume as the names of the node and volume to contain the

partition. The filename and the subvolume of the primary partition are specified

when the file is created.

Although FUP lets you specify any number ranging from 1 through 15 for

sec-partition-num, FUP changes it to a standard DP2 number that starts

at zero when the file is created.

pri-extent-size , sec-extent-size

alters the primary and secondary extent sizes. The default value for

pri-extent-size is one page (2,048 bytes). If you specify a value of zero or

Note. Example 2-6 on page 2-105 shows how the DP2 number is listed in the INFO

DETAIL command.