Eloquence A.05.00 Release Notes

Installation of Eloquence Software on the PC Platform

This document describes the installation of Eloquence A.05.00 software on the PC platform.
There are two groups of software:

Runtime software
This software is required to use Eloquence A.05.00 client/server services on your PC.
Development software
This software has been contributed to enable you to build your own programs using Eloquence remote database services or to customize the Eloquence dialog server. This software is not installed by default.

PC platform prerequisites

Hardware requirements

32 Bit processor of type 80386 or above.
Recommended is a 486 processor and a graphics accelerator card.
at least 4 MB RAM, recommended is 8 MB RAM
Harddisk with at least 4 MB available space

System software

MS WINDOWS 3.1 or above

Network software

To use Eloquence client/server functionality, a network software providing either WINSOCK 1.1 or WSOCKETS API is required.
We successfully tried the following network software:

WRQ TCP CONNECTION (Rev. 2.01 or above)
MS SOCKETS (Rev. 2.2a or above)
MS Windows for Workgroups 3.11 TCP/IP
Netmanage Chamelion (Rev. 3.10 or above)
HP Arpa Services (Rev. 2.5)

In general, each network package which provides a WINSOCK.DLL or WSOCKETS.DLL should work.

Development system

Eloquence includes the development files for the PC platform.
To develop your own database applications using the Eloquence remote database access, or to customize the Eloquence DLGSRV program, you need the following development software:

Microsoft Visual C/C++ 1.0

Installation

Transferring pcclnt.exe

Transfer the file pcclnt.exe from Eloquence directory (either /tmp/B1368B/pc or /usr/eloquence/pc) to your PC. This file is a self extracting archive.

If transferring pcclnt.exe with ftp, please remember to set the file type to binary.

Creating an installation media

Create an installation media by executing

      pcclnt.exe a:

where a: is the target drive or directory.
This will extract Eloquence files for the PC platform to given the target path.

If not extracting to a floppy disc, you have to provide and extract into a directory named disk1. This is required by the setup program.

Start the setup program

Start the Eloquence setup program by executing

   a:\setup

from within the MS Windows environment where a: is the path to the installation drive or directory.

The setup program provides the following choices:

Install runtime software
This is enabled by default. This will transfer the Eloquence runtime files for the PC platform to your disc and install a program group in the Windows program manager.
Install EloqDB development files
This is disabled by default. If enabled, the setup program will install the files, required for developing applications using Eloquence remote database access on PC platform.
Install DLGSRV development files
This is disabled by default. If enabled, the setup program will install the files, required for DLGSRV customizon.

Using the [[Set Location]] push putton, it's possible to specify a different installation directory.

The following pathes may be specified:

Runtime files
This specifies the location, where Eloquence runtime files are to be installed.
Dialog files
This specifies the location, where Eloquence dialog files are to be installed.
Windows files
This specifies the location, where Windows related files should reside. In a shared windows installation, this should point to your local WINDOWS directory.
Eloquence database development files
This specifies the location, where Eloquence database development files are to be installed.
Dialog Server development files
This specifies the location, where dialog server development files are to be installed.

Setup your network connection

To setup your network connection you have to change the following network software configuration files:

services: maps service names and port numbers
hosts: maps IP addresses and host names

The location of these files depend on your network software. Typical locations are:

c:\lanman\etc

c:\wrqnet

c:\windows

Change your hosts file

You have to add the name of your HP 9000 server to your hosts file. Make an entry like below:

   192.1.1.1   hostname

Where 192.1.1.1 is the IP address of your HP9000 system and hostname is the hostname of your HP9000 system.

Change your services file

To provide a service name / port number mapping, you have to change your services file.
Add lines like below to your services file:

   eloq     8000/tcp    # Eloquence remote database
   runsrv   8010/tcp    # Eloquence remote exec server

Where

eloq: is the service name used by Eloquence remote database access.
RUNSRV: is the service name used by the Eloquence remote execution utility.

Verify carefully that the choosen port numbers (8000,8010 in the example above) are unique and not already in use.

Customize eloq.ini file

