B0700/mpe/client
----------------

Eloquence MPE client library

This is a port of the Eloquence image3k library to MPE that allows
to access remote Eloquence databases from MPE.
When used it captures the HP3000 TurboIMAGE intrinsic calls and 
redirects them towards an Eloquence database on a remote system.

Please refer to the location below for detailed installation
instructions:

http://eloquence.marxmeier.com/support/B07/mpeclient/


Requirements:
-------------

- MPE/iX version 6.0 or above
- Functional POSIX environment
- The HP 3000 is connected to a network


Limitations:
------------

* The Eloquence client library is not compatible with TPI products
  (Superdex/Omnidex). However you may use the TPI functions included 
  with the Eloquence server as a replacement.

* The client redirects all IMAGE access to Eloquence. 
  Future versions will likely be enhanced to make this configurable, 
  so that certain databases can be remote, while others can be local.

* Using file equations with databases will likely not work.

* As specified in the Eloquence documentation 
  (http://eloquence.marxmeier.com/support/B07/relnotes/B0700/hp3k/index.html), 
  the Eloquence database is close but not 100% compatible to TurboIMAGE. 
  As a consequence, the TurboIMAGE utilities (such as DBUTIL) will not 
  work with the Eloquence client XL.

* Programs that access remote Eloquence databases via the client XL 
  must make use of standard TurboIMAGE intrinsics. Privileged direct 
  access to data set files is not supported.

* Accessing a database remotely is expected to be noticeably slower 
  than acessing a local database.


Download and installation
-------------------------

The Eloquence image3k library is available for download in three 
formats:

eloqstd.wrq   - WRQ Labels format
eloqstd.bin   - STORE format
eloqtar.tar   - tar format

The md5sum file provides the MD5 checksums of the download files.

The following files are installed:
IMAGE3K.PUB.ELOQ  - the NMXL Eloquence client library
README.PUB.ELOQ   - a "quick start" guide

Installation requires SM capabilities.


WRQ labels format
-----------------

1. Upload eloqstd.wrq to the file ELOQSTD.PUB.SYS on your HP 3000.
   It is important that you use the LABELS transfer type.

2. On your HP 3000, verify that the ELOQSTD file looks correct:

   :LISTF ELOQSTD,2
   ACCOUNT=  SYS         GROUP=  PUB     
   FILENAME  CODE  ------------LOGICAL RECORD-----------  ----SPACE----
                     SIZE  TYP        EOF      LIMIT R/B  SECTORS #X MX
   ELOQSTD   STORE   128W  FB        2436   16776959   1     4096  5 32

   Please verify that the file code is STORE, the file record is 128W FB, 
   and the EOF must match what you see above.

3. Run the installation macro file (ELOQINST.PUB.SYS) from the archive:

   :file e=eloqstd;dev=disc
   :restore *e;eloqinst.pub.sys;local;show
   :xeq eloqinst


STORE format
------------

1. Upload eloqstd.bin to the file ELOQSTD.PUB.SYS on your HP 3000.
   It is important that you use the BINARY transfer type.

   Beloq is a sample ftp session:

   > binary
   > cd /SYS/PUB/
   > put eloqstd.bin ELOQSTD;rec=128,1,F,binary;code=2501
   > bye

2. On your HP 3000, verify that the ELOQSTD file looks correct:

   :LISTF ELOQSTD,2
   ACCOUNT=  SYS         GROUP=  PUB     
   FILENAME  CODE  ------------LOGICAL RECORD-----------  ----SPACE----
                     SIZE  TYP        EOF      LIMIT R/B  SECTORS #X MX
   ELOQSTD   STORE   128W  FB        2436     204800   1     2448  5  8

   Please verify that the file code is STORE, the file record is 128W FB,
   and the EOF must match what you see above.

3. Run the installation macro file (ELOQINST.PUB.SYS) from the archive:

   :file e=eloqstd;dev=disc
   :restore *e;eloqinst.pub.sys;local;show
   :xeq eloqinst


TAR format
----------

1. Upload eloqstd.tar to the file ELOQSTD.PUB.SYS on your HP 3000.
   It is important that you use the BINARY transfer type.

   Beloq is a sample ftp session:

   > binary
   > cd /SYS/PUB/
   > put eloqtar.tar ELOQTAR;REC=128,,V,BINARY
   > bye

2. On your HP 3000, verify that the ELOQSTD file looks correct:

   :LISTF ELOQSTD,2
   ACCOUNT=  SYS         GROUP=  PUB
   FILENAME  CODE  ------------LOGICAL RECORD-----------  ----SPACE----
                     SIZE  TYP        EOF      LIMIT R/B  SECTORS #X MX
   ELOQTAR           128W  VB        2460     204800   1     2512  5  8

   Please verify that the file code is STORE, the file record is 128W VB,
   and the EOF must match what you see above.

3. Run the installation macro file (ELOQINST.PUB.SYS) from the archive:

   :tar.hpbin.sys "xvfo ./ELOQTAR ./ELOQINST"
   :xeq eloqinst eloqtar


---
Revision: 2004-02-03