| |
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 BEING LOADED IS LESS PRIVILEGED THAN THE PREVIOUS
FILE IN THE BINDING SEQUENCE.
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
:linkedit
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:
|
|