The file ELOQ.INI must be located in your WINDOWS directory. Changing ELOQ.INI it's possible to customize RUNSRV and DLGSRV. Please refer to chapter ELOQ.INI File on the PC Platform for further reference.
No changes are necessary to the ELOQ.INI file, unless the defaults are not sufficient. All pathes are updated accordingly be the setup program.

List of files

Files related to Eloquence runtime

File Default directory File Description

eloq.ini WINDOWS Eloquence client configuration

eloqdb.dll ELOQ Eloquence remote database client runtime

runsrv.exe ELOQ Eloquence remote execution utility

dlgsrv.exe ELOQ Eloquence dialog server

eqsrvws.dll ELOQ Eloquence WINSOCK 1.1 transport

eqclntws.dll ELOQ Eloquence WINSOCK 1.1 transport

eqsrvso.dll ELOQ Eloquence WSOCKETS transport

eqclntso.dll ELOQ Eloquence WSOCKETS transport

defaults.eq DLG Dialog Server defaults

File	Default directory	File Description
eloq.ini	WINDOWS	Eloquence client configuration
eloqdb.dll	ELOQ	Eloquence remote database client runtime
runsrv.exe	ELOQ	Eloquence remote execution utility
dlgsrv.exe	ELOQ	Eloquence dialog server
eqsrvws.dll	ELOQ	Eloquence WINSOCK 1.1 transport
eqclntws.dll	ELOQ	Eloquence WINSOCK 1.1 transport
eqsrvso.dll	ELOQ	Eloquence WSOCKETS transport
eqclntso.dll	ELOQ	Eloquence WSOCKETS transport
defaults.eq	DLG	Dialog Server defaults

Files related to the remote database access

The following files are related to developing applications which access the Eloquence database.

File Default directory File Description

eloqdb.h ELOQDB Include file

eloqdb.lib ELOQDB Import library

eloqdb.def ELOQDB Library definition file

File	Default directory	File Description
eloqdb.h	ELOQDB	Include file
eloqdb.lib	ELOQDB	Import library
eloqdb.def	ELOQDB	Library definition file

Files related to DLGSRV customization

The following files are related to DLGSRV customization.

File Default directory File Description

dlgsrv.mak DLGSRV Makefile

bind.obj DLGSRV

helpview.obj DLGSRV

bind.c DLGSRC\SRC Bind functions known to DM runtime

helpview.c DLGSRC\SRC Help system interface

dlgapi.h DLGSRV\H Required include files

dmdrv.h DLGSRV\H

dlgsrv.def DLGSRC\LIB Linker definitions

panel.rc DLGSRV\LIB DLGSRV resources

resource.h DLGSRV\LIB

hp.ico DLGSRV\LIB

note.ico DLGSRV\LIB

prog.ico DLGSRV\LIB

wave.ico DLGSRV\LIB

startup.obj DLGDRV\LIB DLGSRV runtime

convrt.obj DLGDRV\LIB

driver.obj DLGDRV\LIB

drvmain.obj DLGDRV\LIB

panel.obj DLGDRV\LIB

map.lib DLGSRC\LIB required by dlgsrv

File	Default directory	File Description
dlgsrv.mak	DLGSRV	Makefile
bind.obj	DLGSRV
helpview.obj	DLGSRV
bind.c	DLGSRC\SRC	Bind functions known to DM runtime
helpview.c	DLGSRC\SRC	Help system interface
dlgapi.h	DLGSRV\H	Required include files
dmdrv.h	DLGSRV\H
dlgsrv.def	DLGSRC\LIB	Linker definitions
panel.rc	DLGSRV\LIB	DLGSRV resources
resource.h	DLGSRV\LIB
hp.ico	DLGSRV\LIB
note.ico	DLGSRV\LIB
prog.ico	DLGSRV\LIB
wave.ico	DLGSRV\LIB
startup.obj	DLGDRV\LIB	DLGSRV runtime
convrt.obj	DLGDRV\LIB
driver.obj	DLGDRV\LIB
drvmain.obj	DLGDRV\LIB
panel.obj	DLGDRV\LIB
map.lib	DLGSRC\LIB	required by dlgsrv

Last update: 95/11/08