CEKL INQUIRE TASK

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:

Read syntax diagramSkip visual syntax diagramCEKL 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 ]]