Project ABDUX X software for bibliographic look-ups

Paul Barker <P.Barker@cs.ucl.ac.uk> Tue, 01 March 1994 19:18 UTC

Received: from ietf.nri.reston.va.us by IETF.CNRI.Reston.VA.US id aa07930; 1 Mar 94 14:18 EST
Received: from CNRI.RESTON.VA.US by IETF.CNRI.Reston.VA.US id aa07926; 1 Mar 94 14:18 EST
Received: from haig.cs.ucl.ac.uk by CNRI.Reston.VA.US id aa14226; 1 Mar 94 14:18 EST
Received: from bells.cs.ucl.ac.uk by haig.cs.ucl.ac.uk with local SMTP id <g.19702-0@haig.cs.ucl.ac.uk>; Tue, 1 Mar 1994 18:19:42 +0000
Received: from bunnahabhain.cs.ucl.ac.uk by bells.cs.ucl.ac.uk with local SMTP id <g.29699-0@bells.cs.ucl.ac.uk>; Tue, 1 Mar 1994 18:19:34 +0000
To: osi-ds@cs.ucl.ac.uk
Subject: Project ABDUX X software for bibliographic look-ups
Date: Tue, 01 Mar 1994 18:19:32 +0000
Sender: ietf-archive-request@IETF.CNRI.Reston.VA.US
From: Paul Barker <P.Barker@cs.ucl.ac.uk>
Message-ID: <9403011418.aa14226@CNRI.Reston.VA.US>

------- Forwarded Message

A new version of XLookUp for Motif (MXLU) is available for FTP.
MXLU can be retrieved in both source and binary forms. Further
details can be found in the appended release README file.

This version of MXLU also supports the ABDUX pilot service.
ABDUX is Accessing Bibliographic Data Using X.500.

The SUN4 binary release details are:

 ftp://src.brunel.ac.uk/x500/mxlubin-1.1.tar.Z

The binary release is a standalone setup that includes all
neccessary ISODE-8.0 support libraries and configuration
files. Local Motif libraries will not be needed as they are
statically linked into the MXLU binary.

To pick up the source release, retrieve both of the following:

 ftp://src.brunel.ac.uk/x500/query-1.1.tar.Z
 ftp://src.brunel.ac.uk/x500/mxlu-1.1.tar.Z

The source tar files should be unpacked in the same directory.
Requirements are:

 - Motif 1.2.1 or later
 - X11R4 or later (some versions of OpenWindows can cause problems)
 - ISODE headers and libraries.

The README file for the source release is appended.

	Cheers, damy

-----------------------------------<README>-----------------------------------

------------------------------------------------------------------------------
- Motif XLookUp (MXLU) Version 1.1			   28th January 1994.
------------------------------------------------------------------------------

MXLU is an X-Windows/Motif DUA interface to the X.500 directory.
Main features are:

 - Two user friendly search strategies.
 - Browsing capability.
 - Highly tailorable front end.
 - Access to most directory modification operations,
   i.e. add, delete and modify.
 - Facility to communicate with X.400 MUAs (notably XUA).

------------------------------------------------------------------------------
- Documentation.
------------------------------------------------------------------------------

No system manuals or manual pages are currently available,
though (with any luck) this situation will change in the
next week or so.

------------------------------------------------------------------------------
- Requirements.
------------------------------------------------------------------------------

This version of MXLU requires:

 - ISODE 8.0 (though few changes should be necessary in order to
   compile with the ISODE Consortium release).

 - Version 1.2.1 of OSF/Motif.

 - Version 1.1 of the Brunel Query engine library (this is available
   from the Brunel FTP archive (src.brunel.ac.uk) in the file
   "x500/query-1.1.tar.Z".

------------------------------------------------------------------------------
- Directories.
------------------------------------------------------------------------------

The release tree contains the following directories:

 - SRC
   The MXLU source code.

 - CONFIG
   A set of default configuration files.

 - HELP
   Online help text files.

------------------------------------------------------------------------------
- Compilation.
------------------------------------------------------------------------------

 - Follow the instructions in the README found in the "brunel.dua" directory
   (one above this one).

 - Compile the Query engine library if you haven't already done so).
   This should be placed in the "brunel.dua/query-1.1" directory.

 - Run the make script (with ./make) in the "brunel.dua/mxlu-1.1".

Compilation will result in a binary "brunel.dua/mxlu-1.1/src/xmxlu".
This can be tested by changing to the binary's directory and running
with:

 ./xmxlu -test

To install run the above make script with the "inst-all" flag, i.e.:

 ./make inst-all

The install procedure copies the MXLU binary (xmxlu) to SBINDIR
and installs a public invoking shell script (mxlu) to BINDIR,
where SBINDIR and BINDIR correspond to the appropriate ISODE
directories.

------------------------------------------------------------------------------
- Configuration.
------------------------------------------------------------------------------

Username, password and service parameters are read from
.quipurc.

The default runtime configuration file is called "mxlurc"
Four alternative configurations are supplied:
 
 simple.ufn -   Uses the UFN search strategy,
                multiple windows.
      
 simple.form -  Uses the form based search strategy,
                multiple windows.

 full.ufn -     Uses the UFN search strategy,
                multiple windows,
                modify/add/delete present.
        
 full.form -    Uses the form based search strategy,
                multiple windows, modify/add/delete present.

 lib -		For use with the ABDUX pilot service
		(see below).
 
To set up local search paths edit the "entryDB" options
at the top of the configuration file you're using, i.e.
substitute the DNs given for local ones.
 
entryDB : org1 : "c=GB@o=Brunel University"
entryDB : country1 : "c=GB"
entryDB : country2 : "c=US"
 
A manual giving full and proper instructions will be made
available in due course.

------------------------------------------------------------------------------
- Project ABDUX.
------------------------------------------------------------------------------

ABDUX is Accessing Bibliographic Data Using X.500.

Configuration files supporting the ABDUX pilot service are supplied.
To install these run:

 ./make inst-abdux

This will install a shell script called xabdux, which calls MXLU with
an ABDUX specific configuration and binds to the ABDUX pilot DSA.

IMPORTANT: Please note that if you're linking against ISODE-8.0
then you'll probably have to recompile the libraries to accomodate
a larger schema. This means editing the header file "quipu/oid.h"
to set TABLESIZE to 400, i.e.:

#define TABLESIZE 1000

Then re-compile the DSAP library. The DSA will also need re-building
unless dynamically linked with the DSAP library.

------------------------------------------------------------------------------
- Bugs, comments etc.
------------------------------------------------------------------------------

All bug reports and comments are welcome. Please mail them to:
        
 x500@brunel.ac.uk
 
Andrew Findlay, Damanjit Mahl, Paul Wain
Computing and Media Services
Brunel University
Uxbridge Middlesex
UB8 3PH
 

------- End of Forwarded Message