How Do I: Configure a WTC Service

WTC acts as a gateway between the Tuxedo environment and WebLogic environment; therefore, a WTC service definition must exist that maps to the Tuxedo service you want to use in your web service. You can use the New Control dialog to configure WTC services as described in this topic.

Note: An alternative way to configure WTC services is via the WebLogic Server Administration Console. See the WebLogic Tuxedo Connector Administration Guide for information on configuring WTC using the WebLogic Server Administration Console.

To configure a WTC service within Tuxedo Control you must access the WTC Imported Services dialog.

Right-click the web service or Java application and select Insert > Control > New System Control > Tuxedo Control.
The New Control dialog displays.
Select a location and name for the new control and click Next.
Click the Browse button next to the Service Name to open the WTC Imported Services dialog that lists the available WTC imported services
A message window is displayed stating that "No WTC server configured. Press Configure to create one." Press OK to close this message window.
To configure a WTC service from the WTC Imported Services dialog, click Configure and the Workstation Address dialog displays. Domain information is required from the Tuxedo application. (If the service you want is not in the list, then the service has not been imported into WebLogic Server.)
Enter the network address of the workstation listener on a remote Tuxedo domain, such as a machine_name:port number combination //mach1:5100. This is the address of the Tuxedo application so the service names and domain information can be retrieved. Click Next. After the Workstation Address dialog, one of the following scenarios will occur depending on whether the domain information is determined from the Tuxedo application or from a default configuration.

When you click Next on the Workstation Address dialog, if the Tuxedo domain has security turned on, the Security Information for Tuxedo login dialog displays. Enter the Tuxedo application information and click Next.

(If the Tuxedo service has security enabled, you will challenged to user and password infomation.)

A connection to the Tuxedo domain is made and local and remote domain information is imported from the Tuxedo application. If the local and remote domains are configured in WTC successfully, a list of services exported by the Remote Tuxedo Domain displays.

If the machine where the Tuxedo application resides is not reachable and/or the domain information cannot be retrieved from Tuxedo, then a default local and remote domain is configured in WebLogic Server. A prompt displays stating that a default domain will be configured. Click OK.

The Remote Tuxedo Domain Network Address dialog displays. Enter the machine name and the port number where the Tuxedo application resides.

If you click Back, the WTC server Mbean that was created is deleted from the WebLogic Server-WTC configuration.

If you click Next, a default Remote Domain is created. However, because a default Remote Domain was configured, no services are imported. Proceed to the next step.

If the domain information was retrieved from the Tuxedo application, then a list of the Tuxedo Remote domains displays. Select one or more of the remote domains from the list and click OK. Similarly, a list of Local domains displays. Select the Local domain that offers the service you want and click Select. After selecting the Local and Remote domains, the list of exported services by the Tuxedo application displays.

After the Workstation Address dialog, if there is only one Local and Remote domain configured in the Tuxedo application, the list of exported services by the Tuxedo application displays. Select the service you want.

Click Import to create the associated import services.

If you click Cancel, the WTC service is deleted and the WTC Imported Services dialog displays.

If you click Back, the WTC Imported Services dialog appears.

Click Finish when you have completed importing all required services and the configured WTC service will deploy.

After selecting the services to export, if there is more than one Local domain configured in WTC, a dialog displays prompting you to select the Local domain that will be exporting the previously selected service. Click Select after choosing the Local domain.

The WTC Configuration dialog displays.

If all the information to configure WTC was imported from the Tuxedo application, an empty WTC Configuration pane displays. Click Done to complete the WTC service configuration process.
If a default domain is configured, the following WTC Configuration dialog displays with configuration information for *DM_LOCAL_DOMAINS, *DM_REMOTE_DOMAINS and *DM_TDOMAIN. Copy the entries in the pane and paste them into the BDMCONFIG file in your Tuxedo application. Be sure and save the updates to your BDMCONFIG file. Click Done to complete the WTC service configuration process.

The WTC Import Services dialog displays. The services you have imported should display in the list.

Note: When you have completed the configuration, the WTC Imported Services dialog displays. If you want to configure a WTC service when using an existing Tuxedo Control, click Back and the New Control dialog displays. Click Cancel on the New Control dialog to abort the creation of a new Tuxedo Control.

If you have security configured in your WebLogic Server domain, you should set up security for WTC using the WebLogic Server Administration Console. For information on setting up WTC security, refer to the WebLogic Tuxedo Connector Documentation.