What is the Eloquence Client Library for MPE/iX?
The Eloquence Client Library for MPE/iX is a port of the Eloquence image3k library to MPE (as an NMXL).
It provides access to remote Eloquence databases from (native mode) MPE programs.
User programs that reference the library and which utilize the standard set of Image 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 any TPI product (Superdex/Omnidex). However you may
use the TPI functions included with the Eloquence server.
- As specified in the Eloquence documentation
(Eloquence image3k documentation),
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 (which is employed by some well
known third party utilities) is not supported.
- Accessing a database remotely is expected to be noticeably slower than accessing a local database,
depending on application and network properties. Version B.07.10 of the Eloquence Client Library uses
techniques like client side caching to mitigate some of the underlying handicaps.
How do I obtain the Eloquence client software?
The Eloquence Client Library for MPE is available for download via the web:
After downloading the above binary file, you need to upload it to your HP 3000 for
unpacking. We recommend to use the FTP file transfer program (also available
from the Command Prompt on Windows). The following example shows the FTP
commands for transferring the local PC file in binary mode, creating a file in bytestream
format and with a POSIX style (HFS) filename on the HP 3000 side:
C:\> ftp your3000.example.com
Connected to your3000.example.com.
220 HP ARPA FTP Server [A0012C05] (C) Hewlett-Packard Co. 2000 [PASV SUPPORT]
Name (your3000.example.com:yourname): user.demo
331 Password required for USER.DEMO. Syntax: userpass,acctpass
Password:
230 User logged on
Remote system type is MPE/iX.
ftp> binary
200 Type set to I.
ftp> put C:\temp\image3k.tar.Z /tmp/image3k.tar.Z;REC=,,B
150 File: /tmp/image3k.tar.Z;REC=,,B opened; data connection will be opened
226 Transfer complete.
ftp> bye
221 Server is closing command connection
Note the ;REC=,,B option in the above example that is appended to
the target filename without any spaces. This overrides the default BUILD parameters
on the HP 3000 side to have the target file created in bytestream format.
If you prefer to use your favorite terminal emulator's file transfer option,
make sure to perform the transfer in binary mode and create the target file as
bytestream or fixed binary (FB) format on the HP 3000 side (not variable
binary VB format).
How do I install the Eloquence client software?
After transferring the above image3k.tar.Z archive file to your HP 3000, you
uncompress and unpack it with the POSIX tar utility that is included with recent
versions of MPE/iX and may be invoked from inside the POSIX shell or from the MPE
command prompt. The following example shows the use of the tar command to unpack
the files; it assumes that you are already logged on to the MPE group or directory
where you want the library to be placed (use CHGROUP or CHDIR as needed):
:LISTFILE /tmp/image3k.tar.Z ,2
PATH= /tmp/
CODE ------------LOGICAL RECORD----------- ----SPACE---- FILENAME
SIZE TYP EOF LIMIT R/B SECTORS #X MX
1B BA 313344 2147483647 1 1232 4 * image3k.tar.Z
:XEQ /bin/tar "-xvzopf /tmp/image3k.tar.Z"
x README, 14149 bytes, 28 tape blocks
x IMAGE3K, 1749504 bytes, 3417 tape blocks
:LISTF IMAGE3K ,2
ACCOUNT= DEMO GROUP= PUB
FILENAME CODE ------------LOGICAL RECORD----------- ----SPACE----
SIZE TYP EOF LIMIT R/B SECTORS #X MX
IMAGE3K NMXL 128W FB 6834 4096000 1 6848 7 *
:# optionally purge the compressed tar archive after unpacking it...
:PURGE /tmp/image3k.tar.Z
Notice that you may install or copy the Eloquence Client Library for MPE into
any MPE group or directory of your choice. However, if you plan to use it in
conjunction with PRIV MODE programs or libraries, it needs to reside in an MPE
group which has PM capability (using PUB.SYS is possible) as you would otherwise
get the following error message from the MPE loader when attempting to run
privileged programs or libraries together with the IMAGE3K library:
:RUN DEMOPROG.PRV.DEMO;XL="IMAGE3K.PUB.DEMO"
FILE BEING LOADED IS LESS PRIVILEGED THAN THE PREVIOUS
FILE IN THE BINDING SEQUENCE.
File = IMAGE3K.PUB.DEMO
The file being loaded is less privileged than the previous file in the binding
sequence. (LDRERR 602)
Native mode loader message 602
Unable to load program to be run. (CIERR 625)
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
(README.PUB.DEMO in the example above). That file contains a quick
start guide to get you up and running.
For your convenience the README file is
also available online.
Please note: This IMAGE3K release includes some changes in
configuration over the previous versions. Even if you previously used
an older IMAGE3K version, please read the README document and review the
section on changes to previous versions.
How do I get support?
Support is available through all the standard Eloquence
support channels:
|
