INQUIRE DISPATCHER

Retrieve CICS dispatcher information.

Read syntax diagramSkip visual syntax diagramINQUIRE 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).

Description

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.

Options

ACTJVMTCBS(data-area)
returns a fullword binary field giving the number of J8 and J9 mode open TCBs currently allocated to user tasks.

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.

ACTOPENTCBS(data-area)
returns a fullword binary field giving the total number of L8 Start of change and L9 End of changemode open TCBs currently allocated to user tasks.

The L8 Start of change and L9 End of changemode 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 Start of change and L9 End of changemode TCBs for use Start of changeby OPENAPI applications and End of change by task-related user exits that are enabled with the OPENAPI option (Start of change task related user exits only use L8 mode TCBs, End of change 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 L8Start of change or L9 End of change mode open TCB are made to wait.

Start of changeACTSSLTCBS(data-area)End of change
Start of changereturns a fullword binary field giving the total number of S8 mode open TCBs currently allocated to user 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.

End of change
Start of changeACTXPTCBS(data-area) End of change
Start of changereturns a fullword binary field giving the total number of X8 and X9 mode open TCBs currently allocated to user 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 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.

End of change
MAXJVMTCBS(data-area)
returns a fullword binary field giving the maximum number of J8 Start of change and J9 End of change mode open TCBs that CICS is allowed to attach and maintain in its pool of J8 Start of change and J9 End of changemode TCBs. For information about the number actually allocated, see the ACTJVMTCBS option.

The difference between MAXJVMTCBS and ACTJVMTCBS represents the number of such TCBs that are free.

MAXOPENTCBS(data-area)
returns a fullword binary field giving the maximum number of L8 Start of change and L9 End of changemode open TCBs that CICS is allowed to attach and maintain in its pool of L8 Start of change and L9 End of changemode TCBs. For information about the number actually allocated, see the ACTOPENTCBS option.

The difference between MAXOPENTCBS and ACTOPENTCBS represents the number Start of changeof such End of change TCBs that are free.

Start of changeMAXSSLTCBS(data-value)End of change
Start of changereturns 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.End of change
Start of changeMAXXPTCBS(data-value) End of change
Start of changereturns a fullword binary field giving the maximum number of X8 and X9 mode open TCBs that CICS is allowed to attach and maintain in its pool of X8 and X9 mode TCBs. For information about the number actually allocated, see the ACTXPTCBS option.

The difference between MAXXPTCBS and ACTXPTCBS represents the number of such TCBs that are free.

End of change
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 executing a transaction whose profile 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 option in the system initialization table 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.
[[ Contents Previous Page | Next Page Index ]]