2 Installing Eloquence on the HP-UX platform

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