dtjalarm script

Starts and stops the sending of alarms from the Java and VoiceXML environment based on the alarm properties files.

The dtjalarm command runs shell script /var/dirTalk/DTBE/native/aix/dtjalarm which starts the sending of alarms from the Java and VoiceXML environment based by default on the internal alarm properties file com/ibm/hursley/trace/dtjalarm.properties, or optionally, by user-defined external properties file.

dtjalarm does not generate a base Blueworx Voice Response alarm for each log message sent to the log file log.X.log. During startup, a list of alarms that are to be treated as base Blueworx Voice Response alarms is created. The severity of each listed alarm is also referenced by associating it with the appropriate Blueworx Voice Response alarm color to be used (RED, YELLOW, GREEN, WHITE). Refer to Meaning of the alarm colors for details.

Individual listed alarms can also be given a severity of SUPPRESS to prevent the alarm, or a severity of DEFAULT to indicate that the alarm color of the dtjalarm message is determined by the severity category used for logging to log file log.X.log, as follows:

Table 1. dtjalarm message severity categories
Severity Logged in `log.X.log`	Severity of Corresponding Base Blueworx Voice Response Alarm
ERROR	RED
WARNING	YELLOW
NOTIFY	WHITE

In addition to the internal properties file supplied with the product, an external properties file called dtuseralarm.properties can also be used to override the Blueworx-defined settings or expand the alarmed log messages to include messages not deemed by Blueworx as alertable. This file can be found in $DTJ_DIR (by default, /var/dirTalk/DTBE/native/aix/dtuseralarm.properties) The dtuseralarm.properties file is not installed with the product, but instead an example version called dtuseralarm.properties.example is installed in $DTJ_DIR. If you want to modify alarm behavior, copy this file and rename it. This properties file and the internal properties file both use the same formatting conventions. Java and VoiceXML environment messages, which are typically logged as DTJnnnn where nnnn represents a four-digit error code are listed in the properties files without the DTJ prefix. Similarly, VXML browser messages which are typically logged as VXInnnnn are listed without the VXI prefix as a five-digit error code, and Java and VoiceXML environment trace messages are listed as a seven-digit error code. Comment lines are preceded by the # character. For example:

#  legacy DTJ messages (4 digit range)
2001 DEFAULT
2003 RED
2006 GREEN
# VoiceXML browser log messages (5 digit range)
50106 SUPPRESS
# New VRBE trace log messages (7 digit range)
1007002 DEFAULT

In the above example, the alarm for message 50106 has been suppressed.

This script can also be used to stop the sending of alarms from the Java and VoiceXML environment, by adding the -exit switch.