CEMT INQUIRE TASK

Retrieve information about a user task.

In the CICS Explorer, the Tasks operations view provides a functional equivalent to this command.

Description

INQUIRE TASK returns information about user tasks. Only information about user tasks can be displayed or changed; information about CICS-generated system tasks or subtasks cannot be displayed or changed. System tasks are those tasks started and used internally by CICS®, and not as a result of a user transaction.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE TASK (or suitable abbreviations for the keywords). The resulting display lists the status of every task.
  • Type CEMT INQUIRE TASK (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter CEMT INQ TA TE, the resulting display shows the details of only those tasks that were started from a terminal.
You can change various attributes in the following ways:
  • Overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).
  • Use the CEMT SET TASK command.
(value)
The CICS-generated task number, in the range 1 - 99999.
ALL
The default value. The maximum number of tasks displayed is 32000.
TCLASS (value)
The 8-character transaction class name to which the transaction belongs. The maximum number of tasks displayed is 32000.

You cannot specify a list of identifiers, or use the asterisk (*) or plus (+) symbols to specify a family of tasks.

When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format.

CEMT INQUIRE TASK

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE TASKALL( value)TCLASS( value)TRANID( value)FACILITY( value)PURGEFORCEPURGERUNNINGDISPATCHABLESUSPENDEDTASKTERMDESTPRIORITY( value)DDSQDSSDTOTPUUSERID( value)UOW( value)HTYPE( value)HVALUE( value)HTIME( value)BACKOUTCOMMITBRIDGE( value)IDENTIFIER( value)INDOUBTMINS( value)NOWAITWAITDB2PLAN( value)ACTIVITYID( value)ACTIVITY( value)PROCESS( value)PROCESSTYPE( value)CKOPENINTERNALQRUKOPENBRFACILITY( value)

Displayed fields

ACTIVITY (value)
Displays the 16-character, user-assigned, name of the CICS business transaction services activity that this task is executing on behalf of.
ACTIVITYID (value)
Displays the 52-character, CICS-assigned, identifier of the CICS business transaction services activity that this task is executing on behalf of.
BRFACILITY(value)
Displays the 8-byte facility token representing the virtual terminal used by the current task if it is used by the 3270 bridge mechanism. If the task is not currently running in the 3270 bridge environment, zeros are returned.
BRIDGE (value)
Displays the 4-character name of the bridge monitor transaction if the current task is running in a 3270 bridge environment, and was started by a bridge monitor transaction with a START BREXIT TRANSID command. Otherwise, blanks are returned.
DB2PLAN (value)
Displays the 1- to 8-character name of the DB2® plan being used by this task, or blanks if no DB2 plan is being used.
FACILITY (value)
Displays a 4-character string identifying the name of the terminal or queue that initiated the task. If no FACILITY value is displayed, the task was started without a facility.
FTYPE
Displays the type of facility that initiated this task. The values are as follows:
TASK
The task was initiated from another task.
TERM
The task was initiated from a terminal.
DEST
The task was initiated by a destination trigger level as defined in the TDQUEUE resource definition.
HTIME (value)
Displays the time (in seconds) that the task has been in the current suspended state.
HTYPE (value)
Displays the reason why the task is suspended. A null value indicates that there is no hold-up, except for the necessity of reaching the head of the queue.
HVALUE (value)
Displays a 16-character resource name, such as a file name, or a value such as a TCLASS value.

For information about the values that CICS can return in the HTYPE and HVALUE options, see the resource type and resource name details in The resources on which CICS system tasks can wait.

INDOUBTMINS (value)
Displays the length of time, in minutes, after a failure during the indoubt period, before the task is to take the action returned in the INDOUBT attribute. The returned value is valid only if the unit of work is indoubt and the value of the INDOUBTWAIT attribute returns WAIT.
INDOUBT (value)
Displays the action (based on the ACTION attribute of the TRANSACTION resource definition) to be taken if the CICS region fails or loses connectivity with its coordinator while a unit of work is in the indoubt period.

