home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / basic / library / qb_pds / communic / tcqb / tcqb.doc next >
Encoding:
Text File  |  1988-02-16  |  5.0 KB  |  149 lines
  1. Additional documentation added for Qmodem by
  2.  
  3.                     Karl Brendel
  4.                     Ass't Sysop
  5.                     Qmodem GEnie RoundTable
  6.                     GEmail K.BRENDEL
  7.                     CIS 73307,3101
  8.  
  9. Note that in this release of TCQB, and new command line parameter has
  10. been added to control echo (duplex). TCQB command line parameters are
  11. position sensitive. Ie, TCQB interprets the parameter based on its
  12. position on the command line, not on its contents. Unfortunately, the
  13. author chose to make the echo parameter the first one on the line, so
  14. you _must_ revise your .BAT files if they were passing the %2
  15. parameter as shown in the added documentation on the first release.
  16.  
  17. For Qmodem usage, install TCQB as an external protocol on page 3)3) in
  18. Qinstall: Additional Transfer Protocols. I'd suggest the following
  19. entry:
  20.  
  21.  Sel    Name of           Upload Batch      Download Batch    Download File
  22.  Char   Protocol          Filename          Filename          Prompt [Y/N]
  23.  [Q]    [CIS Quick B ]    [SQB.BAT     ]    [RQB.BAT     ]       [N]
  24.  
  25. Place the ?QB.BAT files in the directory from which you run Qmodem. An
  26. example SQB.BAT or RQB.bat could be simply:
  27.  
  28. TCQB FULL %2
  29. ECHO ^G^G
  30.  
  31. (The echo is so you know when the transfer is over. The ^G^G should be
  32. replaced with "real" control-G characters.)
  33.  
  34. The %2 tells TCQB which port you are using. (Note that, unlike Qmodem,
  35. TCQB only supports ports 1 and 2.) It places the downloaded files and
  36. looks for the upload files in the current directory. (Like other
  37. external protocol drivers, TCQB has no way of knowing how you have
  38. defined your up/download directories in Qinstall.) If you wish to do
  39. the files from elsewhere, you must do something similar to this for
  40. SQB.BAT:
  41.  
  42. CD C:\QM\UL
  43. C:\FP\TCQB FULL %2
  44. CD C:\QM
  45. ECHO ^G^G
  46.  
  47. where you would replace "C:\QM\UL" with the drive and path to your
  48. upload directory, "C:\FP\" with the drive and path to TCQB (unless it
  49. is located on the DOS PATH), and "c:\QM" with the drive and path to
  50. the directory from which you run Qmodem. Similarly, your RQB.BAT could
  51. be something like:
  52.  
  53. CD C:\QM\DL
  54. C:\FP\TCQB FULL %2
  55. CD C:\QM
  56. ECHO ^G^G
  57.  
  58. Note that unlike other external protocol drivers you may have used,
  59. the CIS B and QB drivers don't know whether you are going to upload or
  60. download, and Qmodem can't tell them. The CIS end of the transfer will
  61. tell your end what it is doing--and it can't do that while you are
  62. still in Qmodem.
  63.  
  64. What does that mean? It means that you should do your PgUp or PgDn and
  65. go out to TCQB _before_ you tell CIS that you want to do the transfer!
  66. While in TCQB, you can type at the keyboard and read the prompts from
  67. CIS just as if you were still in Qmodem. Do NOT wait until CIS is
  68. already trying to do the transfer before doing the PgUp/Dn. (It may
  69. not be hazardous, but I'm not going to vouch for it!)
  70.  
  71. TCQB also has the unfortunate practice of exiting at the end of the
  72. transfer, so you go back to Qmodem after each transfer. That is a
  73. nuisance, but no big deal. It just means a separate PgUp/Dn for each
  74. transfer. And remember that CIS will not prompt for the protocol or
  75. file type on the subsequent transfers, so you need to go back out to
  76. TCQB earlier.
  77.  
  78. = END = of added documentation.
  79.  
  80.  
  81. TCQB  is a Compuserve QUICK B external driver for programs such as QMODEM.
  82.  
  83. It is written in Turbo C,  the source modules are as follows:
  84.  
  85.  
  86. QUICKB.C        Protocol driver for CIS B and CIS QUICK B
  87.             based in the QUICKB.C found on CIS.
  88.  
  89. TCCRC.C            Fast CRC calculation
  90.  
  91. TCIO.C            Turbo C standalone disk and console I/O.
  92.  
  93. TCSERIAL.C        Turbo C buffered Serial drivers.
  94.  
  95. TCQB.C            Main program
  96.  
  97.  
  98. TCQB.EXE        running version
  99.  
  100.  
  101.  
  102. TCQB DUPLEX PORT BAUD
  103.  
  104.  TCQB defaults to Full Duplex, the first command line parameter in TCQB is
  105. the duplex, it can be either FULL or HALF.
  106.  TCQB defaults to PORT 1, the second command line parameter in TCQB is the
  107. PORT number it can be 1 or 2.
  108.  TCQB deaults to the current baud rate, the third command line parmeter in
  109. TCQB is a new baud rate.
  110.  
  111. examples:
  112.  
  113. TCQB HALF 1 300
  114. TCQB FULL 2 2400
  115. TCQB FULL 1 19200
  116.  
  117.  
  118. TCQB comes up in terminal mode, although you could use TCQB as a terminal,
  119. I would not advise it since it is so limited a terminal emulation. To exit
  120. TCQB just hit ESC at any time.
  121.  
  122.  
  123. Revision History:
  124. -----------------
  125.  
  126. version 1.1
  127.         added extended status and duplex selection (half/full)
  128.  
  129. version 1.1b 
  130.         fixed a bug in the abort of downloads/uploads, the ESC key
  131.         was not being recognized due to a typo in TCQB.C
  132.  
  133. version 1.1c 
  134.         very nasty bug fixed when uploading/downloading files larger
  135.         than 32k. previous versions could hang and lockup the machine
  136.         spewing garbage all over the screen (if thats not a "REAL" bug
  137.         I don't know what is!). It was all because of a lack of a
  138.         declaration in quickb.c declaring lseek() to return a long.
  139.          The checksum routine was rewritten in assembly language for
  140.         speed (of course!).
  141.  
  142.  I can be contacted on compuserve 73307,606 for suggestions or bug reports.
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.