SimC Release 1.0

INTRODUCTION

1.    SimC is a function library for ANSI C and C++, providing 
support facilities for discrete and combined discrete-
continuous simulation including set operations and data
collection.  Before using, please see the separate note
(register.txt) on registration.

2.    The target audience of this documentation is the
simulation programmer.  It has to presume that the reader is
familiar with discrete and combined simulation, and the C/C++
language.


PACKAGE

3.    Content.  Besides this introductory note (intro.txt) the
distribution package should contain the following:

      a.    Documentation:

            intro.txt         - this file.
            events.txt        - reference on event functions.
            sets.txt          - reference on set functions.
            data.txt          - reference on data functions.
            quickref.txt      - quick reference of all functions.

      b.    References:

            simc_wmc.wp       - Reference 3.
            simc_ors.wp       - Reference 4.
            
      c.    Header and Library:

            simc.h      - SimC header file.
            simcs.lib   - library for small memory model (Borland C++).
            simcsm.lib  - library for small memory model (Microsoft Visual C++).

      d.    Sample/Test Files:      

            evtest.c    - for ev- functions
            prtest.c    - for process- functions
            ctest.c     - for continuous- functions
            settest.c   - for set- functions
            dtest.c     - for data functions

      The un-registered package will contain a library for the 
small memory model only.  A registered package will be
complete. SimC has also been compiled and used on other
operating systems and compilers.  For a distribution package
on specific operating systems and/or compilers, please contact
the author.

4.    Installation.  The header "simc.h" and library
"simc??.lib" need to be placed where your compiler and linker
could find them.  The header could be placed in the "include"
directory that many compilers require.  Similarly, the library
could be placed in the "library" directory that many linkers
require. Both could be placed in the directory where your
source code is.


CONVENTIONS

5.    Function Prefixes.  The names of all functions, macros
and data types of each module begin with the same word as
follows:

      a.    Set-        begin with "Set".
      b.    Event-      begin with "Ev".
      c.    Data-       begin with "Tally" or "Accum".
      d.    Process-    begin with "Process".
      e.    Continuous- begin with "Continuous".

6.    Identifiers.  SimC identifiers are generally descriptive 
and, hopefully, self-explanatory.  Compound words are
constructed by capitalizing the first letter of each word eg
the Set function to Read is named "SetRead".  User-defined
names should avoid starting with similar words, and if
required, perhaps should have a lower-cased first letter to
avoid confusion.

7.    Variables.  Names of all user-visible variables, data
structures and structure types are constructed by capitalizing
the first letter of each word and separating major groups by
underscores (_).  In addition, the names of all symbolic
constants defined in header files (#defined) begin with an
underscore (_).


TRADEMARKS

Microsoft Visual C++ is a registered trademark of Microsoft Corporation.
Borland C++ is a registered trademark of Borland International.


REFERENCES

[1]   Banks J. & Carson J.S. 1984.  Discrete-Event System
      Simulation.  Prentice Hall, Inc.

[2]   Kreutzer W. 1986.  System Simulation Programming Styles
      and Languages.  Addison-Wesley.

[3]   Toh C.S. 1993. "SimC, A C Function Library for Discrete
      Simulation".  In Proceedings of the SCS Multiconference
      on Simulation in Engineering Education 18-20 Jan.  (La
      Jolla, Ca).  SCS, San Diego, CA 92177, U.S.A.

[4]   Toh C.S. 1993. "SimC (Ver 2), A C Function Library for
      Discrete & Combined Simulation".  In Proceedings of the
      ORSS 1993 Seminar.  ORSS, NUS, Kent Ridge, Singapore.


