Definition of Actions

Note: The vocal message associated with the group is used to designate the basic group of an alarm in the vocal alarm messages. It is played before the vocal message associated with the tag in alarm. If there is no vocal message associated with the tag, the identification message of the group is played alone. Language The vocal message associated with a group can be defined in var ious languages, the message really transmitted being automatically selected according to the language of the recipient operator. The proposed languages are those which are already used (user interface language, language of defined operators). To add a language to the proposed list, click on the button on the right of the language tabs then select the wished language in the displayed list. To suppress a language, click on the same button, select the language to suppress then click on the "Mask" button.

The Call group action causes the call of the group selected in the Group to call dropdown list with option of inhibition or delay. Note: this action impli citly authorizes the users of the designated group to have access to the tag (consultation, acknowledgment). It is the only way of associating a tag with a group. To authorize a group which should not be called, to have access to the tag, a call action for the group in question must be defined with invalidation of the call. Group to call This dropdown list designates the on call group to call. Select this group in the list of the defined groups by clicking on the arrow of the dropdown list. If the desired g roup does not exist, type its name in the edit field. An empty group is automatically created. It will be necessary to return later to the group configuration to assign users and organize the teams.

Call enabled This option can be used to validate or invalidate the call. The " Default" choice is only enabled for calls on reset or acknowledgment. When this choice is done, the call option is given by the corresponding option in the general alarm options. For the calls on event activation, the call invalidation allows a group to be attached to a tag (for consultation and acknowledgment by the users of the designated group) without having to call the group in question. Call delayed This option allows the call to be delayed during the time indicated in the adjacen t edit field. It is only available for the events defined as alarms. If this option is validated, the detected alarm will be processed as others (event log, alarm table...), but the call will be triggered at the end of the time specified in the adjacent fiel d, and only if the alarm is still active at the end of this time. If the alarm is reset before the end of the specified timeout, then it is automatically acknowledged and no call is triggered. This option allows the filtering of events that are not import ant when they are temporary (short power fail on an installation protected by a UPS for example). A) Call on event activation If the tag is defined as alarm, the alarm detection triggers the call of users of the designated group for transmission of the inf ormation associated with the alarm (numeric, alphanumeric or vocal message, text file). The call will be reiterated so long that the group will not be considered as warned (messages transmitted and call acknowledged). If the variable is not defined as alar m (simple event), the detection of the event triggers the call of the main users (not relief users) of the active team of the designated group for transmission of the information associated with the event (numeric, alphanumeric or vocal message, text file) under the form of a service message (no call of relief users if failed, no call acknowledgment). If the variable is defined as acknowledgment, the event triggers a call of the users concerned by the acknowledgment of the associated basic alarm group, with transmission of the associated formatted message, independently of the designated on-call group. Example format message: "Acknowledgment of &G alarms by &M" message: "Peter HENRY" associated group: "Boiler room" message transmitted: "Acknowledgment of Boiler room alarms by Peter HENRY" B) Call on event reset If the call on reset is validated for an event, only users of the selected on call group having their "call on reset" option validated will be effectively called. The reset of the event triggers the call of the main users (not relief users) of the active team of the designated group for transmission of the information associated with the event reset (numeric, alphanumeric or vocal message, text file) under the form of a service message (no call of relief users if failed, no call acknowledgment). If the variable is defined as alarm, the call on reset is done only if at least one call has been triggered after the alarm detection.

C) Call on alarm acknowledgment If the call on acknowledgment is valid ated for an event, only users of the selected on call group having their "call on acknowledgment" option validated will be effectively called. The acknowledgment of the alarm triggers the call of the main users (not relief users) of the active team of the designated group for transmission of the information associated with the alarm acknowledgment (numeric, alphanumeric or vocal message, text file) under the form of a service message (no call of relief users if failed, no call acknowledgment). The call on a cknowledgment is done only if at least one call has been triggered after the alarm detection.

