Task related user exit programs - EXITTRUE

The Task-related user exits (EXITTRUE) view displays information about installed CICS TS task-related user exits.

Supplied views

To access from the main menu, click:

CICS operations views > CICS region operations views > Task related user exit programs

Table 1. Views in the supplied Task related user exits (EXITTRUE) view set
View Notes
Task related user exits

EYUSTARTEXITTRUE.DETAILED

Detailed information about a specific task related user exit.
Task related user exits

EYUSTARTEXITTRUE.TABULAR

Tabular information about currently installed task related user exits.

Actions

None.

Fields

Table 2. Fields in EXITTRUE views
Field Attribute name Description
Open API status APIST Indicates which APIs the task-related user exit uses.
  • BASEAPI - The task-related user exit program is enabled as either QUASIRENT or THREADSAFE, but without the OPENAPI option. This means it is restricted to the CICS permitted programming interfaces. BASEAPI is a synonym of CICSAPI.
  • OPENAPI - The task-related user exit program is enabled with the THREADSAFE and OPENAPI options. This means that it is permitted to use non-CICS API in a threadsafe manner, for which purpose CICS gives control to the task-related user exit under an open TCB
  • NOTAPPLIC - Not applicable.
Concurrency type CONCURRENTST Indicates the concurrency status of the task-related user exit program specified by the latest Enable command for this program.
  • QUASIRENT - The task-related user exit program is quasi-reentrant and is only able to run under the CICS QR TCB when invoking CICS services through the CICS API. To use any MVS services, this task-related user exit program must switch to a privately-managed TCB.
  • THREADSAFE - The task-related user exit program is threadsafe. If APIST is BASEAPI then the task-related user exit program is able to run under whichever TCB is in use by its user task when the program is given control. If APIST is OPENAPI then the TCB used is always an L8 TCB.
  • REQUIRED - The task-related user exit program requires an open TCB. This value is returned only if APIST is BASEAPI and means the type of open TCB used is any eligible key 8 open tcb. A concurrency and apist combination of REQUIRED and OPENAPI has the same meaning as THREADSAFE and OPENAPI, therefore for reasons of compatibility with previous releases CICS will always return a value of THREADSAFE in this case.
  • NOTAPPLIC - The exit is not a task-related user exit.
Connect status CONNECTST This is valid for task-related user exits only and indicates the state of the connection between the exit and the external resource manager that it support
  • CONNECTED - The task-related user exit is connected to its external resource manager subsystem, and API requests can be issued.
  • NOTAPPLIC - The exit is not a task-related user exit.
  • NOTCONNECTED - The task-related user exit is not connected to its external resource manager subsystem, and therefore API requests cannot be issued.
  • UNKNOWN - The task-related user exit has been enabled and started, but not enabled for SPI requests. UNKNOWN can also be returned if CICS is unable to call the task related user exit. In both of these cases, CICS cannot tell whether it is connected to its external resource manager.
Entry-point address of task related user exit ENTRY Specifies the entry-point address of the task-related user exit program
Entry name ENTRYNAME Specifies the name of the global or task-related user exit program. The value can be the same as the name of the load module, however a different value is returned when the load module contains more than one exit program.
Format execution diagnostic facility (EDF) status FORMATEDFST Indicates whether FORMATEDF was specified on the ENABLE command.
  • FORMATEDF - On
  • NOFORMATEDF - Off
  • NOTAPPLIC - This is a global user exit
Name of exit owning global work area GAENTRYNAME Specifies the name of the currently enabled global, or task-related, user exit program that owns the global work area being used by the exit specified in the entry name field. This field will not contain a value unless a global work area is being used and is owned by another exit program.
Length of global work area GALENGTH Specifies the length of the global work area for this exit program.
Number of work area users GAUSECOUNT Specifies the number of users of the work area
INDOUBTWAIT enabled status INDOUBTST Indicates whether the task-related user exit is enabled with the INDOUBTWAIT keyword.
  • NOTAPPLIC - The exit being inquired upon is a global user exit.
  • NOWAIT - The exit is not enabled with the INDOUBTWAIT keyword.
  • WAIT - The exit is enabled with the INDOUBTWAIT keyword.
Program name PROGRAM Specifies the name of the load module of the exit program.
Purgeable status PURGEABLEST Indicates whether or not the task-related user exit can be purged.
  • PURGEABLE - The task-related user exit program can be purged.
  • NOTPURGEABLE - The task-related user exit program cannot be purged and must be force purged.
  • NOTAPPLIC - The information is not applicable to this release of CICS.
SPI qualifier QUALIFIER This returns, for a task-related user exit that is enabled for SPI calls, the 8-character qualifier returned by the exit.

For global user exits and task-related user exits that are not enabled for SPI calls, returns blanks.

Exit CICS shutdown status SHUTDOWNST Specifies whether the task-related user exit is invoked when CICS shutdown occurs.
  • NOSHUTDOWN - The task-related user exit is not invoked.
  • NOTAPPLIC - Not applicable.
  • SHUTDOWN - The task-related user exit is invoked when CICS shutdown occurs.
Exit-enabled-for-(SPI) calls option SPIST Indicates whether the task-related user exit is enabled for SPI calls.
  • NOSPI - The exit is not enabled for SPI.
  • NOTAPPLIC - The exit being inquired upon is a global user exit. This occurs only when the INQUIRE command is explicitly for a global user exit
  • SPI - The exit is enabled for SPI.
Exit program availability status STARTSTATUS Identifies whether the exit program is available for execution.
  • STARTED - The exit program is available for execution.
  • STOPPED - The exit program is not available for execution.
Length of local work area TALENGTH Indicates the length of a local (task-related) work area.
Start and end of task invocation status TASKSTART Indicates whether the exit program is set to be invoked automatically at the start and end of every task.
  • NOTASKSTART - The exit program is not set to invocation at the start and end of every task.
  • NOTAPPLIC - Not applicable.
  • TASKSTART - The exit program is set for invocation at the start and end of every task.


eyua3sq.html | Timestamp icon Last updated: Sunday, 4 June 2017