Product Documentation

c-treeRTG COBOL Edition User's Guide

Previous Topic

Next Topic

<memoryfile>

The memoryfile option indicates whether to create files in memory rather than on disk. This feature is indicated for temporary files. This feature is off by default.

The synonym <memfile> can be used for the <memoryfile> option.

Accepted Values

Value

Effect

Synonyms

yes

Create file as memory file.

y, true, on, 1

no

Create file as disk file. This is the default value.

n, false, off, 0

Attributes

Value

Effect

Synonyms

persist

Allows the memory file to be available for multiple sessions to multiple applications while the c-treeRTG server is active (unless explicitly deleted). See <memoryfile persist> Attribute below.

 

c-treeRTG memory files default to a maximum size of 4Gb. The KEEPOPEN attribute is automatically applied.

Note: The bulkaddition option (available in c-treeRTG COBOL only) should not be used with the memoryfile option (because doing so would cause the indexes to be created on disk).

Note: The memoryfile option and the <transaction logging="yes"> option are mutually exclusive.

<memoryfile persist> Attribute

Once created, memory files are available until they are either removed or until the c-treeRTG server is shut down. This allows the memory file to be available for multiple sessions to multiple applications while the c-treeRTG server is active.

Typically the deletion of the memory file is performed by the application that created it as it has knowledge of its existence. However, if the application disconnects from the c-treeRTG server in a non-controlled way (i.e., crash), the memory file remains available to other applications which might not know of its existence and therefore will not be able to delete it. Overall, this may cause an accumulation of orphan memory files and an exhaustion of memory.

The <memoryfile persist> configuration attribute specifies if the memory file being created will be available while the c-treeRTG server is active or if it is automatically removed when the application that created it disconnects from the c-treeRTG server (either in a controlled way or as a result of a crash).

<memoryfile persist="yes"> - Once created, the memory file is available until the c-treeRTG server is shut down or until any application manually deletes it.

<memoryfile persist="no"> - The memory file is available until the application that created it disconnects from the c-treeRTG server.

Example

<memoryfile>yes</memoryfile>

See Also

TOCIndex