CEMT INQUIRE TASK

Function

Retrieve information about a user task.

Command options:
This section describes only the options of the CEMT INQUIRE TASK command that relate specifically to BTS. For full details of the INQUIRE TASK command, see the CICS® Supplied Transactions manual.

Description

INQUIRE TASK returns information about user tasks. Only information about user tasks can be displayed or changed; information about CICS-generated system tasks or subtasks cannot be displayed or changed. System tasks are those tasks started (and used internally) by CICS, and not as a result of a user transaction.

Input

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

To change various attributes, you can:

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE TASK
 
                      .-ALl-----------.
>>-CEMT Inquire TAsk--+---------------+--+--------+------------->
                      +-(value)-------+  '-(....)-'
                      '-TClass(value)-'
 
>--+-------------------+--+-----------------+------------------->
   '-ACTIVITYId(value)-'  '-ACTIVITY(value)-'
 
>--+----------------+--+--------------------+------------------><
   '-PROCESS(value)-'  '-PROCESSType(value)-'
 
(value)
is the CICS-generated task number, in the range 1-99999.
ALl
is the default. The maximum number of tasks that can be displayed is 32000.
TClass(value)
is the 8-character transaction class name to which the transactions belong. The maximum number of tasks that can be displayed is 32000.

You cannot specify a list of identifiers, nor can you use the symbols * and + to specify a family of tasks.

Sample screen

Figure 49. CEMT INQUIRE TASK screen
IN TASK
STATUS:  RESULTS - OVERTYPE TO MODIFY
 Tas(0000033) Tra(CEMT) Fac(944D) Sus Ter Pri( 255 )
    Sta(TO) Use(BELL    ) Uow(AB9001D5F56CC800) Hty(ZCIOWAIT) Hva(DFHZARQ
 Tas(0000037) Tra(CEMT) Fac(S21D) Run Ter Pri( 255 )
    Sta(TO) Use(BELL    ) Uow(AB9002E745F93A00)
 
 
 
Note:
Blank fields on the screen indicate that a value does not apply or is ‘negative’; that is, it begins with ‘No’. Underscores indicate input-only fields.

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format as shown in Figure 50.

Figure 50. The expanded display of an individual entry
 IN TASK
 RESULT - OVERTYPE TO MODIFY
   Task(0000033)
   Tranid(CEMT)
   Facility(944D)
   Runstatus(Suspended)
   Ftype(Term)
   Priority( 255 )
   Purgetype(              )
   Startcode(TO)
   Userid(BELL)
   Uow(AB9001D5F56CC800)
   Htype()
   Hvalue()
   Htime()
   Indoubt(Backout)
   Indoubtwait(Wait)
   Bridge()
   Activityid()
   Activity()
   Process()
   Processtype()
 

Displayed fields

Activityid(value)
displays the 52-character, CICS-assigned, identifier of the CICS business transaction services activity that this task is executing on behalf of.
Activity(value)
displays the 16-character, user-assigned, name of the CICS business transaction services activity that this task is executing on behalf of.
Process(value)
displays the 36-character name of the CICS business transaction services process that this task is executing on behalf of.
Processtype(value)
displays the 8-character process-type of the CICS business transaction services process that this task is executing on behalf of.

Related concepts
The master terminal transaction, CEMT
Related reference
CBAM--BTS browser
CEMT INQUIRE PROCESSTYPE
The full syntax of CEMT INQUIRE TASK
CEMT SET PROCESSTYPE
[[ Contents Previous Page | Next Page Index ]]