Notification Manager

Note: this component has a complexity level of "expert", which means that objects of this type are not expected to be created or altered. Please contact support for assistance if you believe that you have a need to create or modify this type of object.

Note: this is an abstract component that cannot be instantiated.

Notification Managers may be used to deliver notification of changes that match one or more subscriptions.

Direct Subcomponents Relations to This Component Properties dsconfig Usage

Direct Subcomponents

The following Notification Managers are available in the server :

These Notification Managers inherit from the properties described below.

Relations to This Component

The following components have a direct aggregation relation to Notification Managers:

Properties

The properties supported by this managed object are as follows:


Basic Properties: Advanced Properties:
 description  monitor-entries-enabled
 enabled
 subscription-base-dn
 transaction-notification

Basic Properties

description

Description
A description for this Notification Manager
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
No
Admin Action Required
None. Modification requires no further action

enabled

Description
Indicates whether this Notification Manager is enabled within the server.
Default Value
None
Allowed Values
true
false
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

subscription-base-dn

Description
Specifies the DN of the entry below which subscription data is stored for this Notification Manager. This needs to be in the backend that has the data to be notified on, and must not be the same entry as the backend base DN. The subscription base DN entry does not need to exist as it will be created by the server.
Default Value
None
Allowed Values
A valid DN.
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action

transaction-notification

Description
Specifies how the operations in an external transaction (e.g. a multi-update extended operation or an LDAP transaction) are notified for this Notification Manager. By default, each operation in an external transaction is treated individually such that a separate notification is delivered for each matched operation. Alternatively, a single notification can be delivered for each transaction containing one or more matched operations, in which case the notification can include all operations in the transaction, or just the operations that were matched.
Default Value
individual
Allowed Values
individual - A separate notification is delivered for each matched operation.

matched-operations - All matched operations in a transaction are included in a single notification.

all-operations - All operations in a transaction are included in a single notification.
Multi-Valued
No
Required
Yes
Admin Action Required
None. Modification requires no further action


Advanced Properties

monitor-entries-enabled (Advanced Property)

Description
Enables monitor entries for this Notification Manager.
Default Value
true
Allowed Values
true
false
Multi-Valued
No
Required
No
Admin Action Required
None. Modification requires no further action


dsconfig Usage

To list the configured Notification Managers:

dsconfig list-notification-managers
     [--property {propertyName}] ...

To view the configuration for an existing Notification Manager:

dsconfig get-notification-manager-prop
     --manager-name {name}
     [--tab-delimited]
     [--script-friendly]
     [--property {propertyName}] ...

To update the configuration for an existing Notification Manager:

dsconfig set-notification-manager-prop
     --manager-name {name}
     (--set|--add|--remove) {propertyName}:{propertyValue}
     [(--set|--add|--remove) {propertyName}:{propertyValue}] ...

To delete an existing Notification Manager:

dsconfig delete-notification-manager
     --manager-name {name}