Previous Topic: Updating Product Control MembersNext Topic: Notes on Translating Event Text


Updating Event Control Members

Each product using this interface provides one or more Event Control Members. You can use the Event Control members as they are or you can customize them for your environment. The member name is structured as a six-character event code and a two-character language code. For example, if the member name is L0Y001EN, the event code is L0Y001 and the language code is EN, meaning English.

The three sections in an Event Control member are the summary, description, and options sections. These sections are designated by the control words “SUMMARY:”, “DESCRIPTION:”, and “OPTIONS:” in column one. The sections must appear in this order.

The summary and description sections contain the text to be used in the CA Service Desk ticket. This text usually contains embedded symbolic parameters that are resolved when the event is triggered.

Note: For CAISDI/els only, the text of the Event Control Members appears to be fragmented. Do not “clean up” the text. It has been structured this way to minimize the amount of ECSA required to store it. If the same text fragment appears more than once across all of the events for a given product, the text fragment is only stored once and all events reference that one text fragment.

The last section, the options section, contains a SET command with one or more parameters specified. You can customize these values to suit your environment. These are the valid SET parameters:

MAXCOUNT

Specifies the maximum number of occurrences that are allowed for this particular event that is expressed as a value from 1 to 999999. Each occurrence of this event causes the event counter to be incremented. Once the limit is reached, no more tickets are opened for this event. If you do not specify MAXCOUNT, then no maximum occurrence limit is set. Unless MINTIME prevents an event from opening a ticket, each time the event is triggered a CA Service Desk ticket is opened.

MINTIME

Specifies the minimum amount of time that must have elapsed after the last occurrence of this event that caused a ticket to be opened. It is expressed in the format of HH:MM. This is a throttle control to prevent flooding the CA Service Desk with redundant tickets for system-wide failures that are recognized by many tasks at about the same time. If MINTIME is not specified, then there is no minimum time restriction. Unless MAXCOUNT prevents an event from opening a ticket, each time the event is triggered a CA Service Desk ticket is opened.

PRIORITY

Sets the Priority field in the CA Service Desk ticket. The possible values are 1, 2, 3, 4, 5, and NONE. The default is 2.

CAISDI/els maintains the event counters and timestamps for each event until either a SHUTDOWN or REMOVE command removes the product definition from the interface. Those values are then discarded. When a subsequent DEFINE command reestablishes the interface, the event counters and timestamps are re-initialized.