Directory Services Change Notification Monitor Initiator

This initiator starts when Directory Services (DS) makes one or more changes to an attribute within a key. This information is used for reporting changes made to DS. This initiator is similar to the IC Change Notification Monitor initiator.

Note: In general, if you must monitor stations (or users and workgroups) for configuration changes, we recommend using the IC Client COM API as the most efficient and safest way to monitor changes. If you do not have Client COM, we recommend IC Change Notification Monitor initiator rather than the Directory Services Change Notification monitor as the next best approach. You must test all changes carefully when using these Monitor initiators to make sure high level access level or security changes don't cause excessive notifications.

For example, when a user's security privileges are changed, DS writes that change to an attribute within that user's User key. DS then generates a notification that it has made the change. The Directory Services Change Notification Monitor initiator then starts and retrieves information about that change from the notification. A notification is generated for each key that changes, and the attributes that changed within that key are listed in a list of string type variables.

Note: This initiator is not currently used in the handlers that ship with CIC.

Initiator Properties Page

For more information on the relationship between the parameters on the Initiator Properties page, see Introduction to Initiators.

Notification Object Type

IC Change Notification

Object ID

This should always remain as {all}.

Notification Event

This specifies the type of change event to monitor. If you want to monitor for all four types of changes, you need to use different handlers that call a common subroutine.

Created Active - fires when an active DS key is created

Deleted Active - fires when an active DS key is deleted

Renamed Active - fires when an active DS key is renamed

Modified Active - fires when an active DS key is modified

Note: All DS keys under the root and site name are considered "active" and subject to monitoring. The root DS key path is: HKEY_LOCAL_MACHINE\SOFTWARE\Interactive Intelligence\CIC\Directory Services\Root. Any keys outside of this tree are considered "inactive."

Outputs

You have the option to create a custom variable to hold each of these outputs, if necessary. If you do create custom variables, you will need to modify the rest of the handlers or subroutines appropriately instead of relying on the default variables provided in this initiator. To create a custom variable, select the (new) option at the top of each drop-down list and specify the variable name on the Declare Variable dialog.

Entry Path

The full path to the DS Key, including the name of the Key, starting in the DS root directory.

Entry Name

The name of the key in which the change was made.

Object Class

Class tells you what kind of object was changed (User, Line, Line Group, Handler, etc). For example, if the change takes place to a specific user's configuration, the Object Class would be User. If someone changed a report log, then the Object Class would be Report Log.

Notification Type

The type of change that took place is described by one of the following values:

• "Created"

• "Deleted"

• "Renamed"

• "Modified"

List Changes Attributes

A list of the attributes that were changed within the Key.

Exit Paths

Start

This step always exits through the start path.