home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 515.lha / BackTalk_v1.40 / About_XPR next >
Text File  |  1991-06-08  |  9KB  |  234 lines
  1. XPR Options
  2.  
  3. The behavior of most XPR libraries can be configured through the options
  4. interface (Selected Protocol Options item under the Files menu).
  5.  
  6.  
  7. Following are the user selectable options for the QuickB library.
  8.  
  9.  
  10. (T) Text mode
  11.  
  12. Y      Turn text character editing on.  On downloads, carriage
  13.         return and line feed pairs are turned into line feeds, the
  14.         standard Amiga line termination.  Also, characters following
  15.         a control-Z are ignored.  On uploads, carriage returns are
  16.         added before line feeds, which makes text more easily
  17.         portable to other machines.
  18.     
  19. N      Turns text character editing off.  All characters are passed
  20.         through as untranslated binary.
  21.     
  22. C      Consult the communications program to determine the text/
  23.         binary status.  XprQuickB defaults to binary transfer if the
  24.         communication program cannot assign a status,
  25.     
  26. H      Use the host's suggestion.  For uploads, text or binary mode
  27.         must be specified on the host command.  This is the default
  28.         value of the option.
  29.  
  30.  
  31. (O) Overwrite mode
  32.         
  33. Y      Silently overwrite existing files during downloads.
  34.     
  35. N        Avoid overwriting existing files.  This is done by
  36.         appending ".dup" or ".dupN" (for N a number from 2 to 99)
  37.         to the downloaded file name.  The new name will generally
  38.         appear in the file transfer status window.  If 99 ".dup"
  39.         files exist, ".dup99" will be overwritten.  This is the
  40.         default value of the option.
  41.     
  42. S      This option aborts the download if the file exists.
  43.  
  44.     
  45. (B) I/O buffer size (KB)
  46.         
  47. nnn    Here, "nnn" is a number representing the desired file buffer
  48.         size in multiples of 1024 bytes (KB).  This allows the disk
  49.         to be accessed less frequently.  A value of 0 disables file
  50.         buffering by XprQuickB.  The default is 16 KB.  The buffer
  51.         is allocated only during file transfers.  If the buffer can
  52.         not be allocated, XprQuickB uses no buffering.
  53.  
  54. (A) Auto-activate transfers
  55.     
  56. Y      Setting this option on allows file transfers to be started
  57.         at the request of the host system.  This is the default.
  58.     
  59. N        This disables host initiation of transfers.
  60.  
  61.     
  62. (D) Delete after sending
  63.     
  64. Y        Turning this option on causes an uploaded file to be deleted
  65.         locally after a successful transfer.  The communication
  66.         program must support the "xpr_unlink" call-back function to
  67.         enable this option.
  68.     
  69. N        Uploaded files are retained.  This is the default.
  70.  
  71.     
  72. (K) Keep partial files
  73.     
  74. Y        Setting this option on causes the incomplete file from an
  75.         unsuccessful download to be retained.
  76.     
  77. N        Setting this option off causes the incomplete file to be
  78.         deleted.  The deletion occurs only if the "xpr_unlink"
  79.         call-back is supported.  This is the default (if
  80.         "xpr_unlink" is available).
  81.  
  82.  
  83. Following are the user selectable options for the ZModem library.
  84.  
  85.  
  86. T{Y|N|?|C}   Text translation mode:
  87.  
  88. TY = Text Yes; if receiving, translate CR/LF pairs or solo
  89.      CR chars to normal Amiga LF chars.  Ignore data past ^Z.
  90.      If sending, suggests to receiver that they should receive
  91.      this file in text mode.
  92.      
  93. TN = Text No; receive file verbatim, without changes.  If
  94.      sending, suggest to receiver that they receive this
  95.      file verbatim, without translations.
  96.  
  97. T? = Text status unknown; if receiving, use sender's
  98.      suggestion as to whether to do EOL translations or not.
  99.      If sending, tell receiver to use default mode, 'cause we
  100.      don't know either.
  101.  
  102. TC = Text mode set by Comm program; the library asks the comm
  103.      program whether or not to use Text mode for each file.
  104.      If the comm program doesn't support the necessary
  105.      xpr_finfo() call, or if the call fails, this option acts
  106.      like T?.  From the user's point of view, what this option
  107.      normally does is set the Text mode to match the comm
  108.      program's built-in text/binary/end-of-line/translation
  109.      mode, if any.
  110.  
  111. O{Y|N|R|S}  Overwrite mode:
  112.  
  113. OY = Overwrite Yes; if about to receive file with same name as
  114.      one which already exists, delete the old file and receive
  115.      the new file in its place.
  116.  
  117. ON = Overwrite No; if about to receive file with same name as
  118.      one which already exists, append ".dup" onto the name of
  119.      the new file to keep them separate.
  120.  
  121. OR = Overwrite Resume; if about to receive file with same name
  122.      as one which already exists, resume receiving file data
  123.      from the current end of the existing file.
  124.  
  125. OS = Overwrite Skip; if (etc.), tell sender never mind, skip
  126.      this file, we don't want it.  Batch transfers will move
  127.      on to the next file in the set, if any.
  128.  
  129. Bnnn   Buffer size:
  130.  
  131.      XPRZModem.library adds a layer of file I/O buffering in
  132.      addition to whatever the comm program may or may not provide.
  133.      This option sets the size of XPRZModem's file I/O buffer in
  134.      kilobytes.  The minimum value is 1 KB, for those using RAM
  135.      drives or fast hard drives, or those whose comm programs
  136.      already provide sufficient buffering.  The maximum value is
  137.      as much contiguous RAM as you have available in your Amiga.
  138.      If you specify more than is actually available, XPRZModem will
  139.      keep decrementing the buffer size requested by 1 KB until the
  140.      memory allocation works.  That way, if your RAM is too
  141.      fragmented to use the amount you request, XPRZModem simply
  142.      uses the largest block available.  Buffering is especially
  143.      helpful for floppy drive users; it keeps your drive from
  144.      continuously gronking and slowing things down all through the
  145.      transfer.  
  146.  
  147. Fnnn   Frame size:
  148.  
  149.      Although normally avoided, ZModem has the ability to require
  150.      an ACK to be sent from the receiver to the sender every X-many
  151.      data bytes.  Normally you don't want to use this feature,
  152.      because not waiting for ACKs is part of how ZModem works so
  153.      fast.  However, this feature can be very useful in conjunction
  154.      with file I/O buffering on slow devices (namely those floppy
  155.      drives).  If you set up a large I/O buffer to avoid gronking
  156.      your floppy so often, you'll find that when the buffer finally
  157.      *does* get around to being flushed that it can take a looonng
  158.      time; so long, in fact, that the delay can cause timeouts and
  159.      errors.  But if you set your ZModem to require the sender to
  160.      wait for an ACK every buffer's-worth of data, the sender will
  161.      politely wait for you to flush your buffer to the slow floppy
  162.      and send it an ACK saying it's OK to continue now.  This value
  163.      should be set to 0 to disable ACKs (normal mode), or set it to
  164.      the actual number of data bytes allowed between ACKs.  For
  165.      example, if you set B64 because of your floppy, you should
  166.      also set F65536.
  167.  
  168. Ennn   Error count:
  169.  
  170.      This allows you to set the number of sequential errors which
  171.      will be required to convince ZModem to abort the transfer.  The
  172.      normal value is 10, meaning that 10 errors must happen in a row
  173.      with no valid data being transferred in order to cause an abort.
  174.      This setting is provided for those using XPRZModem with a BBS,
  175.      who may wish to use a relaxed setting, or those with really
  176.      lousy phone lines who are desparate and patient enough to want
  177.      the transfer to continue in spite of horrible performance.
  178.  
  179. A{Y|N}   Auto-activate mode:
  180.  
  181. AY = Auto-activate Yes; if the comm program supports the
  182.      ability, the library will automatically go into receive
  183.      mode when the start of a ZModem download is detected.
  184.  
  185. AN = Auto-activate No; don't try to automatically start
  186.      downloading, make the user activate it.
  187.  
  188. D{Y|N}   Delete after sending:
  189.  
  190. DY = Delete Yes; delete each file after it has been
  191.      sucessfully sent.
  192.      
  193. DN = Delete No; don't delete files after sending them.
  194.  
  195. K{Y|N}   Keep partial files:
  196.  
  197. KY = Keep Yes; keep the fragment of a file received so far
  198.      if file reception is aborted.  This allows you to use the
  199.      Overwrite Resume option above to pick up where you left
  200.      off on your next attempt.
  201.  
  202. KN = Keep No; delete any partially-received file after an
  203.      aborted transfer.
  204.  
  205. S{Y|N}   Send full directory path:
  206.  
  207. SY = Send path Yes; send full filenames including directory
  208.      path to receiver.
  209.  
  210. SN = Send path No; send only simple filenames, not including
  211.      directory path.
  212.  
  213. R{Y|N}   Receive full directory path:
  214.  
  215. RY = Receive path Yes; use full filename exactly as received,
  216.      instead of using the P option directory path.
  217. RN = Receive path No; ignore received directory path (if any),
  218.      use P option directory path instead.
  219.  
  220. P{dir}   Path to use for received files:
  221.  
  222. Px = Store all received files in directory "x" if option RN
  223.      set.  Ignored if option RY set.  "x" can be any valid
  224.      existing directory, with or without trailing "/"
  225.      (e.g. "Pdf0:", "PComm:hold", etc.).
  226.  
  227.  
  228. If you are using the SETXPR ARexx command to change the default
  229. settings of the selected protocol, in the argument for SETXPR,
  230. the setting for each option must immediately follow the option
  231. character with no intervening characters ("TY", not "T Y" or "T=Y").
  232. When setting multiple options at once, separate the options from each
  233. other with commas and/or spaces, for example, "TN,OR,F0".
  234.