Oracle Audio Technologies Oracle Tuxedo - Manual (Page 21)

R u n n i n g O r a c l e T M A T C P f o r C I C S
Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide 2-3
2. If the multiplex count is 1 and security is disabled, or if the service request came from a
version of TMA TCP gateway prior to Version 3.0, then the following tasks occur.
a. The Handler issues a CICS LINK command to execute the program specified in the TMA
TCP protocol header. With the LINK command it also passes along any request data
provided by the client application that made the original Oracle Tuxedo service request.
b. The Handler waits for the CICS program to finish and receives any returned data from the
CICS program.
c. The Handler transmits the response to the remote TMA TCP gateway gateway.
d. The Handler stays connected to the remote gateway awaiting another service request.
3. If the multiplex count is greater than 1 or security is enabled, then the following tasks occur.
a. The Handler issues an EXEC CICS START TRANS call with the transaction specified in the
Inbound Service File for the service specified in the TMA TCP protocol header. The
transaction should be the same as the Application Handler program.
Note: If security is enabled, the EXEC CICS START TRANSID call uses the user ID specified
in the TMA TCP protocol header.
b. For any completed service requests, the Handler retrieves the response data from the
Application Handler.
c. The Handler transmits the response to the remote TMA TCP gateway gateway.
d. The connection between the Handler and the gateway remains and the Handler waits for
another service request.
For tpacall/TPNOREPLY requests, the remote program is invoked by a CICS START TRANSID
command and no data is returned to the original caller. In this case, a unique transaction must be
defined for the service. Use the Inbound Service Information screen to enter this unique
transaction name rather than using the transaction name that starts the Application Handler.
Shutting Down the Handler
When the network connection is lost, the Handler process automatically shuts down. The next
service request sent causes the Listener to automatically start a new Handler, if necessary.
Use the supplied shutdown transaction BDWN to terminate active TMA TCP for CICS programs.
Depending on the options specified, this causes all Handlers to shut down gracefully. The name
of the
BDWN transaction may have been changed at your site during installation, so verify the
name.