A CONVERSE request from a NetView command list
(or command processor) starts a CICS® transaction on the same
host. The CICS transaction is expected to return a response
to a specified NetView task in a named NetView domain.
The response can have the form of a RESPONSE, an ACK, or a NACK.
EVESNCCI returns a message and a return code
indicating whether the command was successful or not. If the command
is accepted, it is forwarded to the EVENTASK optional task.
The EVENTASK optional task uses the program-to-program interface to notify CICS that the transaction is to
be started.
The started transaction retrieves the input data. The CICS transaction returns a response
to NetView. The response
is sent back to the EVENTASK optional task using the program-to-program interface. The
processing of the response sent to NetView differs
for the various response types, as follows:
A for ACK
The following message is sent to the requestor:
EVE128I POSITIVE ACKNOWLEDGEMENT
N for NACK
The following message is sent to the requestor:
EVE129E response_data
Where response_data is
the data that is returned by the CICS program.
R for RESPONSE
When this request type is used, the NetView program-to-program interface initialization
member is interrogated to locate the function requested so that the
command list can be identified. The request is then scheduled under
the autotask associated with the requested function, after which the
data is sent to the requestor.
Figure 1 illustrates the flow of events initiated by
an EVESNCCI CONVERSE request. Figure 1. An EVESNCCI CONVERSE Request
Notes:
Parameters passed with EVESNCCI indicate the request type (in this case C for CONVERSE), the
target CICS, the name of the function to be invoked, data (if
required), and the requesting operator ID and domain ID.
The responses (RESPONSE, ACK, or NACK) are returned from CICS to the requestor (operator ID and domain ID).
The function name is used to locate the transaction name in the CICS initialization member. If the transaction name cannot be found, a NACK
response is returned.