CEKL INQUIRE TASK

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

You can enter this command in the following ways from the system console:

```
/F cicsregionname,CEKL INQUIRE TASK
```
This command displays the current status of the user tasks in your system. The minimum abbreviation is CEKL I TA.
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 by using CEKL I TA D. The resulting display shows the details of only those tasks that are marked for dispatch in your system.

You can further restrict your selection by using the transaction class or transaction id option, for example, CEKL I TA TRANClass(value). This command returns a list of the tasks for the specified transaction class.
```
/F cicsregionname,CEKL INQUIRE TASK(tasknum)
```
This command 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

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

The following example output is typical output from the inquire command.

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 state. 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, an XPLink (mode X8) 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

Displays the name of the transaction (up to 4 characters) associated with the task.

TCL(tttttttt)

Displays the name of the transaction class (up to 8 characters) associated with the task. It the task is not defined in a class, the value is blank.

USE(aaaaaaaa)

Displays the userid for the task.

ATT(sssss)

Displays 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 no value is 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 can 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 1. 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 2. 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)