Modifying the notification plug-in properties file

You enable your own notifiers by modifying the default notification plug-in properties file.

The default notification plug-in properties file installed with the registry is as follows:

# begin_generated_IBM_copyright_prolog
#
# Licensed Materials - Property of IBM
# 5724-N72
# (c) Copyright IBM Corp. 2006 All Rights Reserved
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with
# IBM Corp.
#
# end_generated_IBM_copyright_prolog
#
# Notifier classes called by the default service registry notification 
# functions
#
# These notifiers are called for all document types
notifiers=com.ibm.sr.api.ServiceRegistryNotifierJMS
# These notifiers are called for governed objects only
notifiers=com.ibm.sr.api.ServiceRegistryNotifierJMS

Additional notifiers can be added by editing the properties file and updating the content stored in the registry. For example, to add a new "SampleNotifier" the properties file might be updated to contain:

notifiers=com.ibm.sr.api.ServiceRegistryNotifierJMS, com.sample.SampleNotifier
governanceNotifiers=com.ibm.sr.api.ServiceRegistryNotifierJMS

The properties files are in the format of standard Java™ properties files. Lines beginning with a # character are comments and are ignored, other lines are of the form <key> = <values>.

The <values> are a comma-separated list of class names of the required notifier classes. Any classes listed must be available on the class path of the application server and must implement the appropriate ServiceRegistryNotifier interface.

The following <keys> can be used:

Key	Description
notifiers	These notifiers are invoked for all object types
governanceNotifiers	These notifiers are invoked only if the object is part of a governed lifecycle. These notifier must implement the ServiceRegistryGovernanceNotifier interface.
notifiers.<objectType>	These notifiers are invoked only if the object is of the specified <objectType>. Currently supported <objectTypes>include: WSDLDocument, XSDDocument, PolicyDocument, XMLDocument, GenericObject.
notifiers.classification.<classification>	These notifiers are invoked only if the object is classified by the <classification> URI. Note: Because of limitations in Java properties files this key cannot contain any ‘:' (colon) characters. These must be removed from any classification URI specified.

The same notifier class can be listed against more than one key, but it will only ever be invoked once for any given object operation.

Disabling the JMS notifier

If you are not using the Email notification service, and you are not using your own JMS client that subscribes to a WSRR JMS notifier topic, you can obtain a performance benefit by disabling the JMS notifier. You do this by setting the jmsNotification parameter in the notification plug-in properties file. The format of this parameter is as follows:

jmsNotification=enabled-flag,time-to-live-value

where enabled-flag is a boolean value that determines whether the JMS notifier is enabled, and time-to-live-value specifies the time, in days, after which JMS messages are automatically deleted from the queue; specifying a time-to-live-value of 0 means that JMS messages are never deleted.

To disable the JMS notifier, specify the following setting:

jmsNotification=false,0

The default setting is as follows:

jmsNotification=true,7

If you are using the Email notification service, or your own JMS client, you must enable the JMS notifier.