The action is dependent on the values returned in the INDOUBTWAIT and INDOUBTMINS attributes; if INDOUBTWAIT returns WAIT, the action is not taken until the time returned in INDOUBTWAIT expires.

The values are as follows:
BACKOUT
All changes made to recoverable resources are to be backed out.
COMMIT
All changes made to recoverable resources are to be committed, and the unit of work marked as completed.
INDOUBTWAIT (value)
Displays how (based on the WAIT attribute of the TRANSACTION definition) a unit of work (UOW) is to respond if a failure occurs while it is in an indoubt state. The values are as follows:
NOWAIT
The UOW is not to wait, pending recovery from the failure. CICS is to take immediately whatever action is specified on the ACTION attribute of the TRANSACTION definition.
WAIT
The UOW is to wait, pending recovery from the failure, to determine whether recoverable resources are to be backed out or committed.

For further information about the meaning of the ACTION and WAIT attributes of the TRANSACTION definition, see TRANSACTION definition attributes.

IDENTIFIER (value)
Displays a 48-character field that contains user data provided by the bridge exit, if the task was initiated in the 3270 bridge environment, or blanks, otherwise. This field is intended to assist in online problem resolution.

For example, this field might contain the WebSphere® MQ correlator for the CICS-MQ bridge, or a web token.

PRIORITY (value)
Displays the priority of the task in the range 0 - 255, where 255 is the highest priority.
Note: You can reset this value by typing over it with a different value.
PROCESS (value)
Displays the 36-character name of the CICS business transaction services process that this task is executing on behalf of.
PROCESSTYPE (value)
Displays the 8-character process-type of the CICS business transaction services process that this task is executing on behalf of.
PURGETYPE (input only field)
Specifies whether a task is to be purged or forced to purge. The values are as follows:
PURGE
The task is to be terminated. Termination occurs only when system and data integrity can be maintained.
FORCEPURGE
The task is to be terminated immediately. System integrity is not guaranteed. In some extreme cases, for example if a task is forced to purge during backout processing, CICS terminates abnormally. If you want to terminate a task but do not want to terminate CICS, use PURGE instead of FORCEPURGE.
RUNSTATUS
Displays the status of this task. The values are as follows:
RUNNING
The task is running.
DISPATCHABLE
The task is dispatchable.
SUSPENDED
The task is suspended.
STARTCODE (value)
Displays how this task was started. The values are as follows:
D
A distributed program link (DPL) request. The program cannot issue I/O requests against its principal facility or any sync point requests.
DS
A distributed program link (DPL) request, as for code D, with the exception that the program can issue sync point requests.
QD
A transient data trigger level was reached.
S
Start command (no data)
SD
Start command (with data)
TO
The operator typed a transaction code at the terminal.
TP
The transaction was started by presetting the transaction ID for the terminal.
U
User-attached task.
TASK (value)
Indicates that this panel relates to a TASK inquiry and displays a CICS-generated task number in the range 1–99999.
TCB (value)
Displays the type of TCB under which the task is running. The values are as follows:
CKOPEN
The task is running under a CICS key open TCB.
INTERNAL
The task is running under one of the CICS internal TCBs. An internal TCB can be one of the following:
  • The concurrent mode (CO) TCB
  • The file-owning mode (FO) TCB
  • The resource-owning mode (RO) TCB
  • The ONC/RPC mode (RP) TCB
  • The sockets listener mode (SL) TCB
  • The secure sockets layer mode (SO) TCB
  • A sockets mode (S8) TCB
  • The FEPI mode (SZ) TCB
QR
The task is running under the CICS QR TCB.
UKOPEN
The task is running under a user key open TCB.
TRANID (value)
Displays a 4-character string identifying the transaction name associated with the task.
UOW (value)
Displays the 16-character local identifier of the unit of work that is associated with this task.
USERID (value)
Displays the user that is currently associated with the task.