Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Notification (WS-Notification) > Use WS-Notification for publish and subscribe messaging for web services > Configure WS-Notification resources > Configure WS-Notification resources by > Create a new v6.1 WS-Notification service


Modify a v6.1 WS-Notification service

Modify the description, Enabled dynamic topic namespaces? and Requires registration properties of a WS-Notification service, and follow links to complete advanced configuration of the WS-Notification service such as adding additional WS-Notification service points, or applying topic namespace documents to permanent topic namespaces.

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, for example monitoring outbound event notification (in response to a subscribe operation) and controlling demand-based publishers (subscribe, pause and resume).

When you create a v6.1 WS-Notification service, the wizard configures three service integration bus inbound services for the WS-Notification service, one for each of the three WS-Notification service roles:

These inbound services are defined on the same service integration bus as the v6.1 WS-Notification service, and each of these inbound services refers to the same bus destination.

You can make web services-specific modifications to the WS-Notification service behavior by modifying the three associated inbound services. We can also configure a custom property that determines the strictness of the syntax checking of topics used under this WS-Notification service.

To modify a WS-Notification service use the administrative console...


Procedure

  1. In the navigation pane, click Service integration -> WS-Notification -> Services or Service integration -> Buses -> bus_name -> [Services] WS-Notification services . The WS-Notification services [Collection] form is displayed.

  2. In the content pane, click the name of a WS-Notification service in the list. The current settings for this WS-Notification service are displayed in the WS-Notification services [Settings] panel.
  3. Modify the following general properties:

    Description

    An optional description of the WS-Notification service.

    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. For more information, see Dynamic topic namespace.

    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.

    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.

    Requires registration

    Indicates whether publisher applications are required to register with the broker before they can publish notifications.
  4. Modify the JAX-RPC handler list and Web Services Security settings. These settings are applied to the event notifications exchanged with WS-Notification client applications. For more information about handler lists, see Work with JAX-RPC handlers and clients. For more information about Web Services Security resources, see Configure secure transmission of SOAP messages by using WS-Security.

    JAX-RPC handler list

    The JAX-RPC handler list that is applied to outbound requests from the WS-Notification service - for example the broker delivering notifications to a consumer.

    Outbound security request binding

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

    Outbound security response binding

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

    Outbound security configuration

    Details of how security is applied to requests and responses.
  5. Modify the additional properties:

    WS-Notification service points

    Select this link to configure the deployment of WS-Notification service points on one or more servers. For more information, see Modify a v6.1 WS-Notification service point.

    Permanent topic namespaces

    Select this link to configure permanent topic namespaces for the WS-Notification service. For more information, see Permanent topic namespace. When you create a new WS-Notification permanent 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. We 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 standard are strictly enforced. Note that there is a performance cost 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.

  6. Modify the inbound service settings for the notification broker, subscription manager or publisher registration manager. For more information, see Modify an existing inbound service configuration.
  7. Apply any changes, then click OK. If the processing completes successfully, the list of WS-Notification services is redisplayed. Otherwise, an error message is displayed.

  8. Save your changes to the master configuration. You need not restart the server for the changes to fully take effect if configuration reload is enabled for the service integration bus.


WS-Notification
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification


Related


showWSNService command
http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf
WS-Notification troubleshooting tips
WS-Notification services [Settings]

+

Search Tips   |   Advanced Search