home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / prog1 / zmnp11.lzh / README < prev    next >
Text File  |  1990-02-25  |  5KB  |  169 lines
  1. ZMNP library - evaluation version.
  2. Version 1.1  12 Feb 90
  3.  
  4.  
  5. Contents:
  6.  
  7. readme        This file.
  8. makefile.tc   Make file for cu.exe (Turbo C)
  9. makefile.msc  Make file for cu.exe (Microsoft C)
  10. cu.c          Source for cu.exe.
  11. zmnp.doc      Interface decription for libraries.
  12. cu.exe          Demonstration program.
  13. zmnp.h          Library header file.
  14. zmnps_tc.lib  Small model library (Turbo C).
  15. zmnps_ms.lib  Small model library (Microsoft C).
  16.  
  17.  
  18. General.
  19.  
  20. This package contains the evaluation version of the ZMNP comms
  21. libraries for PC compatibles which features (in addition to basic
  22. interrupt driven asynchronous comms functions) MNP level 2 error
  23. correction and the XMODEM, YMODEM and ZMODEM file transfer protocols. 
  24. The libraries work with Microsoft C version 5.1 and Turbo C versions
  25. 2.00 and 2.01.  Libraries are available for all the memory models
  26. supported by these compilers.
  27.  
  28.  
  29. CU.C and CU.EXE.
  30.  
  31. CU.EXE (to which CU.C is the source) is a demonstration/testbed program
  32. for the ZMNP library.  It is whimsically named after the UNIX cu command
  33. to which it bears only the most superficial resemblance.
  34.  
  35. Usage: cu [options]
  36.        Options are:
  37.        -o     MNP originate mode.
  38.        -a     MNP answer mode.
  39.        -p<port>  Use COM<port> (default COM1).
  40.        -s<speed> Bps (default 2400).
  41.  
  42. Note that if CU is invoked without either of the -o or -a options, it
  43. will make no attempt to make a MNP connection.
  44.  
  45. When you are running CU, there are four commands you can issue:
  46.  
  47. ~s      starts a ZMODEM upload.  You will be prompted for the names of
  48.         the files to upload (no wildcard support, but you can add this
  49.         to CU.C if you want).
  50. ~r      starts a ZMODEM download.  In the normal course of events, it is
  51.         unnecessary to issue this command as CU will automatically start
  52.         a ZMODEM download as soon as it sees the initialisation string
  53.         from the remote end.  However, if the remote is sending a
  54.         command rather than a file, the download will have to be started
  55.         manually.
  56. ~c      sends a remote command.  You will be prompted for the command
  57.         text.
  58. ~.      hangs up, restores the 8250 and the interrupt vectors to the 
  59.         state they were in before running CU and exits.
  60.  
  61. File transfers may be interrupted by typing ^C (Control C) or ^Break.
  62.  
  63.  
  64. Example session (calling CIX):
  65.  
  66. C:>cu -o
  67. atdp013901244               <-- You type this - CU doesn't know how to dial.
  68. CONNECT 2400                <-- From Hayes compatible modem.
  69. MNP level 2                 <-- From CU - MNP negotation succeeded.
  70.  
  71. Type 'cix' to login: qix
  72.  
  73.  
  74. CIX  Version 1.248  12/21/89
  75. You are on line: tty51
  76. Nickname? (Enter 'new' for new user) username
  77. Password:
  78. You have 3 file(s) in your private subdir.
  79. You have 3 mail message(s) in your in-basket.
  80. There are 2 unread mail message(s).
  81. You are a member of 46 conference(s).
  82. You are now listening for chat
  83. Macro defined.
  84. M:bye
  85. username, you have been online 0:53 on tty51
  86. Goodbye from CIX     !!!HANGUP NOW!!!
  87. MNP link broken
  88.  
  89. C:>
  90.  
  91.  
  92. Restrictions in the evaluation version.
  93.  
  94. 1) The library displays an unsightly version message.  This does not
  95.    appear in the production version.
  96.  
  97. 2) The file transfer 'quiet' options do not work and user supplied
  98.    progress reporting functions are ignored.  Both these options work
  99.    in the production version.
  100.  
  101. 3) Only the small code / small data libraries are supplied.  All memory
  102.    models are supported in the production version.
  103.  
  104. 4) Please note that CU.EXE was built with the production version of the
  105.    library.  If you rebuild it with the evaluation version, its reporter
  106.    function will be ignored and the default will be used.
  107.  
  108.  
  109. Licence.
  110.  
  111. You are welcome to use this software for evaluation purposes.  You may
  112. make and distribute copies of the evaluation version of this software. 
  113. If you want to continue to use this software after you have evaluated
  114. it, you should register.  Registration costs 30 pounds sterling plus
  115. VAT at the current rate (15% at the time of writing making a total of
  116. 34.50 pounds sterling).  Registered users will receive the production
  117. version of the object libraries (all memory models) and will be
  118. entitled to join the ZMNP support conference on the CIX conferencing
  119. system.  The production version of the object libraries will be
  120. supplied on MS-DOS format 5 1/4 inch high density disc (it can also be
  121. supplied via BINMAIL on CIX if preferred).  Please note that it is a
  122. condition of the licence that use of the ZMNP libraries in your own
  123. programs be credited either in the program or its documentation.  No
  124. runtime royalties are payable.
  125.  
  126.  
  127. Problems/bugs.
  128.  
  129. Please report any bugs to me.  Suggestions for improvements are also
  130. very welcome.
  131.  
  132.  
  133. Giles Todd
  134. Rundart Ltd
  135. 176 Cavendish Close
  136. Old Hall
  137. Warrington
  138. WA5 5PT
  139. England
  140.  
  141. +44 925 33472
  142.  
  143. gtodd@cix.UUCP
  144.  
  145. 8<-----------------------------------------------------------------------------
  146.  
  147. Order form.
  148.  
  149. To: Rundart Ltd, 176 Cavendish Close, Old Hall, Warrington, WA5 5PT.
  150.  
  151. Please register my copy of the ZMNP library and send me the production
  152. version of the object libraries on disc / via BINMAIL to work with
  153. Turbo C / Microsoft C.  I enclose a cheque for 34.50 pounds sterling
  154. (including VAT).
  155.  
  156. Name
  157.  
  158. Address
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.