CTASK view


To display the status of active CICS tasks, issue the following command:

CTASK [target [tranID [tranType [fepiStatus [terminalStatus]]]]]

where

 

Parameter

Description

target

is the specific or generic name of a target CICS region

tranID

is the specific or generic name of a transaction

tranType

specifies the type of task, as follows:

  • U (specifies user tasks–the default)
  • S (specifies system tasks)

fepiStatus

specifies the FEPI status of the transactions

terminalStatus

specifies the terminal status of the transactions

 

The following figure is displayed.

CTASK view

ddmmmyyyy  hh:mm:ss ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND  ===>                                                 SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>                                            
>W1 =CTASK============(BCVDVPC==*=======)ddmmmyyyy==hh:mm:ss====MVCICS===D==========179
 CMD Task  Target   S Tran Elapsed  Tc  CPU   Suspend  Suspend     File   DSA   T Suspend  WLM Serv WLM Rpt  Applic   Application
 ---  ID            t  ID    Time   Mo  Time    Type    Time       Waits  Size  R Resource  Class    Class   Version  Name        
        47 BCVCB660 S CKAM 13:22:53 QR   0.00          00:00:00.00      0  5696 N                                                 
        93 BCVCB660 S JNL2 12:21:16 QR   0.00          00:00:00.00      0 12704 N                                                 
        96 BCVCB660 S BCRT 12:21:15 QR   0.00          00:00:00.00      0  2672 N                                                 
        47 BCVCB661 S CKAM 13:22:53 QR   0.00          00:00:00.00      0  5696 N                                                 
        93 BCVCB661 S JNL2 12:21:15 QR   0.00          00:00:00.00      0 12704 N                                                 
        96 BCVCB661 S BCRT 12:21:15 QR   0.00          00:00:00.00      0  2672 N                                                 
        47 BCVCB662 S CKAM 13:22:53 QR   0.00          00:00:00.00      0  5696 N                                                 
        93 BCVCB662 S JNL2 12:21:16 QR   0.00          00:00:00.00      0 12704 N                                                 
        96 BCVCB662 S BCRT 12:21:16 QR   0.00          00:00:00.00      0  2672 N                                                 
        47 BCVCB663 S CKAM 13:22:53 QR   0.00          00:00:00.00      0  5696 N                                                 
        93 BCVCB663 S JNL2 12:21:17 QR   0.00          00:00:00.00      0 12704 N                                                 
        96 BCVCB663 S BCRT 12:21:16 QR   0.00          00:00:00.00      0  2672 N                                                 
        52 BCVCB670 S CKAM 13:22:32 QR   0.00          13:22:32.18      0  5936 N          CICSNRM  CICS                          
        95 BCVCB670 S JNL2 12:21:15 QR   0.00          00:00:00.00      0 12704 N                                                 
        98 BCVCB670 S BCRT 12:21:15 QR   0.00          00:00:00.00      0  2672 N                                                 
        52 BCVCB671 S CKAM 13:22:32 QR   0.00          13:22:32.47      0  5936 N          CICSNRM  CICS                          
        95 BCVCB671 S JNL2 12:21:15 QR   0.00          00:00:00.00      0 12704 N                                                 
        98 BCVCB671 S BCRT 12:21:15 QR   0.00          00:00:00.00      0  2672 N                                                 
        52 BCVCB672 S CKAM 13:22:33 QR   0.00          13:22:33.01      0  5936 N          CICSNRM  CICS                          
        95 BCVCB672 S JNL2 12:21:15 QR   0.00          00:00:00.00      0 12704 N                                                 
        98 BCVCB672 S BCRT 12:21:15 QR   0.00          00:00:00.00      0  2672 N

 

Actions

The CTASK view supports the following line command actions:

 

Line command

Description

CAN

cancels a task by using the CICS SPI SET TASK PURGE (equivalent to CEMT SET TASK)

PUR

purges a task by using the CICS SPI SET TASK FORCEPURGE (equivalent to CEMT SET TASK FORCEPURGE)

Note

Because system and data integrity is not guaranteed, try using the CANCEL command before using this command.

TKI

terminates a task by using the CICS SPI (equivalent to CEMT SET TASK KILL). System and data integrity is not guaranteed.

Note

System and data integrity is not guaranteed. CICS does not accept the command unless an attempt has been made to CANCEL and PURGE the task.

DEL

kills a task with a dump, as long as the integrity of the CICS region can be maintained

Note

Because system and data integrity is not guaranteed, try using the CANCEL and PURGE commands before using this command.

