Viewing and updating web service export bindings

Using the administrative console, you can view information about a web service export binding (including the WSDL file) and configure properties of the associated web module. For the Java™ API for XML Web Services (JAX-WS) bindings, you can also configure a policy set for the binding.

Before you begin

To perform this task, you must have permission to change the master configuration.

About this task

The steps for administering web service bindings depend on the type of binding:

  • For JAX-RPC bindings, you can view attributes of the binding.
  • For JAX-WS bindings, you can view attributes of the binding and configure policy sets.

A policy set is a collection of policy types, each of which provides a quality of service. These types have been configured and can be associated with a web service provider or consumer.

Policy sets work in pairs. You must have the same policy set on the service requester as on the service provider. Therefore, you should have the same policy set on the export binding as on the client.

Note: The Policy set attachments section of the administrative console page appears only for JAX-WS bindings. It does not appear for JAX-RPC service bindings.

Procedure

  1. Select the module that contains the binding by navigating to Applications > SCA Modules and clicking the module name.
  2. Select the binding by performing the following steps:
    1. In the Module components section, expand Exports.
    2. Expand the export, and then expand Binding.
    3. Click the binding to view information about its properties.
      • In the General Properties section, view the name, port, and location (endpoint address) of the web service.
      • From the Related Properties list, click the interface to view the Web Services Description Language (WSDL) file that is associated with the web service.
  3. To change properties that are associated with the web module, click one of the following properties in the Web Module Properties list:
    • Click Manage Export Binding Web Module to view or edit deployment-specific information for a web module. For example, you can edit the Starting weight, which specifies the priority of this module during server startup.
    • Click Context Root to view the web module name and Uniform Resource Identifier (URI) and edit the context root.
    • Click Virtual Hosts to specify the virtual host for the web module. Virtual hosts let you associate a unique port with a module or application.
    • Click JSP reload options for Web modules to specify information about the reloading of JavaServer Pages (JSP) files (such as the number of seconds to scan a file system for updated JSP files).
    • Click Session management to specify information about HTTP session support. For example, you can set the number of minutes before a session times out.
  4. For JAX-WS bindings only, configure policy sets for export bindings by performing the following tasks:
    1. Optional: Expand Preferences, indicate the maximum number of rows and whether you want to retain the filter criteria, and click Apply.
    2. Optional: Select the filter icon if you want to use a filter to search the table.
    3. Select the export binding, and click Attach to attach a policy set to the binding, or click Detach to remove the policy set.
    4. To assign a policy set binding, select the export binding, click Assign Binding, and provide a name for the policy set binding.
    5. Repeat steps 4.c and 4.d for each binding you want to configure.
    6. Save the changes to the master configuration.

Results

If you made any updates, the binding is changed for the selected module. The changes take effect after you restart the SCA module.
Restriction: If the module is redeployed, the configuration changes you made are replaced by the original settings.

To ensure that the changes you made remain with the module across deployments, use IBM Integration Designer to make the changes in the source code for the module.