Retrieve CICS dispatcher information.
INQUIRE DISPATCHER .----------------------------. V | >>-INQUIRE DISPATCHER----+------------------------+-+---------->< +-ACTJVMTCBS(data-area)--+ +-ACTOPENTCBS(data-area)-+ +-ACTSSLTCBS(data-area)--+ +-ACTXPTCBS(data-area)---+ +-MAXJVMTCBS(data-area)--+ +-MAXOPENTCBS(data-area)-+ +-MAXSSLTCBS(data-area)--+ +-MAXXPTCBS(data-area)---+ +-MROBATCH(data-area)----+ +-PRTYAGING(data-area)---+ +-RUNAWAY(data-area)-----+ +-SCANDELAY(data-area)---+ +-SUBTASKS(data-area)----+ '-TIME(data-area)--------'
Conditions: NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The INQUIRE DISPATCHER command returns information about the CICS system under which the task issuing the command is executing.
Many of the options in this command correspond to options in the system initialization table (SIT) and take their initial values from the SIT. Some of these can be changed by a subsequent SET DISPATCHER command, or by using its CEMT equivalent. Other options return CICS dispatcher state data.
The J8 and J9 mode TCBs are allocated from the pool of open TCBs that CICS attaches up to the maximum set by the MAXJVMTCBS system initialization parameter. CICS dispatcher maintains the pool of J8 and J9 mode TCBs for use only by Java programs that require a JVM. The ACTJVMTCBS value can be equal to, or less than, the MAXJVMTCBS value. If it is equal to MAXJVMTCBS, tasks that require a J8 or J9 mode open TCB are made to wait.
The L8 and L9
mode TCBs are allocated from the pool of open TCBs
that CICS attaches up to the maximum set by the MAXOPENTCBS system initialization parameter. CICS dispatcher
maintains the pool of L8
and L9
mode TCBs for use
by OPENAPI applications and
by task-related user exits
that are enabled with the OPENAPI option (
task related
user exits only use L8 mode TCBs,
for example, the CICS DB2 adaptor
when connecting to the DB2 Version 6 or later). The ACTOPENTCBS value can
be equal to, or less than, the MAXOPENTCBS value. If it is equal to MAXOPENTCBS,
tasks that require an L8
or L9
mode open TCB are made
to wait.
The S8 mode TCBs are allocated from the pool of open TCBs that CICS attaches up to the maximum set by the MAXSSLTCBS system initialization parameter. S8 TCBs are used by tasks that require SSL functions. The ACTSSLTCBS value can be equal to, or less than, the MAXSSLTCBS value. If it is equal to MAXSSLTCBS, tasks that require an S8 TCB are made to wait.
The X8 and X9 mode TCBs are allocated from the pool of open TCBs that CICS attaches up to the maximum set by the MAXXPTCBS system initialization parameter. CICS dispatcher maintains the pool of X8 and X9 mode TCBs for use by C and C++ programs compiled with the XPLINK option . The ACTXPTCBS value can be equal to, or less than, the MAXXPTCBS value. If it is equal to MAXXPTCBS, tasks that require an X8 or X9 mode open TCB are made to wait.
The difference between MAXJVMTCBS and ACTJVMTCBS represents the number of such TCBs that are free.
The difference between MAXOPENTCBS and ACTOPENTCBS represents the number of such
TCBs that are free.
The difference between MAXXPTCBS and ACTXPTCBS represents the number of such TCBs that are free.