WAS v8.5 > Administer applications and their environment > Administer web services - Bus enabled web services > Enable web services through the service integration bus > Administer the bus-enabled web services resourcesCreate a new UDDI reference
Create a reference (a pointer) to a UDDI registry for use with service integration bus-enabled web services.
This topic assumes that we have already created a J2C authentication alias for each Authorized Name 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. 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, we can create entries for the web service in one or more UDDI registries.
- When you configure an outbound service, we 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...
- Start the dmgr console.
- In the navigation pane, click Service integration -> Web services -> UDDI References. The UDDI references collection form is displayed.
- Click New. The UDDI references settings form is displayed.
- 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. We 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.
- 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.
To use this UDDI reference, select it when Make an internally-hosted service available as a web service or Make an externally-hosted web service available internally.
Subtopics
- Modify an existing UDDI reference
Modify the configuration details for a UDDI reference that has been configured for use with service integration bus-enabled web services.- Delete UDDI references
delete UDDI references configured for use with service integration bus-deployed web services.- Publishing a web service to a UDDI registry
When you configure an inbound or outbound service, you enable UDDI interaction by associating the service with a UDDI reference, and (depending upon what you are trying to do) either or both of the following pieces of information: The business key that identifies the UDDI business category under which we want our service to appear in the UDDI registry, and the service-specific part of the service key the UDDI registry assigns to your service. To help you understand what UDDI business keys and service keys are, and where you find them in a UDDI registry, here is a description of how to publish a web service to a UDDI registry.
Related concepts:
UDDI registries: Web service directories that can be referenced by bus-enabled web services