home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ibmtsonih.tar.gz / ibmtsonih.tar / tsnker.txt < prev    next >
Text File  |  1986-12-18  |  6KB  |  121 lines
  1.                     NIH TSO KERMIT Installation Instructions
  2.  
  3.                        Version 1.1A -- September 11, 1987
  4.  
  5.                                 Computer Center
  6.                   Division of Computer Research and Technology
  7.                          National Institutes of Health
  8.                               Bethesda, MD  20892
  9.  
  10.  
  11. The NIH version of TSO Kermit is an extensive modification and  rewrite  of  the
  12. University of Chicago TSO Kermit, which in turn was based on an early CMS Kermit
  13. developed at Columbia University.  The external design was done by Roger  Fajman
  14. and  Dale  Wright.  The internal design and programming was done by Dale Wright.
  15. Questions should be addressed to Roger Fajman at
  16.  
  17.       Telephone:  301-496-5181
  18.       BITNET:     RAF@NIHCU
  19.       Postal:     NIH Computer Center
  20.                   Building 12, Room 2239
  21.                   Bethesda, MD  20892
  22.  
  23. The distribution consists of the following data sets.  All  are  in  card  image
  24. format (RECFM=FB, LRECL=80, BLKSIZE=11440) on tape unless otherwise stated.
  25.  
  26. No.   Name           Description
  27. ---   ----           -----------
  28. 1     TSNKER.TXT     These installation instructions.
  29.  
  30. 2     TSNKER.BWR     Beware file -- bugs, cautions, etc.
  31.  
  32. 3     TSNKER.DOC     User documentation.  (RECFM=FB, LRECL=84, BLKSIZE=11424)
  33.  
  34. 4     TSNKER.HLP     TSO HELP information for Kermit
  35.  
  36. 5     TSNUNH.ASM     Source for the UNHEX program that converts the object decks
  37.                      from  printable  hex characters back to their normal binary
  38.                      form.  The object decks are provided in hex form  in  order
  39.                      to facilitate transmission through networks.  UNHEX accepts
  40.                      card image (RECFM=FB, LRECL=80) input from the DDNAME INPUT
  41.                      and  writes  card  image  output to the DDNAME OUTPUT.  The
  42.                      output BLKSIZE must be specified in the DD statement.  If a
  43.                      non-null PARM field is specified, UNHEX removes IEBUPDTE ./
  44.                      control cards from the output.
  45.  
  46. 6     TSNKER.OBH     Object decks for TSO Kermit and support subroutines in  hex
  47.                      form.   This  data  set  should be passed through the UNHEX
  48.                      program.  It may then be  used  as  input  to  IEBUPDTE  to
  49.                      create  the TSNKER.OBJ PDS.  Alternatively, a non-null PARM
  50.                      may be specified to UNHEX and the output passed directly to
  51.                      the linkage editor.
  52.  
  53. 7     TSNTBL.ASM     Source for the module that contains the ASCII-EBCDIC trans-
  54.                      late  tables,  plus  a  few  subroutines  entered to define
  55.                      installation-dependent  values.   This  module  should   be
  56.                      modified  as  needed  and  linked  with the provided object
  57.                      decks.
  58.  
  59. 8     TSNKER.JCL     JCL to perform the installation procedure.
  60.  
  61. The following data sets are needed only if you wish to recompile NIH TSO Kermit.
  62.  
  63. No.   Name           Description
  64. ---   ----           -----------
  65. 9     TSNKER.ALP     Source  for  NIH  TSO  Kermit  in  ALP  (Assembly  Language
  66.                      Preprocessor).   Note:   source for the support subroutines
  67.                      is omitted for the sake of brevity, but can be made  avail-
  68.                      able if needed.
  69.  
  70. 10    TSNEDR.DOC     Documentation for the Edit Format Utility  Package  --  de-
  71.                      scribes  the  support  subroutines  used by NIH TSO Kermit.
  72.                      (RECFM=FB, LRECL=84, BLKSIZE=11424)
  73.  
  74. 11    TSNMAC.DOC     Documentation for macros that are used in TSO Kermit.
  75.  
  76. 12    TSNHEX.ASM     Source for the HEX program that was  used  to  convert  the
  77.                      object decks to printable hex characters.  HEX accepts card
  78.                      image (RECFM=FB, LRECL=80) input from the DDNAME INPUT  and
  79.                      writes  card image output to the DDNAME OUTPUT.  The output
  80.                      BLKSIZE must be specified in the DD statement.  IEBUPDTE ./
  81.                      control  cards are passed through unchanged.  If a non-null
  82.                      PARM field is specified, SYM cards (generated by  the  TEST
  83.                      option of the assember) are removed from the object decks.
  84.  
  85. 13    TSNALP.TXT     Installation instructions for ALP.
  86.  
  87. 14    TSNALP.DOC     User documentation for ALP.
  88.  
  89. 15    TSNTST.ALP     Test program for ALP.
  90.  
  91. 16    TSNALP.PLI     Source for ALP.
  92.  
  93. 17    TSNPST.PLI     Source for the ALP Post-Processor.
  94.  
  95. 18    TSNMAC.ALP     Source for the macro library used with ALP.   Passed  first
  96.                      through ALP and then to IEBUPTDE.
  97.  
  98. 19    TSNPCH.ASM     Source for an assembler program that links  first  to  ALP,
  99.                      then to Assembler H, and then to the post processor.
  100.  
  101. 20    TSNPCX.ASM     Same as above, but for Assembler FX.
  102.  
  103. 21    TSNALP.JCL     JCL cataloged procedures for ALP.
  104.  
  105.  
  106. The installation process consists of the following steps:
  107.  
  108. (1)   Modify the translate table module as  needed  for  your  installation  and
  109.       assemble  it.   The  ASCII-EBCDIC  tables will almost certainly need to be
  110.       modified -- they must match your installations  TSO  translate  tables  in
  111.       order for TSO Kermit to be able to transfer files.  The other items may or
  112.       may not need to be changed.
  113.  
  114. (2)   Convert the hex form of the object decks to binary form.
  115.  
  116. (3)   Link the converted object decks with the object deck of the table  module.
  117.       Place  the  resulting  load  module  into  a  library from which it can be
  118.       invoked as a TSO command processor.
  119.  
  120. The TSNKER.JCL file contains a batch job that performs steps 2 and 3.
  121.