Work requests - WORKREQ

The Work requests (WORKREQ) views display information about EJB work requests and the transactions associated with them.

Supplied views

To access from the main menu, click:

CICS operations views > Task operations views > Work requests

Table 1. Views in the supplied Work requests (WORKREQ) view set

View	Notes
Work requests EYUSTARTWORKREQ.DETAILED	Detailed information about EJB work requests.
Work requests EYUSTARTWORKREQ.FORCEPURGE	Force purge a selected work request.
Work requests EYUSTARTWORKREQ.PURGE	Purge a selected work request.
Work requests EYUSTARTWORKREQ.TABULAR	Tabular information about EJB work requests.

Actions

Table 2. Actions available for WORKREQ views

Action	Description
FORCEPURGE	Force purge a selected work request.
PURGE	Purge a selected work request.
SET	Set attributes according to new values specified in input fields

Fields

Table 3. Fields in WORKREQ views

Field	Attribute name	Description
Client IP address	CLIENTIPADDR	The IPv4 or IPv6 address of the client that originated the request. The format of this IP address is given by the CLNTIPFAMILY value.
The format of the Client IP address	CLNTIPFAMILY	A value indicating the format of the Client's IP address in the CLIENTIPADDR field. These are the possible values: IPV4 - The address is specified in IPv4 dotted decimal address format. IPV6 - The address is specified in IPv6 colon hexadecimal address format. NOTAPPLIC - No entry is specified for the address
Associated CorbaServer	CORBASERVER	The name of the associated CorbaServer.
Host port that received the request	LISTENERPORT	The host port that received the request.
Work request	NAME	The token generated by CICS to identify the work request.
Originating tasks application ID	OAPPLID	The application ID of the originating task.
Task that received the request	OTASK	The number of the task (RequestReceiver) that received the request.
Transaction ID that received the request	OTRANSID	The ID of the transaction that received the request.
Purge type	PURGETYPE	Specifies whether a task is to be purged or forcepurged. The values are: Forcepurge - The work request is terminated immediately. System integrity is not guaranteed. In some extreme cases, for example if a work request is forcepurged during backout processing, CICS terminates abnormally. If you want to terminate a work request but do not want to terminate CICS, you should use PURGE instead of FORCEPURGE. Purge - The work request is terminated, but termination occurs only when system and data integrity can be maintained.
Current request ID	REQUESTID	The ID of the current request. This value is sent by the client initiating the request and is used to associate the reply with the request. A client can be processing more than one request at any given moment.
Stack level of call	STACK	The stack level of this call. As each new request is received from the client the request receiver creates a stack and initializes it with a value of 1. The stack is incremented by 1 every time a new bean is invoked, and decremented each time a bean which has incremented it terminates. So the value of the stack gives the current level within the EJB transaction at which this work request is executing. If a request is sent to a non-CICS EJB server then this field is NOT incremented.
Local task number	TASK	The local task number.
Local transaction ID	TRANSID	The ID of the local transaction.
Address of target CICS system	TSYSTEM	The VTAM APPLID or resolved IPv4 or IPv6 address and port of the target system. The field can be one of the following: The colon hexadecimal IPv6 address and port number of the target system in the format (for example ::a:b:c:d:port) The dotted decimal IPv4 address and port number of the target system in the format a.b.c.d:port Up to eight characters followed by blanks. In this case these 8-characters, or less, are the VTAM applid of the target system If the field contains only a string of blank characters (spaces), the target is not CICS over MRO Another value. CICS does not know about any other possibilities. Any other value must be meaningful to other software at your installation which expects to work with the value obtained from this parameter of this CICS command
Format of the Target system address	TSYSTYPE	Indicates the format of the target system's address. These are the possible values: APPLID - The address is an up to 8 character VTAM APPLID followed by blanks IPV4 - The address is specified in IPv4 dotted decimal address format with a port IPV6 - The address is specified in IPv6 colon hexadecimal address format with a port NOTAPPLIC - No entry is specified for the address. The Target system address contains blanks.
Type of work being performed	WORKTYPE	The type of work being performed: IIOP - Specifies that the work is being performed for an IIOP request SOAP - Specifies that the work is being performed for a Web service request