IIUG Software Repository Files

README FOR RDSLIB AND RDSLINK
=============================

RDSLIB Version 2010.02 (2010-09-04)

There are three programs in this product for use with Informix 4GL-RDS:

    rdsscan     - p-code scanner
    rdslib      - p-code librarian
    rdslink     - p-code linker

The rdsscan program is primarily intended as a diagnostic tool if something
goes wrong.

The rdslib program is analogous to the ranlib program that used to be
used by Unix C compilation systems.  It takes an archive file containing
p-code object files (*.4go), and adds an file which allows rdslink, the
p-code linker, to identify where functions, reports and global variables
are defined.

The rdslink program assembles a p-code program (*.4gi) from a collection
of object files (*.4go) and possibly a collection of p-code libraries
maintained by rdslib, the p-code librarian.

Of necessity, there is a symbiotic relationship between these two
programs; neither is of much use without the other.

Compilation
-----------

This is not as clean as it should be.

Examine the header config.h to see whether any of the predefined systems
is suitable (SOLARIS_2x is close for most SVR4 machines, including early
versions of Linux, but LINUX_GLIBC21 is better if you have the GNU C
Library v2.1 or later).  Copy Makefile to makefile and edit it to fix
the defines at the top so that they are suitable for your machine.  You
may want to uncomment the value for DEFINE2 in Makefile before you build
the product, and either set the value for STR_SYSTEM at the top of
Makefile or specify it on the command line when you build the product.

Run: make
Or:  make STR_SYSTEM="Your O/S Version"

Run: make test

Run: make BOD

Change to the BOD directory and run "jlss install rdslib".  You will
need to be root to do this, or you will need to specify one or more of
the command line options:

    -o owner
    -g group
    -d directory

Changes
-------

Julian Bridle (julian@kpgb.q8.co.uk) provided the basic changes for
handling p-code version 720 (and hence p-code versions 12 and 730).  He
also, at the same time, provided the changes to handle SVR4 archive
files with long file names.  These changes are the trigger for release
3.8 of RDSLIB.  Minor changes were made to version 2002.01 in October
2002 but not released to the IIUG.

Version 2003.01 adds support for I4GL-RDS 7.32.UC1 with its new p-code
version, 732.  This provides the extra information necessary to support
dynamic arrays.  The LICENCE file was added to document that this is GPL
code (of necessity).  This is unlikely to affect any users, but contact
the author if you need an alternative version.

Version 2006.01 adds support for the -M flag to rescan libraries, based
on a code patch submitted by Eric Wilde <ewilde@bsmdevelopment.com>.
The test case for multi-scan support found a core dump bug in the
previous code.  Updated to version 8 of stderr.h.  Reformatted local
code without tabs.

Also updated the p-code structure document, i4glrds.doc to reflect
I4GL-RDS 7.32.  Note that the file is written in troff, not Microsoft
Word.

Version 2007.01 and 2007.02 in response to a single patch from Julian
Bridle (Julian.Bridle@pacepetroleum.com), dealing with 32-bit vs 64-bit
compatibility issues.

@(#)$Id: README,v 3.5 2007/07/20 18:41:11 jleffler Exp $