home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / MYBBS.ZIP / WINDOWS / DESKTOP / MYBBS / CMODEM / CMODEM.DOC < prev    next >
Text File  |  1989-08-08  |  7KB  |  220 lines
  1. ------------------------------------------------------------------------------
  2.  
  3.                            C C H L L - M O D E M
  4.                                   C-MODEM
  5.  
  6. ------------------------------------------------------------------------------
  7.               Hanns Ludwig Lippmann Cultural Center (CCHLL) 1989
  8.             
  9.                      Lavio Pareschi - all rights reserved
  10.  
  11.   As a shareware program, this is not to be to sold or held. DISTRIBUTE IT !
  12. ------------------------------------------------------------------------------
  13.  
  14.  
  15.   C-MODEM
  16.   This is a protocol driver that works similarly and better than DSZ (TM by
  17.   Owen Technology). It just includes a whole new file transfer protocol, built
  18.   around the idea of crash recovery, easy of use and great performance.
  19.   This new protocol, C-MODEM, provides reliable file transmission even in the
  20.   worst conditions, as it adapts itself immediately to any errors that may
  21.   occur ( even in the so called 'error free' modems ).
  22.  
  23.  
  24.  
  25. SOME CHARACTERISTICS
  26. """"""""""""""""""""
  27. >> MAJOR Features of this new communications protocol
  28.    (release 1.00)
  29.  
  30. 1 - Transmission CRASH Recovery
  31.  
  32. Being interrupted by any condition, the file transmitted is saved with the
  33. extension file.BAD til the last byte received correctly.
  34. In the next connection/transmission, the same will be completed automatically.
  35.  
  36.  
  37. 2 - MUTABLE DATA : crc blocks on data blocks of variable size 
  38.  
  39. Depending on velocity and errors during transmission, as well as line 
  40. conditions, the size of data-blocks between crc-blocks will freely vary from
  41. 32 to 4096 bytes.
  42. This reduces the amount of control bytes added to the transmission and
  43. minimizes data repetition.
  44. The result is an excelent true transfer rate.
  45.  
  46.  
  47. 3 - FULL duplex
  48.  
  49. The transmiter doesn't stop every block to receive useless answers.
  50. The transmiter occurs without pauses between blocks.
  51. The receptor only warns when something wrong happens.
  52.  
  53.  
  54. 4 - EXACT size
  55.  
  56. The file will have the exact size in bytes as the original one as it is
  57. up/dowloaded, without useless added bytes to complete blocks of fixed size.
  58.  
  59. ------------------------------------------------------------------------------
  60.  
  61. FILES IN THIS PACKAGE
  62.  
  63. Self-extract CMODEM11.COM (by LHarc):
  64.  
  65. CMODEM.EXE
  66. Executable File to be used as an external protocol (dos).
  67.  
  68. CMODEM.DOC
  69. This doc file
  70.  
  71. RXPCPL.BAT
  72. Bat file for ProcomPlus (download).
  73.  
  74. TXPCPL.BAT
  75. Bat file for ProcomPlus (upload).
  76.  
  77. RX.BAT & TX.BAT
  78. Bat files for use via Dos, with any communications package that
  79. allows DOS access during connectionn and use of interrupt COM vectors.
  80.  
  81. RXBBS.BAT & TXBBS.BAT
  82. Bat files examples for use in BBSs.
  83.  
  84. SHARE.TXT
  85. Shareware concepts.
  86.  
  87. COMMANDS:
  88. """""""""
  89. CMODEM [/port=i][/rx][/tx][/baud=n][/off][/bbs] [filename]
  90.  
  91. /port = 1 (com1), 2 (com2), 3 or 4. Default = 1, to be used.
  92.  
  93. /rx for downloads, default.
  94. - obs: it's not necessary to type the filename during downloads,
  95.        the transmiter will do the job.
  96.  
  97. /tx for uploads.
  98. - obs: filename needed
  99.  
  100. /baud = 300, 1200, 2400, 4800 or 9600 or 0
  101. - to initialize serial port with baud, parity, stop and word.
  102. - if not specified, it will be automaticaly detected and used the same
  103.   existing configuration of the serial port.
  104. - if baud=0 then no baud detection will be made, being unknown, and it will
  105.   use the remaining existing configuration of serial port;
  106.   Obs: the goal of "baud=0" is to disrupt the auto baud detection, if this
  107.   is not correct, as it relies on hardware;
  108. - it maybe possible to achieve better efficiency if this paramater is used
  109.   to pinpoint the correct baud rate in any case;
  110.  
  111. /off to turn off the CRASH recovery function (so it will OVERWRITE any file
  112. that was not completely transmitted)
  113.  
  114. /bbs to use C-Modem in special cases
  115. - no change in ctrl-break and ctrl-C interrupt vectors.
  116. - no pause and alarm at return
  117.  
  118. filename = name of file to be transmitted
  119. - allways necessary when specifying /tx (upload).
  120. - if present on /rx then has priority.
  121.  
  122.  
  123. IMPORTANT:
  124.  
  125. Some com softs, as ProcomPlus, let the serial port as is on going to Dos.
  126. Others, reset or modify de serial chip and maybe necessary to reinitialize it
  127. with /baud=xxx.
  128.  
  129.  
  130. COM PORTS:
  131.  
  132. Com1 : 3F8 - 3FF - IRQ4
  133. Com2 : 2F8 - 2FF - IRQ3
  134. Com3 : 3E8 - 3EF - IRQ4    (not standard)
  135. Com4 : 2E8 - 2EF - IRQ3    (not standard)
  136. -------------------------------------------------------------------------------
  137.  
  138. GUIDELINES:
  139. """"""""""
  140.  
  141. >>>PROCOMPLUS<<<
  142.  
  143. TXPCPL.BAT:
  144. cxmodem /tx/porta=1 %1
  145.  
  146. - in setting up Procomm Plus (Tm DataStorm Thecnologies Inc.) you may use
  147.   txpcpl.bat as an external protocol.
  148.  
  149. - starting an upload, ProcomPlus will ask you a filename to transmit,
  150.   filename that will be recognized by the parameter %1 used in the .bat file.
  151.  
  152. - no filename is needed during the download
  153.  
  154. - you may edit those .bat files to configure it correctly with your system.
  155.  
  156.  
  157. GTPOWER , QMODEM, ZCOMM, MIRROR and others.
  158.  
  159. - access the DOS shell
  160. - give the .bat command:
  161.   >  RX          (to download) or
  162.   >  TX filename (to upload)
  163.   this, only, will execute the external protocol. 
  164.  
  165. Hint:
  166. Read about /baud before try this product.
  167.  
  168.  
  169. BBSs
  170.  
  171. - returns error level 0 if transmission ends ok
  172. - returns error level 1 if transmission ends bad
  173.  
  174.  
  175. RECOVERY
  176.  
  177. Aborted transmissions give the file x the name x.BAD  <-- IMPORTANT
  178. So, no confusing is done.
  179.  
  180. If you want to recovery a file aborted with other protocol, rename to file.BAD
  181. and try C-Modem!
  182.  
  183.  
  184. DISTRIBUTION OF THIS PRODUCT
  185. """"""""""""""""""""""""""""
  186.  
  187.   You and your friends are welcome to share and evaluate this package. This
  188.   documentation must go with all copies of this shareware. To avoid problems,
  189.   it's highly recommended that C-MODEM is ONLY distributed in this package   
  190.   with the same files, checking the same CRC values, shown here. It can be
  191.   packed in any kind of compressor as long as the package integrity is not
  192.   damaged. If any annomaly in the package should be noticed, is to be notified 
  193.   to the board's operator ( on which you got it ). Wipefile any file before
  194.   it behave weirdly.
  195.  
  196.  
  197.  
  198. REGISTRATION
  199. """"""""""""
  200. After a evaluation period, ethical users  M U S T  register their copy of this
  201. package. They can make sending a U$20 bill to:
  202.  
  203.   ******                                               ******
  204.          Centro Cultural Hanns Ludwig Lippmann (CCHLL)
  205.          RIO DE JANEIRO  ( RJ )
  206.          Caixa Postal 34.045   CEP 22.472       BRAZIL
  207.   ******                           ******     
  208.         
  209. >>> Registration of this product bypasses the shareware announcement and
  210.     gives the registered user other advanced functions and the right  to
  211.     receive future versions. Just pay once !!!
  212.  
  213.  
  214. -------------------------------------------------------------------------------
  215. Any major problem, contact the CCHLL-BBS/RJ - BRAZIL.
  216. Door #1: 55-(021)285-6228 (2400C, 1200C, 1200B, 300Bell).
  217. Door #2: 55-(021)265-7380 (1275C,  300B,  300Ccitt).
  218. Configuration: 8-N-1
  219. ---------------------------- < end of document > -----------------------------
  220.