WS-Notification services [Settings]

A WS-Notification service provides access to service integration bus resources for Web services publish and subscribe clients.

To view this pane in the console, click one of the following paths:

  • Service integration > Web services > WS-Notification services > [Content Pane] service_name
  • Service integration > Buses > [Content Pane] bus_name > [Services] WS-Notification services > [Content Pane] service_name

A WS-Notification service provides the ability to expose some or all of the messaging resources defined on a service integration bus for use by WS-Notification applications.

A JAX-RPC handler list and WS-Security bindings define the parameters and security policy that are used when making outbound Web service invocations. These invocations include operations such as outbound event notification (in response to a subscribe operation) and controlling demand based publishers (subscribe, pause and resume).

Configuration tab

Configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.

General properties

Name

The name of the WS-Notification service.

The name forms part of the endpoint on which the service is exposed (that is, the URL used to access the WS-Notification service points that are defined under the service).
Required No
Data type Text

Service integration bus name

The name of the service integration bus with which the WS-Notification service is associated.

Required No
Data type Text

Description

An optional description of the WS-Notification service.

Required No
Data type Text area

Enable dynamic topic namespaces?

Indicates whether dynamic topic namespaces can be used within the WS-Notification service.

That is, whether this service allows dynamic topic namespaces to be created at run time.

A dynamic topic namespace does not require manual administration through the administration console or scripting. A dynamic topic namespace is used automatically in response to a request from a WS-Notification application for a topic namespace URI that has not been defined as a permanent topic namespace (assuming the WS-Notification service has been configured to permit use of dynamic namespaces).

A dynamic topic namespace has the following characteristics:
  • It does not support interoperation between WS-Notification applications and other clients of the bus such as JMS.
  • It is not possible to apply topic namespace documents to this topic space, and thus the structure and content of the topic space are unrestricted.
  • It cannot be used as part of the configuration of service integration bus links or a publish and subscribe bridge.

Use this option to tightly control the topic namespaces that are used when connecting to a particular WS-Notification service (for example for security or auditing requirements). If you deselect this option, any applications that connect to the WS-Notification service and request topics from a dynamic topic namespace are stopped from publishing or receiving messages.

All messages published to a dynamic topic namespace are inserted with the default message reliability setting of reliable persistent. If this value is not acceptable, create a permanent topic namespace and manually configure the attribute to the appropriate value.

Note: The dynamic topic namespaces used on a particular WS-Notification service are backed by a service integration bus topic space that is created automatically when you create the topic namespace. The syntax of topics used within this topic space is internal to the WS-Notification service implementation.
Required No
Data type Check box

Dynamic topic space name

The name of the service integration bus topic space to be used as the dynamic topic space for this WS-Notification servce.

That is, the name of the bus topic space that is used to host the ad-hoc topic namespace, and to host dynamic topic namespaces if they are permitted.
Required No
Data type Text

Requires registration

Indicates whether publisher applications are required to register with the broker before they can publish notifications.

Required No
Data type Check box

Fixed topic set

Indicates whether the list of topics supported by the notification broker is fixed or may vary at runtime.

Required No
Data type Check box

Topic expression dialects

List of topic dialects supported by this WS-Notification service.

That is, the name of the chosen topic dialect as defined by the WS-Topics specification:
  • Simple topics. That is, single-level root topics with no wildcards. For example "stock".
  • Concrete topics. That is, multi-level topics with no wildcards. For example "stock/IBM", "sport/football/results".
  • Full topics. That is, multi-level topics with wildcards and conjunctions. For example "stock//.", "sport/football/*", "sport/*/results", "t1/t3 | t3/t4".
Required No
Data type Text area

JAX-RPC handler list

The JAX-RPC handler list that is applied to inbound service requests for the WS-Notification service.

Required No
Data type drop-down list

Outbound security request binding

The security binding to be used with consumer notifications and remote publisher requests sent by this WS-Notification service.

Required No
Data type drop-down list

Outbound security response binding

The security binding to be used with remote publisher responses received by this WS-Notification service.

Required No
Data type drop-down list

Outbound security configuration

Specifies the details of how security is applied to requests and responses.

Required No
Data type drop-down list

Additional properties

WS-Notification service points
Select this link to configure the deployment of WS-Notification service points on one or more servers.
Permanent topic namespaces
Select this link to configure permanent topic namespaces for the WS-Notification service.
When you create a new permanent WS-Notification topic namespace, you specify the namespace and associate it with one of the service integration bus topic spaces configured on the bus on which the parent WS-Notification service is defined. You cannot modify a permanent topic namespace after it has been created, other than to apply or remove topic namespace documents.
Custom properties
Select this link to configure additional custom properties for this WS-Notification service.
These custom properties are name and value pairs that you can use to set internal system configuration properties. In each pair, the name is a property key and the value is a string value.
To specify a timeout time for outbound requests sent from this WS-Notification service, set the following custom property:
outbound.timeout
The value of this property is the timeout time in milliseconds. If the property is not set, a default timeout of 2 minutes is used.
To determine the strictness of the syntax checking of topics used under this WS-Notification service, set the following custom property:
com.ibm.ws.sib.wsn.strictTopicChecking
Valid values for this property are TRUE and FALSE:
  • If the property value is set to TRUE, the topic syntax rules defined in the WS-Topics specification are strictly enforced. Note that there is a performance overhead compared to the default setting, because each character of a topic is validated against a large list of permitted Unicode characters.
  • If the property is omitted or set to FALSE, syntax checking only ensures that the basic topic structure is valid, and character checking is relaxed to allow any character except * (asterisk) and . (dot) as a topic name part.

Runtime tab

Runtime properties for this object. These properties directly affect the current runtime environment, but are not preserved when that environment is stopped. To preserve runtime property values, change the equivalent property values on the Configuration tab. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.

Additional properties

Subscriptions
This collection lists the subscriptions that have been created on the associated bus member or members by WS-Notification applications. Use this panel to view the information about a subscription, such as the topic on which the subscription is registered and the time at which it is currently set to expire. You can also delete a subscription using the button provided.
Publisher registrations
The set of applications that are currently registered as publishers with the notification broker.
Pull points
This collection lists the pull points that have been created on the associated bus member or members by WS-Notification applications. Use this panel to view the information about a pull point, such as the subscription with which it is associated and the time at which it is currently set to expire. You can also delete a pull point using the button provided.



Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=WSNService_DetailForm
File name: WSNService_DetailForm.html