Eloquence A.05.00 Release Notes

Eloquence A.05.00 Release Notes



ELOQ.INI file on the HP-UX System


The eloq.ini file must be installed in the /usr/eloquence directory. You may change it using a text editor (such as vi).

HP-UX eloq.ini file format


The eloq.ini file 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 the 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 (;) or a hash character(#) in the first column.


dmsrv section

This section is used by the motif and alpha drivers.
The [dmsrv] section may hold the following configuration items:

DefaultsFile

DefaultsFile=<FileName>
Default:
/usr/eloquence/dm/defaults.eq
Function:
Defines the name (and path) of the defaults file used by motif and alpha drivers.
The defaults file is used to provide defaults to dynamic created objects.


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 driver debug level. A zero value is recommended. A nonzero value will cause debug messages output to stderr.



runsrv section

This section is used by Eloquence to communicate with the RUNSRV utility program on a remote host.
The [runsrv] section may hold the following configuration items:

Service

Service=<ServiceName>
Default:
RUNSRV
Function:
Defines the service name (or port number) used to connect to RUNSRV on a remote host.
The service name is used to lookup the port number in your /etc/services file.

Note You have to provide the apropriate entry in your /etc/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.
The resulting port number must be the same on the client and server side.


Debug

Debug=<DebugLevel>
Default:
0
Function:
This is used internally to debug RUNSRV itself. The default value (zero) is recommended. A nonzero value will cause debug messages output to stderr.



dmclnt section

This section is used by Eloquence to communicate with the dialog server on a remote host.
The [dmclnt] section may hold the following configuration items:

Service

Service=<ServiceName>
Default:
dmclnt
Function:
Defines the service name (or port number) used by Eloquence to setup the connection to the dialog server on a remote host.
The service name is used to lookup the port number in your /etc/services file.
If the first character of ServiceName is a digit, it will be considered as a port number. It is recommended to use a service name.
The resulting port number must be the same on the client and server side.

Note Depending on the PortRange, a range of port numbers is used, starting with a port number defined by the service dmclnt.


PortRange

PortRange=<Integer>
Default:
40
Function:
Defines the number of ports reserved for usage by the dialog server. This is also the upper limit of concurrent connected dialog servers.
If this number is nonzero, RunSrv will be used to start the dialog server process, passing the actual port number.



dmclnt@host section

To handle non-standard configurations, it's possible to overwrite default values as defined by the [dmclnt] section. To achieve this, define a section specific to a client PC by appending the PC hostname to dmclnt seperated by an at sign (@).
The [dmclnt@host] section may hold the following configuration items:

Service

Service=<ServiceName>
Default:
value taken from [dmclnt] section
Function:
Defines the service name (or port number) used by Eloquence to setup the connection to the dialog server on a remote hosts.
The service name is used to lookup the port number in your /etc/services file.
If the first character of the ServiceName is a digit, it will be considered as a port number.
This provides a nonstandard way to connect to the client PC. It's recommend to use the default service name.

PortRange

PortRange=<Integer>
Default:
value taken from [dmclnt] section
Function:
Defines number of ports reserved for usage by dialog server.
If the PortRange is zero, only a single port number (as defined by ServiceName) will be used to connect the dialog server.
This provides a nonstandard way to connect to the client PC.


Last update: 95/11/08