INQUIRE DISPATCHER

Description

The INQUIRE DISPATCHER command returns information about the CICS system under which the task issuing the command is running.

Many of the options in this command correspond to options in the system initialization parameters and take their initial values from these parameters. You can change some of the parameter values by using the SET DISPATCHER command. Other options return CICS dispatcher state data.

Options

ACTOPENTCBS(data-area)

Returns a fullword binary field giving the total number of L8 and L9 mode open TCBs currently allocated to tasks.

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 task-related user exits that are enabled with the OPENAPI option. Task related user exits use only L8 mode TCBs; for example the CICS DB2 adapter when connecting to DB2. 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.

ACTSSLTCBS(data-area)

Returns a fullword binary field giving the total number of S8 mode open TCBs currently allocated to tasks.

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.

ACTTHRDTCBS(data-area)

Returns a fullword binary field giving the total number of T8 mode open TCBs currently allocated to enabled JVM servers.

The T8 mode TCBs are allocated from a pool of open TCBs. One pool is used by one JVM server. CICS dispatcher maintains the pools of T8 mode TCBs for use in the JVM server runtime environment.

ACTXPTCBS(data-area)

Returns a fullword binary field giving the total number of X8 and X9 mode open TCBs currently allocated to tasks.

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 a 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.

MAXOPENTCBS(data-area)

Returns a fullword binary field giving the maximum number of L8 and L9 mode open TCBs that CICS is allowed to attach and maintain in its pool of L8 and L9 mode TCBs.

For information about the number allocated, see the ACTOPENTCBS option. The difference between MAXOPENTCBS and ACTOPENTCBS represents the number of such TCBs that are free.

MAXSSLTCBS(data-area)

Returns a fullword binary field giving the maximum number of S8 mode open TCBs that CICS is allowed to attach and maintain in its pool of S8 mode TCBs.

MAXTHRDTCBS(data-area)

Returns a fullword binary field giving the maximum number of T8 mode open TCBs that can exist concurrently in the CICS® region for all enabled and disabled JVMSERVER resources; that is, the total number of threads reserved for all the JVM servers in the region. The number of threads reserved for each JVM server is the THREADLIMIT value on the JVMSERVER resource, plus 1 (the TCB that is reserved for the JVM server). For more information about THREADLIMIT, see JVMSERVER attributes.

The difference between MAXTHRDTCBS and ACTTHRDTCBS represents the number of TCBs that are free. If you initialize another JVM server, one TCB is reserved for the JVM server.

MAXXPTCBS(data-value)

Returns a fullword binary field giving the maximum number of X8 and X9 mode open TCBs that CICS is allowed to attach and maintains in its pool of X8 and X9 mode TCBs.

For information about the number allocated, see the ACTXPTCBS option. The difference between MAXXPTCBS and ACTXPTCBS represents the number of such TCBs that are free.

MROBATCH(data-area)

Returns a fullword binary field giving the number of events that must occur, from a list of MRO and DASD I/O events on which CICS is waiting, before CICS is posted explicitly to process them.

PRTYAGING(data-area)

Returns a fullword binary field giving the rate at which CICS increases the priority of a task waiting for dispatch. CICS increases the task priority by 1 after each PRTYAGING milliseconds of wait time without a dispatch.

RUNAWAY(data-area)

Returns a fullword binary field giving the default system value for runaway task time. This value is used for any task running a transaction with a profile that does not specify runaway task time. See the INQUIRE TRANSACTION option RUNAWAY.

SCANDELAY(data-area)

Returns a fullword binary field giving the maximum number of milliseconds between a user task making a terminal I/O request and CICS dispatching the terminal control task to process it. This value is sometimes called the terminal scan delay, and is set by the ICVTSD option in the system initialization table.

SUBTASKSdata-area)

Returns a fullword binary field giving the value set by the SUBTSKS system initialization parameter, which can be either 0 or 1.

TIME(data-area)

Returns a fullword binary field giving the maximum interval in milliseconds for which CICS gives control to the operating system if no tasks are ready for dispatch. This value is set by the ICV system initialization parameter and is sometimes called the region exit time interval.

Conditions

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.