4 Installing Eloquence on the Windows 16 bit platform

The eloq.ini file

Section [runsrv]

Service=

<Servicename>

Default:

runsrv

Function:

Defines the service name (or port number) RUNSRV expects to become connected from a remote host (running Eloquence).

The service name is used to lookup the port number in your SERVICES file. If the first character of the value is a digit, the value will be considered as a port number. It is recommended to use a service name.

Debug=

<level>

Default:

0

Function:

This activates debug output for the RUNSRV utility. A zero value is recommended.

DlgSrvX=

<Command to start DLGSRV>

Default:

DLGSRV%s -connect %s -IDMfont 1 -IDMcolor 1

Function:

This specifies the command line that is executed by RUNSRV to launch DLGSRV. It must contain two entries of %s.

If an instance of DLGSRV is already running, the first entry of %s will be replaced by the DLGSRV instance appendix. This is necessary since Microsoft Windows denies to run more than one instance of DLGSRV at the same time (please refer to the Eloquence Graphical User Interface documentation for details).

The second entry of %s will be replaced by the connection argument provided by Eloquence (please refer to the DLGSRV documentation for details).

NDlgSrv=

<Number of DLGSRV Instances>

Default:

1

Function:

This specifies the maximum number of DLGSRV instances to be run at the same time.

After changing the NDlgSrv value, you should run the DLGCLONE utility program which automatically creates the required number of DLGSRV clone-copies (please refer to the Eloquence Graphical User Interface documentation for details).

DlgSrv=

<Command to start DLGSRV>

Default:

DLGSRV -connect %s -IDMfont 1 -IDMcolor 1

Function:

This specifies the commandline that is executed by RUNSRV to launch DLGSRV.

An entry of %s will be replaced by the connection argument provided by Eloquence (please refer to the DLGSRV documentation for details).

Section [dlgsrv]

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

MemSz=

<MemorySize>

Default:

4096

Function:

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

DefaultsFile=

<Filename>

Default:

C:\DLG\DEFAULTS.EQ

If you are using modular dialog files, change this default to:

C:\DLG\MODULE\DEFAULTS.EQ

Function:

Defines the name (and path) of the defaults file used by the DLGSRV program. If undefined, DLGSRV will look for a file defaults.eq in the current directory.

The defaults file is used to provide defaults to dynamically created objects.

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=C:\DLG\APP1;C:\DLG\APP2;%IDMLIB%

This causes every dialog file loaded by DLG LOAD to be searched in the directories C:\DLG\APP1 and C:\DLG\APP2. 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 DLGSRV debug level. A zero value is recommended.

Logfile=

<Filename>

Default:

none

Function:

Defines the name (and path) of a log file DLGSRV uses to write debug messages to. An empty value (default) causes DLGSRV to write to dbwin (using OutputDebugString). This value is only used if DebugLevel is nonzero.

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

Section [modules]

Since DDE server programs are not automatically started by Microsoft Windows, this section associates the Microsoft Windows module identifier with the program execution path. This enables the RUNSRV and DLGSRV utility programs to start-up the required DDE server programs themselves if they are not currently running.

If you want to communicate with any Microsoft Windows program using DDE, knowledge about the Microsoft Windows module identifier and the communication topics specific to the program is required. Normally, these informations are contained in the program's documentation.

Example:

  [modules]
  WinWord = C:\WINWORD\WINWORD.EXE

The DLGSRV utility program has built-in support for DDE communication with the Netscape WWW browser. This is used to establish access to the on-line help system. In order to use this, you do not need any information concerning the internal Netscape DDE implementation. All you need to do is to add an entry in the section [modules] so that Netscape can be automatically started.

Example:

  [modules]
  Netscape = C:\NETSCAPE\NETSCAPE.EXE

NOTE: Please refer to the Eloquence Graphical User Interface documentation for details about On-line Help and RUNSRV DDE Communication.

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:

@hostname

hostname is the name of the system where the DLGSRV utility program shall be executed.

ini_section:

Optional name of an user-defined section in the eloq.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. DLGSRV 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, DLGSRV 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 = C:\DLG\DEBUG\DEFAULTS.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","@my-pc 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, DLGSRV 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 C:\TMP\IDMTRACE.TXT

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.