INQUIRE TASK

Retrieve information about a user task.

Command options:
This section describes only the options of the INQUIRE TASK command that relate to BTS. For full details of the INQUIRE TASK command, see the CICS® System Programming Reference manual.
Read syntax diagramSkip visual syntax diagram                             .----------------------------.
                             V                            |
>>-INQUIRE TASK(data-value)----+------------------------+-+----><
                               +-....-------------------+
                               +-ACTIVITY(data-area)----+
                               +-ACTIVITYID(data-area)--+
                               +-PROCESS(data-area)-----+
                               +-PROCESSTYPE(data-area)-+
                               '-....-------------------'
 

Conditions: NOTAUTH, TASKIDERR

Description

The INQUIRE TASK command returns information about a specific user task. User tasks are those associated with user-defined transactions or with CICS-supplied transactions that are normally invoked by an operator.

Options

ACTIVITY(data-area)
returns the 16-character, user-assigned, name of the CICS business transaction services activity that this task is executing on behalf of.
ACTIVITYID(data-area)
returns the 52-character, CICS-assigned, identifier of the CICS business transaction services activity that this task is executing on behalf of.
PROCESS(data-area)
returns the 36-character name of the CICS business transaction services process of which this task is a part.
PROCESSTYPE(data-area)
returns the 8-character process-type of the CICS business transaction services process of which this task is a part.

Conditions

NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
TASKIDERR
RESP2 values:
1
The task cannot be found.
2
The task is executing a type of transaction which is not subject to this command.

Related concepts
BTS activities and processes
Inquiry command
Related reference
CEMT INQUIRE TASK
CREATE PROCESSTYPE
DISCARD PROCESSTYPE
SET PROCESSTYPE
INQUIRE PROCESSTYPE
[[ Contents Previous Page | Next Page Index ]]