3 Installing Eloquence on Windows
The eloq.ini file
Section [runsrv]
This section specifies the defaults used with the runsrv connection protocol. The following configuration items are supported:
Service
- Service=
- service name or port number
- Default:
- runsrv
- Function:
- The default service name or port number to be used with the runsrv connection protocol. If no value is defined the port associated with the service runsrv is used.
Section [eloqdlg]
This section specifies the defaults used with the dlg connection protocol. The following configuration items are supported:
Service
- Service=
- service name or port number
- Default:
- 8011
- Function:
- The default service name or port number to be used with the dlg connection protocol. If no value is defined the port number 8011 is used.
Mapping Driver Specifications
Other sections in the eloq.ini file can be used to map a driver specification to a different value. When a driver is specified (e.g. in the DLG SET ".driver" statement or with the eloqcore -dlg command line option) the argument is looked-up in the eloq.ini configuration file after any protocol specification has been removed. If a section has been found it is used to replace the original argument.
The following configuration items are supported:
dlg
- dlg=
- replacement text
- Function:
- When contacting a DLG driver this is used as a replacement for the specified driver. The value can specify a different protocol.
runsrv
- runsrv=
- [hostname][:service]
- Function:
- When using the Run server to execute a remote operation or to start the Dialog server the runsrv variable can be used to specify a different hostname (or IP address) and/or a different service name (or port number) which should be used instead.
Example
[runsrv]
Service = runsrv
[eloqdlg]
Service = 8011
[mike]
dlg = dlg://lxmike
[chris]
dlg = runsrv://wserv:8765
runsrv = wserv:8765
This example specifies to use a port number for the runsrv protocol which is associated with the service runsrv (as defined in the local SERVICES file). For the dlg protocol the port number 8011 should be used.
When a driver argument "mike" is specified (e.g. "@mike", "dlg://mike" or "runsrv://mike") the value "dlg://lxmike" is used instead. When a driver argument "chris" is specified it is replaced by "runsrv://wserv:8765". When the Run server is contacted from either the command line (using the runclnt utility) or the RunSrv.DLL and a remote name "chris" is passed, the value "wserv:8765" is used instead.
Running multiple runsrv instances on a single system
This is required if the Citrix Metaframe or the Windows Terminal Server product is used. Each user needs to start the RUNSRV32 with a different port number (probably during autostart). Then a driver name containing the host name and the user name is passed and translated by using the mapping defined in eloq.ini.
Suppose the user "chris" has a RUNSRV32 using port 8765 when working on system wserv, then the following mapping section should be added in eloq.ini:
[wserv_chris]
dlg = runsrv://wserv:8765
runsrv = wserv:8765
Eloquence Installation and Configuration - 29 OCT 2004