home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 01e / msk230s1.zip / MSSAAA.HLP < prev    next >
INI File  |  1988-02-12  |  4KB  |  94 lines
  1. [File MSSAAA.HLP]
  2.  
  3. Instructions for Building MS-Kermit 2.30 (1 Jan 1988)
  4. -----------------------------------------------------
  5.  
  6. To assemble any of the Kermit modules, file MSSDEF.H must be on the
  7. default disk.
  8.  
  9.  MSSDEF.H    Symbol definitions for all modules
  10.  MSSCMD.ASM  Command parser
  11.  MSSCOM.ASM  Communications (packets, system-independent)
  12.  MSSFIL.ASM  File i/o
  13.  MSSFIN.ASM  Dummy module to specify end of data segment
  14.  MSSKER.ASM  Main program
  15.  MSSRCV.ASM  Receive module
  16.  MSSSCP.ASM  Script module
  17.  MSSSEN.ASM  Send module
  18.  MSSSER.ASM  Server module
  19.  MSSSET.ASM  Set command module
  20.  MSSTER.ASM  Terminal emulation (system-independent)
  21.  
  22. The program needs an MSX module (system-dependent i/o, interrupt handling,
  23. etc) for the desired system, plus an MSU modle (keyboard translator), plus an
  24. MSY module (terminal emulation) for the same system (if there is one), and
  25. possibly an MSZ module (in case the MSY module got too big).  The MSX and MSY
  26. file may come with associated .HLP or .BWR files, which you should read.  Also,
  27. if you can't find the MSU, MSX and MSY modules for your system, read file
  28. MSAAAA.HLP, which lists the naming conventions.
  29.  
  30. ASSEMBLING:
  31.  
  32. For version 2.29 of Kermit-MS, most common assemblers, including any version
  33. of IBM or Microsoft MASM, can be used without any special switches. Bascially,
  34. each .ASM file is assembled independently to produce a .OBJ file. Note that
  35. the standard header file MSSDEF.H must be present with the .ASM file during
  36. assembly. Users of MS MASM version 1.0+ should be aware that many bugs exist
  37. in that early release; Kermit-MS assembles correctly under MS MASM v1.25 and
  38. later; version 5 was used on the release files. Consistent versions of MASM
  39. and LINK should be used together; check the file dates. A typical command is
  40.  
  41.         A>masm msscom;
  42.  
  43. LINKING:
  44.  
  45. Once all the required object modules exist, they may be linked together to
  46. produce Kermit.  The MSSFIN module must come LAST.  For example, for the
  47. IBM PC version:
  48.  
  49. A>link
  50.  
  51.    Microsoft Object Linker V2.00
  52. (C) Copyright 1982 by Microsoft Inc.
  53.  
  54. Object Modules [.OBJ]: msscmd msscom mssfil mssker mssrcv mssscp +
  55. msssen mssser mssset msster msgibm msuibm  msxyibm mszibm mssfin
  56. Run File [MSSCMD.EXE]: Kermit;          (or other convenient name)
  57.  
  58. A>
  59.  
  60. If a convenient Link command file is used, such as MSVIBM.LNK below, then the
  61. appropriate command is just
  62.  
  63.         A>link @msvibm.lnk
  64.  
  65.  
  66. USING MAKE:
  67.  
  68. Makefiles (for those who have the Microsoft DOS version of the UNIX 'make'
  69. program) to build each version of MS-DOS Kermit are in MSVxxx.MAK. MSVIBM.MAK
  70. builds the IBM version, MSVRB.MAK builds the Rainbow 100 version, etc.  To
  71. execute a makefile, type the command "make msvxxx.mak", where xxx is ibm, rb1,
  72. etc.  The makefiles show the assembly, link, and BOO steps.  Even if you don't
  73. have a 'make' program, they will show you which files are necessary for which
  74. version.  The advantage of using "make" is that only those steps that are
  75. necessary will be performed -- e.g. .ASM files will not be reassembled if
  76. there is already a corresponding .OBJ file with a later creation date.
  77.  
  78. USING DOS BATCH:
  79.  
  80. There are also MSS*.BAT file which can also be used to assemble and link
  81. MS-DOS Kermit for * = IBM, RB1, GEN, etc.
  82.  
  83. THE LINK STEP:
  84.  
  85. Both the makefile and the batch file rely on the presence of an MSVxxx.LNK
  86. Linker command file for each implementation.  For instance, here is MSVIBM.LNK
  87. for the IBM PC family:
  88.  
  89. msscmd+msscom+mssfil+mssker+mssrcv+mssscp+msssen+mssser+
  90. mssset+msster+msgibm+msuibm+msxibm+msyibm+mszibm+mssfin
  91. msvibm;
  92.  
  93. [End of MSSAAA.HLP]
  94.