        SGS release 1.0.x

These are the release notes for SGS version 1.0.  Read them carefully,
as they tell you what this is all about, explain how to install the
software, and what to do if something goes wrong. 

WHAT IS SGS?

  SGS is a unique sequence number generator that can be used by mSQL
  applications (and others) to provide unique identifiers. 

  SGS is a Sequence Generation System featuring a lightweight
  sequence daemon and an easy to use C API allowing you to use the
  functionality from within your favorite C, C++ or Objective-C
  applications.  The API provides functions for creating and
  destroying named sequences, getting the current or the next value,
  caching entries in memory, and setting the increment or the
  current value for each named sequence.

  Many client applications can access the sequence daemon, and need
  not be on the same machine, as they communicate with the daemon
  by means of TCP/IP networking.

  SGS is Copyright (C) 1995 Pascal Forget

  SGS is free software.  See COPYING for details.

  SGS is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

  Report problems and direct all questions to:

    sgs-bugs@wsc.com


INSTALLING SGS

  To install sgs, set the current directory to sgs/src.  Then, execute
  the "setup" script.  This will build the makefile for the project,
  and create the machine dependent header file site.h.  You will be
  prompted for the directory in which you want the sgs executables and
  datafiles to be installed, the make version, and a few other things.
  If you don't know what to answer to one of the questions, just press
  RETURN, as this will normally do the right thing.  Then, type
  "make install".  The API library will be built first, since both the
  client applications and the sequence daemon use it.  Then the daemon
  will be made, and finally the example programs.

  SGS has been tested on Linux, and NEXTSTEP, and I am currently
  working to get it compiling "right out of the box" on SunOS and
  Solaris. SGS is expected to run on BSD 4.3 Unixes, and most of
  System V implementations, with a little tweaking of the makefiles.

  As the release number suggests, this is a release version, and not
  an alpha or beta product.  It should work flawlessly all the time.

  If you experience some difficulties compiling or executing the
  software or if you would like to make some suggestions, send
  email to: sgs-bugs@wsc.com.  I'll be glad to help in any way I can.
  Now since SGS is free software, I cannot guarantee that I will be
  able to solve your problem, but I'll do my best to accommodate your
  needs.


AUTHOR'S DETAILS

  SGS was written by:

  Pascal Forget
  Chief Programmer, Arc Project
  Working on location at:
  Wall Street Concepts Investment Services
  90 Broad Street, New York NY USA 10004
  Phone: (212) 797-1887
  E-Mail: pascal@wsc.com, pascal@hasc.ca


ARCHIVE LOCATIONS

  ftp://bond.edu.au/pub/Minerva/msql/Contrib/sgs-1.0.0.tar.gz
  ftp://ceo-www.jrc.it/pub/sgs/src/sgs-1.0.0.tar.gz


ACKNOWLEDGEMENTS

  I would like to thank Dirk-Willem vanGulik <Dirk.vanGulik@jrc.it> for
  providing a ftp home to SGS, and for his suggestions; Peter Samuel
  <peter@uniq.com.au> for his help on setting up the Solaris 2 version, and
  Nicolas Viau <viau@citi.doc.ca> for taking the time to test drive the
  early drafts and inspect the code and make comments and suggestions.
  Many thanks also go to William J. O'Donovan, for helping me track down
  an insidius bug.

***************************************************************************

Release Notes For Version 1.0.0

* added the sgsSetHostname() API function
* Fixed known bugs
* Tested on NEXTSTEP and Linux
* Modified the setup script to work flawlessly on tested platforms

Release Notes For Version 0.2.0

* New API documentation
* Modifications to the 'setup' script for Solaris 2.x
* sgsd now prints an error message to the console when it fails to properly
  open the definitions or values files.
* New documentation on debugging and starting the sgsd daemon.
* Modification of the way API header files are included by the daemon
* New example program 'test' that performs quality assurance and benchmarking

Release Notes For Version 0.1.1

* Fixed the daemon failing to save properly the sequence definitions on file
* Prefixed the API function names with "sgs"
* Created the setup script that builds the makefile and the site.h file

Release Notes for version 0.1.0

* First release.  Initial tests on NEXTSTEP and Linux architectures.
