WebSphere WebSphere Application Server Network Deployment, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Creating a new outbound service configuration

To create an outbound service, you need to know the location of the externally-published WSDL file that describes the service. This WSDL file is either available at a Web address or through a UDDI registry.

If the WSDL file for your outbound service is stored in a UDDI registry, you associate the outbound service with a UDDI reference to the registry. You choose the UDDI reference from a selection list, so you must configure the UDDI reference before you configure a new outbound service that uses it.

An outbound service is a Web service that is hosted externally, and is made available through a service integration bus. To make an externally-hosted service available through a bus, you first associate it with a service destination, then you configure one or more port destinations (one for each type of binding, for example SOAP over HTTP or SOAP over JMS) through which service requests and responses are passed to the external service. You get the port definitions from the WSDL, but you can choose which ones you want to create.

You can create a new outbound service through the command line, or through the administrative console.
Note: If the bus needs to pass messages through an authenticating proxy server to retrieve WSDL documents, then you cannot use the administrative console for this task and you must create your new outbound service through the command line. For more information see the corresponding troubleshooting tip.

To create a new outbound service through the administrative console, complete the following steps:

  1. Start the administrative console.
  2. In the navigation pane, click Service integration > Buses > [Content Pane] bus_name > Outbound Services. The outbound services collection form is displayed.
  3. Click New. The New outbound service wizard is displayed.
  4. Use the wizard to create the new outbound service configuration by completing the following steps. For more information about the properties that you set with the wizard, see Outbound services settings and Outbound ports settings.
    1. Locate the target service WSDL.
    2. Select the service from the WSDL.
      Note:
      • This option is needed in case there is more than one service in the WSDL. The field is filled in for you by default. If there is only one service in the WSDL, accept the default.
      • There needs to be at least one port defined in the service you select.
    3. Select the ports that are to be enabled for this service.
      Note: Select at least one port.
    4. Name the outbound service, the service destination and all of the port destinations.
      Note:
      • Default names are generated, but you can rename them. The default names are unique within the current service integration bus. Any replacement names that you choose must be similarly unique. If you enter a name that is not unique, an error message is displayed.
      • If you have created a port selection mediation and deployed it to the service integration bus, then it is available for selection in the list of mediations. If you do not want to use a port selection mediation with this outbound service, select none from the selection list. This list contains all mediations, including port selection mediations, that are currently deployed to this service integration bus.
      • The list of available ports is a subset of the ports that are described in the WSDL file. You chose this subset in the previous step. If you selected more than one port in the previous step, you should also set the default port to be used unless otherwise specified by a port selection mediation.
    5. Assign each port destination and (optionally) the port selection mediation to a bus member.
      Note:
      • Bus members are application servers or clusters that are added to this bus.
      • The option to assign a port selection mediation to a bus member is only displayed if you selected a mediation in the previous step.
  5. Click Finish.
If the processing completes successfully, the list of outbound services for this service integration bus is updated to include the new outbound service. Otherwise, an error message is displayed.

Because the service is hosted externally, you might also need to enable proxy server authentication for each port to get permission to access the Internet.

If you want to secure your new outbound service, or apply any JAX-RPC handler lists to the ports, or enable proxy server authentication for any of the ports, use the administrative console to modify your outbound service configuration.

Related tasks
Modifying an existing outbound service configuration
Deleting outbound service configurations
Publishing a Web service to a UDDI registry
Related reference
Creating a new outbound service configuration through the command line
Refreshing the outbound service WSDL file through the command line
Adding an outbound port through the command line
Removing an outbound port through the command line
Setting the default outbound port through the command line
Related information
Outbound Services settings
Outbound Ports settings

Task topic

Terms of Use | Feedback

Last updated: 5 Oct 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\tasks\tjw_out_new.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)