Creating a new WS-Notification service point using the wsadmin tool

Use a command script to create a new WS-Notification service point. A WS-Notification service point defines access to a WS-Notification service on a given bus member through a specified Web service binding (for example SOAP over HTTP). Applications use the bus members associated with the WS-Notification service point to connect to the WS-Notification service. The existence of a WS-Notification service point causes Web service endpoints for the notification broker, subscription manager and publisher registration manager for this WS-Notification service to be exposed on the server with which the service point is associated. WS-Notification applications use these endpoints to interact with the WS-Notification service.

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

The wsadmin scripting client is run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere® Application Server scripts".

This command is only valid when used with WebSphere Application Server Version 6.1 and later application servers. Do not use it with earlier versions.

Command-line help is provided for service integration bus commands:

Purpose

This command creates the following resources:
  • It creates a new WS-Notification service point on a WS-Notification service.
  • It creates the three service integration bus inbound ports that represent the three roles played by the broker, and it creates the association between these objects and the new WS-Notification service point.
  • It creates a new service integration bus endpoint listener if required, and connects the new or existing endpoint listener to the service integration bus with which the WS-Notification service is associated.
Command name
createWSNServicePoint
Target
WSNService
Result
A WS-Notification service point is created.

Required parameters

name
The name of the WS-Notification service point. This appears as part of the address of the Web service that is exposed on the chosen server.

Conditional parameters

server
Name of the server on which the WS-Notification service point is created.
  • If you specify the copyServicePoint parameter, then you need not specify this parameter.
  • If this parameter is used then the node parameter must be specified.
node
Name of the node on which the server is located.
  • If you specify the copyServicePoint parameter, then you need not specify this parameter.
  • If this parameter is used then the server parameter must be specified.

Choose either to configure a new endpoint listener or use an existing one:

eplName
Name of an endpoint listener.
  • If you specify the copyServicePoint parameter, then you need not specify this parameter.
  • If this endpoint listener has already been defined on the chosen server, then the eplURLRoot and eplWSDLServingURLRoot parameters should not be specified. Otherwise, the eplURLRoot and eplWSDLServingURLRoot parameters must both be specified.
eplURLRoot
Root of the externally visible endpoint address URL for Web services accessed using this endpoint listener.
  • If you specify the copyServicePoint parameter, then you need not specify this parameter.
  • If the endpoint listener has already been defined on the chosen server, then this parameter should not be specified.
eplWSDLServingURLRoot
Root of the externally visible HTTP URL where the WSDL file associated with this endpoint listener is located. In most circumstances this is http://host_name:port_number/SIBWS. For more information, see Creating a new endpoint listener configuration or Creating a new endpoint listener configuration using the wsadmin tool.
  • If you specify the copyServicePoint parameter, then you need not specify this parameter.
  • If the endpoint listener has already been defined on the chosen server, then this parameter should not be specified.

Copy the configuration from an existing WS-Notification service point definition:

copyServicePoint
The name of an existing service point configured on the WS-Notification Service from which the other configuration attributes are copied. If you specify this parameter, then you only need to specify the name parameter. All other values are taken from the nominated existing service point.

Optional parameters

description
An optional description of the WS-Notification service point.

Example

In the following examples, the WS-Notification service point uses the WS-Notification service "newService" created in the example from topic "Creating a new WS-Notification service using the wsadmin tool".

Create a WS-Notification service point on "server1" on "node1" and create a new endpoint listener that uses SOAP over HTTP on channel 1, where the host address of the server is "http://myHost:9080":

set newServicePoint [ $AdminTask createWSNServicePoint $newService 
{ -name newServicePoint -node node1 -server server1 -eplName myNewEPL 
-eplURLRoot http://myhost:9080/wsn 
-eplWSDLServingURLRoot http://myhost:9080/sibws } ]



Subtopics
Deleting a WS-Notification service point using the wsadmin tool
Listing WS-Notification service points using the wsadmin tool
Showing the properties of a WS-Notification service point using the wsadmin tool
Related concepts
Learning about WS-Notification
Related tasks
WS-Notification - publish and subscribe messaging for Web services
Securing WS-Notification
Related reference
Creating a new WS-Notification service using the wsadmin tool
Creating a new WS-Notification administered subscriber using the wsadmin tool
Creating a new permanent WS-Notification topic namespace using the wsadmin tool
Applying a WS-Notification topic namespace document using the wsadmin tool
Retrieving a reference to an inbound service using the wsadmin tool
Retrieving a reference to an inbound port using the wsadmin tool
WS-Notification troubleshooting tips
Configuring WS-Notification resources using the wsadmin tool
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 6:03:36 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-base-iseries&topic=rjwsn_cli_wsnservpt_new
File name: rjwsn_cli_wsnservpt_new.html