April 28, 2004 � Insufficient Memory Configuration: GMHEAP
Several issues have been reported to InterSystems� Worldwide Response Center that are the result of under-configuration of �Generic Memory Heap� (GMHEAP). GMHEAP is a Cache' Configuration Parameter that can be modified in Configuration Manager -> Advanced -> Memory -> Generic Memory Heap.
Several enhancements in Cache' 4.1 and Cache' 5 result in increased use of GMHEAP compared to earlier versions. As a result, issues can be encountered after upgrading to Cache' 5.0.x versions and to a lesser extent after upgrading to Cache' 4.1.x versions. The issues can occur on any supported operating system or hardware.
Problems related to insufficient GMHEAP include but are not limited to:
�Inability to support the licensed number of users
�Lock Table not large enough or can�t be expanded
�Cache' failing to start
�Inability to compile a large number of object classes at once
�Inability to have a desired number of datasets, namespaces,
routine mappings, subscript level mappings(SLM), or locale tablesInterSystems has developed the utility ^GMHEAPREQ that will provide a minimum recommended value based on your active configuration (.cpf) file. The minimum recommended value produced is for Cache' 5.0.x requirements and since Cache' 4.1.x requirements are slightly less the value also serves as a minimum for 4.1.x. Regardless of the Cache' version the utility is run for (it is compatible with Cache' 3, 4 & 5) it will produce a minimum value for Cache' 5.0.x.
This utility only reports a minimum recommended value. It does not change any parameter settings within your configuration.
We recommend that this utility be run prior to upgrading to Cache 4.1.x or 5.0.x versions and GMHEAP be increased to the minimum recommended value.
The utility is available on our FTP server. The file name is gmheapreq.rsa.
ftp://ftp.intersystems.com/pub/cache/patches/gmheapreq.rsa
To install, please use %RI from within Cache' programmer mode. It can be installed into any namespace. To run, issue D ^GMHEAPREQ and it will display the recommended value. For example:
USER>D ^GMHEAPREQ
This utility will examine you current/active configuration file, and will provide a minimum recommended value.
*** Using configuration file name: $1$DKA300:[CACHESYS.NEELIX.C50]CACHE.CPF
Current GMHEAP size = 2816 KB Recommended minimum GMHEAP size: 3199 KB
If you have any questions regarding this, please contact the InterSystems Worldwide Response Center at Worldwide Response Center at [EMAIL PROTECTED]
