Introduction to WebLogic Tuxedo Connector Programming

Introduction to WebLogic Tuxedo Connector Programming

Note: For information on how to develop WebLogic Server Enterprise JavaBeans , see Programming WebLogic Enterprise JavaBeans.
The following sections provide information about the development environment you will be using to write code for applications that interoperate between WebLogic Server and Tuxedo:
Developing WebLogic Tuxedo Connector Applications
WebLogic Tuxedo Connector JATMI Primitives
WebLogic Tuxedo Connector TypedBuffers

Developing WebLogic Tuxedo Connector Applications

Note: For more information on the WebLogic Tuxedo Connector JATMI, view the Javadocs for WebLogic Classes.The WebLogic Tuxedo Connector classes are located in the weblogic.wtc.jatmi and weblogic.wtc.gwt packages.
In addition to the Java code that expresses the logic of your application, you will be using the Java Application -to-Transaction Monitor Interface (JATMI) to provide the interface between WebLogic Server and Tuxedo.

Developing WebLogic Tuxedo Connector Clients

Note: For more information, see Developing WebLogic Tuxedo Connector Client EJBs
A client process takes user input and sends a service request to a server process that offers the requested service. WebLogic Tuxedo Connector JATMI client classes are used to create clients that access services found in Tuxedo. These client classes are available to any service that is made available through a the WebLogic Tuxedo Connector WTCServer MBean.

Developing WebLogic Tuxedo Connector Servers

Note: For more information, see Developing WebLogic Tuxedo Connector Service EJBs
Servers are processes that provide one or more services. They continually check their message queue for service requests and dispatch them to the appropriate service subroutines. WebLogic Tuxedo Connector uses EJBs to implement services which Tuxedo clients invoke.

WebLogic Tuxedo Connector Interoperability with Tuxedo CORBA objects

Note: For more information, see Using WebLogic Tuxedo Connector for RMI/IIOP and CORBA Interoperability
The WebLogic Tuxedo Connector provides bi-directional interoperability between WebLogic Server and Tuxedo CORBA objects. The WebLogic Tuxedo Connector:
Enables Tuxedo CORBA objects to invoke upon EJBs deployed in WebLogic Server using the RMI/IIOP API (Inbound).
Enables objects (such as EJBs or RMI objects) to invoke upon CORBA objects deployed in Tuxedo using the RMI/IIOP API (Outbound).
Enables objects (such as EJBs or RMI objects) to invoke upon CORBA objects deployed in Tuxedo using a CORBA Java API (Outbound).

WebLogic Tuxedo Connector JATMI Primitives

The JATMI is a set of primitives used to begin and end transactions, allocate and free buffers, and provide the communication between clients and servers.

Name

Operation
tpacall Use for asynchronous invocations of a Tuxedo service during request/response communication.tpacall has two forms:
deferred synchronous

asynchronous

tpcall Use for synchronous invocation of a Tuxedo service during request/response communication.
tpconnect Use to establish a connection to a Tuxedo conversational service.
tpdiscon Use to abort a conversational connection and generate a TPEV_DISCONIMM event when executed by the process controlling the conversation.
tpdequeue Use for receiving messages from a Tuxedo /Q during request/response communication.
tpenqueue Use for placing a message on a Tuxedo /Q during request/response communication.
tpgetrply Use for retrieving replies from a Tuxedo service during request/response communication.
tprecv Use to receive data across an open connection from a Tuxedo application during conversational communication.
tpsend Use to send data across a open connection to a Tuxedo application during conversational communication.
tpterm Use to close a connection to a Tuxedo object.

WebLogic Tuxedo Connector TypedBuffers

Note: WebLogic Tuxedo Connector does not support double-byte character sets or international character sets. These features are dependent on future releases of Tuxedo.
WebLogic Tuxedo Connector provides an interface called TypedBuffers that corresponds to Tuxedo typed buffers. Messages are passed to servers in typed buffers. The WebLogic Tuxedo Connector provides the following buffer types:.

Buffer Type

Description
TypedString Buffer type used when the data is an array of characters that terminates with the null character. Tuxedo equivalent: STRING.
TypedCArray Buffer type used when the data is an undefined array of characters (byte array), any of which can be null. Tuxedo equivalent: CARRAY.
TypedFML Buffer type used when the data is self-defined. Each data field carries its own identifier, an occurrence number, and possibly a length indicator. Tuxedo equivalent: FML.
TypedFML32 Buffer type similar to TypeFML but allows for larger character fields, more fields, and larger overall buffers. Tuxedo equivalent: FML32.
TypedXML Buffer type used when data is an XML based message. Tuxedo equivalent: XML for Tuxedo Release 7.1 and higher.
TypedView Buffer type used when the application uses a Java structure to define the buffer structure using a view description file. Tuxedo equivalent: VIEW
TypedView32 Buffer type similar to View but allows for larger character fields, more fields, and larger overall buffers. Tuxedo equivalent: VIEW32.

Name	Operation
tpacall	Use for asynchronous invocations of a Tuxedo service during request/response communication.tpacall has two forms: deferred synchronous asynchronous
tpcall	Use for synchronous invocation of a Tuxedo service during request/response communication.
tpconnect	Use to establish a connection to a Tuxedo conversational service.
tpdiscon	Use to abort a conversational connection and generate a TPEV_DISCONIMM event when executed by the process controlling the conversation.
tpdequeue	Use for receiving messages from a Tuxedo /Q during request/response communication.
tpenqueue	Use for placing a message on a Tuxedo /Q during request/response communication.
tpgetrply	Use for retrieving replies from a Tuxedo service during request/response communication.
tprecv	Use to receive data across an open connection from a Tuxedo application during conversational communication.
tpsend	Use to send data across a open connection to a Tuxedo application during conversational communication.
tpterm	Use to close a connection to a Tuxedo object.

Buffer Type	Description
TypedString	Buffer type used when the data is an array of characters that terminates with the null character. Tuxedo equivalent: STRING.
TypedCArray	Buffer type used when the data is an undefined array of characters (byte array), any of which can be null. Tuxedo equivalent: CARRAY.
TypedFML	Buffer type used when the data is self-defined. Each data field carries its own identifier, an occurrence number, and possibly a length indicator. Tuxedo equivalent: FML.
TypedFML32	Buffer type similar to TypeFML but allows for larger character fields, more fields, and larger overall buffers. Tuxedo equivalent: FML32.
TypedXML	Buffer type used when data is an XML based message. Tuxedo equivalent: XML for Tuxedo Release 7.1 and higher.
TypedView	Buffer type used when the application uses a Java structure to define the buffer structure using a view description file. Tuxedo equivalent: VIEW
TypedView32	Buffer type similar to View but allows for larger character fields, more fields, and larger overall buffers. Tuxedo equivalent: VIEW32.