deleteWSNService command

Use the deleteWSNService command to delete a WS-Notification service and associated resources. A WS-Notification service provides access to service integration bus resources for web services publish and subscribe clients.

You can delete a WS-Notification service by using the wsadmin tool as described in this topic, or by using the administrative console.

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.

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

This command deletes the specified WS-Notification service and all the objects configured on the service:
  • For Version 7.0 WS-Notification services, the WS-Notification service points and the associated service point application are deleted.
  • For Version 6.1 WS-Notification services, the WS-Notification service points and the associated service integration bus inbound ports are deleted.
  • WS-Notification permanent topic namespaces and any service integration bus topic spaces that were created by the topic namespace are deleted.
  • Topic namespace documents defined for the permanent topic namespaces, and (for Version 6.1 WS-Notification services) the associated XML documents stored in an SDO repository are deleted.

Target object

WSNService

Required parameters

None.

Conditional parameters

None.

Optional parameters

-deleteSIBTopicSpaces
TRUE or FALSE. Indicates whether service integration bus topic spaces created by definition of a WS-Notification permanent topic namespace should also be deleted (default is FALSE).

Example

Delete the WS-Notification service newService created in the example from the topic about creating a new WS-Notification service by using the wsadmin tool.
  • Using Jython:
    AdminTask.deleteWSNService(newService, ["-deleteSIBTopicSpaces", "TRUE"])
  • Using Jacl:
    $AdminTask deleteWSNService $newService {-deleteSIBTopicSpaces TRUE}