createJAXWSHandler command

Use the createJAXWSHandler command to create a new Java™ API for XML-based Web Services (JAX-WS) handler configuration so that the handler can be used, as part of a handler list, with Version 7.0 WS-Notification services.

You can create a new JAX-WS handler configuration by using the wsadmin tool as described in this topic, or by using the administrative console as described in Creating a new JAX-WS handler configuration.

This task assumes that you have already created your handler. You can do this by using IBM® Rational® Application Developer or a similar tool. You must also make the 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) that you want to monitor, as detailed in Loading JAX-WS handler classes.

To run the command, use the AdminTask object of the wsadmin scripting client.

[IBM i][IBM i]The wsadmin scripting client is run from Qshell. [IBM i]For more information, see Configuring Qshell to run WebSphere scripts using wsadmin scripting.

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, enter the following command at the wsadmin prompt:

    print AdminTask.help('WSNotificationCommands')

  • For overview help on a given command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After using the command, save your changes to the master configuration by using the following command:

AdminConfig.save()

Purpose

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 creates a new JAX-WS handler configuration so that the handler can be used, as part of a handler list, with Version 7.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 cell scope 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: \ / , # $ @ : ; " * ? < > | = + & % '
-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.
Note: You 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

Create the configuration for a particular JAX-WS handler class:
  • Using Jython:
    targetCell = AdminConfig.list('Cell')
    JAXWSHandler = AdminTask.createJAXWSHandler(targetCell, 
    ["-name", "handler1", "-className", "handlerClass", "-description", "desc"])
  • Using Jacl:
    $AdminTask createJAXWSHandler targetCell 
    {-name handler1 -className handlerClass -description desc}

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: March 5, 2017 17:54
File name: rjwsn_cli_jaxws_handler_new.html