Running Oracl e TMA TCP fo r CI CS
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.
Oracle Tuxedo Mainframe Adapter for TCP CICS User Guide |