GS_INIT_FILE_MEMORY_LIMIT - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000

Type

Long

Description

Note: This property only applies to 64-bit applications.

When GeoStan is initialized, it will memory-map as many data files into memory as the GS_INIT_FILE_MEMORY_LIMIT allows. The default value of 16 GB is sufficient for memory-mapping two streets and two points data sets. Memory mapping your data files can provide a 10-15% performance improvement compared to mapping none of them. However, if your environment has memory constraints, you can set the GS_INIT_FILE_MEMORY_LIMIT to the number of megabytes you can afford.

This initialization property can only be set once per GeoStan executable process. If you attempt to set this property again (i.e., on a separate thread), the request is ignored.

If all of the data files cannot be memory-mapped in the space provided, the status property GS_STATUS_FILE_MEM_SYS_EXCDD is set to true. To see how much virtual memory is being used for memory-mapping data files, query the status property GS_STATUS_MEMORY_USED.

Values

0 - 256000 (megabytes)

Default value

16000 (megabytes)

Relation to deprecated feature

GsSetFileMemoryLimit