Creating a new UDDI reference

Create a reference (a pointer) to a UDDI registry for use with service integration bus-enabled web services.

Before you begin

This topic assumes that you have already created a J2C authentication alias for each Authorized Name that you want to associate with this UDDI reference. For more information about Authorized Names, see UDDI registries: Web service directories that can be referenced by bus-enabled web services.

About this task

A UDDI reference is a pointer to a UDDI registry. This registry can be a private UDDI registry such as the IBM® WebSphere® UDDI Registry, or a public UDDI registry. The service integration technologies interact with UDDI registries in two ways:
  • When you configure an inbound service, you can create entries for the web service in one or more UDDI registries.
  • When you configure an outbound service, you specify the location of the target WSDL file that describes the web service. This WSDL file can be located at a URL or through a UDDI registry.

In the UDDI model, web services are owned by businesses, and businesses are owned by Authorized Names. Each UDDI reference gives access to the Web services that are owned by a single Authorized Name in a single UDDI registry. For more information about how the service integration technologies work with UDDI registries, see UDDI registries: Web service directories that can be referenced by bus-enabled web services and Publishing a web service to a UDDI registry. For more general information about UDDI and UDDI registries, see the UDDI community at uddi.org.

To create a new UDDI reference, complete the following steps:

Procedure

  1. Start the administrative console.
  2. In the navigation pane, click Service integration -> Web services -> UDDI References.
    The UDDI references collection form is displayed.
  3. Click New.
    The UDDI references settings form is displayed.
  4. Type the following general properties:
    Name
    Type the name by which the UDDI reference is known. This name must be unique, and it must follow the following syntax rules:
    • It must not start with . (a period).
    • It must not start or end with a space.
    • It must not contain any of the following characters: \ / , # $ @ : ; " * ? < > | = + & % '
    You might need more than one UDDI reference for a given UDDI registry. For more information, see UDDI registries: Web service directories that can be referenced by bus-enabled web services.
    Description
    Type the (optional) description of the UDDI reference.
    Inquiry URL
    Type the web address that provides access to this registry for the SOAP inquiry API.
    Publish URL
    Type the web address that provides access to this registry for the SOAP publish API.
    Authentication alias

    Type the J2C authentication alias for the user ID and password of an Authorized Name that has update access to this registry.

    The alias you enter here must match the user ID of the owner of the corresponding business in the UDDI registry. You can see the owning user ID in UDDI by looking at the business details under the Authorized Name field. If the alias you enter here does not match the Authorized Name value for the business that owns the service, then the service is not published or found.

    If the business has more than one Authorized Name, you might want to set up multiple UDDI references (each with a different authentication alias) to the same UDDI registry.

  5. Click OK.

Results

If the processing completes successfully, the list of UDDI references is updated to include the new UDDI reference. Otherwise, an error message is displayed.

What to do next

To use this UDDI reference, select it when Making an internally-hosted service available as a web service or Making an externally-hosted web service available internally.