Function
INQUIRE TASK returns information about user tasks, and displays the list
on the console from which the command was issued and the job log for the CICS
region.
Description
From a system console enter:
/F cicsregionname,CEKL INQUIRE TASK
This displays the current status of the user tasks in your system. The
minimum abbreviation is CEKL I TA.
From a system console enter: CEKL INQUIRE TASK followed by one
of the options to limit the range of information that you require. You can
restrict the list of tasks using CEKL I TA D, the resulting display
shows you the details of only those tasks that are marked for dispatch in
your system. You can further restrict your selection using the transaction
class or transaction id option, for example, CEKL I TA TRANClass(value). This returns a list of the tasks for the specified transaction
class.
From a system console enter:
/F cicsregionname,CEKL INQUIRE TASK(tasknum)
This displays the current status of the task in your system.
The minimum abbreviation is CEKL I TA(tasknum).
Syntax
The syntax of the CEKL INQUIRE TASK command is as follows:

CEKL INQUIRE TASK
>>-CEKL Inquire TAsk-------------------------------------------->
.------------------.
V |
>--+-+------------------+----+--------------+-+-+--------------><
| +-TRANClass(value)-+ +-Running------+ |
| '-TRANSid(value)---' +-Dispatchable-+ |
| '-Suspended----' |
'-(tasknum)----------------------------------'
Options
- Task(tasknum)
- selects the specified task. tasknum is a CICS-generated task
number, in the range 1-99999. Task entered without a tasknum lists
all the tasks on your system. A maximum of 1000 tasks are returned.
- TRANClass (value)
- selects only user tasks from the specified transaction class. TRANClass
is a unique transaction class name (up to 8 characters) to which the transaction
belongs. You cannot use the symbols * and + to specify transaction class.
- TRANSid (value)
- selects only user tasks with the specified transaction name (up to 4
characters) associated with the transaction. You cannot use the symbols *
and + to specify transaction class.
- Running
- selects tasks that are executing. These tasks are also included if you
specify none of the category options (DISPATCHABLE, RUNNING, and SUSPENDED).
- Dispatchable
- selects tasks that are ready to run (dispatchable). These tasks are
also included if you specify none of the category options (DISPATCHABLE, RUNNING,
and SUSPENDED).
- Suspended
- selects tasks that are suspended (tasks waiting for some event or condition).
Tasks that have not reached the point of initial dispatch either because the
transaction class limit has been reached or because the maxtasks limit has
been reached. These tasks are also included if you specify none of the category
options (DISPATCHABLE, RUNNING, and SUSPENDED).
Results
A typical output from the inquire command is shown below
TAS(nnnnn) ppp ddd cc tttt TCL(tttttttt) USE(aaaaaaaa) ATT(sssss) CPU(sssss)
RUA(sssss) HTI(sssss) HTY(rrrrrrrr) HVA(rrrrrrrr)
- TAS(nnnnn)
- nnnnn displays the CICS-generated task number in the range
1-99999 for this task.
- ppp
- ppp shows whether the task is being purged, forcepurged or
killed. It displays one of the following - PUR, FOR, or KIL. A blank implies that none of the actions have been
tried.
- ddd
- ddd shows whether the task is in a dispatchable, running or
suspended. It displays one of the following - DIS, RUN, or SUS.
- cc
- cc specifies the TCB that is associated with this task. The
values for cc are:
- CK
- indicates that the task is associated with a CICS key open TCB, for
example, a JVM (mode J8) TCB.
- IN
- indicates that the task is associated with one of the CICS internal
TCBs
- QR
- indicates that the task is associated with the CICS QR TCB
- UK
- indicates that the task is associated with a user key open TCB.
If the task has not reached the point of initial dispatch, the value
is blank.
- tttt
- is the name of the transaction (up to 4 characters) associated with
the task.
- TCL(tttttttt)
- is the name of the transaction class (up to 8 characters) associated
with the task. It the task is not defined in a class then this is blank.
- USE(aaaaaaaa)
- displays the userid for the task.
- ATT(sssss)
- is the length of time (in seconds) since the task was attached. A value
of 99999 indicates that the time is greater than 24 hours.
- CPUtime(sssss)
- displays the CPU time, in seconds, used by this task. If monitoring
is inactive, the value (*****) is returned. If there is no value
returned the task has reached either a transaction class limit or its maxtasks
limit. If the task has not reached the point of initial dispatch, the value
is blank. A value of 99999 indicates that the time is greater than 24 hours.
- RUnAway(sssss)
- displays the current limit, in seconds, used by CICS to monitor the
task for a runaway condition. If the value is zero, CICS is not monitoring
the tasks for a runaway condition.
For suspended tasks only, the output includes HTIme(sssss), HTYpe(reason), and HVAlue(resourcename). The values for these three
attributes are:
- HTIme(sssss)
- displays the time (in seconds) that the task has been in the current
suspended state. A value of 99999 indicates that the time is greater than
24 hours.
- HTYpe(rrrrrrrr)
- displays the reason why the task is suspended.
- HVAlue(rrrrrrrrr)
- displays a resource name (up to 16 characters), for example, a file
name or a TS queue name.
Note:
Blanks may be returned for HTYpe and HVAlue. For example,
this occurs if the NAME option is not specified on the WAIT EXTERNAL command.
Sample screen
The sample output shows the output that is generated and returned to the
TSO User log. In this example the CEKL command has been used to obtain a
list of all the tasks in the system MEACO22X and has returned 14 user tasks.
Only the first three tasks are shown in this sample. The first two tasks
are suspended and the third one is running.
The output for task 5 indicates that the task is suspended, the TCB is
the QR TCB, and the transaction id is XSSY. The userid for the transaction
is CICSUSER, the attach time is 6731 seconds, the amount of CPU time used
is 39 seconds, and the runaway time limit is 5 seconds. The second line returns
the values for the time that the task has been suspended (HTime), the reason
why the task is suspended (Htype), and the associated resource name (Hvalue).
The second task is similar to the first.
The third task, with the transaction id of L001, is still running in the
QR TCB.
Figure 50. CEKL INQUIRE TASK output
F MEACO22X,CEKL I TA
+IYK2ZFX3 DFHCQ0243I CEKL INQUIRE: 00014 task(s) matched selection criteria.
+IYK2ZFX3 TAS(00005) SUS QR XSSY USE(CICSUSER) ATT(06731) CPU(00039) RUA(00005)
+IYK2ZFX3 HTI(06732) HTY(ICMIDNTE) HVA(DFHAPTIM)
+IYK2ZFX3 TAS(00006) SUS QR XSSY USE(CICSUSER) ATT(06731) CPU(00093) RUA(00005)
+IYK2ZFX3 HTI(03293) HTY(ICEXPIRY) HVA(DFHAPTIX)
+IYK2ZFX3 TAS(00033) RUN QR LOO1 USE(CICSUSER) ATT(00033) CPU(00023) RUA(00010)
The second example shows where a task number has been selected and one
record is returned.
Figure 51. CEKL INQUIRE TASK output
F MEACO22X,CEKL I TAS(62)
+IYK2ZFX3 DFHCQ0241I CEKL INQUIRE: task number 00062 found.
+IYK2ZFX3 TAS(00062) SUS QR XEMT USE(CICSUSER) ATT(00176) CPU(00069) RUA(00005)
+IYK2ZFX3 HTI(00176) HTY(ZCIOWAIT) HVA(DFHZARQ1)
[[ Contents Previous Page | Next Page Index ]]