3.10 Connection with the TPBroker/OTM client by using the gateway functionality in CTM

CTM provides gateway functionality, which allows the following types of clients to call J2EE applications that operate on application servers:

• TPBroker clients

  Client applications developed by using TPBroker Version 5 or later.

• TPBroker OTM clients

  Client applications developed by using TPBroker Object Transaction Monitor.

Also, CTM can output analysis information about the gateways that send and receive requests. This information can be converted into CSV format. The converted information can then be used for further analysis with analysis information output by other J2EE server functions. For details about performance analysis trace output, see the description of performance trace analysis in Chapter 7. Performance Analysis by Using Trace Based Performance Analysis in the uCosminexus Application Server Maintenance and Migration Guide.

The following figure shows an overview of calling J2EE applications from a TPBroker client or TPBroker OTM client by using the CTM gateway functionality.

Figure 3‒23: Overview of calling J2EE applications from a TPBroker client or TPBroker OTM client

When the TPBroker client sends a request to the J2EE application on a J2EE server, the request passes through an ORB gateway. When the TPBroker OTM client sends a request to the J2EE application on a J2EE server, the request passes through an OTM gateway. The ORB and OTM gateways are processes provided by CTM, and are started when the CTM daemon is started.

The following describes how TPBroker and TPBroker OTM clients can send requests to J2EE applications, and how references can be resolved.

• For TPBroker clients

  If 1 is specified for the -CTMAgent or -CTMIDLConnect option of the ctmregltd command, the CTM regulator enables the ORB gateway functionality. If 1 is specified for -CTMAgent, a CORBA reference is registered in the smart agent by using the EJB lookup name as an object name. Therefore, the TPBroker client resolves the reference destination by specifying the EJB lookup name as an argument for _bind(). If 1 is specified for -CTMIDLConnect, the TPBroker client resolves the reference destination by using the ctmgetior command to obtain the IOR string.

• For TPBroker OTM clients

  If 1 or a larger value is specified for the -CTMTSCGwStart option of the ctmstart command, the OTM gateway starts. On the TPBroker OTM client, specify the EJB lookup (registration) name as a TSC acceptor name for an argument of the constructor that generates a TSC user proxy. Note that the TSC acceptor name cannot be omitted. Select TSC regulator as the connection protocol.

You might want to develop client applications that allow TPBroker clients or TPBroker OTM clients to call applications on J2EE servers. For details about how to develop such applications, see the documentation for TPBroker or TPBroker Object Transaction Monitor.

To Page Top