Important: | Subscriptions that you add using this service take effect immediately; however, they are not made permanent unless you also persist them to disk with the pub.event:saveEventManagerSettings service. If you do not run pub.event:saveEventManagerSettings after adding subscribers, your changes will be lost when the server is restarted. |
EventType | String Type of event to which the event handler is subscribing. Must be one of the following: Alarm Event Audit Event Audit Error Event Error Event Exception Event GD End Event AGD Start Event JMS Delivery Failure Event JMS Retrieval Failure Event Journal Event Port Status Event Replication Event Security Event Session End Event Session Expire Event Session Start Event Stat Event Tx End Event Tx Start Event
| |||
Filter | String Selects (filters) the set of events within EventType to which the event handler is subscribing. addSubscriber uses Filter as a pattern string to filter a particular attribute of an event. The pattern string can be composed of literal characters, which match a character exactly, and/or the "*" character, which matches any sequence of characters. For example: | |||
This pattern string... | Would match... | |||
* | Any string | |||
M* | Any string that starts with an uppercase "M." | |||
M*X | Any string that starts with an uppercase "M" and ends with an uppercase "X." | |||
The following table shows the attribute that is filtered for each event type. Note that some event types cannot be filtered. | ||||
EventType | Filtered attribute | |||
Alarm Event | Message generated by the alarm event. | |||
Audit Event | Fully qualified name of the service that generates the audit event. | |||
Audit Error Event | Concatenated values of the destination and errorCode parameters of the audit error event. | |||
Error Event | Error message text for the error that generates the error event. | |||
Exception Event | Fully qualified name of the service that generates the exception event. | |||
GD End Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
GD Start Event | Fully qualified name of the service that generates the GD Start Event. | |||
JMS Delivery Failure Event | Name of the JMS connection alias used to send the message to the JMS provider. | |||
JMS Retrieval Failure Event | Fully qualified name of the JMS trigger that invoked the trigger service for which the error occurred. | |||
Journal Event | The major code and minor code of the message that causes the journal event. | |||
Port Status Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Replication Event | Name of the package being replicated. | |||
Security Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Session End Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Session Expire Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Session Start Event | User ID of the user starting the session or the groups to which the user belongs. (The filter is applied to a space-delimited list of groups, composed of group names suffixed with the user's user ID.) The following examples show how you might filter session start events for various groups and/or user IDs: To select session starts for any user in the Administrators group, the filter would be: *Administrators* To select session starts for the user ID "LRMalley" in the Administrators group, the filter would be: *Administrators*LRMalley To select session starts for the user ID "LRMalley" in any group, the filter would be: *LRMalley | |||
Stat Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Tx End Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Tx Start Event | None. This event type cannot be filtered. Filter is ignored for this event type. | |||
Service | String Fully qualified name of the event-handler service (the service that will execute when the event specified by EventType and Filter occurs). | |||
Comment | String Descriptive comment for this subscription. This comment is displayed when subscriptions are viewed with Designer. | |||
Enabled | String Flag specifying the status of the subscription. Must be one of the following values. Set to: true to make the subscription active. false to make the subscription inactive. This is the default.
|
Result | String Flag indicating whether the subscriber was successfully added. A value of: true indicates that the subscriber was added successfully. false indicates that the subscriber was not added. |