Running Option Browser

You may run the Option Browser for an existing or a new application or resource database. Options to be set in a application database depend on the option schema provided in the application dictionary.

Requirements

You may run the Option Browser when you have installed ODABA . The Option Browser is platform independent and can be used on Windows, LINUX and several UNIX platforms. The Option Browser requires a project resource database (dictionary), which contains option schemata (configuration templates).

Running the Option Browser usually requires separate specifications for data source and resource database. Theoretically, one could always use the ode.sys as dictionary, since data types going to be processed are part of the system dictionary. When configuring an application database, this may, however, the schema version in the database which makes the database inaccessible when running with the application resource database.

Usage

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

.../odaba/ode90.exe ini_file [ options ]

ode90.exe 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 Main , which might be defined in the configuration or ini-file or as additional option passed on a command line.

Configuration or Ini-file

The ini-file refers to the resource database location and can be provided as configuration or ini-file. The database referenced in the ini-file is required for storing current settings (options) and temporary data. Below you will find examples for an ini-file. The DATA_DB section refers to the application database location.

[SYSTEM]

DICTIONARY=ode.sys

[ODE90]

PROJECT=OptionBrowser

RESOURCES=RESOURCES_DB

DATA=DATA_DB

PROJECT_DLL=Designer

CTXI_DLL=AdkCtxi

DESIGNER_RES=res

SYSAPPL=YES

[RESOURCES_DB]

DICTIONARY=ode.sys

DATABASE=ode.dev

ACCESS_MODE=Read

NET=YES

ONLINE_VERSION=YES

[DATA_DB]

DICTIONARY=... my resource database

DATABASE=... my database

NET=YES

ACCESS_MODE=Write

ONLINE_VERSION=YES

Options

In order to reduce the number of required ini-files and command files, one may use the ini-file as being provided with the installation, which refers to a symbolic database path referenced by the DBPath option. Calling the Option Browser, any number of options can be passed preceded with a '-' sign:

ode90.exe cmd/ode.ini - PROJECT =OptionBrowser - DBPath =projects\sample\sample.dev - TRACE =log

Using options allows running different ODABA GUI applications with only one configuration or ini-file. Instead of passing option parameters, one may also set options in a command or bat file as in the example below. In contrast to options set in command or ini-files, which must never bequoted, options passed on the command line have to be quoted when containing spaces.

DBPath is a option, which has been defined in the ini-file for the DATABASE option in order to support dynamic path locations. Since DATABASE might be referenced in different sections of the ini-file, it is more save to refer to the more specific variable DBPath .

Details for configuring data source are described in in the WEB documentation under Reference documentation/Database references/Data source definition .