CONFIGURE.FILE

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

Format

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

where

file.name

is the name of the file to be configured.

parameters

are the new settings of the file configuration parameters. The following parameters may be specified:

DYNAMIC

converts file to dynamic hashed type. Ignored if file is already dynamic.

DIRECTORY

converts file to directory type. Ignored if file is already a directory.

DEFAULT

resets all parameters to their default values.

CASE	converts the file to use case sensitive record ids.

ECS {"map.name"}

sets ECS mode on file

ENCODING name

sets encoding name for directory file

GROUP gid

sets the group ownership of the file using either a group number or a group name (not Windows)

GROUP.SIZE n

sets 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.

IMMEDIATE

causes an immediate file resize, if required, releasing unused primary subfile group space.

LARGE.RECORD bytes

sets the large record size in bytes.

MERGE.LOAD pct

sets the merge load factor for the file.

MINIMUM.MODULUS n

sets 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 n

sets the next sequential record id to be used by the CREATING.SEQKEY option of the WRITE statement.

NEXT QUERY

displays the next sequential record id to be used by the CREATING.SEQKEY option of the WRITE statement.

NO.CASE

converts the file to use case insensitive record ids.

NO.ECS

clears ECS mode on file.

NO.MAP

suppresses 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.RESIZE

disables file resizing.

RESIZE

enables file resizing.

SPLIT.LOAD pct

sets the split load factor for the file.

TO.LOWERCASE

set the file to force record ids to lowercase (directory files only).

TO.UPPERCASE

set the file to force record ids to uppercase (directory files only).

USER uid

sets the user ownership of the file using either a user number or a user name (not Windows)

VERSION vno

allows 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.

Deleting records from a dynamic hashed file merges groups to keep the file load value between the merge load and split load but does not release any free space back to the operating system as it is highly likely to be needed again soon. The free space can be forcibly released with

CONFIGURE.FILE filename RESIZE IMMEDIATE

Reconfiguring the VOC

The CONFIGURE.FILE command needs exclusive access to the file that is being reconfigured. Because the VOC file is permanently open, reconfiguration of this file can only be done from another account. Also, the file.name must reference an F-type VOC entry, not a Q-pointer. The process therefore becomes:

1.Logto another account (e.g. QMSYS)

2.Create an F-type VOC entry that points to the VOC of the original account

3.Do the CONFIGURE.FILE command

4.Delete the F-type VOC entry

5.Logto the original account

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 UTF-8

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.