In this task you will create a Tuxedo Control file and then add a method to the control file.
Click Create a new Tuxedo Control to use and enter a name for the JCX file in the New JCX name field.
Note: The Tuxedo Control you create must be in a folder within the Project. For example, the JCX name will be folder.name or folder\name.
Select the type of service from the menu. This specifies the type of interaction that the Tuxedo Control supports in the Tuxedo service.
Note: For more information about specifying queue service types, see How Do I: Create a Tuxedo Control That Uses Queue Type Services. |
|
Select the type of buffer from the menu. This specifies the type of buffer that the Tuxedo Control will construct to send to the Tuxedo service.
Note: For input XML using data dependent routing, remove all comments generated by the WebLogic Workshop test browser in the XML buffer. Depending on the location of the comments in the buffer, Tuxedo may have problems parsing the buffer. |
|
|
|
Type the WTC imported service name. This name should match the service name that is mapped in Create a WebLogic Tuxedo Connector (WTC) Service. If you are not sure of the service name, you can click Browse and a list of imported WTC service names display. If the service is listed in the WTC Imported Services dialog, you can select it and click OK. If the service you want is not listed, then the service has not been imported into WebLogic Server. To import a service from the WTC Imported Services dialog, click Import and the Services Exported by Tuxedo Application dialog displays. For information about importing WTC services, see Import New Tuxedo Services. |
|
Type the name of the field table for the Tuxedo service when using fml or fml32 buffers. You should specify the field table when using fml or fml32 buffers that are sent or act as reply buffers from the called service. The name of the field table should match the classes generated with the mkfldclass or mkfldclass32 utilities. For buffer types fml and fml32, WTC needs the names and types of the fields the buffer can contain. These are described in field table classes created with mkfldclass and mkfldclass32 utilities. For more information about mkfldclass and mkfldclass32 utilities, see WebLogic Server Javadoc. |
|
Type the names of the view classes that correspond to the view buffer types that can be received from the Tuxedo service. This field is only required when the Tuxedo service returns a view or view32 buffers. These classes are independent from the Send View Class attribute which is used to specify the view or view32 class that represents the view buffer the Tuxedo service expects as an input. Note: The value of this attribute may be a list of classes so that a single Tuxedo service can respond with different VIEW buffers. For information about viewj and viewj32 utilities, see WebLogic Server Javadoc. |
|
If you have selected view or view32 in the Buffer type field, the Send View Class field becomes active. This attribute provides the name of the class that represents the view/view32 buffer the service is expecting as an input buffer. This view class is used to create the TypedView buffer. |
When using the Insert Wizard to create a new Java Control Extension, a single method is defined that corresponds to the Service Type and Service Name specified in the Insert Wizard. The signature and possibly the name of this method in the JCX file needs to be edited to match the name and buffer contents expected for the Tuxedo service being called. In addition, any other services that this control calls must have methods defined for them in this interface.
For queued services, the method name created by the wizard is enqueue, dequeue, or enqueueDequeue. You can change the wizard-created name.
For information about mapping data and fields to create request/response buffers, see How Do I: Map Java Data Types/FML and VIEW Buffers.
Within the web service or Java application, you can browse available Tuxedo services from the Insert Control - Tuxedo dialog. In the Service Name or Receive Queue Space fields, you can click Browse and see a list of available WTC imported services. If the service you want is not in the list, then the service has not been imported into WebLogic Server.
Note: Before you can import the service to WebLogic Server, you must configure the WTC service. To configure a WTC service, click Configure on the WTC Imported Services dialog box. Refer to How Do I: Configure a WTC Service.
To import a service from the WTC Imported Services dialog, click Import and the Workstation Address dialog displays.
Note: login dialog displays. Enter the Tuxedo application information and click Next.
A connection to the Tuxedo domain is made and a list of services exported by the Remote Tuxedo Domain displays.
If you click Cancel, the WTC service is deleted and the WTC Imported Services dialog displays.
If you click Back, the Workstation Address dialog displays.
Click Finish when you have completed importing all required services and the configured WTC service will deploy. The WTC Import Services dialog displays. The services you have imported should display in the list.
For more information about importing WTC services, see "Setting Up a WebLogic Tuxedo Connector (WTC) Connection."