Maximum number of worker threads

The maxworker parameter defines the maximum number of concurrent requests that CICS® Transaction Gateway can process.

maxworker=<number>
Description
Set the value in the range 1-1,000,000 to specify the maximum number of worker threads. Set the value to be less than or equal to maxconnect. If the value exceeds the EXCI pipes limit, a warning message is issued, and the value of maxworker is reduced to be equal to the EXCI logon limit, LOGONLIM. Because all CICS server connections share the same pool of worker threads, this restriction also affects IPIC connections. If EXCI is disabled by setting environment variable CTG_EXCI_INIT to NO, this restriction does not apply.You might need to set the value of maxworker to less than the supported maximum value because of constraints on memory or other system resources. You can specify that there is no limit to the number of worker threads by setting the value of maxworker to -1. For more information about threading limits, see Threading model.

You can use the ctgstart command with the -maxworker option to override the value of the port parameter. For more information, see Options on the ctgstart command

Because there is a maximum limit on the number of EXCI pipes per MVS™ address space, set maxworker according to the EXCI pipe reuse model:
Reuse all (CTG_PIPE_REUSE=ALL)
Less than or equal to the EXCI pipe maximum limit set by CICS (LOGONLIM) divided by the number of unique APPLIDs in communication with CICS Transaction Gateway.
Reuse one per thread (CTG_PIPE_REUSE=ONE)
Less than or equal to the EXCI pipe maximum limit set by CICS (LOGONLIM).
In both cases, to avoid resource shortage errors set RECEIVECOUNT in the CICS sessions definition to be greater than the number of EXCI pipes being used. For more information see EXCI pipe limit exceeded. Starting multiple instances of CICS Transaction Gateway can increase throughput, for more information see Starting multiple CICS Transaction Gateways.

This parameter is in the GATEWAY section of the configuration file.

Default value
If this parameter is not specified, the default value is 100.

Reference Reference

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//ctgzos/maxi2.html