Company Administrators and Developers can create event domain constants that will be available in scripting for all event objects associated with an event domain.
- On the Developer tab, in the Domains menu, click Event Domain Constants.
- In the Event Domain drop-down list, select the event domain for which you want to create or modify the constants, and then click Continue.
- xMatters displays the Event Constants page.
- Do one of the following:
- To modify an existing constant, click its name in the list to view its details. For information about the fields and values, see below.
- To remove a constant, select the check box next to it in the Event Domain Constants list, and then click Remove Selected.
- To add a new constant, click the Add New link above the list, and then specify the details on the Add New Event Domain Constant page. For information about the fields and values, see below.
If you are modifying or adding an event domain constant, you can define the following settings (Constant Name and Value are mandatory):
- Constant Name: the name of each event domain constant must be unique within the event domain, and will automatically be converted to all upper-case when the constant is created. Constant names are limited to 100 characters or less, and can contain only alphanumeric characters, underscores, and spaces (no punctuation or other special characters).
- Value: event domain constant values are limited to a maximum of 4000 characters from the ASCII character set (Decimal: 32 - 126).
- Description: the description field is optional.
To simplify the Integration Agent command line calls, all optional parameters have defaults. You can change the defaults by adding each parameter as an event domain constant in the xMatters web user interface (Developer > Event Domain Constants > Generic). The name of each event domain constant must match the value of the Constant Name column in the table below.
The event domain constants for the generic domain must be created manually (i.e., they are not created out-of-the-box).
Controls fail-safe functionality, notifying the fail safe recipient via EMAIL under certain circumstances; valid values are:
Identifies the name of the Group to notify via email if the fail safe functionality is enabled.
The default value is "Generic Failsafe"; note that this Group does not exist in an out-of-the-box installation. You must create this Group and add at least one email Device or User with an email Device to a 24x7 Coverage.
|EMAILCSS||Contains the Cascading Style Sheet (CSS) used to format HTML emails.|
|EMAILFOOTER||Contains the text to place at the bottom of each email notification; this text is often used for corporate boilerplate or disclaimer copy.|
Used to specify the address of the xMatters web server. The links provided in notification content use this constant value to locate the web server which would process the response. For these links to work, this address must be reachable from the Device where the User will receive the notification; normally, this is the IP address or fully-qualified host name of the xMatters web server.
The default value is http://localhost:8888
|uselogo||Set this if you want the logo to be displayed within HTML email notifications. Default is true.|
|EMAILLOGOURL||The URL at which the logo to be used in HTML emails can be accessed.|
|overridedevicerestrictions||When set to true, notifications will ignore any restrictions that Users have configured on their Devices; default is false.|
|useemergencydevices||Forces the use of User's emergency Devices; default is false.|
|trackdelivery||Tracks when each Device is delivered to; default is false. Setting this to false may give a performance advantage, but you lose any information about whether a delivery was successful or not.|
|annotatedelivery||Annotates when a notification is delivered to each Device; default is false. Note that setting this to false may result in a performance advantage, but will also result in the loss of any information about whether a delivery was successful.|
|annotate||Enables submission of annotations back to the management system; default is false.|
|tracksubscriptiondelivery||Track when each Device is delivered to for Subscriptions; default is false.|
|subscriptionannotate||Enables submission of Subscription annotations back to the management system; default is false.|
|maxinvalidresponses||Specifies the maximum number of invalid responses allowed before notification is no longer requeued; default value is "3".|
|enablehtmlemail||Enables HTML email functionality; default is true.|
|debug||Indicates whether to log informational messages for debugging and troubleshooting purposes. You may want to disable this behavior in your production systems to improve performance. Default is false.|