Primary parameters
These parameters are usually specified for all servers:
- POOLNAME=pool_name
- specifies the name, of 1 to 8 characters, of the queue pool used to
form the server name and the name of the coupling facility list structure
DFHXQLS_poolname. This parameter is valid only at initialization, and must
always be specified.
This keyword can also be coded as POOL.
- BUFFERS={100|number}
- specifies the number of queue buffers to allocate for the server address
space.
A queue index buffer holds a queue index entry plus up to 32K of queue data (for a small queue). When a READ or WRITE request completes the queue index information is retained in the buffer. This can avoid the need to reread the queue index if the same queue is referenced from the same MVS image before the buffer has been reused. If no buffer is available at the time of a request, the request is made to wait until one becomes free.
The number of buffers should preferably be at least ten for each CICS region that can connect to the server in this MVS image. This avoids the risk of buffer waits. Additional buffers may be used to reduce the number of coupling facility accesses by keeping recently used queue index entries in storage. In particular, if the current version of a queue index entry is in storage at the time a queue item is read, the request requires only one coupling facility access instead of two. If the current version of a queue index entry is in storage when a second or subsequent item is written to the same queue, the request requires only one coupling facility access instead of three.
It is not worth defining extra buffers beyond the point where this might cause MVS paging, as it is more efficient to reread the index entry than to page in the buffer from auxiliary storage. This parameter is valid only at initialization.
The valid range is from 1 to 999999.
This keyword can also be coded as BUF.
- FUNCTION={SERVER|UNLOAD|RELOAD}
- Information about this parameter is given in Unloading and reloading queue pools.
- STATSOPTIONS={NONE|SMF|PRINT|BOTH}
- specifies the statistics options that determine whether interval statistics
are produced and whether statistics are sent to SMF, the print file, or both.
This keyword can also be coded as STATSOPT.
- ENDOFDAY={00:00|hhmm}
- specifies the time when end of day statistics are to be collected and
reset. If statistics options specify NONE, end of day statistics are written
to the print file. The valid range is from 00:00 to 24:00.
This keyword can also be coded as EOD.
- STATSINTERVAL={3:00|hhmm}
- specifies the statistics interval, within the range of 1 minute to 24
hours. It is ignored if STATSOPTIONS=NONE.
The valid range is from 00:01 to 24:00 (although it may be specified in seconds).
This keyword can also be coded as STATSINT.