Eloquence for MPE Quick Start Guide
-----------------------------------
Welcome to Eloquence for MPE, the client library which allows your
HP 3000 software to access remote Eloquence databases.
This document is not a detailed manual, but instead is intended to
provide you with the basic steps necessary to get started using the
Eloquence for MPE client. Since you're reading this we assume that you
have already successfully installed the software (which, at this
writing, consists solely of a single NMXL library file). Further, we
will assume that you have installed the software in the default
location, and that the library is called IMAGE3K.PUB.ELOQ. It should
look very similar to this...
:listf image3k.pub.eloq,2
ACCOUNT= ELOQ GROUP= PUB
FILENAME CODE ------------LOGICAL RECORD----------- ----SPACE----
SIZE TYP EOF LIMIT R/B SECTORS #X MX
IMAGE3K NMXL 128W FB 7296 4096000 1 9008 1 *
If the CODE, SIZE, TYP or EOF columns don't match what you see on your
system, then there may have been a problem with the installation. If
that's the case, then please review your steps, or contact customer
service.
The following must be true in order to use the Eloquence client:
- Your HP 3000 is on a network.
- One of a) You know the IP address of the remote system
where an Eloquence database resides, or
b) You know the node name of the remote system and
your HP 3000 can resolve node names (most likely
via a DNS server, or perhaps via HOSTS.NET.SYS)
- Your HP 3000 can PING the remote system. (Use PING.NET.SYS if
you know the remote IP address, or NETTOOL.NET.SYS if you are
using a node name.)
- The software which will access the remote Eloquence database makes
use of the standard TurboIMAGE API's (Image intrinsics). In other
words, it doesn't do any privileged direct file access of the
Image data set files. (Certain HP and third-party utilities open
Image data sets directly, and therefore can't be used to access
remote Eloquence databases.)
The MPE Eloquence client is accessed simply by adding an "XL=..."
parameter to the invocation of any program which does standard Image
calls. If you would normally do...
:run myprog
...to access a local Image database, then the following would be
used to access a same-named Eloquence database in a remote location:
:run myprog;xl="image3k.pub.eloq"
An MPE CI variable called EQ_DBSERVER (or an environment variable,
if running a POSIX program from withinn the shell) is used to control
where the Eloquence client looks in order to find an Eloquence data-
base on a remote server. The value of the variable follows the format
"server:port", where "server" can either be a node name or an IP
address, and "port" is by default 8102.
From the MPE prompt you'd set the EQ_DBSERVER variable by doing one of
the following:
a) If the Eloquence server resides in the same subnet as your HP 3000
then simply do...
:setvar EQ_DBSERVER "somenode:8102"
b) If the Eloquence server is in a different subnet, then use a fully
qualified domain name...
:setvar EQ_DBSERVER "somenode.somecompany.com:8102"
c) Use an IP address...
:setvar EQ_DBSERVER "192.168.0.1:8102"
Similarly, inside the shell the command to set EQ_DBSERVER is...
$ export EQ_DBSERVER="somenode:8102"
For more information on database names and EQ_DBSERVER settings please
see
http://www.hp-eloquence.com/support/B07/relnotes
/B0700/hp3k/compat.html#db_name
(Sorry for the wrap; these two strings need to be pasted together to
create a valid URL)
A note on the port number: By default the Eloquence server process uses
port 8102. However, this is configurable and may be set by the server
administrator. The EQ_DBSERVER variable is the most common, and most
visible mechanism for setting the server port, but it can also be set
globally by adding the following entry to the services file:
eloqdb 8102/tcp # Eloquence data base server
Note: In the unix/posix world the services file is usually found in
/etc/services but in MPE it is SERVICES.NET.SYS
If your HP 3000 is on a network with access to the internet, then the
following is a good test to see the Eloquence client at work:
:setvar EQ_DBSERVER "invent9k.external.hp.com:8102"
:run query.pub.sys;xl="image3k.pub.eloq"
HP32216D.03.20 QUERY/NM FRI, JAN 23, 2004, 11:53 AM
COPYRIGHT HEWLETT-PACKARD CO. 1976
>b=sample
PASSWORD = >> { just hit RETURN here }
MODE = >>5
>s=customers
>find custno="32001 "
1 ENTRIES QUALIFIED
>r all
CUSTNO =32001
MATCHCODE =B¿HM
NAME1 =Ch. BÑhm GmbH & Co KG
NAME2 =Feinmechanik
NAME3 =
STREET =Archimedesstr. 1-4
ZIPCITY =D-7268 GECHINGEN
PHONE =08458/776
TURNOVER = .000000000000000
= 29475.5300000000
= 584773.570000000
SALESAREA =D
>exit
END OF PROGRAM
:
Note: if you don't have access to name resolution services, then try
replacing the string "invent9k.external.hp.com" with the IP address
192.6.38.25 in the SETVAR statement above.
In summary, then, to access any arbitrary remote Eloquence database you
simply set the EQ_DBSERVER variable as described above, and then run
your program with the XL="..." parameter to specify the location where
the IMAGE3K library is installed.
That's it, good luck!!
----------
2004-01-26