Terminal control languageTCL commandsFf-resize command

f-resize command

The f-resize command in the DM account examines existing file modulos (VME only) for every file found in the file-of-files file, and recalculates a new recommended modulo for each file.

Syntax

f-resize {(options}

Parameter(s)

options a Resizes one account.
e Forces resize of empty files. As a default, empty files are ignored by the f-resize program.
p Directs output to the system printer via the spooler.
r{frame.size} Resizes files according to the frame size specified. If the frame size is not specified, the frame size of the current system is used.
u Specifies that no downsizing takes place.
x Removes the resize parameter from attribute 13 of the d-pointer.

Description

Files are given a new recommended size according to their statistical information and are given a new modulo based on a file 75% full. The files are not immediately resized. The recommended modulo is stored in the file’s file-defining item (D-pointer) in attribute 13.

If a period exists in attribute 13 of the file pointer, this data file is not resized.

To resize a file:

  1. Do a full save so all the file names are in the file-of-files file.

  2. Perform the f-resize.

  3. Do a full save of the system (which saves the recommended modulos).

  4. Do a restore of the desired account (or of the entire system), and the system refers to the recommended modulo in recreating the files, unless file reallocation is disabled during the restore.

Warning: This command can downsize files without notice. This is a concern in such cases as having files that are used perhaps only once a year for batch type processing, and remain empty until year-end processing is run. If the file is detected as empty, this process usually downsizes the file space to the minimum of one frame. To prevent this, a period can be placed in attribute 13 of the file pointer to inhibit resizing for this file. Also, files may not be resized if the Update Lock Code in their file-defining item is specified as Update Protected, and the user running f-resize does not have sufficient privileges. The error illegal a-correlative can be generated if this program is run on a file whose D-pointer has information in attribute 14 or in attribute 8, which is not a valid correlative.

See also

account-restore command, check-resizing command, D-pointer, f-resize command, f/realloc, File-defining items, File-of-files file (VME), istat command, kill-resizing command, list-resizing macro, mds file, Modulo, reallocation, resize command, resizing file, save command

Parent topic: F