Tuning parameters
These parameters are provided for tuning purposes, but usually you can omit these and let the TS server use the default values.
- ELEMENTRATIO={1|number}
- An MVS coupling facility resource management (CFRM) parameter
that specifies the element part of the entry-to-element ratio when
the structure is first allocated. This value determines the proportion
of the structure space that is initially set aside for data elements.
The ideal value for the entry-to-element ratio is the average size of data for each entry divided by the element size. However, the server automatically adjusts the ratio according to the actual entry and element usage.
This parameter is valid only at server initialization, and is used only when the structure is first allocated. The valid range is from 1 to 255.
You can abbreviate this keyword to ELEMRATIO.
For further information about this parameter in the coupling facility, see z/OS MVS Programming: Sysplex Services Guide.
- ELEMENTSIZE={256|number}
- An MVS CFRM parameter that specifies the element size for structure
space, which must be a power of 2. This parameter is
used only for coupling facility log streams. The valid range
is 256 to 4096. For current coupling facility implementations, there
is no reason to change this parameter from the default value of 256.
This parameter is valid only at server initialization and is used only when the structure is first allocated.
You can abbreviate this keyword to ELEMSIZE.
- ENTRYRATIO={1|number}
- An MVS CFRM parameter that specifies the entry part of the entry-to-element
ratio when the structure is first allocated. This value determines
the proportion of structure space that is initially set aside for
list entry controls.
It is not essential to specify this parameter because the server automatically adjusts the ratio, based on actual usage, to improve space utilization if necessary.
This parameter is valid only at server initialization and is used only when the structure is first allocated. The valid range is from 1 to 255.
For further information about this parameter in the coupling facility, see z/OS MVS Programming: Sysplex Services Guide.
- LASTUSEDINTERVAL={00:10|hh:mm}
- A CICS parameter that specifies how often the last used time for
large queues is updated.
For small queues, the last used time is updated on every reference. For large queues, updating the last used time requires an extra coupling facility access, so this update occurs only if the queue has not previously been accessed in this interval of the current time. Therefore, the last used time interval returned by an INQUIRE command can be greater than the true value by an amount up to the value of this parameter. The last used time is used mainly to determine whether the queue is obsolete, so a suitable value for the LASTUSEDINTERVAL parameter is normally a few minutes.
See INQUIRE TSQUEUE / TSQNAME.
The valid range is from 00:00 to 24:00. This value can also be specified in seconds.
You can abbreviate this keyword to LASTUSEDINT.
- SMALLQUEUEITEMS={9999|number}
- A CICS parameter that specifies the maximum number of items that
can be stored in the small queue format in the queue index entry data
area. This parameter can force a queue to be converted to the large
queue format if it has a large number of small items. It can be more
efficient to write the items separately than to rewrite the whole
small queue data area each time.
The valid range is from 1 to 32767.
- SMALLQUEUESIZE={32K|number}
- A CICS parameter that specifies the maximum data size for a small
queue, including the two-byte length prefix on each data item. If
a queue exceeds the maximum size when a second or subsequent item
is written to it, the queue is converted to the large queue format.
This parameter can force queues to be converted to the large queue format at a smaller size than 32K. This is to prevent large amounts of data being written to the small queue format. On systems where asynchronous coupling facility processing causes contention for hardware resources, using this parameter can improve performance. However, on most systems, it is more efficient to defer conversion until the maximum size of 32K is reached.
The valid range is from 4096 to 32768.