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

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

    image

    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.

    image

  8. The WTC Configuration dialog displays.
  9. 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.

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