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

Creating a new inbound service configuration

This topic assumes that you already have an internal service that you want to configure as an inbound service, and that the internal service is available at a service integration bus destination.

You must also create a template WSDL file that describes the service, and make the WSDL available at a URL or through a UDDI registry. For information on how to create a WSDL file, see Developing a WSDL file.

When you create a new inbound service, you associate it with one or more of the following resources: You choose each of these resources from a selection list of resources that you have previously configured, so you must configure each resource before you configure a Web service that uses it.

An inbound service is a Web interface to a service that is provided internally (that is, a service provided by your own organization and hosted in a location that is directly available through a service integration bus destination). To configure a locally-hosted service as an inbound service, you associate it with a service destination, and with one or more endpoint listeners through which service requests and responses are passed to the service. You can also choose to have the local service made available through one or more UDDI registries.

You can create a new inbound 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 inbound service through the command line. For more information see the corresponding troubleshooting tip.

To create a new inbound 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 > Inbound Services. The inbound services collection form is displayed.
  3. Click New. The New inbound service wizard is displayed.
  4. Use the wizard to create the new inbound service configuration by completing the following steps. For more information about the properties that you set with the wizard, see Inbound services settings.
    1. Select the service destination and template WSDL location.
      Note: The template WSDL is the service-specific WSDL file that you have created to describe this inbound service.
    2. Select the service from the template WSDL.
      Note:
      • This option is needed in case there is more than one service in the template WSDL. The field is filled in for you by default. If there is only one service in the WSDL, accept the default.
    3. Specify the name of the inbound service and select the endpoint listeners.
      Note:
      • You need not supply a name for the inbound service. If you choose not to supply a name, a default name is created. The default name is derived from the service destination name, with characters that are invalid for names filtered out.
      • An inbound port is automatically created for each endpoint listener that you select. Each inbound port is created without a template port, JAX-RPC handler list or security settings and is given a default name that relates to the endpoint listener selected. For an overview of the relationship between endpoint listeners and inbound ports, see Endpoint listeners and inbound ports - entry points to the service integration bus.
    4. Define any UDDI publication properties.
      Note: The wizard allows you to specify the UDDI publication properties that are used to publish this inbound service to an initial UDDI registry. After you create an inbound service through the wizard, you can use the modify an existing inbound service configuration option to publish the service to more UDDI registries. For information about the UDDI publication properties, see UDDI Publication settings and UDDI registries - Web service directories that can be referenced by service integration technologies.
  5. Click Finish.
If the processing completes successfully, the list of inbound services for this service integration bus is updated to include the new inbound service. Otherwise, an error message is displayed.

If you want to secure your new inbound service, or to apply any JAX-RPC handler lists to the ports for the service, or publish the service to more UDDI registries, use the administrative console to modify your inbound service configuration.

Related tasks
Modifying an existing inbound service configuration
Deleting inbound services configurations
Publishing a Web service to a UDDI registry
Related reference
Creating a new inbound service configuration through the command line
Refreshing the inbound service WSDL file through the command line
Publishing to UDDI the inbound service WSDL file through the command line
Removing from UDDI the inbound service WSDL file through the command line
Related information
Inbound Services settings
Inbound 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_in_new.html

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