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.