## 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 Insert Control - Tuxedo 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.

1. Within the web service or Java application, choose Insert->Controls->Tuxedo. The Insert Control - Tuxedo dialog displays. 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.
2. In step 2 of the Insert Control - Tuxedo dialog, select Create a new Tuxedo Control to use option. This will activate the Step 3 section of the dialog and allow you to browse the Service Name or Receive Queue Space fields. A list of available WTC imported services displays. If the service you want is not in the list, then the service has not been imported into WebLogic Server.
3. 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.
4. 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.

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. Proceed to step 5.

- 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 step 6.

5. If the domain information was retrieved from the Tuxedo application and there is more than one remote domain configured, then a list of the Tuxedo Remote domains displays. Select one or more of the remote domains from the list and click OK. Similarly, if there is more than one Local domain configured in the Tuxedo application, then 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 Workstation Address dialog displays.

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.

6. 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_TDOMAINS. 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. It may be helpful to review step 5 when selecting services.

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 extension, click Back and the Insert Control - Tuxedo dialog displays. Click Cancel on the Insert Control - Tuxedo dialog to abort the creation of a new Tuxedo Control extension.

7. 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.

Related Topics

- WebLogic Tuxedo Connector Documentation
- Create a WebLogic Tuxedo Connector (WTC) Service