home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / ibmtsonih / tsnalp.txt < prev    next >
Text File  |  2020-01-01  |  3KB  |  76 lines
  1.                          ALP INSTALLATION
  2.  
  3. The ALP files are
  4.  
  5.   TSNALP.TXT            This text
  6.   TSNALP.DOC            Upper-lower case text for the most recent
  7.                         user documentation.
  8.   TSNTST.ALP            An ALP test program using all constructs
  9.   TSNALP.PLI            PL/I source for ALP
  10.   TSNPST.PLI            PL/I source for the post-processor (which
  11.                         processes the ALP and Assembler listings
  12.                         to produce a new ALP listing with location
  13.                         counter values)
  14.   TSNMAC.ALP            The macro library used with ALP-generated
  15.                         code (IEBUPDTE input)
  16.   TSNPCH.ASM            Source for an assembly language program
  17.                         which links first to ALP and then to
  18.                         Assembler H
  19.   TSNPCX.ASM            Same as above, but for Assembler FX.
  20.   TSNALP.JCL            Sample cataloged procedures for using ALP
  21.  
  22.  
  23. INSTALLATION:
  24.  
  25. 1. The PL/I source must be compiled by the Optimizing compiler using
  26.    the preprocessor (MACRO option) for ALP.  Recommended options are:
  27.  
  28.       OPT(2)       optimization in effect
  29.       SEQ(74,78)   location of 5-digit PL/I sequence numbers
  30.       GN,NUM       use of sequence numbers in compile and
  31.                    run-time error messages
  32.       MACRO,IS,NS  use of preprocessor: list macro source
  33.                    input, but not expanded source (not needed for
  34.                    POSTALP)
  35.  
  36. 2. The resulting object modules must be linkedited with the PL/I
  37.    library and placed in an appropriate data set.
  38.  
  39. 3. The macro library is partially coded in ALP.  It is installed by
  40.    feeding the source through ALP and then feeding the output to
  41.    IEBUPDTE to actually create the library.  The JCL at the start of
  42.    the macro library data set should be removed first.  It is handy
  43.    to have a cataloged procedure which calls ALP, scratches any old
  44.    version of a macro library, and then calls IEBUPDTE to create
  45.    the new version in its entirety from the ALP output.
  46.    Alternatively, individual macros may be updated by first passing
  47.    them to ALP and then giving the output to IEBUPDTE.
  48.  
  49. 4. Cataloged procedures for invoking the preprocessor and the
  50.    assembler should be installed. Necessary files (DDNAMES) are:
  51.  
  52.       ALP: SYSIN    - ALP source input
  53.            SYSPRINT - preprocessor listing of input, etc.
  54.            SYSOUT   - assembly source generated by ALP
  55.            SYSTERM  - diagnostic output from ALP
  56.  
  57.       ASSEMBLER: Only the normal assembler files, except that
  58.                  SYSIN is the data set created by ALP (its SYSOUT)
  59.  
  60.       POSTALP: SYSPRINT - ALP listing (input)
  61.                ASMPRINT - Assembler listing (input)
  62.                NEWPRINT - new ALP listing (output)
  63.                ALTPRINT - copy of Assembler listing (optional output)
  64.                ASMHTERM - SYSTERM listing for Assembler H generated
  65.                           from the assembly listing (optional)
  66.                POSTERR  - PL/I runtime error messages
  67.  
  68.  
  69. Address questions about ALP to:  Roger Fajman
  70.                                  Building 12, Room 2239
  71.                                  Computer Center
  72.                                  National Institutes of Health
  73.                                  Bethesda, Md. 20205
  74.  
  75.                                  Phone:  (301) 496-5181
  76.