***************************************************************************
*  TLS SAMPLE PROJECT: Readme File                                        *
*                                                                         *
* COPYRIGHT: Copyright(C) International Business Machines Corp.,1995.     *
*                                                                         *
* DISCLAIMER OF WARRANTIES:                                               *
*   The accompanying code is sample code created by the IBM Corporation.  *
*   This sample code is not part of any standard IBM product and is       *
*   provided to you solely for the purpose of assisting you in the        *
*   development of your applications.  The code is provided "AS IS",      *
*   without warranty of any kind.  IBM shall not be liable for any        *
*   damages arising out of your use of the sample code, even if they      *
*   have been advised of the possibility of such damages.                 *
***************************************************************************
SAMPLE - TLS
   DESCRIPTION:
        Through the use of the __thread keyword, The VisualAge for C++
        compiler provides Thread-Local Storage (TLS) support. Static and global
        TLS variables declared with this keyword will have copies created on
        a per-thread basis. This means that each thread will have its own copy
        of a TLS variable which can be modified without affecting the contents
        of the variable in any other thread.

   TASK:
        Shows multiple threads modifying a static TLS variable.

   CONCEPT/FEATURE:
        This program creates two threads. The first thread modifies the
        value of a static TLS variable. The second thread checks the value
        of this variable to verify that its local copy has not been
        affected.

        For more information on VisualAge for C++'s TLS support, please refer
        to VisualAge for C++'s Programming Guide.

   SOURCE FILE LOCATION:
        X:\ibmcppw\samples\compiler\tls

        where X: is the drive you installed the samples and document
        component of VisualAge for C++.


HOW TO RUN THE SAMPLE:

   FROM THE COMMAND LINE:
        Simply type the name of the .EXE file, that is:

            TLS


HOW TO BUILD THE SAMPLE YOURSELF:

   FROM THE COMMAND LINE:

       Run NMAKE

SOURCE FILES - TLS:

    FILE NAME(s)   DESCRIPTION
    ------------   ------------
    tls.c          C source code for TLS sample.
    makefile       Makefile to build the sample.


MORE VISUALAGE FOR C++ SAMPLES INFORMATION:

    A complete listing of samples shipped with the VisualAge for C++
    product can be found in the online GUIDE to SAMPLES. To access this
    notebook, simply:

    - Open the VISUALAGE FOR C++ program group in the Program Manager window,
      then,

    - Open the GUIDE TO SAMPLES notebook in the program group.

