| export (D3/Unix) | Index Level | f.modulo |
| Syntax | f-resize {(options} |
| Category | TCL |
| Type | Verb |
| Description |
Examines existing file modulos for every file found in the "file-of-files" file, and recalculates a new "recommended" modulo for each file.
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 dot "." exists in attribute 13 of the file-pointer, this data file will not be resized. The complete file resizing process is to: a) Do a full "save" so all the filenames are in the "file-of-files" file. b) Perform the f-resize. c) Do a full "save" of the system (which will save the recommended modulos). d) Do a restore of the desired account (or of the entire system), and the system will refer to the recommended modulo in re-creating the files, unless "file reallocation" is disabled during the restore. |
| Options |
a Resize one account
e Force 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} ("r", followed by a frame size) Resizes files according to the frame size specified. If frame.size is not specified, the frame size of the current system is used. u Specifies that no downsizing will take place. |
| See Also | files resize f/realloc reallocation file-of-files account-restore save file-defining item istat |
| Example | |
| Warnings |
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 will usually downsize the file space to the minimum of one frame. To prevent this, a dot "." 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. |
| Compatibility | D3 7.0 AP |
| export (D3/Unix) | Index Level | f.modulo |