home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / KERMIT.ZIP / READ.ME < prev   
Text File  |  1991-10-20  |  7KB  |  159 lines
  1.   ------------------------------------------------------------------
  2.  
  3.                            Oberon Software
  4.                         518 Blue Earth Street
  5.                           Mankato, MN 56001
  6.  
  7.              Voice: 507/388-7001     CIS:      72510,3500
  8.              BBS:   507/388-1154     GEnie:    B.FLOWERS
  9.              FAX:   507/388-3099     MCI Mail: oberon/413-5847
  10.  
  11.  
  12.   ------------------------------------------------------------------
  13.  
  14.   Kermit.Exe -- Notes 8/12/90, Brady Flowers, Oberon Software
  15.                 Addenda on 10/28/90, Brady Flowers
  16.                 Addenda on 10/20/91, Brady Flowers
  17.  
  18.         Copyright (c) 1990, 1991, Oberon Software, Mankato, MN
  19.  
  20.   ------------------------------------------------------------------
  21.  
  22.   Kermit.Exe is a standalone Kermit protocol that was quickly pieced
  23. together from some Kermit souce code written between 1981 and 1983
  24. at Columbia University and bearing the names Bill Catchings, Bob Cattani,
  25. Chris Maio, and Frank da Cruz, and modified on 7/13/83 by Jim Guyton of
  26. the Rand Corporation.  I then sprinkled a few "#ifdef OS2"'s into it.
  27.  
  28.   The intent was to create a sample, external protocol for TE/2 but
  29. it is possible to use the protocol driver in other situations as long
  30. as the following requirements are met:
  31.  
  32.   * CommPak2.Dll, version 0.99 or greater must be located somewhere
  33.     on your LIBPATH.
  34.  
  35.   * The calling process must be able to pass the communications port
  36.     handle to kermit on the command line.
  37.  
  38.   ------------------------------------------------------------------
  39.  
  40.   Command line syntax is:
  41.  
  42.     kermit [-]p{s|r} <porthandle> [<filename(s)>]
  43.  
  44.     'p' is REQUIRED, it triggers acceptance of the porthandle
  45.     's' for SEND file(s)
  46.     'r' for RECEIVE files(s)
  47.          Note: Either 's' or 'r' (but not both) MUST be specified
  48.  
  49.     <filename(s)> must be specified when sending files, of course. On
  50.          receive they need to be specified only if the name or path
  51.          needs to be changed in transit (Kermit WILL send full path
  52.          names!).  If, for instance, you want to use the default name
  53.          for the first file and change the name of the second, you
  54.          must place two filenames on the command line but you can
  55.          specify "*" as a place holder for the first.  You cannot
  56.          otherwise use wildcard filespecs when sending or receiving.
  57.  
  58.   ------------------------------------------------------------------
  59.  
  60.   Running Kermit.Exe as an External Protocol with TE/2
  61.  
  62.   Place the following two entries into a TE/2 external programs file,
  63. either TE2.XEX or an alternate file (if you don't know what this means,
  64. please refer to the TE/2 Documentation, VIII. Customization, D. TE2.XEX).
  65.  
  66.           0x0011,1
  67.           Kermit Upload
  68.           <d:\Path>\kermit.exe
  69.           -ps %h %?[Enter File(s) for Kermit Upload:]
  70.           0x0011,1
  71.           Kermit Download
  72.           <d:\Path>\kermit.exe
  73.           -pr %h %?[Enter File(s) for Kermit Download:]
  74.  
  75.   Replace "<d:\Path>" with the actual drive and path information for
  76. kermit.exe on your system.
  77.  
  78.   When you are ready to transfer a file, make sure that the external
  79. programs file containing these lines is loaded (if you used TE2.XEX, it
  80. is loaded by default, otherwise type Alt-J to display the External
  81. Programs menu, type 'N' to load a new file, and specify the name of
  82. your alternate file).  Inform the host of the desired action, when the
  83. host indicates that it is ready to send/receive, type Alt-J to invoke
  84. the External Programs menu and select Kermit Upload/Download, you will
  85. be prompted for the file names.
  86.  
  87.   You can abort a Kermit transfer in progress by pressing the ESCape key.
  88.  
  89.   A couple words of warning, because Kermit transmits the full filename
  90. specified with no translation, if a path is specified and the file is not
  91. renamed, that path must exist on the receiver for the transfer to work.
  92. Also, Kermit will happily overwrite any existing file without a word;
  93. make sure you get the name of the received file right!
  94.  
  95.   ------------------------------------------------------------------
  96.  
  97.   Source Code
  98.  
  99.   When the CommPak/2 Toolkit becomes available, the source for Kermit.Exe
  100. will be released with it as an example of accessing the dynamic link
  101. library functions.
  102.  
  103.  
  104.   ------------------------------------------------------------------
  105.  
  106.   Addenda and Errata
  107.  
  108.   10/28/90
  109.  
  110.   This update of Kermit.Exe addresses one small bug which would cause
  111. a protection violation under certain conditions.  This Kermit has
  112. proven to be rather slow, this version will NOT improve the protocol
  113. effiency or throughput.
  114.  
  115.   10/20/91
  116.  
  117.   Recompiled and linked to take advantage of (and to make sure that it
  118. is compatible with) the lastest release of COMMPAK2.DLL (Version 0.99).
  119.  
  120.  
  121.   ------------------------------------------------------------------
  122.  
  123.   You don't have TE/2!?
  124.  
  125.   TE/2 is a telecommunications program for OS/2 protected mode. 
  126. Supported file transfer protocols are: XModem, XModem-1K, YModem,
  127. YModem-G, ZModem, and Ascii. Supported terminal emulations include:
  128. TTY, ANSI-BBS, IBM 3101, and VT100.  Other features include multiple,
  129. 200 entry dialing directories, call logging, extensive facility for
  130. running external programs/protocols, split screen chat mode,
  131. assignable function keys, and more.  
  132.  
  133.   A version of TE/2 is distributed as a Shareware Product of Oberon
  134. Software and is available on CompuServe, GEnie, and many OS/2 BBSes
  135. around the world (including the Oberon BBS, the number for which is
  136. to be found at the beginning of this document).  Oberon Software also
  137. offers and enhanced, registered version of TE/2.  The registered
  138. version contains a very robust script language, CompuServe B+
  139. protocol, and other enhanced features.
  140.  
  141.   For information on ordering or registering TE/2 please contact
  142. Oberon Software by one of the methods given above.
  143.  
  144.   ------------------------------------------------------------------
  145.  
  146.   Disclaimer
  147.  
  148.   You use Kermit.Exe at your own risk.  Kermit.Exe is not guaranteed to
  149. be error free.  Oberon Software and Brady Flowers will not be liable for
  150. any damages or loss to property, business, or data arising from the use,
  151. misuse, or inability to use this software.  Your use of this software
  152. constitutes your agreement to these terms.
  153.  
  154.   Kermit.Exe, TE/2, CommPak/2, and this document are all subject to
  155. change with respect to each other and in no way imply a commitment on
  156. the part of Oberon Software.
  157.  
  158.  
  159.