2 Installing Eloquence on the HP-UX platform

The eloqcl.ini file

Section [dlgsrv]

The section [dlgsrv] and any user-defined sections may hold the following configuration items:

MemSz=

<MemorySize>

Default:

4096

Function:

MemorySize specifies the size of a memory area used for communication. The arguments exchanged by server and client is limited by the communication memory. A value of 4096 is recommended.

DefaultsFile=

<Filename>

Default:

/opt/eloquence6/share/dlg/defaults.eq

Function:

Defines the name (and path) of the defaults file used by motif dialog driver to provide defaults to dynamically created objects.

If you are using modular dialog files, change the default value to the defaults.eq file in the module subdirectory.

/opt/eloquence6/share/dlg/module/defaults.eq

IdmLib=

<Search Path>

Default:

none, the environment variable IDMLIB is used instead.

Function:

On execution of the DLG LOAD statement the specified dialog file is searched in each directory specified by the IdmLib item regardless of any directory specification named in the DLG LOAD statement. The directories are separated by ':'.

If IdmLib is specified in the [dlgsrv] section it overrides the value of the IDMLIB environment variable unless the token $IDMLIB is included into the directory list.

If IdmLib is specified in an user-defined section it overrides the value of the IdmLib item specified in the [dlgsrv] section unless the token $IDMLIB is included into the directory list.

Example:

IdmLib=/path1:path2:$IDMLIB

This causes every dialog file loaded by DLG LOAD to be searched in the directories /path1 and /path2. If the dialog file cannot be found in these locations, searching is continued using the value of the previous IdmLib item, such as the value of the IDMLIB environment variable.

DlgPath=

<Path>

Default:

none

Function:

Defines the path where DLGSRV expects dialog files.

Dlg=

<Prefix>

Default:

DLG

Function:

This specifies the file extension, by which Eloquence recognizes a Eloquence dialog file.

Whenever Eloquence tries to load a Dlg file (for example sample.dlg), it will try to locate and load an Idc (e.g. sample.idc) or Idm (e.g. sample.idm) file first.

Idm=

<Prefix>

Default:

IDM

Function:

This specifies the file extension, by which Eloquence recognizes a Dialog Manager dialog file.

This file is usually created by the cvdlg utility program or the Dialog Manager graphical editor.

Idc=

<Prefix>

Default:

IDC

Function:

This specifies the file extension, by which Eloquence recognizes a compiled Dialog Manager dialog file.

Debug=

<Level>

Default:

0

Function:

DebugLevel specifies the debug of the motid dialog driver level. A zero value is recommended.

Logfile=

<Filename>

Default:

none

Function:

Defines the name and path of a log file the motif dialog driver uses to write debug messages to. This value is only used if DebugLevel is nonzero.

HelpBaseURL=

<Path to Netscape>

Default:

none

Function:

The Netscape item is used by the motif dialog driver as the location of the Netscape executable. This is vital in order to communicate with or startup Netscape.

If the Netscape item is nopt present, the NETSCAPE environment variable is is used instead. If this variable is not present, the following path will be assumed:

/usr/X11/bin/netscape

HelpBaseURL=

<URL>

Default:

none

Function:

This defines the base URL of the on-line help files.

Example: HelpBaseURL=http://www/help/

FileBaseURL=

<URL>

Default:

none

Function:

This defines the base URL for the function EqHelpViewFile.

Example: FileBaseURL=http://www/files/

ManBaseURL=

<URL>

Default:

none

Function:

This defines the base URL for the function EqHelpManPage.

Example: ManBaseURL=http://www/cgi-bin/man2html

User-defined sections

The DLGSRV utility program is launched by the DLG SET ".driver" statement, the syntax of this statement is:

DLG SET ".driver","driver_spec [ini_section [arguments]]"

driver_spec:

motif

ini_section:

Optional name of an user-defined section in the eloqcl.ini file where the defaults specified in the section [dlgsrv] can be overridden.

arguments:

Additional arguments can optionally be specified here and will be passed-through to the Dialog Manager.

1. the motif dialog driver sets up the Dialog Manager argument list from the arguments specified in the DLG SET ".driver" statement, if any. DLGSRV then reads the configuration items in the section [dlgsrv] (please refer to the description of Section [dlgsrv] below).

2. If ini_section is specified in the DLG SET ".driver" statement, the motif dialog driver reads additional configuration items from this user-defined section. If these items have been previously specified in the section [dlgsrv], the previous values are overridden.

[debug]
DefaultsFile = /path/to/mydefaults.eq

This user-defined section named [debug] defines one item DefaultsFile. In order to activate this item, the name of this section must be specified in the DLG SET ".driver" statement, e.g.:

DLG SET ".driver","motif debug"

Any previous DefaultsFile definition in section [dlgsrv] is overridden with the new value from section [debug].

1. If ini_section is specified in the DLG SET ".driver" statement, the motif dialog driver searches this user-defined section for an item named Arguments. If this item exists, its value is appended to the Dialog Manager argument list.

[debug]
Arguments = -IDMtracefile /tmp/tracefile

This enables an additional Dialog Manager argument which creates a trace file for debugging purposes.

1. Finally, the composed Dialog Manager argument list is passed to the Dialog Manager runtime system start-up function.

Additionally, user-defined sections may hold the following configuration item:

Arguments=

<Additional Dialog Manager Arguments>

Default:

none

Function:

Additional arguments specific to the current user-defined section can optionally be specified here and will be passed-through to the Dialog Manager.

NOTE: For a list of valid commandline arguments, please refer to the ISA Dialog Manager documentation.