Modifying an existing outbound service configuration

Modify the configuration details for an outbound service. For example: secure the service; apply JAX-RPC handler lists to the ports for the service; publish the service to more than one UDDI registry.

1. Start the administrative console.
2. In the navigation pane, click Service integration -> Buses -> bus_name -> [Services] Outbound Services.
   A list of outbound services is displayed in an outbound services collection form.
3. Click the name of an outbound service in the list.
   The current settings for this outbound service are displayed.
4. Optional: Click Reload WSDL to reload the external WSDL file for this outbound service.
   Note:

   • When you create a new outbound service, a copy of the external WSDL file for the service is loaded into a locally-maintained repository. If the external service provider changes the WSDL file, you must update the local copy.
   • When you click Reload WSDL, you run the command that is described in Refreshing the outbound service WSDL file by using the wsadmin tool. For the command to complete successfully, the conditions must be met that are described in that topic.
   • If the bus needs to pass messages through an authenticating proxy server to retrieve WSDL documents, then you cannot use the Reload WSDL option and you must run the refresh WSDL command by using the wsadmin tool. For more information see the corresponding troubleshooting tip.
5. Modify the general properties. For information about each of these properties, see Outbound services settings.
   Note:

   • When you change an outbound service name, the system looks up all objects that refer to it and updates the name. Any replacement name that you choose must be unique within the current service integration bus. If you enter a name that is not unique, an error message is displayed.
   • You cannot change the Service destination name. However, if you click View alongside the name, you can view and modify the configuration information for the service destination.
   • If you change the WSDL location information (that is the fields WSDL location type, WSDL location and WSDL UDDI Registry), then click Apply, the outbound service WSDL file is reloaded. Therefore you should click Apply after you make any changes to the WSDL location information and before you change any of the WSDL-derived fields (for example WSDL service name, and list of available ports).
   • Although logically the WSDL service name and namespace are only required if there is more than one service in the WSDL, the fields that you use to set them are coded within the administrative console as compulsory fields. They are filled in for you by default, so if they are not logically required for your service you should leave the default values. If you remove the value from either field, the administrative console treats the empty field as an error.
   • The list of available ports from which you choose the Default port name is a subset of the ports that are described in the WSDL file. You chose this subset when you created or last modified this outbound service. To add or remove available ports, use the additional properties option Outbound Ports.
   • 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 drop-down list. This list contains all mediations, including port selection mediations, that are currently deployed to this service integration bus.
   • Bus members are application servers or clusters that are added to this bus. The Bus member property defines the bus member to which the port selection mediation is assigned. If you change the Port selection mediation property value to (none), you should also change the Bus member property value to (none). If you want to use a port selection mediation, assign it to a bus member. If you do not do this, the administrative console displays an error message.
   • If you select the option to Enable operation-level security then you must also complete, for this outbound service, the steps described in Password-protecting a web service operation.
6. Modify the additional properties.
   1. Modify the ports that are associated with this outbound service.
      For information about the properties of outbound service ports, see Outbound ports settings.

      Note:

      • Requests and responses to an outbound service can be sent across any binding (for example SOAP over HTTP or SOAP over JMS) that is available to both the service integration bus and the external web service. Each available binding is represented by a port.
      • You can use a JAX-RPC handler list to monitor activity at the port, and take appropriate action (for example logging or re-routing) depending upon the sender and content of each message that passes through the port. If the external web service requires HTTP basic authentication, you can use a JAX-RPC handler list to provide an HTTP basic authentication header.
      • You can use WS-Security to set the levels of security to be applied to messages. The security level can be set independently for request and response messages. For more information, see Service integration technologies and WS-Security.
      • You can set the levels of security to be applied to messages. The security level can be set independently for request and response messages.
      • The service integration technologies require access to the Internet to invoke an outbound service or to retrieve a target service WSDL file. If you use a proxy server in support of Internet routing, and if your proxy server requires authentication before it grants access to the Internet, then you must enable proxy server authentication.
   2. Modify the custom properties, if any, that you have set for this outbound service.
      These custom properties are name and value pairs that you can use to set internal system configuration properties. In each pair, the name is a property key and the value is a string value.
7. Save your changes to the master configuration.