home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / hsd114g6.zip / HSDLP.DOC < prev    next >
Text File  |  1993-07-18  |  10KB  |  232 lines
  1.  
  2.                               DLP HS/Link
  3.  
  4.                      Copyright 1993 Samuel H. Smith
  5.                           All Rights Reserved
  6.  
  7.  
  8.             A version of the HS/Link File Transfer Protocol
  9.                               for use with
  10.                         ProComm Plus for Windows
  11.  
  12.                     (PRELIMINARY APPLICATION NOTES)
  13.  
  14.  
  15. HSLINK.DLP is a special version of the HS/Link program which has been written
  16. specifically for use by ProComm Plus for Windows (PROWIN).
  17.  
  18.  
  19.                               INSTALLATION
  20.  
  21. Simply place the HSLINK.DLP in your PROWIN directory, and the HSLINK protocol
  22. will automatically appear in the protocol menus and will work as other
  23. protocols do in this environment.
  24.  
  25. If you wish to include HS/Link in your "host mode" operations, copy the
  26. supplied HOST.WAS file to your PROWIN\ASPECT directory.
  27.  
  28.  
  29.                                OPERATION
  30.  
  31. Once HSLINK.DLP is installed in your PROWIN directory, the HS/Link protocol
  32. will automatically appear in PROWIN's protocol menus.
  33.  
  34. Downloads are automatic and require no special attention.
  35.  
  36. To upload, click the "upload" icon and select files to transmit.
  37.  
  38. To perform a bidirectional transfer, note that you MUST NOT press the final
  39. <ENTER> key required by the BBS you are calling.  Instead, click the "upload"
  40. icon and flag outgoing files.  When HSLINK starts on your end, it will send
  41. the final <ENTER> key sequence to the BBS.
  42.  
  43.                              CONFIGURATION
  44.  
  45. If you wish to set HS/Link options, you can modify the HSLINK.INI file in
  46. your PROWIN directory.  These settings are normally manipulated via the
  47. "Advanced!" setup option of HS/Link from within PROWIN.
  48.  
  49. To configure HSLINK.DLP, activate ProComm+ "Current Setup" ICON, then
  50. highlight the button "Protocol: hslink.dlp" and click "Advanced!".
  51.  
  52. Crash Recovery settings
  53.         Off
  54.                 Disable crash recovery.  Do not allow received files to
  55.                 overwrite existing files.  Partial files from aborted
  56.                 transfers are automatically erased.
  57.  
  58.         Full Recovery
  59.                 Enable full crash recovery.  This option causes partial
  60.                 files from aborted transfers to be retained.  If a
  61.                 received file matches the filename of an existing file,
  62.                 the contents of the file is compared to the received
  63.                 file, and only those blocks which differ are
  64.                 transferred.
  65.  
  66.         Overwrite
  67.                 Disable crash recovery.  Allow received files to
  68.                 overwrite existing files.  Partial files from aborted
  69.                 transfers are retained.
  70.  
  71.  
  72. Block Size settings
  73.         256     Each block will be 265 bytes in length
  74.         1k      Each block will be 1024 bytes in length
  75.         2k      Each block will be 2048 bytes in length
  76.         4k      Each block will be 4096 bytes in length
  77.  
  78. Acknowledge Window Settings
  79.         Full streaming (none)
  80.                 In this mode of operation, blocks are transmitted
  81.                 continuously with no acknowledgement of receipt.  This
  82.                 mode of operation is useful when error correcting modems
  83.                 are used or when flow control is not required.
  84.  
  85.         8 blocks (normal)
  86.                 In this mode of operation, up to 8 blocks may be in
  87.                 transit before an acknowledgement of receipt is
  88.                 required.  Once acknowledgement is received, the next
  89.                 block will be transmitted.  This acknowledgement process
  90.                 provides a form of flow control which is useful when
  91.                 other forms of flow control are not totally reliable.
  92.  
  93.         4 blocks (PC Pursuit)
  94.                 When operating HSLINK on a PC Pursuit connection, I
  95.                 recommend the settings of Ack Window = 4, Block size =
  96.                 256, Xon/Xoff = ON, Minimal Blocks = OFF.
  97.  
  98. File Settings
  99.         Transfer Log File:
  100.                 This defines the DSZLOG-style transfer result log
  101.                 filename.  If left blank, the DSZLOG environment
  102.                 variable specifies this filename.  If no DSZLOG
  103.                 environment setting exists, no logfile will be produced.
  104.  
  105.         Error Log File:
  106.                 This defines the filename for a detailed transfer and
  107.                 error log to be created.  If left blank, the HSERR
  108.                 environment variable specifies this filename.  If no
  109.                 HSERR environment setting exists, no logfile will be
  110.                 produced.
  111.  
  112.         Duplicate Checklist:
  113.                 This defines the filename of a duplication checklist
  114.                 file.  The duplication checklist file can contain a list
  115.                 of directories or filenames to check for duplication.
  116.                 If an incoming file matches a filename or a file in a
  117.                 directory listed here, the file will be rejected.
  118.                 NOTE: duplication checking is active ONLY when Crash
  119.                 Recovery is set to "OFF".  Other crash recovery modes
  120.                 grant HSLINK permission to modify existing files, making
  121.                 a duplication checklist meaningless.
  122.  
  123. Other Options
  124.         Original File Time Stamp
  125.                 Checking this option causes the original file's time and
  126.                 date to be preserved.  Unchecking the option causes the
  127.                 current time and date to be given to a file when it is
  128.                 received.
  129.  
  130.         Minimal Blocks
  131.                 Checking this option causes HSLINK to minimize each
  132.                 block transmitted, resulting in an increase in thruput.
  133.                 Unchecking this option causes HSLINK to include
  134.                 additional information in each block as required by PC
  135.                 Pursuit or some other environments.
  136.  
  137.         File Buffering
  138.                 Checking this option causes HSLINK to use a 10k buffer
  139.                 for files being received or transmitted.  Unchecking
  140.                 this option causes HSLINK to read or write each file
  141.                 block as it is sent or received.
  142.  
  143.         Large Status Display
  144.                 Checking this option causes a larger file transfer
  145.                 status display to be used.
  146.  
  147.         XON/XOFF Handshake
  148.                 Checking this option indicates that you desire to use
  149.                 the XON/XOFF software handshake.  Unchecking this option
  150.                 indicates that you do not desire this handshake, but
  151.                 that you will still use it if the remote unit desires
  152.                 its use.
  153.  
  154.         Force Remote to use Local Settings
  155.                 Checking this option causes forces the remote unit to
  156.                 use your settings for Minimal Blocks, Block Size, Ack
  157.                 Window and Xon/Xoff.  Unchecking this option allows the
  158.                 remote unit to override your settings, or causes
  159.                 compromise settings to be negotiated according to both
  160.                 local and remote options.
  161.  
  162.         Allow Bidirectional Transfers
  163.                 Checking this option allows files to be received while
  164.                 files are being transmitted.  Unchecking this option
  165.                 causes HSLINK to reject any incoming files when files
  166.                 are being transmitted.
  167.  
  168.         Beeper in Chat Mode
  169.                 Checking this option allows the remote unit to beep your
  170.                 speaker with the "page remote" or ^G key in CHAT mode.
  171.                 Unchecking this option forces your speaker to remain
  172.                 silent at all times.
  173.  
  174.  
  175. Controls
  176.         OK
  177.                 This causes current settings to be saved.
  178.  
  179.         Cancel
  180.                 This causes changes in settings to be discarded and
  181.                 previous settings to remian in effect.
  182.  
  183.         Use Default
  184.                 This resets all settings to their original default
  185.                 values, which should work properly in most
  186.                 circumstances.
  187.  
  188.         Register...
  189.                 This allows you to enter your personal registration code
  190.                 as well as your name and company name.
  191.  
  192.  
  193.  
  194.                               DIFFERENCES
  195.  
  196. HSLINK.DLP is similar to the standard DOS HSLINK with the following
  197. exceptions:
  198.  
  199. *  GIF files are automatically displayed onscreen during file transfer.
  200.  
  201. *  The command line is automatically provided by PROWIN.  Modify the
  202.    HSLINK.INI file provide protocol options.
  203.  
  204. *  The "REGISTER" screen now accepts DLP HS/Link activation codes.
  205.    Sorry, but DOS HS/Link registrations are not valid for the Windows
  206.    DLP version.
  207.  
  208.  
  209.  
  210.               !!!!!!!!!!!!!! BETA TEST VERSION !!!!!!!!!!!!!!!!
  211.      This version may seem to work, but it has not been fully tested and
  212.               is not an official release!  You have been warned.
  213.            PLEASE MAKE FREQUENT BACKUP COPIES OF ALL CRITICAL FILES
  214.               !!!!!!!!!!!!!! BETA TEST VERSION !!!!!!!!!!!!!!!!
  215.  
  216.     Beta Testing is a means of getting widespread exposure to unfinished
  217.     versions of a program during the development process.  The idea is for as
  218.     many users as possible to "beta test" the program and to make suggestions
  219.     and report bugs.  This type of widespread testing can lead to a very
  220.     stable and bug-free finished product (the RELEASE version). Please read
  221.     HSLINK.NEW to see what has been changed recently.
  222.  
  223.     If you encounter problems or would like to make a suggestion, please
  224.     contact the author. HS/Link product support is available by voice at
  225.     (818) 891-4228 between 9am and 6pm pacific time, TUESDAY through
  226.     SATURDAY.
  227.  
  228.     To obtain newer beta test versions, please call (818) 891-1344 and select
  229.     the "free downloading" service from the initial "special services menu".
  230.     You need not be a registered Tool Shop BBS user to access this special
  231.     service.
  232.