Eloquence A.05.00 Release Notes

Eloquence A.05.00 Release Notes



ELOQ.INI File on the PC Platform


The ELOQ.INI file must be installed in your WINDOWS directory. You may change it using a text editor (such as MS DOS edit or WINDOWS notepad).

PC eloq.ini file format


The file ELOQ.INI contains several sections each containing a group of related configuration items. The sections and configuration items have the following format:
  [Section]
  Item=Value

Section is the name of a section. The enclosing brackets ([ ]) are required and they must start at the 1st column.
Item=Value defines a value of a configuration item. Item is the name of a configuration item. It consists of any sequence of characters (case insensitive) and digits followed by a equal sign (=). Depending on item type, the value may either be an integer or a string (optionally enclosed in double quotes).
Comment lines must start with a semicolon (;) in the first column.

global section

This section is used by the RUNSRV and the DLGSRV programs.
The [global] section may hold the following configuration items:

Transport

Transport=<TransportName>
Default:
WINSOCK
Function:
Defines the network transport API used by Eloquence.
Eloquence RUNSRV and DLGSRV applications support both, the WINSOCK 1.1 and WSOCKETS APIs. This value must be set according to your networking software.
The following values are supported:


runsrv section

This section is used by the RUNSRV utility program.
The [runsrv] section may hold the following configuration items:

Service

Service=<ServiceName>
Default:
RUNSRV
Function:
Defines the service name (or port number) RUNSRV expects to become connected from a remote host.
The service name is used to lookup the port number in your SERVICES file.

Note You have to provide the apropriate entry 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

Debug=<DebugLevel>
Default:
0
Function:
DebugLevel specifies the RunSrv debug level. A zero value is recommend.

DlgSrv

DlgSrv=<Commandline>
Default:
"dlgsrv -connect %s -IDMfont 1 -IDMcolor 1"
Function:
This specifies the commandline executed by RUNSRV to launch DLGSRV. An entry of %s will be replaced by arguments passed by Eloquence (please refer to the DLGSRV documentation for details)


dlgsrv section

The [dlgsrv] section may hold the following configuration items:

MemSz

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

DefaultsFile=<FileName>
Default:
defaults.eq
Function:
Defines the name (and path) of the DLGSRV defaults file. If undefined, DLGSRV will look for a file defaults.eq in the current directory.
The defaults file is used by DLGSRV to provide defaults to dynamic created objects.


DlgPath

DlgPath=<Path>
Default:
none
Function:
Defines the path, where DLGSRV expects dialog files.


Dlg

Dlg=<FileExtension>
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 Idm (eg. sample.idm) or Idc (eg. sample.idc) file first.

Note Although it's possible to use Eloquence dialog files (they are converted internally at runtime) it's strongly recommended to convert them to Dialog Manager format due to performance considerations.



Idm

Idm=<FileExtension>
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

Idc=<FileExtension>
Default:
idc
Function:
This specifies the file extension, by which Eloquence recognizes a compiled Dialog Manager dialog file.
This file is created by the idm utility program provided with the Dialog Manager product.


Debug

Debug=<DebugLevel>
Default:
0
Function:
DebugLevel specifies the DLGSRV debug level. A zero value is recommend.


Logfile

LogFile=<FileName>
Default:
none
Function:
Defines the name (and path) of a logfile, 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.

Host

Host=<HostName>
Default:
none
Function:
HostName specifies a hostname DLGSRV will use the connect remote host (running Eloquence).
This configuration item provides a nonstandard way connecting to a Eloquence process. Using this option is not recommended.

Service

Service=<ServiceName>
Default:
none
Function:
Defines the service name (or port number) DLGSRV will use the connect remote host (running Eloquence).
The service name is used to lookup the port number in your SERVICES file. If the first character of ServiceName is a digit, it will be considered a port number.
This configuration item provides a nonstandard way connecting to a Eloquence process. Using this option is not recommended.


Last update: 95/11/08