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