company logo

Running Message Browser

One may run the MessageBrowser for a selected error log-file, which may contain error and event messages from any number of applications.

MessageBrowser can be called from a command line in DOS or UNIX.

...ode.exeini_file [ options ] // windows

...codeini_file [ options ] // Linux

(c)ode is the generic GUI framework, which is called as entry point for all ODABA applications. In order to call the proper application, the PROJECT option has to be set to MessageBrowser, which might be defined in the configuration or ini-file or as additional option passed on a command line.

Options for the MessageBrowser might be set from within the MessageBrowser or by calling the Option Browser with the MessageBrowser's application database.

# linux

LD_LIBRARY_PATH=/lib:/usr/lib/:%ODABA_ROOT%lib \

%PROGPATH%/code MessageBrowser.ini code

.. Windows

@echo off

:: ODE startup wrapper script

:: ODABA_ROOT should be the folder where you installed ODABA

set ODABA_ROOT=...odaba root path

cd /D "%ODABA_ROOT%"

start "" ode.exe MessageBrowser.ini

exit

Configuration or Ini-file

The ini-file refers to the database location and can be provided as configuration or ini-file. An example for an ini-file is shown below. The DATDB option refers to the Message Browser's application database location, which is used for storing temporary data, only. As resource database (RESDB) one may also refer to MessageBrowser.dev, when running MessageBrowser as independent application.

The location for the error log-file is taken from the TRACE option, which might be set in the ini-file or passed as option to the program call. The error.lst file displayed in the Message Browser must be available in the directory defined in the TRACE option.

Although the application does not really need a database, a database location has to be provided at a location with write access. The database does not contain relevant information and may be deleted after terminating message browser.

Two options allow influencing the MessageBrowser behavior:

  • RefreshTime - Waiting time in seconds until refreshing (re-reading) the list
  • MaxErrors - Maximum number of error lines kept in the list. When the list exceeds this size, additional lines are cut. The option is

[SYSTEM]

DICTIONARY=ode.sys

;[ode] under Windows

[code]

SYSDB=ode.sys

RESDB=ode.dev

DATDB=temp.dat

PROJECT=MessageBrowser

TRACE=mylogs

[Options]

RefreshTime=5

MaxErrors=300

Passing trace file via options

In order to call the Message Browser for error log-files in different directories by using the same ini- or configuration file, the TRACE option might be passed as option in the program call.

code MessageBrowser.ini -TRACE=log

The TRACE option in the program call will overwrite the option value in the ini-file or environment settings. Additional options may be defined in the Options section in the ini-file or vie the options dialog in the message