How to build an executable version of Kermit-TSO   (3 Feb 1987)
================================================

Kermit-TSO is composed of four assembly language subroutines, and the
PASCAL main program. They should separately be assembled resp. compiled
and then linked together.

   1. Extract four assembler routines from file KERMIT.ASM

   2. Make sure a TSO command is installed, which allows you to run some
      other TSO commands and reroute their output to a file.

   3. If your site's ASCII/EBCDIC translation table does not conform
      to the one implemeted in the PASCAL source, then enter the
      corresponding translation table for your site.

      The original translation tables look as follows:

      +--------------------------------------------------------+
      |  ASCIITOEBCDIC =                                       |
      |         '010203372D2E2F1605250B0C0D0E0F'XC ||  (* 0 *) |
      |       '101112133C3D322618193F271C1D1E1F'XC ||  (* 1 *) |
      |       '405A7F7B5B6C507D4D5D5C4E6B604B61'XC ||  (* 2 *) |
      |       'F0F1F2F3F4F5F6F7F8F97A5E4C7E6E6F'XC ||  (* 3 *) |
      |       '7CC1C2C3C4C5C6C7C8C9D1D2D3D4D5D6'XC ||  (* 4 *) |
      |       'D7D8D9E2E3E4E5E6E7E8E9ADE0BD5F6D'XC ||  (* 5 *) |
      |       '79818283848586878889919293949596'XC ||  (* 6 *) |
      |       '979899A2A3A4A5A6A7A8A9C04FD0A107'XC ||  (* 7 *) |
      |       '00000000000000000000000000000000'XC ||  (* 8 *) |
      |       '00000000000000000000000000000000'XC ||  (* 9 *) |
      |       '00000000000000000000000000000000'XC ||  (* A *) |
      |       '00000000000000000000000000000000'XC ||  (* B *) |
      |       '00000000000000000000000000000000'XC ||  (* C *) |
      |       '00000000000000000000000000000000'XC ||  (* D *) |
      |       '00000000000000000000000000000000'XC ||  (* E *) |
      |       '00000000000000000000000000000000'XC ;   (* F *) |
      |                                                        |
      |                                                        |
      |  EBCDICTOASCII =                                       |
      |         '0102030009007F0009000B0C0D0E0F'XC ||  (* 0 *) |
      |       '1011121300000800181900001C1D1E1F'XC ||  (* 1 *) |
      |       '00000000000A171B0000000000050607'XC ||  (* 2 *) |
      |       '0000160000000004000000001415001A'XC ||  (* 3 *) |
      |       '200000000000000000005C2E3C282B7C'XC ||  (* 4 *) |
      |       '2600000000000000000021242A293B5E'XC ||  (* 5 *) |
      |       '2D2F00000000000000007C2C255F3E3F'XC ||  (* 6 *) |
      |       '000000000000000000603A2340273D22'XC ||  (* 7 *) |
      |       '00616263646566676869007B00000000'XC ||  (* 8 *) |
      |       '006A6B6C6D6E6F707172007D00000000'XC ||  (* 9 *) |
      |       '007E737475767778797A0000005B0000'XC ||  (* A *) |
      |       '000000000000000000000000005D0000'XC ||  (* B *) |
      |       '7B414243444546474849000000000000'XC ||  (* C *) |
      |       '7D4A4B4C4D4E4F505152000000000000'XC ||  (* D *) |
      |       '5C00535455565758595A000000000000'XC ||  (* E *) |
      |       '303132333435363738397C0000000000'XC ;   (* F *) |
      +--------------------------------------------------------+


   4. Assemble the four assembler source files, and compile the PASCAL
      main program using the PASCAL/VS compiler (with NOOPT option!).

   5. Link the files into a loadable module (system library).

      Example of points 4 & 5:
        ASMH     KERM(TWRITE)          (from library KERM.ASM)
        ASMH     KERM(TREAD)
        ASMH     KERM(WAIT)
        ASMH     KERM(TERMSIZE)
        PASCALVS KERM(KERMIT) NOOPT    (from library KERM.PASCAL)
        PASCMOD  KERM(KERMIT) +
           OBJ(KERM(TREAD),KERM(TWRITE),KERM(WAIT),KERM(TERMSIZE)) +
           LOAD('''SYS1.CMDLIB(KERMIT)''')

   6. Install a CLIST with the following content:
        PROC 0
        CONTROL NOMSG NOFLUSH
        FREE FILE(DFILE,SFILE,RFILE,TSODS)
        FREE DA(TSODS)
        SET INIT =
        IF &SYSDSN(KERMIT.SETUP) = OK THEN SET INIT = &STR(@INIT)
        CALL 'SYS1.CMDLIB(KERMIT) '&SYSUID.&INIT'

   7. Install a system help in one of the system help libraries
)F Function -
     The KERMIT Command Procedure starts a filetransfer program, which
     implements the KERMIT file transfer protocol for IBM computers run-
     ning under the MVS/XA operating system. KERMIT supports transfer of
     most filetypes to and from the host.

   Notes:
     a) Filetransfer may only run over an ASCII (asynchronous) line.
     b) You may setup KERMIT by specifing some valid KERMIT commands
        in the dataset 'Uid.KERMIT.SETUP'. After processing all setup
        commands, KERMIT is ready for interactive use.
     c) KERMIT is delivered on an asis base, any problems should be re-
        ported to the 'Help desk' - Tel .......

)X Syntax -
     %KERMIT

)O Operands - none



To run TSO Kermit, simply type "%KERMIT" after the TSO system prompt.
And now enjoy this new version of KERMIT running under MVS/TSO ...

---- Fritz