Abstract


An additional VRBE problem determination utility is available in Blueworx Voice Response for AIX Fix Pack 2 (fix level 4.2.0.550).


Content


A new Blueworx Voice Response utility called dtjlogmon is available to system administrators that enable them to collect a dtbeProblem output (or run any other command) automatically when an error or another message is reported in the VRBE log (.log) files or VRBE trace (.trc) files.

The dtjlogmon script can be run in two modes: scan mode or test mode.


In scan mode, the dtjlogmon script runs a command automatically when a specified error is logged to the VRBE log (.log) files or the VRBE trace (.trc) files. The default command run is dtbeProblem -s $DTJ_HOME/dtj_logs which collects a dtbeProblem output in the $DTJ_HOME/dtj_logs directory.


In test mode, the dtjlogmon script inserts specified text in the active VRBE log file or active VRBE trace file to check that a specified command is triggered.


The dtjlogmon command runs shell script:
/var/dirTalk/DTBE/native/aix/dtjlogmon

For information on using dtbeProblem to gather information about Java and VoiceXML environment, refer to the section “Collecting VRBE specific information” in the Blueworx Voice Response Problem
Determination manual.


Scan mode syntax


In scan mode:


dtjlogmon [-l|-t|-a] -s searchString [-y] [-c command]
[-i interval] [-o]
dtjlogmon -?


Scan mode parameters


In scan mode:


-l  Scans the log.n.log files for the text specified by the -s parameter.

-t
Scans the wvrtrace.n.trc files for the text specified by the -s parameter.

-a  
Scans the Node output files as specified in VRBE configuration file default.cff for the text specified by the -s parameter. File default.cff must be consistent with the current config.cfd file.


At least one of the above parameters must be present together with the -s parameter.


-s searchString Specifies the string that will trigger the command or commands specified by the -c parameter. A search string that includes spaces must be enclosed in double quotation marks. The search string can be a regex as for the egrep utility. The search string is CASE SENSITIVE, so “send ANNOUNCE” will not trigger a search string of “SEND ANNOUNCE”.

-c
command Specifies the command or commands to run when the text is generated. The default is "dtbeProblem -s $DTJ_HOME/dtj_logs". Commands that includes spaces must be enclosed in double quotation marks. You can run multiple commands by separating them with a semicolon (;) for example:
-c "command1 ; command2; command3"

-i interval Specifies the interval in seconds that the command is to wait between scans of the files. The default is 5.

-y
Forces the script to run without prompting the user for confirmation of the supplied parameters.

-o  Specifies that the command should loop back around and continue to execute the command or commands specified by the -c parameter on new instances of the search string until terminated. This parameter is required for scripted invocations of dtjlogmon.

-?  Prints the help information for the command.


Scan mode example commands


dtjlogmon -l -s "Starting applications for node AppNode1 at host LocalHost"


Scans the log.n.log files for the text "Starting applications for node AppNode1 at host LocalHost" and runs the command "dtbeProblem -s $DTJ_HOME/dtj_logs"


dtjlogmon -a -s LocalHost -c "ls ; ls -l ; pwd"


Scans the Node output files as specified in VRBE configuration file default.cff for the text "LocalHost" and runs the commands ls, ls -l, and pwd sequentially in the same thread.


dtjlogmon -l -s "foo|bar"


Scans the log.n.log files for the text “foo” and “bar” and runs the command "dtbeProblem -s $DTJ_HOME/dtj_logs" if a line being written to the log includes the text “foo” or “bar” or “foo” and “bar”.


 

Test mode syntax

In test mode:


dtjlogmon [-l|-t] -w -s "insertString"
dtjlogmon -?


Test mode parameters


In test mode:


-l  Inserts the text specified by the -s parameter in the active log.n.log file.

-t
  Inserts the text specified by the -s parameter in the active wvrtrace.n.trc file.


At least one of the above parameters must be present together with the -s and -w parameters.


-s insertString Specifies the string that is to be inserted in the active log or trace file. A string that includes spaces must be enclosed in double quotation marks.

-w
Writes out the specified text to the active log or trace file.

-?
  Prints the help information for the command.


Test mode example commands


dtjlogmon -l -w -s "Starting applications for node AppNode1 at host LocalHost"


Inserts the text “Starting applications for node AppNode1 at host LocalHost” in the active log.n.log file.


dtjlogmon -t -w -s LocalHost


Inserts the text “LocalHost” in the active wvrtrace.n.trc file.