In this task you will create a Tuxedo Control file and then add a method to the control file.
The next page of the wizard allows to enter control properties.
Service Name | 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 Select. 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 Workstation Address dialog displays. Note that this field corresponds to the annotation attribute: @tuxedo(serviceName). For information about importing WTC services, see Import New Tuxedo Services. |
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. This field corresponds to the annotation attribute @tuxedo(serviceType). |
|
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 Workshop test browser in the XML buffer. Depending on the location of the comments in the buffer, Tuxedo may have problems parsing the buffer. Note that this field corresponds to the annotation attribute: @tuxedo(bufferType).
|
|
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. Note that this field corresponds to the annotation attribute: @tuxedo(fieldTables). |
|
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. Note that this field corresponds to the annotation attribute: @tuxedo(viewClasses). |
|
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. Note that this field corresponds to the annotation attribute: @tuxedo(sendViewClass). |
When using the Insert Wizard to create a new Control, 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 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 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 New Control 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. (Note that the Configure button will be greyed out if a WTC connection is already present.) 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.
A connection to the Tuxedo domain is made and a list of services exported by the Remote Tuxedo Domain displays.
If you click Back, the WTC Imported Services dialog displays.
For more information about importing WTC services, see "Setting Up a WebLogic Tuxedo Connector (WTC) Connection."