EventType | String Event type that you want the subscription to have: Alarm Event Audit Event Error Event Exception Event GD End Event GD 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 Tip: To view the current list of event types, you can execute the pub.event:getEventTypes service. | |
gID | String ID of the subscriber that you want to modify. To get the current list of subscriber IDs, execute the
pub.event:getSubscribers service. | |
Filter | String Filter that you want subscription to have. Filter is a pattern-matching string 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. | |
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 called 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 that you want the subscription to specify. | |
Comment | String Descriptive comment that you want to assign to the subscription. | |
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. Note: Although the default value is false, you will generally want to set Enabled to true to activate the subscription immediately after it is modified. |
Result | String Flag indicating whether the subscriber was successfully modified. A value of: true indicates that the subscriber was updated successfully. false indicates that the subscriber was not updated (typically because an invalid subscriber ID was provided in gID). |