home *** CD-ROM | disk | FTP | other *** search
/ The Arcade BBS / arcadebbs.zip / arcadebbs / WWIVUTIL / HSWWIV.TXT < prev    next >
Text File  |  1992-07-18  |  12KB  |  261 lines
  1.  
  2.                         OPTIMIZING HS/LINK FOR WWIV 4.21
  3.      
  4.           After talking at length with Sam Smith, the author of HS/Link, I
  5. think I have the proper setups to make HS/Link work reliably with PC Pursuit. I
  6. also found out a couple of other things that really speed HS/Link up for
  7. regular transfers.
  8.      
  9.           The first part of this document defines some terms that are used in
  10. the rest of this discussion. The second part discusses ways of setting up
  11. HS/Link to optimize normal WWIV BBS connections. The third part describes the
  12. problems involved using HS/Link on WWIV with PC Pursuit, and how they can be
  13. taken care of. Part 4 deals with optimizing HS/Link for use with your terminal
  14. program, and part 5 deals with how to do Bi-Directional uploads and downloads.
  15.      
  16.      
  17.      Part 1 - Definitions:
  18.      
  19.      BLOCK :
  20.      HS/Link sends data in packets (blocks). Normally each block contains a
  21.      unique sequence number and checksum info to aid in data verification and
  22.      error detection and recovery.
  23.      
  24.      BLOCK SIZE (-s) : 
  25.      Size of each block in bytes.
  26.      
  27.      CONFIGURATION FILE :
  28.      An ASCII file that is used to set HS/Link's options. This file can be
  29.      created with HSCONFIG, or with your editor. The default configuration file
  30.      is HSLINK.CFG. This is the file that HS/Link looks for if no other is
  31.      specified on the command line. To specify another configuration file start
  32.      your command line as follows: "HSLINK -@filename". Don't type the quotes.
  33.      The filename is the name of the alternate configuration file you want
  34.      HS/Link to use. This MUST be the FIRST option on the command line.
  35.      
  36.      CURRENT HS/LINK VERSION :
  37.      Be sure to use the LATEST release of HS/Link. While the current version is
  38.      always compatible with older versions, you will not get the benefit of the
  39.      latest enhancements and fixes if you are using an old version. At the time
  40.      of this writing, the latest RELEASE version is 1.12.
  41.      
  42.      DOWNLOAD DIRECTORY (-U) :
  43.      This option controls the destination directory for incoming files. By
  44.      default, HS/Link will put incoming files into the "current" directory.
  45.      This is where WWIV is expecting to find them. The BBS will move the files
  46.      to where they belong, so the -U option should NOT be used for the BBS. It
  47.      may however be used in conjunction with a caller's terminal program. For
  48.      Example, -UC:\TEMP in the caller's HSLINK.CFG file would place the
  49.      incoming files in his TEMP directory on drive C:.
  50.      
  51.      FORCE REMOTE TO USE LOCAL OPTIONS (-!) 
  52.      This option causes the remote (called) end to use some of the options
  53.      specified by the calling end. This does NOT affect any of the options
  54.      having to do with security, such as the upload path, or the overwrite
  55.      option. It does affect block size (-s), xon/xoff (-hx), and windows (-w).
  56.      
  57.      HARDWARE HANDSHAKING - CTS/RTS (default) : 
  58.      A means of flow control where the modem asserts the CTS (clear to send)
  59.      line when it is able to receive data from the computer. If it's buffer
  60.      fills up, it drops the CTS line. In the same way, the computer asserts the
  61.      RTS (request to send) line when it is able to receive data from the modem,
  62.      and drops it if it is busy. This scheme is used by High Speed modems that
  63.      can operate with a port speed that is higher than the connect speed.
  64.      
  65.      SLOW HANDSHAKE (-hs) :
  66.      Sends Xoff or lowers RTS during disk I/O. This causes the computer to
  67.      signal the modem not to send any data during disk I/O. It is available for
  68.      systems with slow disk access. It may help if you get frequent CRC errors
  69.      of COM overruns on clean lines.
  70.      
  71.      WINDOW (-w) : 
  72.      The number of blocks HS/Link will send before stopping and waiting for an
  73.      acknowledgment (ACK)
  74.      
  75.      XON/XOFF (default) :
  76.      A software method of telling the other end to suspend/restart          
  77.      sending data. It is not generally necessary for error correcting modems,
  78.      but no harm is done by leaving it enabled. (Do not disable this if Slow
  79.      Handshaking (-hs) is required by your system)
  80.      
  81.      
  82.      Part 2 - Optimizing HS/Link for WWIV BBSs that do NOT make NET calls via  
  83.             
  84.               PCP
  85.      
  86.      If you operate a WWIV BBS that does NOT make NET callouts via PCP, then
  87. the following HSLINK.CFG file settings and INIT settings should be optimum for
  88. you.
  89.      
  90.                 HSLINK.CFG - use HSCONFIG or wordprocessor to create
  91.      
  92.      -A        /* don't send ACKs */                      << don't type the >>
  93.      -S4096    /* sets 4k blocks */                       << comments       >>
  94.      -W0       /* do not wait for ACK /*
  95.      
  96.                     INIT settings for HS/Link
  97.      
  98.      Description              : HS/Link
  99.      Xfer OK code             : 0
  100.      Require MNP/LAPM         : N
  101.      Receive command line:
  102.      HSLINK -P%2 -E%4 -U%3
  103.      Send command line:
  104.      HSLINK -P%2 -E%4 %3
  105.      Receive batch command line:
  106.      HSLINK -P%2 -E%4 -U%3
  107.      Send batch command line:
  108.      HSLINK -P%2 -E%4 @%3
  109.      Bi-directional transfer command line:
  110.      HSLINK -P%2 -E%4 -@ @%3
  111.      
  112.      
  113.      Part 3 - Optimizing HS/Link for WWIV BBSs that make NET calls via PC      
  114.          
  115.               Pursuit
  116.      
  117.           OK, now for the problem with PCP. Being a timeshare net, it does not
  118. transmit data continuously, especially during busy times. There may be delays
  119. in data transmission. If the HS/Link default block size of 1024, or 4096 is
  120. used, and the default window of 8 is in effect, HS/link will send 8 of these
  121. blocks before stopping for an acknowledgment. If PCP is busy, this may be more
  122. data than it can "swallow" in one gulp. Once PCP gets behind, it may have
  123. problems recovering, in which case the data may or may not get thru. Even if it
  124. does, the ACK may not get back to the sending end, in which case HS/Link waits
  125. for it's internal timeout, before trying again. Often PCP cannot recover at
  126. all, and HS/Link will finally about the transfer.
  127.      
  128.           This problem can be resolved by using smaller blocks, and smaller
  129. windows. A setting of 512 or smaller for the block size is recommended, and a
  130. window of 4 should work fine. This will give PCP smaller blocks of data, and
  131. HS/Link will stop more often to check that the data has been received.
  132.      
  133.           This sounds easy to implement, but there is one problem with WWIV
  134. that we have to overcome. We are able to set the command line that HS/Link uses
  135. for regular BBS callers by using the INIT program, BUT we have no way of
  136. controlling the command line that the NETWORK uses for it's callouts. This
  137. means we are stuck using the same configuration for both our NET calls and our
  138. regular callers. 
  139.      
  140.           There is a workaround that will do the job for those systems that
  141. make NET callouts via PCP, but still want their regular callers to get the best
  142. speed out of HS/Link. We can set the options we want to use for NET callouts in
  143. the HSLINK.CFG file, since that is the one HS/Link looks for by default. Then
  144. we can create another configuration file to use when a regular caller activates
  145. HS/Link. We can specify that alternate configuration file on the HS/Link
  146. command lines in INIT. If you called your alternate config file BBS_CALL.CFG,
  147. and it was in your C:\WWIV directory, then your HS/Link setup in INIT should
  148. look like this:
  149.      
  150.      Description              : HS/Link
  151.      Xfer OK code             : 0
  152.      Require MNP/LAPM         : N
  153.      Receive command line:
  154.      HSLINK -@C:\WWIV\BBS_CALL.CFG -P%2 -E%4 -U%3
  155.      Send command line:
  156.      HSLINK -@C:\WWIV\BBS_CALL.CFG -P%2 -E%4 %3
  157.      Receive batch command line:
  158.      HSLINK -@C:\WWIV\BBS_CALL.CFG -P%2 -E%4 -U%3
  159.      Send batch command line:
  160.      HSLINK -@C:\WWIV\BBS_CALL.CFG -P%2 -E%4 @%3
  161.      Bi-directional transfer command line:
  162.      HSLINK -@C:\WWIV\BBS_CALL.CFG -P%2 -E%4 -@ @%3
  163.      
  164.           Your default HS/Link config file that will be used for the NET
  165. callouts should look like the following. It should be named HSLINK.CFG, and
  166. should be in the same directory as HS/Link. This is the optimum setup for use
  167. with PCP:
  168.      
  169.      -!        /* force remote to use these settings */
  170.      -S512     /* use 512 byte blocks */
  171.      -W4       /* wait for ACK after every 4 blocks */
  172.      
  173.           Your alternate config file for use with regular callers should look
  174. like this, and the name should match what you specified in INIT on the HS/Link
  175. command line (ie. BBS_CALL.CFG), and should also be in the same directory as
  176. HS/Link.
  177.      
  178.      -A        /* don't send ACKs */
  179.      -S4096    /* sets 4k blocks */
  180.      -W0       /* do not wait for ACK /*
  181.      
  182.           These should provide optimum setup for those WWIV BBS systems that
  183. callout via PCP and want the best for their non PCP callers. Regular PCP
  184. callers should configure their terminal programs to use a setup like the
  185. HSLINK.CFG mentioned in part 4.
  186.      
  187.      
  188.      Part 4 - HS/Link and your terminal program
  189.      
  190.           The calling party has the responsibility of determining the best
  191. HS/Link configuration options for his/her particular situation (PCP, Non PCP,
  192. etc). You should configure HS/Link for your terminal program, and include at
  193. least the following options in the .CFG file. Be sure to include the (-!) to
  194. force the remote to also use your preferences.
  195.      
  196.           If you are calling via PCP, then your HS/Link config file should look
  197. like the following one. You should also use PCP's default handshaking:
  198.      
  199.      -!        /* force remote to use these settings */
  200.      -S512     /* use 512 byte blocks */
  201.      -W4       /* wait for ACK after every 4 blocks */
  202.      -UC:\temp /* set this to the directory you want your downloads to go in /*
  203.      
  204.           If you use "direct" connections ( regular lines), then your HS/Link
  205. config file should look like this:
  206.      
  207.      -!        /* force remote to use these settings */
  208.      -A        /* don't send ACKs */
  209.      -S4096    /* sets 4k blocks */
  210.      -W0       /* do not wait for ACK /*
  211.      -UC:\temp /* set this to the directory you want your downloads to go in /*
  212.      
  213.           In the event that you do both PCP and Non PCP calls, you can give one
  214. of these files a different name (ie NON_PCP.CFG), and then on the HS/Link
  215. command line for your Non PCP calls, include the following as the FIRST option:
  216.      
  217.      -@NON_PCP.CFG 
  218.      
  219.      Be sure to include the pathname.   ie @C:\TELEX\NON_PCP.CFG
  220.      
  221.      
  222.      Part 5 - Bi-Directional file transfers
  223.      
  224.         For bi-directional transfers to work properly, You must NOT have a
  225. "Download Directory" set in the HSLINK.CFG file for the BBS !  This is the
  226. option that begins with a -U. If you want uploads to go to the Sysop directory,
  227. you should set that option in INIT. It is ok for the caller to have the -U
  228. option set for his terminal program.
  229.      
  230.          Here is the procedure for doing bi-directional file transfers:
  231.      
  232.      Select (D)ownload
  233.      Enter the file name you want to receive
  234.      Select "Batch" as the protocol
  235.      Repeat for additional files
  236.      
  237.      Select (U)pload
  238.      Enter the file name and description of the file to be uploaded
  239.      Select "Batch" as the protocol
  240.      Repeat for additional files
  241.      
  242.      Type X or B to bring up the "Batch" transfer menu
  243.      Select B from the menu    << this is important. D or U will NOT work >>
  244.      Select HS/Link as the protocol
  245.      Start your HS/Link UPLOAD  << HS/Link will take care of the downloads >>
  246.      
  247.      
  248.           I hope this takes some of the mystery out of HS/Link operation. Sam
  249. Smith (HS/Link author) has looked this over, and it has his blessings. If you
  250. have any problems, or discover something I have overlooked, or described
  251. incorrectly, PLEASE notify me as soon as possible. I will attempt to update
  252. this document as new information becomes available.
  253.      
  254.      
  255.      
  256.                                 Lance Halle  1@6211 
  257.            MOON VALLEY TRIANGLE    Phoenix, Az.    602-942-9228  24 hrs 
  258.                              WWIVnet  602 A.C.  [GSA ASV] 
  259.      
  260.      07/11/92
  261.