The Call User action provokes the call of the user selected in the User to c all dropdown list with option of forcing the called number. Note: so that the user can consult the tag or acknowledge the alarm, the tag has to be attached to one of the on call groups which the user belongs, by defining an a "call group" action for the gr oup in question. If the operator does not belong to any the groups to be called, he will not have access to the tag. User to call This dropdown list designates the user to call. Select this user in the list of the defined users by clicking on the arrow of the dropdown list. On event activation (or reset or acknowledgment following the selected tab), the designated user will receive a call of type "service message" with the formatted message which corresponds to the selected tab. Programmed number When this option is checked, the call of the user is processed by using the number that is active at the call time, with possible call of the relief number in case of failure. Designated number When this option is checked, the call of the user is processed by using the number which is explicitly designated in the list below. In case of failure, there is no possible call of the relief number.

The Execute script action executes the m essage processor script selected in the Script to execute dropdown list. Script to execute This dropdown list designates the treatment of the Message Processor that will be triggered every time the event is set (or reset or acknowledged following the selected tab). This treatment can be used to parse the event and consecutively activate alarms or to trig actions in response to the event. Only the Message Processor prototypes that are defined with the "Alarm" interface are proposed in the list. The associate d scripts are started at the software launching time and have to block themselves for waiting the event (instruction RECEIVEALARM).

The Execute command action executes the command selected in the Command to execute dropdown list with option of forcing the written value. Command to execute This dropdown list designates the command to execute. Select this command in the list of defined commands, by clicking on the arrow of the dropdown list.

Button Add... If the wished command does not exist in the list, click on this button to create a new command and add it to the list (see § 5.16.2 "Command definition"). Button Edit... To modify the parameters of the selected command, click on this button ( see § 5.16.2 "Command definition"). Button Delete Click on this button to delete the selected command. Button Test Click on this button to test the selected command. Value (default) The value defined in this field is the value which will be transmitted in all the requests of writing which make the command and for which no value is not exp licitly defined. This option makes it possible to use generic commands for definition of outputs to control and to parameterize the transmitted value at the time of the action. The forced value can contain variable fields that will be updated at the time o f event activation (or reset or acknowledgment following the selected tab). Click on the button

to integrate the value of a supervised tag in the default value transmitted by the command. In the displayed dialog box, select the wished tag then validate. The numerical identifier of the tag is inserted in the edit field at the current cursor position, under the form: &(tag id).

The Stop command action stops the execution of the command selected in the Command to stop dropdown list. Command to stop This dropdown list designates the command to stop. Select this command in the list of defined commands, by clicking on the arrow of the dropdown list. This action can be use, for e xample, to abort on event reset or alarm acknowledgment a temporized command that was activated on alarm detection.

The Execute application action launches the applic ation or URL designated in the Open application or document dropdown list. The defined command line will be executed on activation of the event (or reset or alarm acknowledgment according to the selected tab). It can be executed for test by clicking on the "Test" button. Open application or document This dropdown list designates the application to execute or the document to open. Type in this field a command line which designates an application (with its possible parameters) or a document. The application or document must be typed with their full path. The command lines that have been already defined are registered and can be directly selected by clicking on the arrow of the dropdown list. This field also can define a web page by its URL ( http://...). This web page will be automatically displayed when executing the action, in an independent browser window or in the supervision plug-in of Alert, according with the option below. When an URL is defined as action for the associated tag , the corresponding web page can also be directly displayed from the user interface of Alert by clicking in the list with the right button of the mouse on the tag in question then selecting the command "Display the attached web page..." in the contextual menu. Button Browse... The application or the document can be searched and selected by clicking on this button. Show URL in plug-in "Supervision" This option is only validated (not grayed) when the application defined in the edit field above is an URL (name beginning with "http://"). When this option is checked, the URL will be displayed in the supervision plug -in. In the opposite case, it will be displayed in an independent browser. Button Test The defined command line can be executed for test by clicking on this button.

The Play Tone action plays the sound file attached to the called group or designated in the Sound file dropdown list. Note: The option Play group tone defined on t he Alarms page of the general options forces the execution of the sound file associated to the on-call group attached to the alarm (or to first of the attached groups) for all the defined alarms, regardless of the Play Tone actions possibly defined. Sound file This dropdown list designates the sound file to play. Click on the "Browse..." button to search and select a sound file or directly type the name of the wanted file with its full path. The sound file already selected in actions or associated with the on call groups attached to the tag (groups to be called) can be directly selected by cli

...