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

Creating a new gateway instance

You create Web services gateway instances to partition the total set of gateway and proxy services into logical groups to allow simpler management. Note that destinations are already partitioned by the service integration bus, so each gateway instance is limited to gateway and proxy services within the same bus. However, gateway services can then map to target services that are available on other buses.

To create a new gateway instance, complete the following steps:

  1. Start the administrative console.
  2. In the navigation pane, click Service integration > Buses > [Content Pane] bus_name > Web service gateway instances. The gateway instances collection form is displayed.
  3. Click New. The gateway instances settings form is displayed.
  4. Type the following general properties:
    Name
    Type the name by which the gateway instance 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: \ / , # $ @ : ; " * ? < > | = + & % '
    Description
    Type the (optional) description of the gateway instance.
    Gateway namespace
    Type the namespace that you want to use for the gateway services in exported WSDL documents. There is no fixed syntax for the gateway namespace, but whatever name you choose is likely to be more effective if it observes the following guidelines:
    • The name begins with urn:

      See the guidance on Internet standards for the syntax of Uniform Resource Names (URNs) at http://www.ietf.org/rfc/rfc2141.txt.

    • The name is globally unique.
    • The name reflects your company name.
    Default proxy WSDL URL

    Type the location (Web address) of the default proxy WSDL file.

    A gateway service that runs in proxy mode has no actual target services and therefore no WSDL that the gateway can use to configure the service invocation. A generic template WSDL file is used to configure the basic parameters for the invocation call. For more information, see JAX-RPC handlers and proxy operation.

    The supplied template WSDL is located at
    http://host_name:port_number/sibws/proxywsdl/ProxyServiceTemplate.wsdl
    where host_name and port_number are the host name and port number for this application server. For example
    http://your.server.name:4080/sibws/proxywsdl/ProxyServiceTemplate.wsdl
    Alternatively, you can supply the URL for your own equivalent template.
    Note: You can also override the default proxy WSDL, and supply an alternative WSDL, for an individual proxy service using the administrative console option Service integration > Buses > [Content Pane] bus_name > Web service gateway instances > [Content Pane] instance_name > Proxy Services > [Content Pane] service_name.
  5. Click OK.
If the processing completes successfully, the list of gateway instances is updated to include the new gateway instance. Otherwise, an error message is displayed.

You are now ready to configure gateway services or proxy services for this gateway instance.

Related tasks
Modifying an existing gateway instance
Deleting gateway instances
Related information
Web service gateway instances 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\twsg_gwinst_new.html

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