KIL

kills a task with a dump, as long as the integrity of the CICS region can be maintained

Note

Because system and data integrity is not guaranteed, try using the CANCEL and PURGE commands before using this command.

FOR

forces a task to abend with a dump without regard for the integrity of the CICS region. It uses MainView for CICS internal logic

Note

Because system and data integrity is not guaranteed, try using the CANCEL and PURGE commands before using this command.

Note

The STR, STL, ZTr, DTr, and PTr commands are not valid on the task summary views. For more information, see Start-detail-trace-for-active-transactions.

STR

starts a detail trace for the in-flight task without logging

The trace ID name begins with the lowercase characters dt followed by a unique count and the task number.

STL

starts a logged detail trace for the in-flight task

The trace ID name begins with the lowercase characters dt followed by a unique count and the task number.

ZTr

stops a previously started in-flight task trace

DTr

displays the summary trace entries listed in the STRAC view for the in-flight task trace

PTr

purges the trace entry for an in-flight task as long as there is only one entry found

Otherwise, a warning message is displayed indicating there are multiple traces found for this task.

Note

The DEL, KIL, and FOR commands do not affect

  • a task executing a CICS (DFH*) module
  • a system task
  • a task in the middle of a DB2 request (current program DFHD2EX*)
  • a task with a Suspend Type of ZCIOWAIT, ICWAIT and FCXCWAIT (try the CANCEL and PURGE commands instead)

Related views

The following views are part of the CTASK family of views.

 

View

Description

CTASKZ

This view is a summary view of active CICS tasks.

The data is summarized by transaction ID. The Count field shows how many tasks are represented by each line of summary data. You can hyperlink from the Count field to the TASK view to expand a line of summary data.

CTASKDE

To display detailed information about the elapsed time for a specific CICS task, hyperlink from the Elapsed Time field of the CTASK view.

If RMI=YES in the MCT, RMI times are collected. Values are calculated for DB2 and MQ. IMS values are displayed in the DBCTL Time field.

CTASKDST

To display detailed information about the suspend time for a specific CICS task, hyperlink from the Suspend Time field of the CTASK view.

CTASKDC

To display detailed information about the CPU statistics for a specific CICS task, hyperlink from the CPU Time field of the CTASK view.

CTASKQ

To display the Quick Menu for a specific CICS task and related resources, hyperlink from the Task ID field of the CTASK view.

CTASKDA

To display detailed information about task storage area addresses and identifications, hyperlink from the Storage Addresses field of the CTASKQ detail menu.

CTASKDPG

To display detailed information about the program control statistics for a specific CICS task, hyperlink from the Program Control field of the CTASKQ detail menu.

CTASKDTM

To display detailed information about terminal control statistics for a specific CICS task, hyperlink from the Terminal Control field of the CTASKQ detail menu.

CTASKDTQ

To display the Quick Menu for temporary storage, transient data and journal statistics for a specific CICS task, hyperlink from the TS/TD/Journal Control field of the CTASKQ detail menu.

CTASKDQ

To display the Quick Menu for WebSphere MQ information that is associated with a specific CICS task, hyperlink from the MQ Series Utilization field of the CTASKQ detail menu.

Note

For additional information about WebSphere MQ usage, you can hyperlink from the MQ Susbsystem ID field on CTASKDQ to the CONNZ view in MainView for WebSphere MQ.

CTASKDJV

To display information about task’s use of Java virtual machines, hyperlink from the Java Utilization field of the CTASKQ detail menu.

CTASKDTC

To display information about task’s use of TCP/IP, hyperlink from the Sockets (TCPIP) field of the CTASKQ detail menu.

CTASKDTP

To display information about the TCP/IP interface utilization by a task, hyperlink from the Sockets Utilization (MCT) field of the CTASKQ detail menu.

CTASKDWB

To display information about task’s use of web services, hyperlink from the WEB (CWI/Documents) field of the CTASKQ detail menu.

CTASKDBT

To display information about task’s usage of BTS, hyperlink from the CICS BTS Statistics field of the CTASKQ detail menu.

CTASKDFP

To display information about a task’s use of the front-end programming interface, hyperlink from the Front End Programming Interface field of the CTASKQ detail menu.

CTASKDCN

To display information about a task’s container utilization, hyperlink from the Channel/Container Utilization field of the CTASKQ detail menu.

CTASKDEX

To display information about the EXEC CICS SPI and API commands executed by a specific task, hyperlink from the EXEC Interface Commands field of the CTASKQ detail menu.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*