Guardian User's Guide
Using FUP for Advanced File Management
Guardian User’s Guide—425266-001
8-21
Modifying Partitioned Files
The ALTER command with the PART option changes the file label of the primary 
partition so that it includes the new extent size of the secondary partition in $VOL2. 
Next, the RENAME command with the PARTONLY option gives the secondary 
partition a temporary name; this command preserves the data in this partition. 
The SET LIKE command recreates the file-creation parameters of the original secondary 
partition. Then the SET EXT command changes the extent size in the current FUP 
parameters. The CREATE command recreates the secondary partition with a larger 
extent size. 
The DUP command with the OLD and PARTONLY options copies the data from the 
temporary file to the newly created partition with the DUP command. Finally, the 
PURGE command deletes the temporary file. 
Although you can RENAME a file that is open for read-write or write-only access, you 
cannot copy such a file with the DUPLICATE command. Thus, you must ensure that the 
partition is not being written to if the preceding sequence of operations is to succeed. 
(File-access modes are discussed in the ENSCRIBE Programmer’s Guide.)
Adding Partitions
You can add partitions to relative and entry-sequenced files that do not already have 
them, but not to key-sequenced files. This example uses a nonpartitioned relative file 
named $VOL1.SVOL.RELFILE. To add a partition to this file, enter: 
The SET LIKE command sets the file-creation parameters to those of the original file, 
$VOL1.SVOL.RELFILE. The SET command with the PARTONLY option specifies 
that the file to be created is a secondary partition. The CREATE command creates a new 
partition on volume $VOL2. 
The SHOW command with the EXT option displays the extent sizes of the original file. 
The ALTER command with the RELFILE option changes the file label of 
$VOL1.SVOL.RELFILE to show that it is the primary partition of a partitioned file with 
a secondary partition in the volume $VOL2. 
This command adds a third partition on the volume $VOL3:  
-VOLUME $VOL1.SVOL
-SET LIKE RELFILE
-SET PARTONLY
-CREATE $VOL2.RELFILE
-SHOW EXT
 EXT ( 100 PAGES, 10 PAGES )
-ALTER RELFILE, PART ( 1, $VOL2 , 100, 10 ) 
-CREATE $VOL3.RELFILE
-ALTER RELFILE, PART ( 2, $VOL3, 100, 10 ) 










