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

Creating a new JAX-RPC handler list

Use this task to create a Java API for XML-based Remote Procedure Call (JAX-RPC) handler list 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.

Why and when to perform this task

To enable JAX-RPC handlers to perform more complex operations, you chain them together into handler lists. You can then associate each JAX-RPC handler list with one or more ports, so that the handler list can monitor activity at the port, and take appropriate action depending upon the sender and content of each message that passes through the port.

To create a new JAX-RPC handler list, complete the following steps:

Steps for this task

  1. Start the administrative console.
  2. In the navigation pane, click Service integration > Web services > JAX-RPC handler lists. The JAX-RPC handler lists collection form is displayed.
  3. Click New. The JAX-RPC handler lists settings form is displayed.
  4. Type the following general properties:
    Name
    Type the name by which the handler list 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: \ / , # $ @ : ; " * ? < > | = + & % '
    For example TestList.
    Description
    Type 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 handlers from the list of available JAX-RPC handlers, then click Add to move the selected handlers into 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.
  5. Click OK. The general properties for this item are saved.
  6. Apply the changes.
If the processing completes successfully, the list of handler lists is updated to include the new handler list. Otherwise, an error message is displayed.
To use this handler list, select it for use with a Web service as described in Configuring Web services for a service integration bus.
Related concepts
Service integration technologies and JAX-RPC handlers

Task topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\tasks\tjw_jaxrpc_handler_list_new.html

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