@AWK 'READ-THIS' File

                           @ A W K
                           =======

@AWK is a port of the awk programming langauge to Unisys
2200/Dorado computers.  This is version 1R1Q1 released on
2012-01-09.

The source for this port ("updated May 1, 2007") is:
     http://www.cs.bell-labs.com/cm/cs/awkbook/index.html

Please read my disclaimer at the bottom of this element.  My
contribution to @AWK is distributed under the GNU General
Public License (GPL), version 2.  For more information, please
see the LICENSE-2200 element distributed with this software.

Also please read Lucent Technologies' copyright notice,
license and disclaimer at the top of element MAIN/C.

Your use of @AWK indicates your acceptance of these terms.

This software has passed a few tests but has not been tested
extensively.  Therefore, I do not know whether it works.  So
please consider this to be experimental, and not of production
quality.

Some expected areas of difficulty:
- Environment variables.
- popen and pclose.
- Anything that expects a hierarchical file directory.

I would appreciate bug reports, but do NOT promise any fixes
or support.  Feel free to send YOUR fixes if possible.

To call @AWK, you must use the alternate processor call syntax
(or whatever Unisys calls it).  Assuming that you've installed
@AWK or copied the ZOOM to TPF$, you can run a simple program
via:

     @'AWK  'BEGIN { print "Hello, world!" }'

If your program is in an element:

     @'AWK -f YOURQUAL*YOURFILE.HELLOWORLD

If your program reads an input data file (or element):

     @'AWK -f YOURQUAL*YOURFILE.YOURPGM  YOURQUAL*YOURDATA.

You can get version information via:

     @'AWK --version

A simple example of @AWK use is found in the element
SMALLEST-DIV/AWK.


Enjoy,
  Steve J. Martin
  2012-01-09



  **********************************************************************
  **                                                                  **
  **                        D I S C L A I M E R                       **
  **                                                                  **
  **  THIS PROGRAM IS PROVIDED WITHOUT CHARGE ON AN "AS IS" BASIS.    **
  **  AS SUCH, WARRANTY IS NEITHER EXPRESSED NOR IMPLIED.             **
  **                                                                  **
  **  IT IS EXPECTED THAT THIS PROGRAM WILL BE CAREFULLY EVALUATED    **
  **  AS TO SUITABILITY AND CORRECTNESS BY AN EXPERIENCED 'UNIVAC'    **
  **  1100/2200 INTERNALIST BEFORE BEING USED.  THE AUTHOR(S) AND/OR  **
  **  AGENT(S) OF THE AUTHOR(S) ASSUME NO LIABILITY FOR DAMAGE        **
  **  DIRECTLY OR INDIRECTLY CAUSED BY THIS PROGRAM, INCLUDING BUT    **
  **  NOT LIMITED TO CASES WHERE SUCH DAMAGE RESULTS FROM PROGRAM     **
  **  MALFUNCTION, PROGRAM DESIGN DEFICIENCY, INACCURATE OR           **
  **  INADEQUATE DOCUMENTATION, IMPROPER USE, OR DESIGN/CODING        **
  **  CHANGES IN 1100/2200 HARDWARE OR SOFTWARE SYSTEMS.              **
  **                                                                  **
  **  USE OF THIS PROGRAM IS AT YOUR OWN RISK.  IF YOU ARE NOT SURE   **
  **  OF WHAT YOU'RE DOING, IT IS STRONGLY RECOMMENDED THAT YOU NOT   **
  **  USE THIS PROGRAM.                                               **
  **                                                                  **
  **********************************************************************

*EOF*