Displaying tasks that are using the CICS-MQ connection

You can use the CICS®-MQ adapter control panels to display detailed information about CICS tasks that are using MQI calls, including their transaction IDs and task numbers.

About this task

If you want to see only the number of tasks using the connection, you can use any of the methods described in Displaying CICS-MQ connection status and settings. The INQUIRE MQCONN commands and the CICS-MQ adapter Display Connection panel also specify the number of trigger monitor (CKTI) tasks that are using the connection.

The CICS-MQ adapter Display Task panel provides details for each CICS task using the connection, as follows:
  • Transaction ID (name)
  • User ID
  • CICS task number
  • Task status
  • Thread status
  • Total number of API calls issued by this task
  • Whether resource security checking is active for this task
  • Whether this task is currently in the CICS-MQ API-crossing exit
  • Most recent API call issued by this task
  • Thread ID used by WebSphere® MQ

Figure 1 shows the layout of this information. For detailed information about each attribute, see the CKQC help panel, accessed by pressing PF1.

Procedure

To display the task information using the CICS-MQ adapter control panels:
  1. Type CKQC and press Enter to access the CICS-MQ adapter control panels.
  2. Select Task from the menu bar.
  3. To obtain information about all tasks that are currently active, select the List all tasks action from the menu.
  4. To specify the starting number of the first task to be displayed, select the List from task action from the menu.

Example

Figure 1. The CICS-MQ adapter Display Task panel

 CKQCM3                       Display Task panel
 
 Read task status information. Then press F12 to cancel.
 
 Tasks   1 to   3 of   3
 
 Tran    User   Task   Task    Thread     Total    Res  API    Last     Thread
  Id      Id    Num   Status   Status      APIs    Sec Exit   MQ call     ID
 ---- -------- ----- -------- --------  ---------- ---  --- ---------- --------
 PUTQ CICSUSER 00065  Normal  In Queue         102 No   No    MQPUT1   00012420
 GETQ CICSUSER 00067  Normal  Between           22 No   No    MQOPEN   00012620
 CKTI CICSUSER 00123  Normal  Msg Wait           2 No   No    MQGET    00012C20
 
 
 
 
 
 
 
 
 
 
 
 
 
 F1=Help  F7=Backward  F8=Forward  F12=Cancel  Enter=Refresh