Copyright © Cloud Software Group, Inc. All Rights Reserved

Adapter and Kenan/BP Interaction

The adapter acts as an interface to the Kenan/BP application. Using the adapter, an application configured on the TIBCO environment can interact with the Kenan/BP application.

The following figure shows the main components of the adapter and how the adapter interacts with Kenan/BP system components to integrate external applications with it through the TIBCO environment.

Figure 2 Adapter and Kenan/BP System Integration

TIBCO ActiveMatrix Adapter for Kenan/BP contacts the Kenan/BP application through the API-Transaction Set 2.2 or 3.0. The API Set offers a Java Interface through which other functions can invoke the Kenan/BP functionality. You can use four ways to access the Java Interface as follows:

•

JavaBeans

•	Enterprise JavaBeans

•

HashMaps

•	Document Object Model (DOM)

The adapter uses the DOM approach to communicate with the Kenan/BP API-TS 2.2 or 3.0.

After receiving a request, the adapter will perform the following procedure to allow interaction with Kenan/BP.

•	The request sent to the API-TS (when using the DOM approach) is in the form of an XML message. This message contains the API call name (for example, AccountCreate). The syntax and input parameters are validated by the API-TS against a corresponding XSD file (Account.xsd in this case).

•	The incoming request to the API Transaction Set is authenticated by a Security Server. This Security Server controls access to the API-TS by assigning roles and users.

•	The BSDMSettings object allows you to configure the connection to the API TS server. The BSDMSessionContext object lets you specify parameters relating to how each call is executed.

•	The Tuxedo Services form the backbone of the KenanFX middleware. Once a request is received by the API-TS, the Java Interface maps it to the appropriate Tuxedo service. The Tuxedo Services then manage further execution of the API Call.

•	The incoming message is converted from XML to DOM Document format prior to invoking the API Call.

•	Kenan/BP sends a DOM object as a reply, which is in turn converted to an XML string and sent to the calling function.

Copyright © Cloud Software Group, Inc. All Rights Reserved