Similar to cache priming configuration options of PRIME_CACHE, PRIME_CACHE_BY_KEY, and PRIME_INDEX, except that those options take effect only when an application opens the files.
For advanced and flexible configuration, options are specified in JSON format with the format shown here:
subsystem cache prime_cache_at_startup {
"allow_connections": true,
"thread_count": 8,
"prime_cache": [
{"file": "filename1.dat", "size": "1 gb"},
{"file": "filename2.dat"}
],
"prime_cache_by_key": [
{"file": "filename1.dat", "size" : "1 gb", "index": 1, "reverse": false},
{"file": "filename2.dat", "size" : "1 gb", "index": 1}
],
"prime_index": [
{"file": "filename1.dat", "size": "1 gb", "index": 1},
{"file": "filename2.dat", "size": "1 gb", "index": 1}
]
}
Description of supported attributes:
Note: In addition to the specified size limits, the data and index cache sizes limit the cache priming as follows:
prime_cache and prime_cache_by_key stop if the data cache becomes full.
prime_index stops if the index cache becomes full.
The SUBSYSTEM CACHE PRIME_CACHE_AT_STARTUP configuration option can be specified in a server settings file. If it is used in a settings file, the option cannot also be used in the configuration file- in that case, the subsystem is considered blocked and the configuration file options are ignored. Likewise, if this subsystem is specified more than once in the configuration file, only the first occurrence of the subsystem block takes effect. The other occurrences are blocked.
The subsystem can be commented out by placing a semicolon at the start of the SUBSYSTEM line. However, individual lines within the subsystem block cannot be commented out. Attempting to do so will cause a syntax error halting server startup.
By default, the server logs information about the files that it loads into cache to CTSTATUS.FCS. The configuration option CTSTATUS_MASK PRIME_CACHE_AT_STARTUP can be used to disable this logging.
Default: No priming at startup,
See Also
PRIME_INDEX (PRIME_INDEX, Prime Index)