ALP INSTALLATION

The ALP files are

  TSNALP.TXT            This text
  TSNALP.DOC            Upper-lower case text for the most recent
                        user documentation.
  TSNTST.ALP            An ALP test program using all constructs
  TSNALP.PLI            PL/I source for ALP
  TSNPST.PLI            PL/I source for the post-processor (which
                        processes the ALP and Assembler listings
                        to produce a new ALP listing with location
                        counter values)
  TSNMAC.ALP            The macro library used with ALP-generated
                        code (IEBUPDTE input)
  TSNPCH.ASM            Source for an assembly language program
                        which links first to ALP and then to
                        Assembler H
  TSNPCX.ASM            Same as above, but for Assembler FX.
  TSNALP.JCL            Sample cataloged procedures for using ALP


INSTALLATION:

1. The PL/I source must be compiled by the Optimizing compiler using
   the preprocessor (MACRO option) for ALP.  Recommended options are:

      OPT(2)       optimization in effect
      SEQ(74,78)   location of 5-digit PL/I sequence numbers
      GN,NUM       use of sequence numbers in compile and
                   run-time error messages
      MACRO,IS,NS  use of preprocessor: list macro source
                   input, but not expanded source (not needed for
                   POSTALP)

2. The resulting object modules must be linkedited with the PL/I
   library and placed in an appropriate data set.

3. The macro library is partially coded in ALP.  It is installed by
   feeding the source through ALP and then feeding the output to
   IEBUPDTE to actually create the library.  The JCL at the start of
   the macro library data set should be removed first.  It is handy
   to have a cataloged procedure which calls ALP, scratches any old
   version of a macro library, and then calls IEBUPDTE to create
   the new version in its entirety from the ALP output.
   Alternatively, individual macros may be updated by first passing
   them to ALP and then giving the output to IEBUPDTE.

4. Cataloged procedures for invoking the preprocessor and the
   assembler should be installed. Necessary files (DDNAMES) are:

      ALP: SYSIN    - ALP source input
           SYSPRINT - preprocessor listing of input, etc.
           SYSOUT   - assembly source generated by ALP
           SYSTERM  - diagnostic output from ALP

      ASSEMBLER: Only the normal assembler files, except that
                 SYSIN is the data set created by ALP (its SYSOUT)

      POSTALP: SYSPRINT - ALP listing (input)
               ASMPRINT - Assembler listing (input)
               NEWPRINT - new ALP listing (output)
               ALTPRINT - copy of Assembler listing (optional output)
               ASMHTERM - SYSTERM listing for Assembler H generated
                          from the assembly listing (optional)
               POSTERR  - PL/I runtime error messages


Address questions about ALP to:  Roger Fajman
                                 Building 12, Room 2239
                                 Computer Center
                                 National Institutes of Health
                                 Bethesda, Md. 20205

                                 Phone:  (301) 496-5181