WAS v8.5 > Administer applications and their environment > Administer web services - Notification (WS-Notification) > Use WS-Notification for publish and subscribe messaging for web services > Configure WS-Notification resources > Configure WS-Notification resources > Configure JAX-WS handlers > Create a new JAX-WS handler configuration

Modify an existing JAX-WS handler configuration

Modify a Java API for XML-based Web Services (JAX-WS) handler configuration for a handler used, as part of a handler list, with JAX-WS based v7.0 WS-Notification services.

We can modify a JAX-WS handler configuration using the dmgr console as described in this topic, or using the modifyJAXWSHandler command.

If we modify a handler class but do not change the class name, we do not have to modify the handler configuration as described in this topic. You just have to stop then restart the servers or clusters that host the services or service points that this handler monitors.

A Java API for XML-based Web Services (JAX-WS) 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. We can use the dmgr console to list existing handler configurations, and to view and modify their configuration details.

1. Start the dmgr console.
2. Navigate to Service integration -> WS-Notification -> JAX-WS Handlers. A list of handlers is displayed in a JAX-WS handlers collection form.

3. Click the name of a handler in the list. The current JAX-WS handlers settings for this handler are displayed.

4. Modify the following general properties:

   Name

   Modify the name of the handler.

   This name must be unique at cell scope, 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 name, the system looks up all objects that refer to it and updates the name.

   Description

   Modify the (optional) description of the handler.

   Class name

   Change the name of the class that is to be instantiated.

   If we change the class name, you must also make the new handler class available to the server or cluster that hosts the WS-Notification service points (for inbound invocation handling) or WS-Notification services (for outbound invocation handling) to monitor, as detailed in Loading JAX-WS handler classes.

   We can configure multiple instances of a handler by creating each instance with a different handler name, and pointing to the same handler class.

5. Save your changes to the master configuration.
   

Results

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

Related concepts:

WS-Notification

Related

Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification

Reference:

WS-Notification troubleshooting tips
modifyJAXWSHandler command
showJAXWSHandler command

Related information:

Delete JAX-WS handler configurations
JAX-WS Handlers [Settings]

+

Search Tips   |   Advanced Search