contact contact

Eloquence B.07.00 Release Notes
MPE Client Library


What is Eloquence for MPE/iX?

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

User programs that utilize the standard set of TurboIMAGE intrinsics can access remote Eloquence databases as if they were local to the HP 3000. Certain HP-supplied system utilities, such as QUERY.PUB.SYS can also reference the client library and gain access to remote Eloquence databases.

Current Limitations

  • The Eloquence client is not compatible with TPI products (Superdex/Omnidex). The TPI functions included with the Eloquence server are available.

  • 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 to redirect a database's locations will likely not work.

  • As specified in the Eloquence image3k documentation, the Eloquence database is close but not 100% compatible to TurboIMAGE. As a consequence, most 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 (which is employed by some well known third party utilities) is not supported.

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

How do I obtain the Eloquence client software?

Eloquence for MPE is available for download via the web, and is offered in three formats:

What gets installed?

The installation process asks where you would like to install the software. Assuming you select the default, which is the ELOQ account, then the following files are installed:
   IMAGE3K.PUB.ELOQ        (the NMXL Eloquence client library)
   README.PUB.ELOQ         (a "quick start" guide)

What do I do next?

Once you've successfully downloaded and installed the Eloquence for MPE client software on your HP 3000, please read the README file that was installed in the same group as the library (most likely in README.PUB.ELOQ). That file contains a quick start guide to get you up and running. For your convenience the README file is also available online.

Known Problems (and Solutions)

When running an application in privileged mode or loading privileged libraries you may get an error like below:
  File = /usr/lib/libsocket.sl
  The file being loaded is less privileged than the previous file in
  the binding sequence. (LDRERR 602)
  Native mode loader message 602
The IMAGE3K library depends on some POSIX libraries (libsocket and libc) that are loaded from /usr/lib (a hfs directory). However, in some cases privileged applications cannot load libraries located in hfs directories.

Once a library has been loaded with PM, any libraries that follow must also have PM. Unfortunately, since posix/hfs directories can't be assigned PM (only MPE groups can) your only recourse will be to copy the appropriate posix libraries to a location that does have PM, and alter the IMAGE3K library to reference them there.

First we enable the PM privilege for the eloq account and the pub.eloq group. This requires SM capabilities:

  :altacct eloq;cap=+pm;pass=xxxxxxxx
  :altgroup pub.eloq;cap=+pm
where "xxxxxxxx" is a user-selected password. The current installation script doesn't put any password security on the ELOQ account; it isn't really necessary. However, if the account gets PM capability added, then it becomes a potential security hole, and you should consider to add a password.

Then copy the libsocket and libc shared libraries to the pub.eloq group and change the image3k library to load the libraries. Here might be a good place to log in as MGR.ELOQ,PUB (doing so will ensure that no ACDs get added to your library files when you copy them over).

  :copy /usr/lib/libsocket.sl, /ELOQ/PUB/libsocket.sl
  :copy /lib/libc.sl, /ELOQ/PUB/libc.sl
  :newlink link=/ELOQ/PUB/LIBSOCK;to=/ELOQ/PUB/libsocket.sl
  :newlink link=/ELOQ/PUB/LIBC;to=/ELOQ/PUB/libc.sl
  LinkEd> altxl image3k.pub.eloq;lib=libsock.pub.eloq,libc.pub.eloq
  LinkEd> exit

When running QUIZ (or other COGNOS PowerHouse programs) you need to list the IMAGE3K library before the PowerHouse libraries. The RUN statement should look similar like below (depends on the PowerHouse versions):

  :run quiz.ph819c3.cognos;xl="image3k.pub.eloq,*phlibodx,*phlibxl"
Otherwise QUIZ could fail with an error message like below:
  *E* Could not open the language table specified by COGNLSTAB.

How do I get support?

Support is available through all the standard Eloquence support channels:

  Privacy | Webmaster | Terms of use | Impressum Revision:  2004-02-05  
  Copyright © 1995-2003 Marxmeier Software AG