OPSYS(data-area)
returns a 1-character string representing the type of operating system currently running. A value of “4” represents OS/400.
RELEASE(data-area)
returns a 4-character string representing the CICS version and release numbers.
For example, a returned value of “0310” represents CICS/400 V5R2M0.
STARTUP(cvda)
returns a CVDA value indicating the startup state that was used to start the
CICS control region. CVDA values are:
COLDSTART
The control region did not recover any resources when it was started. *COLD was supplied in the STRTYPE parameter of the
STRCICS command.
WARMSTART
The control region recovered TD and TS queues when it was started. *WARM was supplied in the STRTYPE parameter of the STRCICS command.
EMERGENCY
The control region recovered TD and TS queues when it was started. *EMER was supplied in the STRTYPE parameter of the
STRCICS command.
INQUIRE TASK
(
data-value
)
FACILITY (
data-area
) FACILITYTYPE (
cvda
)
STARTCODE (
data-area
) TRANSACTION (
data-area
) USERID (
data-area
)
Condition:
TASKIDERR
The EXEC CICS INQUIRE TASK command retrieves information about the named user task. User tasks are tasks that are associated either with user-defined transactions or with CICS-supplied transactions that are normally invoked by an operator.
Options
FACILITY(data-area)
returns a 4-character string representing the name of the facility associated with this task. If the task was initiated from a terminal (that is, FACILITYTYPE value is TERM), FACILITY returns the name of the terminal. If the task was initiated by a destination trigger level as defined in the DCT (that is,
FACILITYTYPE value is DEST), FACILITY returns the name of the transient data queue associated with this task. If FACILITYTYPE is neither TERM nor
DEST, FACILITY returns a null value (blanks).
FACILITYTYPE(cvda)
returns a CVDA value indicating the type of facility that initiated this task.
CVDA values are:
TASK
The task was initiated by another task.
TERM
The task was initiated from a terminal.
494
CICS for iSeries Application Programming Guide V5
DEST
The task was initiated by a destination trigger level as defined in the destination control table (DCT).
STARTCODE(data-area)
returns a 2-character string representing a value that indicates how this CICS task was started. Possible values are:
D
DS
Distributed program link (DPL).
DPL plus sync-on-return.
QD
A CICS transient data trigger level was reached.
S
START command (no data).
SD
TO
START command (with data).
Operator entered a CICS transaction code at the terminal.
TP
Transaction was started by presetting the transaction ID for the CICS terminal, either by using RETURN TRANSID, or by having a CICS transaction permanently assigned to the CICS terminal.
CICS user-attached task.
U
TASK(data-value)
specifies as a 4-byte packed decimal value the sequence number that identifies the task.
TRANSACTION(data-area)
returns a 4-character string representing the transaction name (if any) associated with the task.
USERID(data-area)
returns a 10-character string representing the identifier of the CICS user currently associated with the CICS task.
Exception Conditions
TASKIDERR
occurs if the named task cannot be found (RESP2=1).
Default action: Terminate the task abnormally.
Chapter 33. System programming reference
495
