
Caché Parameter File Reference
routines



Server:docs1 
Instance:LATEST 
User:UnknownUser 


Size of shared memory for caching routine buffers.
Synopsis
[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 nonzero 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.
Examples
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 36 MB. The maximum value depends on how much shared memory is allocated for global buffers and other uses. The total shared memory size on a 64–bit system 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