TASK - Tasks

The TASK view shows general information about currently executing tasks. Examples of how to use this view can be found in:

Availability

The TASK view is available for all managed CICS® systems.

Access

Issue command:
TASK [task [RUNning|DISpatchable|SUSpended [tranid [activityid [process [processtype ]]]]]

task
is the ID of a currently executing task or * for all tasks. If you specify a task ID, the tranid parameter must either be * or be omitted.

RUNning|DISpatchable|SUSpended
Limits the view to tasks that are either running, ready to run, or suspended. Specify * to include all tasks regardless of their run status.

tranid
Limits the view to tasks that are running one or more named transactions. Enter a specific or generic transaction name. If you specify a transaction ID, the task parameter must be *.

The following parameters apply to CICS Transaction Server for OS/390®, Version 1 Release 3 and later systems only:

activityid
is a specific or generic activity id.

process
is a specific or generic process name.

processtype
is a specific or generic process type name.

If you do not specify parameters, the view includes information about all tasks within the current scope.

Select:
TASK from the OPERATE menu, and TASK from the TASK submenu.

Figure 105 and Figure 106 are an example of the TASK view.

Figure 105. The TASK view (left side)
 27FEB2005  21:22:07 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =TASK==============EYUPLX01=EYUPLX01=27FEB2005==21:22:07====CPSM=========21
 CMD Task  CICS     Tran Run User     Term LU Name  Unit of Work Id  Pri Tran     
 --- Id--- System-- ID-- Sta ID------ ID-- -------- ---------------  --- Class--- 
        28 IYCRCTSS COIE SUS CTSQ0SR                B1CB83F037710105 255 DFHTCL0
        29 IYCSCTSG CKAM SUS CTSS0GR                B1CBA56AB0D6C103 255 DFHTCL0
        33 IYCRCTSG COIE SUS CTSR0GR                B1CF6C06CF6D2607 255 DFHTCL0
        35 IYCSCTSF CKAM SUS CTSS0FR                B1CF42172B182700 255 DFHTCL0
        36 IYCSCTSF CKTI SUS CTSS0FR                B1CF42172499B500   1 DFHTCL0
        38 IYCRCTSG COI0 SUS CTSR0GR                B1CF9EA7487AA507 255 DFHTCL0
        38 IYCRCTS8 COI0 SUS CTSR01R                B1CF9EE941D6E109 255 DFHTCL0
        39 IYCRCTS8 COIE SUS CTSR01R                B1CF9EE97E46B709 255 DFHTCL0
        43 IYCRCTSK CECI SUS CTSR0KD  E0C5          B1CF91747FF97607   1 DFHTCL0
        44 IYCQCTS4 CEMT SUS CTSQ04D  TC04          B1CF7099E1F01E00 255 DFHTCL0
        45 IYCRCTSK COI0 SUS CTSR0KR                B1CF9EA74A2CC906 255 DFHTCL0
        46 IYCRCTSK COIE SUS CTSR0KR                B1CF9EAA4A543F09 255 DFHTCL0
        48 IYCQCTT8 COI0 SUS CTSQ0AD                B1CF9EE8475AD004 255 DFHTCL0
        49 IYCQCTT8 COIE SUS CTSQ0AD                B1CF9EEE148D7A00 255 DFHTCL0
        53 IYCQCTSR COI1 SUS CTSQ05D  -AAF          B1CF9EE705AF6603 255 DFHTCL0
        53 IYCRCTSS COI0 SUS CTSQ0SR                B1CF9EA74BA92906 255 DFHTCL0
        54 IYCQCTSR COI2 SUS CTSQ05D  -AAE          B1CF9EE71113C002 255 DFHTCL0 

Figure 106. The TASK view (right side)
 27FEB2005  21:22:07 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =TASK==============EYUPLX01=EYUPLX01=27FEB2005==21:22:07====CPSM==========3
 CMD Task  Tran     Current  Suspend  Suspend
  -- Id--- Class--- Suspend- Type---- Value---
        28 DFHTCL00 00:00:24
        29 DFHTCL00 00:00:00
        33 DFHTCL00 00:00:00
        35 DFHTCL00 00:00:00 
        36 DFHTCL00 00:00:00 
        38 DFHTCL00 00:00:00
        38 DFHTCL00 00:00:00 
        39 DFHTCL00 00:00:00
        43 DFHTCL00 00:02:03
        44 DFHTCL00 00:00:00
        45 DFHTCL00 00:00:00
        46 DFHTCL00 00:00:00
        48 DFHTCL00 00:00:00
        49 DFHTCL00 00:00:00
        53 DFHTCL00 00:00:08
        53 DFHTCL00 00:00:00
        54 DFHTCL00 00:00:00
                                             

Action commands

Table 217 shows the action commands you can issue from the TASK view. The overtype field is shown in Table 218.

The action commands and overtype field for the TASK view are available for all managed CICS systems for which TASK is valid.

Table 217. TASK view action commands
Primary command Line command Description
FORcepurge
task sysname
FOR Forces CICS to purge a task immediately, regardless of whether system or data integrity can be maintained.
PURge
task sysname
PUR Purges a task normally. CICS does not purge the task unless system and data integrity can be maintained.
n/a SET Sets a task attribute according to the new value you specify in an overtype field (see Table 218).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
Where:
task
Is the ID of an executing task.
sysname
Is the specific or generic name of a CICS system.

Table 218. TASK view overtype field
Field name Values
Pri 0-255

Hyperlinks

Table 219 shows the hyperlink fields on the TASK view.

Table 219. TASK view hyperlink fields
Hyperlink field View displayed Description
Task ID TASKD Detailed view of the specified task.
Term ID TERMNLD Detailed view of the terminal associated with the specified task.
Tran Class TRNCLSD Detailed view of transaction classes associated with the CICS system where a task is running.
Unit of Work ID TASK

Tabular view showing all tasks that have the same network Unit of Work ID as the selected task.

Note that if monitoring is inactive in a CICS system, the network Unit of Work ID is not available. As a result:

  • if monitoring is inactive in the CICS system whose task is being hyperlinked on, the hyperlink will not take place, resulting in message BBMHY010W.
  • if monitoring is inactive in a CICS system whose task is related to the task that is the object of a valid hyperlink, the task cannot be included in the resulting display.
Note:
You can also display the TASKS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]