Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)
modifyJAXWSHandler command
Use the modifyJAXWSHandler command to modify a Java API for XML-based Web Services (JAX-WS) handler configuration for a handler that is used, as part of a handler list, with v7.0 WS-Notification services.
We can modify a JAX-WS handler configuration by using the wsadmin tool as described in this topic, or by using the admin console as described in Modify an existing JAX-WS handler configuration.
If you modify a handler class but do not change the class name, you 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.
To run the command, use the AdminTask object of the wsadmin scripting client.
Command-line help is provided for service integration bus commands:
- For a list of the available WS-Notification commands, plus a brief description of each command, run at the wsadmin prompt:
print AdminTask.help('WSNotificationCommands')
- For overview help on a given command, run at the wsadmin prompt:
print AdminTask.help('command_name')
After using the command, save changes to the master configuration; for example, by using the following command:
AdminConfig.save()
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. This command modifies a JAX-WS handler configuration that can be used, as part of a handler list, with v7.0 WS-Notification services.
The configuration object associates a unique name (the name parameter) with a Java class (the className parameter) that refers to the JAX-WS handler implementation.
Target Object
A JAX-WS handler configuration object.
Required parameters
-name
The name of the JAX-WS handler configuration object. 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.
-className
The name of the JAX-WS handler class that this configuration object represents. This name must be a fully qualified java class name. For example com.ibm.jaxws.handler.TestHandler.
If you change the class name, 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 Load 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.
Conditional parameters
None
Optional parameters
-description
A description of the JAX-WS handler.
Example
Modify the configuration for a particular JAX-WS handler class:
### Jython
AdminTask.modifyJAXWSHandler(JAXWSHandler, ["-name", "newHandler1", "-className", "newHandlerClass", "-description", "newDesc"] )### Jacl
$AdminTask modifyJAXWSHandler JAXWSHandler {-name newHandler1 -className newHandlerClass -description newDesc}
WS-Notification
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification
Load JAX-WS handler classes
Modify an existing JAX-WS handler configuration
Related
WS-Notification troubleshooting tips
JAX-WS Handlers [Settings]