CEMT INQUIRE TASK
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 destination control table (DCT).
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 on the values that can appear in the
HTYPE and HVALUE options, and how they can be
used as an aid in problem determination, see the
“resource type” and “resource name” details in the
CICS
Problem Determination Guide
.
Indoubtmins(
value
)
displays the length of time, in minutes, after a failure
during the in-doubt period, before the task is to take the
action returned in the Indoubt field. The returned value is
valid only if the unit of work is in-doubt and Indoubtwait
returns WAIT.
See also Indoubt and Indoubtwait.
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 in-doubt period.
The action is dependent on the values returned in
Indoubtwait and Indoubtmins; if Indoubtwait returns
WAIT, the action is not taken until the time returned in
Indoubtwait expires.
The values are:
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 in-doubt state.
The values are:
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 the
CICS Resource Definition Guide
.
IDentifier(
value
)
| returns a 48-character field containing 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, it could contain the MQ correlator for the
| 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 overtyping 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.
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.
Purgetype (
input only field
)
specifies whether a task is to be purged or forcepurged.
The values are:
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 forcepurged during
backout processing, CICS terminates abnormally.
If you want to terminate a task but do not want to
terminate CICS, you should use PURGE instead
of FORCEPURGE.
In some BTAM situations, further user action is
required to complete the purging of the task. If a
Chapter 11. Master terminal CEMT 121