CONFIGURE.FILE

Top  Previous  Next

 

The CONFIGURE.FILE command changes the configuration of a file.

 

 

Format

 

CONFIGURE.FILE {DICT} file.name  parameters

 

where

 

file.nameis the name of the file to be configured.

 

parametersare the new settings of the file configuration parameters. The following parameters may be specified:
DYNAMICConverts file to dynamic hashed type. Ignored if file is already dynamic.
DIRECTORYConverts file to directory type. Ignored if file is already a directory.
GROUP.SIZE nsets the group size in units of 1024 bytes. Values in the range 1 to 8 are permitted.
MINIMUM.MODULUS nsets the minimum modulus for the file. Any positive non-zero value may be used.
LARGE.RECORD bytessets the large record size in bytes.
SPLIT.LOAD pctsets the split load factor for the file.
MERGE.LOAD pctsets the merge load factor for the file.
DEFAULTresets all parameters to their default values.
NO.CASEconverts the file to use case insensitive record ids.
CASEconverts the file to use case sensitive record ids.
NO.RESIZEdisables file resizing.
RESIZEenables file resizing.
IMMEDIATEcauses an immediate file resize, if required.

 

Parameters which are not specified retain their existing values.

 

 

The CONFIGURE.FILE command adjusts the settings of one or more file parameters. Changes to the file type or group size result in immediate restructuring of the file and require exclusive access. Changes only affecting other dynamic file parameters will occur steadily as the file is updated unless the IMMEDIATE option is used.

 

Note that converting a file from case sensitive ids to case insensitive ids will result in loss of data if the file contains records that contain two or more record using keys with alternative casing of the same text.

 

The NO.RESIZE option disables the normal automatic split/merge operations that occur in dynamic files. The IMMEDIATE option can be used later to force the deferred splits/merges to be applied. See the description of dynamic files for more details on the use of this feature.

 

The resizing operations of the IMMEDIATE option are fully interruptable and can be performed while the file is in use.

 

 

Examples

 

CONFIGURE STOCK MINIMUM.MODULUS 200 SPLIT.LOAD 75

 

This command changes the minimum modulus and split load percentage of the STOCK file. The actual change will take effect as the file is updated by future access.

 

 

CONFIGURE STOCK DIRECTORY

 

This command changes the file to be a directory file.