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
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”.
-ccommand 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.