CONFIGURE.FILE

CONFIGURE.FILE

Top  Previous  Next

 

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

 

 

Format

 

CONFIGURE.FILE {DICT} file.name  parameters {REPORTING}

 

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.
DEFAULTresets all parameters to their default values.
CASEconverts the file to use case sensitive record ids.
ECS {"map.name"}sets ECS mode on file
ENCODING namesets encoding name for directory file        
GROUP gidsets the group ownership of the file using either a group number or a group name (not Windows)
GROUP.SIZE nsets the group size in units of 1024 bytes. Values in the range 1 to 8 are permitted but for best performance should be a power of two.
IMMEDIATEcauses an immediate file resize, if required, releasing unused primary subfile group space.
LARGE.RECORD bytessets the large record size in bytes.
MERGE.LOAD pctsets the merge load factor for the file.
MINIMUM.MODULUS nsets the minimum modulus for the file. Any positive non-zero value may be used.
MODE ddd{:sss}sets the file permissions modes where ddd is desired mode settings for the directory that represents the file. This must be a three digit octal value as used in the Linux chmod command. The optional sss component is the mode settings to be applied to the items in this directory. If sss is omitted, the ddd value is used. (not Windows)
NEXT nsets the next sequential record id to be used by the CREATING.SEQKEY option of the WRITE statement.
NEXT QUERYdisplays the next sequential record id to be used by the CREATING.SEQKEY option of the WRITE statement.
NO.CASEconverts the file to use case insensitive record ids.
NO.ECSclears ECS mode on file.
NO.MAPsuppresses mapping of characters in directory file record names that are normally restricted. This option affects only the data portion of the file and is therefore invalid when the DICT keyword is present. Note that when this option is used the application is responsible for ensuring that record names comply with operating system file name rules.  See directory files for more information.
NO.RESIZEdisables file resizing.
RESIZEenables file resizing.
SPLIT.LOAD pctsets the split load factor for the file.
USER uidsets the user ownership of the file using either a user number or a user name (not Windows)
VERSION vnoallows configuration of the file for compatibility with versions of QM prior to release 2.2-0.

 

 

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. The REPORTING option will show progress. 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 have ids 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 interruptible and can be performed while the file is in use.

 

 

Examples

 

CONFIGURE.FILE 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.FILE STOCK DIRECTORY

 

This command changes the file to be a directory file.

 

 

CONFIGURE.FILE STOCK DIRECTORY ENCODING UTF8

 

This is similar to the previous example but sets the file to use UTF-8 encoding.

 

 

CONFIGURE.FILE STOCK DYNAMIC ECS

 

This command converts the STOCK file to an ECS mode dynamic file.