Modifying an existing JAX-RPC handler list

A Java™ API for XML-based remote procedure calls (JAX-RPC) handler is a Java class that performs a range of handling tasks. For example: logging messages, or transforming their contents, or terminating an incoming request. Modify the configuration details for a JAX-RPC handler list that has been configured for use with service integration bus-deployed web services.

Before you begin

You can only add previously-configured handlers to a handler list. To configure a handler, see Creating a new JAX-RPC handler configuration.

About this task

Handlers monitor messages at ports, and take appropriate action depending upon the sender and content of each message. To enable handlers to undertake more complex operations, you chain them together into handler lists. The approach taken in WebSphere® Application Server is to apply handler lists (rather than individual handlers) at the ports, where each handler list contains one or more handlers.

To list the existing handler lists, and to view and modify their configuration details, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Service integration -> Web services -> JAX-RPC Handler Lists.
    A list of all the handler lists is displayed in a JAX-RPC handler lists collection form.
  2. Click the name of a handler list in the list.
    The current JAX-RPC handler lists settings for this handler are displayed.
  3. Modify the following general properties:
    Name
    Modify the name of the handler list.
    This name must be unique, and it must obey 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: \ / , # $ @ : ; " * ? < > | = + & % '

    When you change a handler list name, the system looks up all objects that refer to it and updates the name.

    Description
    Modify the (optional) description of the handler list.
    JAX-RPC handlers
    In the JAX-RPC handlers pane, complete the following steps:
    1. Select one or more previously-configured handlers from either the list of available JAX-RPC handlers or the list of handlers for this JAX-RPC handler list, then click Add or Remove to modify the list of handlers for this JAX-RPC handler list.
    2. Select a handler in the list of handlers for this JAX-RPC handler list, then click Up or Down to change the position of the handler within the list.
    Handlers are applied in the sequence in which they appear in the handler list.
    Note: If you click Reset, only the Name and Description fields are reset to their state when the form was first loaded. The two lists of available and assigned handlers are not reset.
  4. Save your changes to the master configuration.

Results

If the processing completes successfully, the list of handler lists is redisplayed. Otherwise, an error message is displayed.

What to do next

To use this handler list, select it for use with a web service as described in Modifying an existing inbound service configuration or Modifying an existing outbound service configuration.