Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see Why Migrate to InterSystems IRIS?


Allocates shared memory to the routine cache to create routine buffers.


[config]    routines=n      or  routines=n1, n2, n3, n4, n5, n6


You can specify the amount of memory to allocate for caching routine buffers in two ways — either specifying a single value or specifying values for all six buffer sizes.

You can specify only a single value, n, for the total size, in megabytes, of shared memory that Caché allocates for routine buffers. Caché divides this memory into the various buffer sizes for optimum performance.

Or you can specify the amount of memory to allocate for each routine buffer size. If you use this format, you must specify all 6 values (some of them can be 0). If fewer than 6 are given, Caché reverts to the first format using n=n1.

  • n1 is the number of MB for 2 KB routine buffers

  • n2 is the number of MB for 4 KB routine buffers

  • n3 is the number of MB for 8 KB routine buffers

  • n4 is the number of MB for 16 KB routine buffers

  • n5 is the number of MB for 32 KB routine buffers

  • n6 is the number of MB for 64 KB routine buffers

If a non-zero memory size is specified for any buffer size, the minimum number of buffers allocated for that size is 430. Therefore, the actual memory allocated for buffers of a given size could be bigger than configured. Because the Caché system requires 64K buffers, at least the minimum number of 64K buffers is always allocated even if 0 is specified.

The total number of allocated buffers is limited to 65528. If the number of buffers allocated exceeds this number, it is reduced to the maximum. The total amount of shared memory space on a 64-bit system cannot exceed 1023 MB.



Allocate 256 MB for routine buffers, divided into various sizes by Caché's internal formula.


To allocate a minimum number of buffers, enter a single value of 0.

Range of Values

The default is 0, but Caché allocates a minimum amount of buffer space according to an internal formula. Minimum number of routine buffers for each size is 430 (if a smaller number is specified, the system adjusts up to 430). Total number of buffers cannot exceed 65528. Total amount of shared memory space on a 64–bit system cannot exceed 1023 MB.

For routines=n, Caché allocates a minimum of 35 MB. The maximum value depends on how much shared memory is allocated for global buffers and other uses. The total shared memory size cannot exceed 1023 MB. For routines=n1,n2,n3,n4,n5,n6, values other than 0 are subject to a minimum value of 300. The total number of buffers cannot exceed 65528.

Management Portal

On the page System Administration > Configuration > System Configuration > Memory and Startup, select the option to Configure Memory Settings Manually. In the Memory Allocated for Routine Cache (MB) field, enter a number of megabytes. See Memory and Startup Settings in the “Configuring Caché” chapter of the Caché System Administration Guide for more information about allocating memory for routine buffers using the management portal.