home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RAFM121.ZIP / RAFM.DOC < prev    next >
Encoding:
Text File  |  1993-02-12  |  115.9 KB  |  3,004 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                 ▐▀▀▀▀▀▀▀▀▀▀▌  ▐▀▀▀▀▀▀▀▀▌  ▐▀▀▀▀▀▀▀▀▀▌  ▐▀▀▀▀▀▀▀▀▀▀▀▀▌
  24.                 ▐▄  ▄▄▄▄▄  ▌  ▐  ▄▄▄▄  ▌  ▐▄  ▄▄▄▄▄ ▌  ▐  ▄▄▄  ▄▄▄  ▌
  25.                  ▐  ▌   ▐  ▌  ▐  ▌  ▐  ▌   ▐  ▌   ▐▄▌  ▐  ▌ ▐  ▌ ▐  ▌
  26.                  ▐  ▀▀▀▀▀  ▌  ▐  ▀▀▀▀  ▌   ▐  ▀▀▀▌     ▐  ▌ ▐  ▌ ▐  ▌
  27.                  ▐  ▄▄  ▄▄▄▌  ▐  ▄▄▄▄  ▌   ▐  ▄▄▄▌     ▐  ▌ ▐  ▌ ▐  ▌
  28.                  ▐  ▌▐▄ ▀▌    ▐  ▌  ▐  ▌   ▐  ▌        ▐  ▌ ▐▄▄▌ ▐  ▌
  29.                 ▐▀  ▀▌▐▄ ▀▀▌ ▐▀  ▀▌▐▀  ▀▌ ▐▀  ▀▌      ▐▀  ▀▌    ▐▀  ▀▌
  30.                 ▐▄▄▄▄▌ ▐▄▄▄▌ ▐▄▄▄▄▌▐▄▄▄▄▌ ▐▄▄▄▄▌      ▐▄▄▄▄▌    ▐▄▄▄▄▌
  31.  
  32.      ──────────────────────────────────────────────────────────────────────
  33.      RemoteAccess File Manager version 1.21 - Copyright by René van Hoorn
  34.      ══════════════════════════════════════════════════════════════════════
  35.  
  36.                      RemoteAccess File Manager version 1.21
  37.      ───────────────────────────────────────────────────────────────────────
  38.  
  39.  
  40.      ╒═════════════════════════════════════════════════════════════════════╕
  41.      │░░░ Contents ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  42.      ╘═════════════════════════════════════════════════════════════════════╛
  43.  
  44.           Introduction and credits . . . . . . . . . . . . . . . . . .    1
  45.  
  46.           Legal aspects  . . . . . . . . . . . . . . . . . . . . . . .    3
  47.  
  48.           General  . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  49.  
  50.           Installation . . . . . . . . . . . . . . . . . . . . . . . .    8
  51.  
  52.           Upgrading from 1.20 version to 1.21  . . . . . . . . . . . .    9
  53.  
  54.           Environment  . . . . . . . . . . . . . . . . . . . . . . . .    9
  55.  
  56.           Rafm . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  57.           Commandline parameters . . . . . . . . . . . . . . . . . . .   11
  58.           Tagging  . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  59.           Multi-line systems . . . . . . . . . . . . . . . . . . . . .   12
  60.           Menus  . . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  61.  
  62.           RafmEdit . . . . . . . . . . . . . . . . . . . . . . . . . .   25
  63.           Areas  . . . . . . . . . . . . . . . . . . . . . . . . . . .   25
  64.           Files  . . . . . . . . . . . . . . . . . . . . . . . . . . .   27
  65.           Protocols  . . . . . . . . . . . . . . . . . . . . . . . . .   32
  66.                 Protocols (External) . . . . . . . . . . . . . . . . .   32
  67.                 Protocols (Internal) . . . . . . . . . . . . . . . . .   34
  68.           Configuration  . . . . . . . . . . . . . . . . . . . . . . .   35
  69.                 General  . . . . . . . . . . . . . . . . . . . . . . .   35
  70.                 Colors . . . . . . . . . . . . . . . . . . . . . . . .   36
  71.                 Downloading  . . . . . . . . . . . . . . . . . . . . .   36
  72.                 Uploading  . . . . . . . . . . . . . . . . . . . . . .   38
  73.                 Maintenance  . . . . . . . . . . . . . . . . . . . . .   40
  74.                 Archives . . . . . . . . . . . . . . . . . . . . . . .   41
  75.                 User Info  . . . . . . . . . . . . . . . . . . . . . .   42
  76.  
  77.           RafmCln  . . . . . . . . . . . . . . . . . . . . . . . . . .   42
  78.  
  79.           RafmCD . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  80.  
  81.           RafmChk  . . . . . . . . . . . . . . . . . . . . . . . . . .   46
  82.  
  83.           RafmAll  . . . . . . . . . . . . . . . . . . . . . . . . . .   47
  84.  
  85.           RafmLCom . . . . . . . . . . . . . . . . . . . . . . . . . .   48
  86.  
  87.  
  88.  
  89.      ───────────────────────────────────────────────────────────────────────
  90.                                                                     Page: i
  91.  
  92.                      RemoteAccess File Manager version 1.21
  93.      ───────────────────────────────────────────────────────────────────────
  94.  
  95.  
  96.           RafmCnvt . . . . . . . . . . . . . . . . . . . . . . . . . .   50
  97.  
  98.           Bugreports, address etc. . . . . . . . . . . . . . . . . . .   51
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.      ───────────────────────────────────────────────────────────────────────
  146.                                                                    Page: ii
  147.  
  148.                      RemoteAccess File Manager version 1.21
  149.      ───────────────────────────────────────────────────────────────────────
  150.  
  151.  
  152.      ╒═════════════════════════════════════════════════════════════════════╕
  153.      │░░░ Introduction and credits ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  154.      ╘═════════════════════════════════════════════════════════════════════╛
  155.  
  156.      Welcome to RAFM, the ultimate file-manager for RemoteAccess (tm)
  157.      version 1.11 and up. First of all, I'd like to thank you for showing
  158.      interest in this program, believe me, you won't be disappointed! 
  159.  
  160.      Rafm is the product of well over two years of programming and testing.
  161.      And over the course of these years it has developed into what can only
  162.      be described as the best file-manager available for Remote Access.
  163.  
  164.      The author (René van Hoorn) debated for some time wether or not to
  165.      release Rafm as shareware. Although shareware is without doubt the
  166.      best way to spread programs to a widest possible audience (and the
  167.      only way for you to try before you pay). It is an unfortunate fact of
  168.      life that very few people that use shareware programs after the
  169.      initial trial period will actually bother to register them.
  170.      Finally, it was decided to release the first versions as shareware.
  171.      Maybe the shareware philosophy still works? On the other hand, maybe
  172.      not, it is up to YOU to keep the shareware ideal alive! 
  173.  
  174.      RAFM has a couple of registered-only features which are marked in the
  175.      documentation with a +. These features are not available to non-
  176.      registered users but will be activated when a valid key is present.
  177.  
  178.      This document makes reference to the following third-party products,
  179.      all copyrights, trademarks and reserved rights held in these products
  180.      are acknowledged.
  181.  
  182.      Copyrights:
  183.  
  184.      RemoteAccess :         copyright by Andrew Milner & Continental
  185.                             Software
  186.      Bimodem:               copyright by Eric Labs
  187.      PkArc, PkZip:          copyright by PKWARE Inc.
  188.      Pak:                   copyright by NoGate Consulting
  189.      Arj:                   copyright by Robert K Jung
  190.      Lha, LhArc :           copyright by Haruyasu Yoshizaki
  191.      Hyper :                copyright by P. Sawatzki and K.P. Nischke
  192.      Squeeze it:            copyright by Jonas I. Hammarberg
  193.      Scan:                  copyright by McAfee Associates
  194.      DSZ, GSZ :             copyright by Omen Technology INC
  195.      HsLink:                copyright by Samuel H. Smith
  196.      QFF, RFW, 
  197.      FileDoor:              copyright by Robert W. van Hoeven
  198.      RAFM Documentation:    Eddy Matthews & René van Hoorn
  199.  
  200.  
  201.      ───────────────────────────────────────────────────────────────────────
  202.                                                                     Page: 1
  203.  
  204.                      RemoteAccess File Manager version 1.21
  205.      ───────────────────────────────────────────────────────────────────────
  206.  
  207.  
  208.  
  209.      I would like to thank:
  210.  
  211.      Andrew Milner for writing RemoteAccess
  212.      Maris for her mental support
  213.      Pim van Kralingen for testing some very early alpha-versions
  214.      Eddy Matthews for re-writing the document files
  215.  
  216.      and of course my beta-team! Thanx guys!
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.      ───────────────────────────────────────────────────────────────────────
  258.                                                                     Page: 2
  259.  
  260.                      RemoteAccess File Manager version 1.21
  261.      ───────────────────────────────────────────────────────────────────────
  262.  
  263.  
  264.      ╒═════════════════════════════════════════════════════════════════════╕
  265.      │░░░ Legal aspects ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  266.      ╘═════════════════════════════════════════════════════════════════════╛
  267.  
  268.  
  269.      By installing RAFM and its associated programs on your system, you
  270.      indicate your agreement to the following terms and conditions. If you
  271.      do not agree to these conditions, you should not install and use RAFM.
  272.  
  273.      Users of RAFM must accept this disclaimer of warranty:
  274.  
  275.      The author, René van Hoorn, disclaims all warranties, expressed or
  276.      implied, including, without limitation, the warranties of
  277.      merchantability and of fitness for any purpose.
  278.  
  279.      The author assumes no liability for damages, direct or consequential,
  280.      which may result from the use of RAFM and its utilities.
  281.  
  282.      RAFM is copyrighted material by René van Hoorn, Hilversum, The
  283.      Netherlands
  284.  
  285.                             THIS PRODUCT IS SHAREWARE
  286.  
  287.      You may use it for 30 days without registering in order to assess the
  288.      contents of this package. Continued use of this package after the
  289.      initial period of 30 days requires you to pay a registration fee as
  290.      defined in the various RAFM registration files to René van Hoorn or to
  291.      one of his alloted registration sites.
  292.  
  293.      The registration fee will license one copy for use on any one computer
  294.      at any one time.
  295.  
  296.      You are allowed to copy and distribute the unregistered version of
  297.      this package, providing that you make no charges other than are
  298.      necessary for copying, materials and handling. The files must not be
  299.      separated or altered in any way whatsoever including reverse
  300.      engineering.
  301.  
  302.      Registration entitles you to use RAFM for as long as you wish, removes
  303.      the intro-message and activates the extra registered only {+}
  304.      features.
  305.  
  306.      The author (René van Hoorn) is in no way obliged to give future
  307.      support for any version of RAFM.
  308.  
  309.      If you don't agree with these rules, you may NOT use RAFM!
  310.  
  311.  
  312.  
  313.      ───────────────────────────────────────────────────────────────────────
  314.                                                                     Page: 3
  315.  
  316.                      RemoteAccess File Manager version 1.21
  317.      ───────────────────────────────────────────────────────────────────────
  318.  
  319.  
  320.      ╒═════════════════════════════════════════════════════════════════════╕
  321.      │░░░ General ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  322.      ╘═════════════════════════════════════════════════════════════════════╛
  323.  
  324.  
  325.      Ok, now for the good part: What is RAFM?
  326.  
  327.      Rafm is a complete file management system. It supports all of RA's
  328.      internal functions and many more besides. Perhaps you thought Rafm was
  329.      just another FileDoor?, it isn't!.
  330.       
  331.      For users of RA it's quite revolutionary, because it doesn't rely on
  332.      RA's Files.Bbs anymore (although it still fully supports their use).
  333.      Instead of those files, it uses ONE database and for high-speed access
  334.      a small index-file. At this moment in time there isn't a faster
  335.      program around. Also, the full-screen editor is unique and offers you
  336.      a powerful set of tools for editing and maintaining the file-section
  337.      of your BBS. You will no longer need to edit those long ASCII-files...
  338.  
  339.  
  340.      Now for a brief and incomplete overview of the main features:
  341.  
  342.      -    Global download from every area.
  343.      -    Internal ProtocolEngine with support for Xmodem, Xmodem/1K,Ymodem
  344.           and Zmodem (incl. -G versions for reliable connects only).
  345.      -    Enhanced protocol interface. All protocols can be used, not only
  346.           those creating a log-file.
  347.      -    Support for Bi-directional protocols (Send and Receive
  348.           simultaneously).
  349.      -    Built-in Bimodem interface, no need for an external program.
  350.      -    Multi-language support using compiled .LNG files.
  351.      -    Use of multi-line file-descriptions.
  352.      -{+} Users have the option to download a file containing the
  353.           description of downloaded files.
  354.      -    Users have the ability to select a maximum of 20 files to
  355.           download, even if the selected protocol doesn't support batch-
  356.           tranfers.
  357.      -    Support for ZIP/ARC/PAK/ARJ/LZH and HYP archives, including self-
  358.           extracting archives.
  359.      -    Users can view archives, extract files from archives and convert
  360.           archives to another type.
  361.      -    2 types of file-listing (RAFM and RA-alike).
  362.      -    Estimated time to download a file is shown in the listing.
  363.      -    Users can be forced to enter filenames and descriptions before
  364.           the actual upload.
  365.      -{+} (On-line) Virus-checking and re-archiving of uploads. 
  366.  
  367.  
  368.  
  369.      ───────────────────────────────────────────────────────────────────────
  370.                                                                     Page: 4
  371.  
  372.                      RemoteAccess File Manager version 1.21
  373.      ───────────────────────────────────────────────────────────────────────
  374.  
  375.  
  376.      -    Full-screen ANSI/Avatar cursor-tagging, no need to enter
  377.           filenames anymore.
  378.      -    Built in Chatmode (or use an external program). 
  379.      -    Fully user-definable colours.
  380.      -    Dupe-checking (all or selected areas).
  381.      -    Duplicate files can be moved to a special area or killed. (Same
  382.           for bad archives).
  383.      -    Uploads can be restricted to one area.
  384.      -    Working (!) Kb and File-ratios, with an option to leave out the
  385.           first x number of files and x Kb.
  386.      -    Functional private (sysop-only) files.
  387.      -    Support for Free Files (Won't affect the user's time- and
  388.           download-limit).
  389.      -    Support for unwanted filenames.
  390.      -    Option to give upload-credit both in time and/or in increased
  391.           download-kb-limit.
  392.      -    Full use of FILE_ID.DIZ and DESC.SDI files describing the
  393.           uploaded file.
  394.      -    Rafm can delete unwanted files from archives (especially those
  395.           stupid BBS-advertisements).
  396.      -    (Optional) Automatic log-off after transfer. 
  397.      -    Auto-Adopt. (Scanning directories for files and adding them to
  398.           the database).
  399.      -    File-maintenance. Optionally you can let Rafm move and/or kill
  400.           static files that aren't downloaded within a certain (definable)
  401.           period.
  402.      -    Fully multi-line aware.
  403.      -    CD-ROM support.
  404.      -    Avatar-support.
  405.      -    Internal ANSI and Avatar-driver for fast screen display. 
  406.      -    and much much more...
  407.  
  408.      Perhaps the most important feature of Rafm:
  409.      except for the offline virus-check and re-archiving of uploads, ALL
  410.      options are contained in only ONE program! There is no need for
  411.      constant switching between programs! (In fact, this was the main
  412.      reason for writing Rafm.)
  413.  
  414.      What's in the archive?
  415.  
  416.      - 120to121.EXE:  Upgrade utility for converting your datafiles from
  417.                       version 1.xx to 1.20.
  418.      - RAFM.EXE:      The main program. A fossil-driven door with carrier-
  419.                       detect and time-check (of course).
  420.      - RAFMALL.EXE:   The all/new-file list creator. With its own internal
  421.                       full-screen configuration. Can create upto 10
  422.  
  423.  
  424.  
  425.      ───────────────────────────────────────────────────────────────────────
  426.                                                                     Page: 5
  427.  
  428.                      RemoteAccess File Manager version 1.21
  429.      ───────────────────────────────────────────────────────────────────────
  430.  
  431.  
  432.                       different all/new-file list combinations in only one
  433.                       run.
  434.      - RAFMCD.EXE:    A little program to convert your file-listings to a
  435.                       special format, designed to be used with CD-ROMs.
  436.      - RAFMCD.DEF:    Example of a coniguration file for RAFMCD.EXE
  437.      - RAFMCLN.EXE:   Maintenance-program for use in your nightly(?) batch-
  438.                       file. Used to keep the database up-to-date.
  439.      - RAFMCHK.EXE:   Virus-check and re-archiving program. Used to
  440.                       manipulate newly uploaded files.
  441.      - RAFMCNVT.EXE:  The conversion-program. Used to read the files.bbs
  442.                       into Rafm's database.
  443.      - RAFMEDIT.EXE:  The full-screen editor. Used to edit areas, files and
  444.                       protocols.
  445.      - RAFMLCOM.EXE:  Language compiler. Used to compile .LNG files
  446.      - *.OVR:         Several overlays, used by the different .EXE's. 
  447.      - README.1ST:    Important note!
  448.      - BETA.APP:      Beta-application form. Use this form when you want to
  449.                       become a beta-tester for RAFM.
  450.      - COMMON.Q-A:    An overview of commonly asked questions about RAFM. 
  451.      - RAFM.DOC:      That's what you're reading now.
  452.      - ENGLISH.LNG:   Default language file (English)
  453.      - DUTCH.LNG:     Dutch language definition.
  454.      - GERMAN.LNG:    German language definition file.
  455.      - RAFMPROT.DDD:  Description of the most often used protocols (rename
  456.                       this to RafmProt.Dat if you want to use it).
  457.      - RAFMZIP.BAT:   Batch-file used by RafmAll to archive the created
  458.                       All/New-files-listings.
  459.      - REGISTER.DOC:  Information about prizes and registration procedures.
  460.      - REGISTER.*:    Several registration-forms for each country where a
  461.                       support-node is located.
  462.      - RAFMSUP.DOC:   List of support-nodes which will help you setting up
  463.                       RAFM.
  464.      - RAFMVAR.DOC:   File desciribing RAFM's strucures.
  465.      - EXAMPLE.ARJ:   Set of menus and .A?? files.
  466.      - WHATS.NEW:     Short overview of all changes since 1.00
  467.  
  468.  
  469.      After installation, the following files will be created:
  470.  
  471.      - RAFMAREA.DAT:  Contains the area-information.
  472.      - RAFMCONF.DAT:  Configuration-file.
  473.      - RAFMFILE.DAT:  The file-database.
  474.      - RAFMIDX.DAT:   Index-file.
  475.      - RAFMPROT.DAT:  Contains all info about installed protocols. 
  476.      - ALLCONF.DAT:   Created and used by RafmAll.
  477.      - *.CLG:         One or more compiled language file(s).
  478.  
  479.  
  480.  
  481.      ───────────────────────────────────────────────────────────────────────
  482.                                                                     Page: 6
  483.  
  484.                      RemoteAccess File Manager version 1.21
  485.      ───────────────────────────────────────────────────────────────────────
  486.  
  487.  
  488.      What other programs do you need apart from these files?
  489.  
  490.      - One or more archivers. 
  491.  
  492.           Rafm uses following programs:
  493.  
  494.           - ZIP:      PkZip.Exe (tested with version 1.10 and 2.04C)
  495.           - ARC:      PkArc/PkxArc (tested with version 3.5)
  496.           - LZH:      LhArc.Exe/Lha.Exe (tested with both versions 1.13 and
  497.                       2.12)
  498.           - PAK:      Pak.Exe (tested with version 2.51)
  499.           - ARJ:      Arj.Exe (tested with version 2.30)
  500.           - HYP:      Hyper.Exe (tested with version 2.5)
  501.           - SQZ:      Sqz.Exe (tested with version 1.08.02)
  502.  
  503.           Note: Please use only the tested versions (or higher) of the
  504.           archivers. Some functions (like adding comments to ARJ archives)
  505.           will NOT work with earlier versions!
  506.  
  507.      - A virus-scanner, f.e. Scan from McAfee.
  508.      - RemoteAccess (V1.1x or higher)
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.      ───────────────────────────────────────────────────────────────────────
  538.                                                                     Page: 7
  539.  
  540.                      RemoteAccess File Manager version 1.21
  541.      ───────────────────────────────────────────────────────────────────────
  542.  
  543.  
  544.      ╒═════════════════════════════════════════════════════════════════════╕
  545.      │░░░ Installation ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  546.      ╘═════════════════════════════════════════════════════════════════════╛
  547.  
  548.  
  549.      Installation is quite easy, just follow these steps:
  550.  
  551.       1.  Create a new sub-directory and copy the *.EXE and *.OVR files to
  552.           this directory (Multi-liners: place a copy of RAFM.EXE in each of
  553.           your line-directories).
  554.  
  555.       2.  Rafm uses an environment-variable called "RAFM" (without the ""
  556.           of course) to find the data-files. If this variable is NOT set,
  557.           Rafm will use the current directory.
  558.  
  559.           Edit your autoexec.bat and add following line to it:
  560.  
  561.           SET RAFM=<Full Path>
  562.  
  563.           Don't forget to reboot before you run Rafm for the first time and
  564.           don't put any spaces in the SET command or else it won't work!
  565.           (refer to your DOS-manual)
  566.  
  567.       3.  Copy all .A?? files to your textfile-path and all .MNU files to
  568.           your menufile-directory.
  569.  
  570.       4.  Run RafmCnvt.Exe and answer the questions asked.
  571.  
  572.       5.  Run RafmEdit.Exe. The first time RafmEdit is run, it will create
  573.           the configuration- and protocol-datafile. Walk through all menu-
  574.           options and change whatever you want.
  575.  
  576.       6.  Run RafmLCom.Exe to compile the language files.
  577.           You have to rename or create a language file first! The archive
  578.           contains three different language files (*.LNG).
  579.  
  580.       7.  Create a type 7 menu-entry in RA (using RaConfig -m). The
  581.           dataline should contain following:
  582.  
  583.           C:\RA\RAFM\RAFM.EXE *N *M
  584.  
  585.           *N is only necessary when running a multi-line system. (*M is
  586.           RA's memory swap feature) It's advised to use the memory-swap,
  587.           because Rafm has to call other programs (archivers, transfer-
  588.           protocols etc).
  589.  
  590.  
  591.  
  592.  
  593.      ───────────────────────────────────────────────────────────────────────
  594.                                                                     Page: 8
  595.  
  596.                      RemoteAccess File Manager version 1.21
  597.      ───────────────────────────────────────────────────────────────────────
  598.  
  599.  
  600.      Now you're ready to run Rafm local. Run RAFM with the -L parameter and
  601.      enter your name . For easy operation it's advised to place the RAFM-
  602.      directory in your PATH (refer to your DOS manual). In that case Rafm
  603.      and all accompanying programs will always be able to find the *.DAT
  604.      files.
  605.  
  606.  
  607.      ╒═════════════════════════════════════════════════════════════════════╕
  608.      │░░░ Upgrading from 1.20 version to 1.21 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  609.      ╘═════════════════════════════════════════════════════════════════════╛
  610.  
  611.  
  612.      This release (v1.21) uses different structures to earlier versions so
  613.      you will need to convert your old datafiles to the new format.
  614.  
  615.      Please follow these 3 steps:
  616.  
  617.       1.  Copy 120to121.EXE to the directory where Rafm is located and run
  618.           it from there.
  619.           (Note: multiline users should run 120to121.EXE from each of their
  620.           line-directories when using different datafiles for each line!)
  621.  
  622.       2.  Run RafmEdit and change the new fields as necessary.
  623.  
  624.       3.  Edit and re-compile your language files by using a standard
  625.           ASCII-editor and RafmLCom!
  626.  
  627.  
  628.      ╒═════════════════════════════════════════════════════════════════════╕
  629.      │░░░ Environment ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  630.      ╘═════════════════════════════════════════════════════════════════════╛
  631.  
  632.  
  633.      Rafm can use three different environment-variables:
  634.  
  635.      (If necessary refer to your DOS manual for more information on the use
  636.      of environment-variables.)
  637.  
  638.       RAFM: 
  639.                 Should point to the directory where the *.DAT files are
  640.                 located.
  641.  
  642.                 i.e SET RAFM=C:\RA\RAFM
  643.  
  644.                 If not present, Rafm will look for these files in the
  645.                 current directory.
  646.  
  647.  
  648.  
  649.      ───────────────────────────────────────────────────────────────────────
  650.                                                                     Page: 9
  651.  
  652.                      RemoteAccess File Manager version 1.21
  653.      ───────────────────────────────────────────────────────────────────────
  654.  
  655.  
  656.       RAFMTEMP:
  657.                 If present, Rafm will use the directory pointed to by this
  658.                 variable to store the memory-swapfile. If you have a RAM-
  659.                 disk, speed will increase when you let Rafm swap to this
  660.                 disk.
  661.  
  662.                 i.e SET RAFMTEMP=E:\RAFM
  663.  
  664.       RAFMOVR:
  665.                 If present, Rafm will look for the OVR-file in the
  666.                 directory pointed to by this variable. If not present, Rafm
  667.                 will first look in the current directory and then search
  668.                 through the PATH. As with RAFMTEMP, speed will increase
  669.                 further when placing the OVR-file on a RAM-disk.
  670.  
  671.                 i.e. SET RAFMOVR=E:\RAFM
  672.  
  673.                 If using this variable, the OVR-file should be placed in
  674.                 the directory pointed to by RAFMOVR before executing Rafm.
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.      ───────────────────────────────────────────────────────────────────────
  706.                                                                    Page: 10
  707.  
  708.                      RemoteAccess File Manager version 1.21
  709.      ───────────────────────────────────────────────────────────────────────
  710.  
  711.  
  712.      ╒═════════════════════════════════════════════════════════════════════╕
  713.      │░░░ Rafm ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  714.      ╘═════════════════════════════════════════════════════════════════════╛
  715.  
  716.  
  717.      RAFM is the main program of the package. Rafm takes care of whatever a
  718.      remote user wants to do on-line. Rafm can read and understand the
  719.      standard RA-menus, so you should only need to make minor changes to
  720.      your menus when installing Rafm. Please refer to the Menus section of
  721.      the this manual for a full description of all menu-types used by Rafm.
  722.  
  723.      There are a few hard-coded names for some screens used by Rafm. All
  724.      .A?? files should be placed in the textfile-path, as defined in
  725.      RaConfig. RAFM is fully compatible with RA's multi-language support,
  726.      just place the .A?? file in the special textfile-directory for each
  727.      language. RAFM will search the specified language-directory first, and
  728.      only if a file isn't present in that directory, it will look in the
  729.      default-textfile-directory (as defined in RaConfig).
  730.  
  731.      - ARCHHELP.A??:  The Archive-helpfile is shown when a user presses H,
  732.                       when using the full-screen archive-viewer.
  733.      - RAFMDOWN.A??:  Download-menu. Should show all protocols available to
  734.                       the user.
  735.      - RAFMUP.A??:    Upload-menu. Should show all protocols available to
  736.                       the user.
  737.      - RAFMAREA.A??:  Displayed when a user presses the ?-key whenever
  738.                       he/she has to choose an area. This is only the case
  739.                       when NOT using templates!
  740.  
  741.      The Rafm-Archive contains examples of all these files.
  742.  
  743.      ╒═════════════════════════════════════════════════════════════════════╕
  744.      │░░░ Commandline parameters ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  745.      ╘═════════════════════════════════════════════════════════════════════╛
  746.  
  747.  
  748.      Normally, Rafm only uses one commandline-parameter. This parameter
  749.      indicates on which line Rafm is running. Since Rafm assumes it's
  750.      running on line 1, single-line systems don't have to use this.
  751.  
  752.      f.e. C:\RA\RAFM\RAFM.EXE *N 
  753.  
  754.      (RA will replace *N with the current node number and pass it to Rafm)
  755.  
  756.                   MULTI-LINE SYSTEMS MUST USE THIS PARAMETER !!
  757.  
  758.  
  759.  
  760.  
  761.      ───────────────────────────────────────────────────────────────────────
  762.                                                                    Page: 11
  763.  
  764.                      RemoteAccess File Manager version 1.21
  765.      ───────────────────────────────────────────────────────────────────────
  766.  
  767.  
  768.      For offline testing purposes only, you can use the -L parameter. Do
  769.      NOT use the -L parameter when executing Rafm from RA! (Note: during
  770.      local operation, RAFM will ignore most of the system-parameters and
  771.      show 0 instead of the actual value (f.e. number of calls etc.). Don't
  772.      worry, when executing RAFM from RA, the correct values will be shown!)
  773.  
  774.      ╒═════════════════════════════════════════════════════════════════════╕
  775.      │░░░ Tagging ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  776.      ╘═════════════════════════════════════════════════════════════════════╛
  777.  
  778.  
  779.      One of the most practical and user-friendly features of RAFM is file-
  780.      tagging. ANSI/Avatar users can select a file using the cursor-keys and
  781.      pressing [Enter] when the highlight is over the chosen file. Doing
  782.      this eliminates the need for entering filenames manually, users don't
  783.      even have to know the actual filename!
  784.  
  785.      ASCII users can still tag files, but will be prompted to enter the
  786.      filename before proceeding.
  787.  
  788.      Please note that Rafm will turn off the status-line whilst displaying
  789.      a file listing otherwise your local screen would become a mess when a
  790.      user selected the cursor-tagging option. You can force the status-line
  791.      on by pressing [F10] if you wish. RAFM supports the ANSI-escape codes
  792.      for Home, Cursor Up/Down and End. Unfortunately, ANSI doesn't have a
  793.      code for the PgUp/PgDn keys, so if a user wants to use these keys,
  794.      he/she will need to turn on Numlock or put the software into Doorway
  795.      mode.
  796.  
  797.      You as Sysop can manually add, delete or change files in the taglist
  798.      by pressing [Alt-T] when a user is on-line. 
  799.  
  800.      ╒═════════════════════════════════════════════════════════════════════╕
  801.      │░░░ Multi-line systems ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  802.      ╘═════════════════════════════════════════════════════════════════════╛
  803.  
  804.  
  805.      Rafm is completely multi-line aware. All files that should be shared,
  806.      are shared and record-locking is available. Note: Rafm will ONLY use
  807.      record-locking if it's indicated in RaConfig that you really are
  808.      running multi-line. For record-locking, Rafm uses share, so this
  809.      should be loaded first (you probably already have share installed,
  810.      because RA uses share too). Screen-writes are never direct, unless
  811.      indicated by RaConfig. Because Rafm will always search the current
  812.      directory for it's datafiles first, you can easily create different
  813.      configuration- and protocol-files for each line.
  814.  
  815.  
  816.  
  817.      ───────────────────────────────────────────────────────────────────────
  818.                                                                    Page: 12
  819.  
  820.                      RemoteAccess File Manager version 1.21
  821.      ───────────────────────────────────────────────────────────────────────
  822.  
  823.  
  824.      IMPORTANT: The maintance program RafmCln does NOT use any record-
  825.      locking. Make sure ALL lines are down when using this program,
  826.      otherwise you run the risk of ruining your database!!!
  827.  
  828.      {+} Another nice feature of Rafm: everytime a new menu is being read,
  829.      Rafm will check the filedates of the *.DAT files. If the filedate has
  830.      changed Rafm will re-read these files automatically. This allows you
  831.      to change your configuration using RafmEdit whilst users are on-line!
  832.      No need to close-down the system!
  833.  
  834.      {+} RAFM will also listen to the semaphore file RAXITn.xxx. When this
  835.      file is found, RAFM will immediately exit to RA.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.      ───────────────────────────────────────────────────────────────────────
  874.                                                                    Page: 13
  875.  
  876.                      RemoteAccess File Manager version 1.21
  877.      ───────────────────────────────────────────────────────────────────────
  878.  
  879.  
  880.      ╒═════════════════════════════════════════════════════════════════════╕
  881.      │░░░ Menus ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  882.      ╘═════════════════════════════════════════════════════════════════════╛
  883.  
  884.  
  885.      This is perhaps the most important part in configuring Rafm. The menus
  886.      you create will give your files area it's own "feel", and will make
  887.      your system look completely different from any others. The menu system
  888.      gives you immense flexibilty, not only visually, but in allowing or
  889.      disallowing access to certain functions or file areas to groups of
  890.      users.
  891.  
  892.      The menus can be edited using RaConfig -m. Each menu line has a line
  893.      of text that is displayed to the user, a menu "type", a minimum
  894.      security level and various flags that can be set to any required value
  895.      needed to access that line, and some optional data that is required by
  896.      some menu types.
  897.  
  898.      There are approximately 30 menu functions available to Rafm that may
  899.      be activated by a user pressing the key you have assigned to a
  900.      particular function.
  901.  
  902.      Rafm reads and understands the standard RA-menus. However, not all
  903.      types can be used and Rafm does NOT always use the same optional data
  904.      as RemoteAccess!. An overview showing all menu-types and a short
  905.      explanation follows.
  906.  
  907.  
  908.      IMPORTANT NOTE!
  909.  
  910.      There is ONE hard-coded menu-name, and that's RAFMTOP.MNU. This is the
  911.      first menu to be shown. If NOT present, Rafm will abort!
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.      ───────────────────────────────────────────────────────────────────────
  930.                                                                    Page: 14
  931.  
  932.                      RemoteAccess File Manager version 1.21
  933.      ───────────────────────────────────────────────────────────────────────
  934.  
  935.  
  936.      Type:            1
  937.      Name:            Goto another menu
  938.      Optional Data:   <Menu Name> /F=<File Area>|+|-
  939.  
  940.      Description:     This function causes a jump to another menu <Menu
  941.                       Name> If you enter "QUITRAFM" (without the "") on the
  942.                       optional dataline, Rafm will end the session and
  943.                       return to RA, without disconnecting.
  944.  
  945.      Examples:
  946.  
  947.                       FILES : Jump to the menu 'FILES'.
  948.  
  949.                       FILES /F=20: Jump to the menu 'FILES' and set the
  950.                       selected file area template to file area '20'.
  951.  
  952.                       FILES /F=+: Jump to the menu 'FILES' and set the
  953.                       selected file area template to the current file area
  954.                       plus 1.
  955.  
  956.  
  957.      Type:            2
  958.      Name:            Gosub another menu
  959.      Optional Data:   <Menu Name> /F=<File Area>|+|-
  960.  
  961.      Description:     As for menu type 1, but saves the path to the last
  962.                       menu on a "stack", making it possible to return to
  963.                       the calling menu with a type 3 menu.
  964.  
  965.  
  966.      Type:            3
  967.      Name:            Return from gosub
  968.      Optional Data:   None
  969.  
  970.      Description:     Returns from a Gosub (type 2) to the previous menu in
  971.                       the stack.
  972.  
  973.  
  974.      Type:            4
  975.      Name:            Goto menu after clearing menu stack 
  976.      Optional Data:   <Menu Name> /F=<File Area>|+|-
  977.  
  978.      Description:     As for menu type 1, but before jumping to the new
  979.                       <Menu Name>, the gosub menu stack is cleared. Beware!
  980.                       you cannot use a type 3 return after this!
  981.  
  982.  
  983.  
  984.  
  985.      ───────────────────────────────────────────────────────────────────────
  986.                                                                    Page: 15
  987.  
  988.                      RemoteAccess File Manager version 1.21
  989.      ───────────────────────────────────────────────────────────────────────
  990.  
  991.  
  992.      Type:            5
  993.      Name:            Display a *.A?? text file
  994.      Optional Data:   <1-8 character name>
  995.  
  996.      Description:     This menu will display the named file from your
  997.                       textfile directory. Depending on the current users
  998.                       settings, either <filename>.ASC, <filename>.ANS or
  999.                       <filename>.AVT will be displayed. Should a user have
  1000.                       AVATAR enabled, but <filename>.AVT is missing then
  1001.                       <filename>.ANS would be displayed. Similarly if .ANS
  1002.                       was missing then <filename>.ASC would be displayed.
  1003.                       As with RA's type 5 menu function, it is possible to
  1004.                       display comprehensive system or user details by
  1005.                       inserting special control codes in the files. Please
  1006.                       refer to Ra's Text File Control Codes in the RA docs
  1007.                       for more information.
  1008.  
  1009.      Examples:
  1010.  
  1011.                       STATS: If STATS was inserted in the optional data
  1012.                       line, it would display the file 'STATS.AVT' if the
  1013.                       user had AVATAR enabled, 'STATS.ANS' if the user had
  1014.                       ANSI enabled or the file 'STATS.AVT' was missing and
  1015.                       'STATS.ASC' if the user only had ASCII enabled or
  1016.                       both the AVT and ANS files were missing.
  1017.  
  1018.  
  1019.      Type:            7
  1020.      Name:            Run an external program in a shell
  1021.      Optional Data:   <Command Line> [Control Codes]
  1022.  
  1023.      Description:     This command will run an external program in a shell
  1024.                       whilst the user is online. The full name of the
  1025.                       program and its path must be specified if it is an
  1026.                       .EXE or a .COM file. If you wish to call a batch
  1027.                       file, this must be done via COMMAND.COM (see RA docs
  1028.                       for more info)
  1029.  
  1030.                       Many external programs require certain parameters to
  1031.                       be passed to them on the command line, so the
  1032.                       following control codes may be used. In each case the
  1033.                       code is replaced by its value:
  1034.  
  1035.                       *A :  Insert the users handle (if used) in
  1036.                             DORINFO.DEF instead of the users real name.
  1037.  
  1038.                       *B :  Set baud rate to the users speed, or 0 if local
  1039.  
  1040.  
  1041.      ───────────────────────────────────────────────────────────────────────
  1042.                                                                    Page: 16
  1043.  
  1044.                      RemoteAccess File Manager version 1.21
  1045.      ───────────────────────────────────────────────────────────────────────
  1046.  
  1047.  
  1048.  
  1049.                       *C :  Full path and name to COMMAND.COM
  1050.  
  1051.                       *D :  Automatically generate the DOOR.SYS file needed
  1052.                             by some external utilities.
  1053.  
  1054.                       *F :  Users first name.
  1055.  
  1056.                       *G :  Determine wether the user has ANSI graphics
  1057.                             enabled. 0=Off/1=On.
  1058.  
  1059.                       *L : Users last name.
  1060.  
  1061.                       *M :  Activate the memory-swap feature. Rafm will
  1062.                             attempt to swap itself and all the memory it
  1063.                             occupies to EMS (if installed) and disk,
  1064.                             leaving only a small portion resident. Useful
  1065.                             for memory hungry programs, but it can take a
  1066.                             few seconds to do the swap.
  1067.  
  1068.                       *N :  Line number, as passed from RA
  1069.  
  1070.                       *P :  Communications port being used.
  1071.  
  1072.                       *R :  Users record number in RA's user file.
  1073.  
  1074.                       *T :  Time remaining for current call.
  1075.  
  1076.                       *! :  Freeze the system timer whilst in the shell.
  1077.                             Useful for external chat programs etc.
  1078.  
  1079.                       *# :  Turn off the "Wants chat" indicator on return
  1080.                             from the shell.
  1081.  
  1082.  
  1083.                       Please note!!
  1084.  
  1085.                       RemoteAccess also supports the following control
  1086.                       codes which are NOT supported by Rafm. They are: *H,
  1087.                       *O and *1
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.      ───────────────────────────────────────────────────────────────────────
  1098.                                                                    Page: 17
  1099.  
  1100.                      RemoteAccess File Manager version 1.21
  1101.      ───────────────────────────────────────────────────────────────────────
  1102.  
  1103.  
  1104.      Type:            8
  1105.      Name:            Product information
  1106.      Optional Data:   None
  1107.  
  1108.      Description:     Displays Rafm's product information to the remote
  1109.                       user.
  1110.  
  1111.  
  1112.      Type:            9
  1113.      Name:            Terminate the session
  1114.      Optional Data:   None
  1115.  
  1116.      Description:     This option will disconnect and doesn't let the user
  1117.                       return to RA! If you want to do that, use a type 1!
  1118.                       Please note: when running RA locally, this option
  1119.                       will NOT log you off the system, it will ONLY drop
  1120.                       you back into RA. Rest assured it WILL work correctly
  1121.                       when a user is online!.
  1122.  
  1123.  
  1124.      Type:            11
  1125.      Name:            Page sysop for a chat
  1126.      Optional Data:   <Paging string>
  1127.  
  1128.      Description:     This function will display the <paging string> to the
  1129.                       user and page the sysop for a chat. You may break in
  1130.                       for a chat at any time by pressing ALT-C, which will
  1131.                       initiate a chat using Rafm's internal chat routine or
  1132.                       an external chat program if configured in RaConfig.
  1133.  
  1134.      Type:            14
  1135.      Name:            Time / Display statistics
  1136.      Optional Data:   <None>
  1137.  
  1138.      Description:     Will show some information about the user's limits,
  1139.                       and how much has already been used.
  1140.  
  1141.  
  1142.      Type:            30
  1143.      Name:            Directory
  1144.      Optional Data:   <Full path> or /F
  1145.  
  1146.      Description:     Displays a DOS style directory of the directory
  1147.                       specified in the optional data field.
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.      ───────────────────────────────────────────────────────────────────────
  1154.                                                                    Page: 18
  1155.  
  1156.                      RemoteAccess File Manager version 1.21
  1157.      ───────────────────────────────────────────────────────────────────────
  1158.  
  1159.  
  1160.                       The use of the "/F" parameter will enable you to use
  1161.                       the current file template area instead of the <Full
  1162.                       path>
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.      ───────────────────────────────────────────────────────────────────────
  1210.                                                                    Page: 19
  1211.  
  1212.                      RemoteAccess File Manager version 1.21
  1213.      ───────────────────────────────────────────────────────────────────────
  1214.  
  1215.  
  1216.      Type:            31
  1217.      Name:            List Files
  1218.      Optional Data:   /F
  1219.  
  1220.      Description:     Displays a list of files available for download. If
  1221.                       the "/F" parameter is present in the optional data
  1222.                       field Rafm will assume that you're using templates
  1223.                       and will display the listing instantly. If not, Rafm
  1224.                       will first ask the user which area should be
  1225.                       displayed. Besides entering the area-number, there
  1226.                       are 2 special keys:
  1227.  
  1228.                       - ?: Displays an overview of all areas that the user
  1229.                       can access. If present, RafmArea.A?? will be
  1230.                       displayed.
  1231.  
  1232.                       - +: Will list all files in ALL areas.
  1233.  
  1234.  
  1235.      Type:            32
  1236.      Name:            Download a File
  1237.      Optional Data:   None
  1238.  
  1239.      Description:     First, RafmDown.A?? is displayed and the user has to
  1240.                       select a protocol. Besides the hot-keys defined in
  1241.                       RafmEdit, there is also an extra option: "-", which
  1242.                       will abort the download.
  1243.                       After choosing the protocol, the user can enter
  1244.                       filenames and/or download any files that he/she has
  1245.                       tagged.
  1246.                       Wildcards (* and ?) are allowed. Rafm will refuse *.*
  1247.                       however.
  1248.                       Please note that RAFM will always allow a user to
  1249.                       download files from any area (but only if they have
  1250.                       access to it AND you have enabled this option!).
  1251.                       There's no difference between a type 32 and a type
  1252.                       59!!
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.      ───────────────────────────────────────────────────────────────────────
  1266.                                                                    Page: 20
  1267.  
  1268.                      RemoteAccess File Manager version 1.21
  1269.      ───────────────────────────────────────────────────────────────────────
  1270.  
  1271.  
  1272.      Type:            33
  1273.      Name:            Upload a File
  1274.      Optional Data:   </F=Area Number>
  1275.  
  1276.      Description:     Similar to type 32. Uses RafmUp.A?? instead of
  1277.                       RafmDown.A??.
  1278.                       If you've activated "Restrict uploads" Rafm will
  1279.                       place the file in the area you've defined in
  1280.                       RafmEdit.
  1281.                       When you enter a valid "/F=Area Number" on the
  1282.                       optional data line, Rafm will place the file in that
  1283.                       area.
  1284.                       If you've done neither of these, Rafm will just place
  1285.                       the file in the currently active area.
  1286.  
  1287.  
  1288.      Type:            34
  1289.      Name:            View Archive
  1290.      Optional Data:   None
  1291.  
  1292.      Description:     Activates the full-screen archive viewer. Rafm can
  1293.                       handle all popular types of archivers. Be sure to
  1294.                       place the necessary archive-programs in your Path, or
  1295.                       else Rafm won't be able to find them. There is a
  1296.                       possibility to show a help-file, called ARCHHELP.A??.
  1297.  
  1298.  
  1299.      Type:            35
  1300.      Name:            File scan by keyword.
  1301.      Optional Data:   None
  1302.  
  1303.      Description:     This function searches all file areas that a user has
  1304.                       access to for a keyword that is supplied by the user.
  1305.                       Any entries that match are displayed with the name of
  1306.                       the area the match was found in. The user also has
  1307.                       the option to tag any files that are displayed.
  1308.  
  1309.  
  1310.      Type:            36
  1311.      Name:            File scan by Filename.
  1312.      Optional Data:   None
  1313.  
  1314.      Description:     Same as type 35 menu, except that the user enters a
  1315.                       filename to be scanned for.
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.      ───────────────────────────────────────────────────────────────────────
  1322.                                                                    Page: 21
  1323.  
  1324.                      RemoteAccess File Manager version 1.21
  1325.      ───────────────────────────────────────────────────────────────────────
  1326.  
  1327.  
  1328.      Type:            37
  1329.      Name:            Show new files
  1330.      Optional Data:   None
  1331.  
  1332.      Description:     Same as RA, with an extra option to ask the number of
  1333.                       days to scan back instead of a single date.
  1334.  
  1335.  
  1336.      Type:            39
  1337.      Name:            Display a fully named text file
  1338.      Optional Data:   <Full path and name>
  1339.  
  1340.      Description:     Similar to the type 5 menu, but allows you to specify
  1341.                       the full path and filename including extension of the
  1342.                       file to be displayed. You can also use the control
  1343.                       characters as explained in the type 5 menu function.
  1344.  
  1345.       
  1346.      Type:            40
  1347.      Name:            Display an *.A?? text file with hot-keys 
  1348.      Optional Data:   <1-8 character name>
  1349.  
  1350.      Description:     Same as RA. Similar to a type 5 menu function except
  1351.                       that the current menu hot keys remain active whilst
  1352.                       the file is displayed.
  1353.  
  1354.  
  1355.      Type:            45
  1356.      Name:            Display a text file and wait
  1357.      Optional Data:   <1-8 character name>
  1358.  
  1359.      Description:     The same as a type 5 menu function, but prompts the
  1360.                       user to press [Enter] before continuing.
  1361.  
  1362.  
  1363.      Type:            46
  1364.      Name:            Display a direct text file with CR
  1365.      Optional Data:   <Full path and name>
  1366.  
  1367.      Description:     Displays the specified text file (the path must be
  1368.                       included in the optional data field) and waits for
  1369.                       the user to press [Enter] before continuing.
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.      ───────────────────────────────────────────────────────────────────────
  1378.                                                                    Page: 22
  1379.  
  1380.                      RemoteAccess File Manager version 1.21
  1381.      ───────────────────────────────────────────────────────────────────────
  1382.  
  1383.  
  1384.      Type:            47 {+}
  1385.      Name:            Make an entry in the systemlog
  1386.      Optional Data:   <Log entry>
  1387.  
  1388.      Description:     Writes the contents of the optional data field to the
  1389.                       system log. 
  1390.  
  1391.                       There is one special character you may enter: an @,
  1392.                       which is replaced by the currently active file area.
  1393.  
  1394.  
  1395.      Type:            48
  1396.      Name:            Download a specific file
  1397.      Optional Data:   <Full path and name> /F
  1398.  
  1399.      Description:     Allows the user to download a file or files that you
  1400.                       have pre-defined. The user can select which protocol
  1401.                       to use.
  1402.                       Adding the /F parameter instructs RAFM NOT to use
  1403.                       it's database but directly scan the drive for the
  1404.                       specfied file(s). Beware that doing this may increase
  1405.                       speed but you'll lose all special options like free
  1406.                       file etc.
  1407.  
  1408.      Examples:
  1409.  
  1410.                       C:\FILES\RA\BBS\RAFM*.ARJ
  1411.  
  1412.                       Would send all files in the C:\FILES\RA\BBS directory
  1413.                       that matched RAFM*.ARJ.
  1414.  
  1415.  
  1416.      Type:            50
  1417.      Name:            Select file area
  1418.      Optional Data:   None
  1419.  
  1420.      Description:     Shows a listing of all areas the user has access to
  1421.                       and lets the user choose another area. If present,
  1422.                       the file RafmArea.A?? will be displayed, otherwise
  1423.                       Rafm will use its own internal listing.
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.      ───────────────────────────────────────────────────────────────────────
  1434.                                                                    Page: 23
  1435.  
  1436.                      RemoteAccess File Manager version 1.21
  1437.      ───────────────────────────────────────────────────────────────────────
  1438.  
  1439.  
  1440.      Type:            55
  1441.      Name:            Download any file
  1442.      Optional Data:   None
  1443.  
  1444.      Description:     An extremely powerful function that should ONLY be
  1445.                       accessible by the sysop. It allows anyone that has
  1446.                       access to it to download ANY file from ANY valid
  1447.                       directory using any of the available protocols! This
  1448.                       function takes no account of any download limits that
  1449.                       may be in force.
  1450.  
  1451.      Type:            59
  1452.      Name:            Global download
  1453.      Optional Data:   None
  1454.  
  1455.      Description:     Same as type 32.
  1456.  
  1457.  
  1458.      Type:            65 {+}
  1459.      Name:            Change User's flags
  1460.      Optional Data:   <Flagset><FlagNum><Action>
  1461.  
  1462.      Description:     Allows you to set or toggle any of the users security
  1463.                       flags. The <Action> determines how the flag is to be
  1464.                       set:
  1465.  
  1466.                       - : Turn flag OFF
  1467.                       + : Turn flag ON
  1468.                       * : Toggle flag
  1469.  
  1470.                       For example, if the optional data field contained
  1471.                       "A2+ B2- C2*" then flag A2 would be turned on, B2
  1472.                       would be turned off and flag C2 would be toggled.
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.      ───────────────────────────────────────────────────────────────────────
  1490.                                                                    Page: 24
  1491.  
  1492.                      RemoteAccess File Manager version 1.21
  1493.      ───────────────────────────────────────────────────────────────────────
  1494.  
  1495.  
  1496.      ╒═════════════════════════════════════════════════════════════════════╕
  1497.      │░░░ RafmEdit ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1498.      ╘═════════════════════════════════════════════════════════════════════╛
  1499.  
  1500.  
  1501.      RafmEdit is the full-screen editor of Rafm. With RafmEdit you can edit
  1502.      areas, files, protocols and configuration. Like all Rafm-programs,
  1503.      RafmEdit will first search the current directory for *.DAT files. Only
  1504.      if one or more *.DAT files can't be found in the current directory,
  1505.      will RafmEdit look in the directory pointed to by the RAFM environment
  1506.      variable.
  1507.  
  1508.      Use the cursor-keys and [Enter] to walk through the menu-choices.
  1509.      [Esc] will abort input when pressed the first time. Pressing [Esc]
  1510.      again will close an edit-window. [F10] will immediately save changes
  1511.      and close an edit-window. When exiting RafmEdit will ask if you want
  1512.      to save the changes, answering this question with 'N'(o) will discard
  1513.      any changes you've made in that session. Please note that changes to
  1514.      files will always become permanent instantly.
  1515.  
  1516.      ╒═════════════════════════════════════════════════════════════════════╕
  1517.      │░░░ Areas ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1518.      ╘═════════════════════════════════════════════════════════════════════╛
  1519.  
  1520.  
  1521.      Areas:     Choose an area or an empty slot (indicated with <Not Used>)
  1522.                 with the cursor-keys. Alternatively you can also directly
  1523.                 type an area-number to select. When you've reached the
  1524.                 desired area, press [Enter] and a new window will open. You
  1525.                 can now edit the chosen area. Since most fields are the
  1526.                 same as RA, I will only explain the additional fields:
  1527.  
  1528.                 - Password:
  1529.                       Areas can be protected with a password. Files in
  1530.                       these areas can still be seen by users, but if they
  1531.                       want to download from these areas, they have to enter
  1532.                       the correct password.
  1533.                 - Header: 
  1534.                       When a user decides to List a particular file area,
  1535.                       the filename entered here will be displayed first.
  1536.                       Only the filename (without extension) should be
  1537.                       entered as Rafm will automatically display either AVT
  1538.                       ANS or ASC depending on the users settings. The file
  1539.                       to be displayed should be in your textfile directory,
  1540.                       and could concievably contain extra info about the
  1541.                       particular file area, or a banner to brighten up your
  1542.                       file listings and make them unique. 
  1543.  
  1544.  
  1545.      ───────────────────────────────────────────────────────────────────────
  1546.                                                                    Page: 25
  1547.  
  1548.                      RemoteAccess File Manager version 1.21
  1549.      ───────────────────────────────────────────────────────────────────────
  1550.  
  1551.  
  1552.                 - Free Area:
  1553.                       Indicates if a user can download from this area
  1554.                       without affecting his/her limits. Please note that
  1555.                       ALL files in the area will be free files (there is
  1556.                       also an similar option in the files-section that will
  1557.                       allow INDIVIDUAL files to be marked as free). 
  1558.                 - Protected:
  1559.                       Areas can be protected against the maintenance
  1560.                       function of RafmCln. If an area is protected, files
  1561.                       in this area will never be moved or killed because of
  1562.                       inactivity.
  1563.                 - Proc. Arch.:
  1564.                       If set to NO, files in this area will never be re-
  1565.                       archived by RafmChk. This can be useful for areas
  1566.                       where you place your Fidonet-related files for
  1567.                       example.
  1568.                 - No Update: 
  1569.                       Indicates whether or not RafmCln has to update the
  1570.                       sizes and dates of the files located in this area.
  1571.                       Especially useful when using a CD-ROM or for an
  1572.                       offline file area.
  1573.                 - Kill Deleted:
  1574.                       If set to Yes, deleted files (in this case, a deleted
  1575.                       file means a file which has been physically erased
  1576.                       from disk) will be removed from the database when
  1577.                       running RafmCln -D. If set to No, deleted files will
  1578.                       never be removed from the database (which allows you
  1579.                       to create an offline file-area with files you don't
  1580.                       always want to have on your HD).
  1581.                 - Skip Dupe: 
  1582.                       If set to Yes, the duplicate-detect routines will not
  1583.                       scan this area.
  1584.                 - CDRom:
  1585.                       If set to Yes, this option indicates the files in
  1586.                       this area are located on CD-ROM. Rafm will treat this
  1587.                       area differently from 'normal' areas:
  1588.                       -     Files will be copied to your harddisk just
  1589.                             before downloading to increase transfer-speed.
  1590.                       -     Rafm will NOT scan this area for new files, NOT
  1591.                             try to re-archive the files in this area and
  1592.                             also will NOT perform any kind of updating
  1593.                             during nightly maintenance.
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.      ───────────────────────────────────────────────────────────────────────
  1602.                                                                    Page: 26
  1603.  
  1604.                      RemoteAccess File Manager version 1.21
  1605.      ───────────────────────────────────────────────────────────────────────
  1606.  
  1607.  
  1608.      ╒═════════════════════════════════════════════════════════════════════╕
  1609.      │░░░ Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1610.      ╘═════════════════════════════════════════════════════════════════════╛
  1611.  
  1612.  
  1613.      Files:     Activating this option will open 2 different windows. On
  1614.                 the left side all files are displayed, on the right side an
  1615.                 overview of all possible command-keys is shown.
  1616.                 All commands are activated via an Alt-Key combination.
  1617.                 Typing without the Alt-key pressed will activate the
  1618.                 Search-function (look at the 'Search- String'). You can
  1619.                 clear the search-string by using backspace or [Ctrl-Home].
  1620.                 The spacebar will tag a file (or if a file has already been
  1621.                 tagged, remove the tag). Except for the Edit and Add
  1622.                 function, every function will work with all tagged files at
  1623.                 once. So, if you've tagged 10 files and press [Alt-M], all
  1624.                 10 files will be moved!
  1625.  
  1626.                 - Search on keyword [Alt-K]:
  1627.                       Allows you to search through the database on
  1628.                       keywords. Works exactly the same as the menu type 35.
  1629.                 - Search on wildcard [Alt-F]:
  1630.                       Allows you to search through the database on
  1631.                       wildcards. Works exactly the same as the menu type
  1632.                       36.
  1633.                 - Select files in 1 area [Alt-A]:
  1634.                       Allows you to tag all files in a specific area and
  1635.                       perform an action on all the tagged files at once,
  1636.                       Alt-D to delete, or Alt-M to move etc.
  1637.                 - Delete tagged file(s) [Alt-D] or [Del]:
  1638.                       Will erase the tagged file(s) from disk and mark the
  1639.                       record(s) in the database as deleted. Deleted records
  1640.                       can only be removed from the database by using
  1641.                       RafmCln -K (and only when you've enabled kill deleted
  1642.                       files in that area)
  1643.                 - Move tagged file(s) [Alt-M]:
  1644.                       Will move tagged file(s) to a different area. You
  1645.                       will be prompted to enter the area number to move the
  1646.                       tagged files to, either enter it directly at the
  1647.                       prompt or press [F2] for a list of available file
  1648.                       areas. Only the area-number in the database is
  1649.                       changed, but you can optionally let RafmEdit copy the
  1650.                       file physically to another directory and reset the
  1651.                       file date.
  1652.                 - Edit [Alt-E] or [Enter]:
  1653.                       Opens another window in which you can edit the
  1654.                       selected file. Note that Rafm will store the full
  1655.  
  1656.  
  1657.      ───────────────────────────────────────────────────────────────────────
  1658.                                                                    Page: 27
  1659.  
  1660.                      RemoteAccess File Manager version 1.21
  1661.      ───────────────────────────────────────────────────────────────────────
  1662.  
  1663.  
  1664.                       directory with each file, so it is possible for a
  1665.                       file to have a different directory than the area in
  1666.                       which it is located. This will save you much copying
  1667.                       and moving, but can cause problems when using
  1668.                       Bimodem, because when a user has entered Bimodem and
  1669.                       has access to the directory, there is no way Rafm can
  1670.                       prevent a user from downloading a file.
  1671.  
  1672.                       The edit-window shows several fields which you can
  1673.                       change:
  1674.  
  1675.                       - FileName:
  1676.                             The complete name of the file, including
  1677.                             extension.
  1678.                       - Directory: 
  1679.                             The full path to the file. You can prevent
  1680.                             possible problems if you always include the
  1681.                             drive-letter. Pressing [F2] will give you an
  1682.                             overview of all available directories.
  1683.                       - Area #:
  1684.                             Determines in which area the file is located.
  1685.                             As said before, the directory of the file
  1686.                             doesn't have to be the same as the directory of
  1687.                             the corresponding area. Again, pressing [F2]
  1688.                             will give you an overview of all areas.
  1689.                       - Downloads: 
  1690.                             The number of times the file has been
  1691.                             downloaded.
  1692.                       - Size: 
  1693.                             The size of this file in bytes. This is
  1694.                             automatically detected by RAFM, you can't edit
  1695.                             it manually. If the filesize has been altered
  1696.                             then running RafmCln -U will update the
  1697.                             filesize where necessary.
  1698.                       - FileDate: 
  1699.                             The date the file was uploaded. This can be
  1700.                             automatically updated if it is changed by
  1701.                             running RafmCln -U. If you change the date
  1702.                             RafmEdit will also update the file itself.
  1703.                       - Uploader: 
  1704.                             The name of the person who uploaded the file.
  1705.                             This is automatically determined by Rafm when
  1706.                             the file is uploaded. Or if it is a local
  1707.                             upload (a file you've added locally) then the
  1708.                             upload name will default to that of the sysop.
  1709.  
  1710.  
  1711.  
  1712.  
  1713.      ───────────────────────────────────────────────────────────────────────
  1714.                                                                    Page: 28
  1715.  
  1716.                      RemoteAccess File Manager version 1.21
  1717.      ───────────────────────────────────────────────────────────────────────
  1718.  
  1719.  
  1720.                       - Password: 
  1721.                             When a file is protected by a password, a user
  1722.                             has to enter this password first before he/she
  1723.                             can download the file. Password protected files
  1724.                             can always be seen in a listing.
  1725.                       - Last access:
  1726.                             The most recent date the file was downloaded.
  1727.                             This date is used by the maintenance function
  1728.                             to determine whether a file is active or
  1729.                             inactive. 
  1730.                       - Description:
  1731.                             The description of the file. You can enter upto
  1732.                             210 characters. The description is entered on
  1733.                             one line, but will automatically word wrap when
  1734.                             displayed to the user online.
  1735.                             Note: a "|" will be translated into a CR/LF
  1736.                             combination in a file-listing. If the entry is
  1737.                             a comment (see further) this field holds the
  1738.                             text to be displayed.
  1739.                       - Free: 
  1740.                             Can this file be downloaded for free? (i.e. It
  1741.                             will not affect any of the user's limits)
  1742.                       - Private:
  1743.                             When a file is private, the file can only be
  1744.                             seen or downloaded by users that have a
  1745.                             security level which is equal to or higher than
  1746.                             set in the corresponding area. Private files
  1747.                             will also never appear in an All/Newfiles-
  1748.                             listing.
  1749.                       - Checked:
  1750.                             if set to Yes, it means that the file has
  1751.                             already been scanned and/or rearchived (on-line
  1752.                             or offline doesn't matter).
  1753.                       - Deleted:
  1754.                             Determines if the file has been deleted from
  1755.                             the database. This doesn't mean the file
  1756.                             doesn't exist anymore, only that Rafm will
  1757.                             ignore the file and it will not be displayed in
  1758.                             the all/newfile listings. 
  1759.                       - Protected: 
  1760.                             If set, the file will never be moved or killed
  1761.                             by the maintenance function. Use this if you
  1762.                             don't want to protect the whole area, but only
  1763.                             a few files in that particular area.
  1764.                       - Comment:
  1765.                             Indicates whether or not this entry should be
  1766.                             treated as a comment. Normally, the text
  1767.  
  1768.  
  1769.      ───────────────────────────────────────────────────────────────────────
  1770.                                                                    Page: 29
  1771.  
  1772.                      RemoteAccess File Manager version 1.21
  1773.      ───────────────────────────────────────────────────────────────────────
  1774.  
  1775.  
  1776.                             entered in the description-field is used as a
  1777.                             comment. You can also use a .A?? file as a
  1778.                             comment by entering a @ followed by a 8
  1779.                             character filename. Since it is not (yet)
  1780.                             possible to insert an entry in the database,
  1781.                             you will have to choose the filename carefully.
  1782.  
  1783.                 - Add a file [Alt-A] or [Ins]:
  1784.                       Will create a new (blank) record in the database and
  1785.                       then activate the Edit-function to let you add a new
  1786.                       file to the database.
  1787.                 - Clear all tags [Alt-C]:
  1788.                       Will clear all previously tagged entries.
  1789.                 - Global Edit [Alt-G]:
  1790.                       With this option you can change several files at
  1791.                       once:
  1792.  
  1793.                       - Directory: 
  1794.                             Change the directory of all tagged files. Files
  1795.                             are NOT copied to this directory, only the
  1796.                             entry in the database will be changed.
  1797.                       - Last access date:
  1798.                             Change the date on which the files were last
  1799.                             downloaded on all tagged files. 
  1800.                       - Uploader: 
  1801.                             Change the name of the person who uploaded the
  1802.                             file. Useful if a user sends a batch of files
  1803.                             on disk for example. 
  1804.                       - Description:
  1805.                             Change the description of all tagged files.
  1806.                       - Statusbits:
  1807.                             Change the statusbitsof all tagged files. There
  1808.                             are 5 different statusbits:
  1809.                             - Free: 
  1810.                                   Determines if the file can be downloaded
  1811.                                   for free.
  1812.                             - Private: 
  1813.                                   Determines if the file is private (sysop-
  1814.                                   only)
  1815.                             - Checked: 
  1816.                                   Whether or not the file has already been
  1817.                                   scanned and/or rearchived
  1818.                             - Deleted: 
  1819.                                   Has the file been deleted from the
  1820.                                   database?
  1821.  
  1822.  
  1823.  
  1824.  
  1825.      ───────────────────────────────────────────────────────────────────────
  1826.                                                                    Page: 30
  1827.  
  1828.                      RemoteAccess File Manager version 1.21
  1829.      ───────────────────────────────────────────────────────────────────────
  1830.  
  1831.  
  1832.                             - Protected:
  1833.                                   If set, the file will not be touched by
  1834.                                   the maintenance function of RafmCln.
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.      ───────────────────────────────────────────────────────────────────────
  1882.                                                                    Page: 31
  1883.  
  1884.                      RemoteAccess File Manager version 1.21
  1885.      ───────────────────────────────────────────────────────────────────────
  1886.  
  1887.  
  1888.      ╒═════════════════════════════════════════════════════════════════════╕
  1889.      │░░░ Protocols ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1890.      ╘═════════════════════════════════════════════════════════════════════╛
  1891.  
  1892.  
  1893.      Protocols (External):
  1894.  
  1895.      Rafm can handle 5 types of external protocol:
  1896.      - Logfile:
  1897.           Protocols that create a logfile (f.e. DSZ)
  1898.      - Errorlevel:
  1899.           Some protocols don't create a logfile, but exit with an
  1900.           errorlevel. Rafm assumes that an errorlevel of 0 means Ok. Any
  1901.           other errorlevel should indicate the transfer has failed.
  1902.      - Bimodem:
  1903.           Rafm has a complete built in Bimodem interface, taking advantage
  1904.           of the many features of Bimodem. There is no need for any
  1905.           external interface.
  1906.           Note: although Rafm will take care of the security (download-
  1907.           limit, time-limit, directories etc.) you still have to configure
  1908.           Bimodem to suit your own needs!
  1909.      - Bi-directional:
  1910.           Besides Bimodem, there is at least one protocol than can send and
  1911.           receive files simultaneously. You can't use the oridinary Logfile
  1912.           type, because RAFM won't scan the logfile for both up and
  1913.           downloads. Bi- directional types are expected to create a
  1914.           logfile, if not, you can't use them in RAFM. The main difference
  1915.           between logfile- and Bi-directional-types is the download
  1916.           keyword. Normally RAFM will treat this keyword as case-
  1917.           insensitive, but this is NOT the case with Bi-directional types!
  1918.      - Other:
  1919.           If you can't get the protocol to work with any of the first 4
  1920.           types, you probably shouldn't use it, but if you still want to,
  1921.           you could try this one. This type will cause Rafm to measure the
  1922.           time the transfer took, and compare it to the calculated time
  1923.           (size/speed/efficiency*100). If the actual time and the
  1924.           calculated time match, then Rafm will assume the transfer was
  1925.           succesfull. The success of this type depends very much on the
  1926.           accuracy of the efficiency rating.
  1927.           If you don't know exactly, set it high (about 95%). That should
  1928.           do it.
  1929.  
  1930.      The archive contains a sample RafmProt.Dat (RafmProt.DDD) with a
  1931.      number of often used protocols. The only thing you have to do is
  1932.      change the directories. If you want to install other protocols, please
  1933.      read the section below first!
  1934.  
  1935.  
  1936.  
  1937.      ───────────────────────────────────────────────────────────────────────
  1938.                                                                    Page: 32
  1939.  
  1940.                      RemoteAccess File Manager version 1.21
  1941.      ───────────────────────────────────────────────────────────────────────
  1942.  
  1943.  
  1944.      - Description:                                            (All types) 
  1945.           The name and description of the protocol. The first word will be
  1946.           placed in the logfile. An underscore ("_") will be translated to
  1947.           a blank space when displayed, but you can use this to force Rafm
  1948.           to take more than 1 word into the logfile (f.e.: True_Ymodem will
  1949.           show "True Ymodem" in the logfile, if you don't use the
  1950.           underscore, only the word "True" will be written to the logfile).
  1951.      - Enabled/Disabled:                                        (All types)
  1952.           Determines whether or not users can use the protocol. 
  1953.      - Kind:                                                    (All types)
  1954.           Logfile, Errorlevel, Bimodem, Other or Bidirectional. 
  1955.      - Hot-Key:                                                 (All types)
  1956.           The character used in the menu's to select the protocol.
  1957.           Obviously ALL protocols must use a different Hot-key.
  1958.      - Download command:                                        (All types)
  1959.           The complete command and control codes (look at the end of this
  1960.           section for an overview of these control codes) to execute the
  1961.           protocol in download (send) mode.
  1962.      - Upload command:                                          (All types)
  1963.           Similar to the Download command, only for upload (receive) mode.
  1964.      - Efficiency:                                              (All types)
  1965.           The efficiency of the protocol (in %). This is important because
  1966.           Rafm will calculate the transfer-time according to this
  1967.           efficiency. It is even more important when using the type
  1968.           "Other". 
  1969.      - Max. files:                         (Logfile/Bimodem/Bi-directional)
  1970.           Rafm can transfer a maximum of 20 files in one session. For
  1971.           errorlevel and other types, the maximum number is always one,
  1972.           even if the protocol itself can transfer more than one file a
  1973.           time. When using opus-typeprotocols ( protocols that DON'T use
  1974.           control-files to specify the filenames) limit the maximum number
  1975.           of files to 4. This is because of the limited size of the
  1976.           commandline that DOS can handle.
  1977.      - Logfile:                            (Logfile/Bimodem/Bi-directional)
  1978.           The full path to the logfile created by the protocol. With
  1979.           Bimodem you should specify the complete path to your Bimodem.Cfg
  1980.           and NOT the logfile created by Bimodem!!!
  1981.      - Download Keyword:                           (Logfile/Bi-directional)
  1982.           When the external protocol has finished and control is returned
  1983.           to Rafm, the log file that was created will be scanned to extract
  1984.           information about what files were sent or recieved. Rafm scans
  1985.           the logfile for the UPLOAD or DOWNLOAD LOG KEYWORD. When it finds
  1986.           that word, it will scan forward x number of words to get the name
  1987.           of the file transferred.
  1988.           See the RA docs for more information. 
  1989.      - Upload KeyWord:                             (Logfile/Bi-directional)
  1990.           See Download keyword for explanation. 
  1991.  
  1992.  
  1993.      ───────────────────────────────────────────────────────────────────────
  1994.                                                                    Page: 33
  1995.  
  1996.                      RemoteAccess File Manager version 1.21
  1997.      ───────────────────────────────────────────────────────────────────────
  1998.  
  1999.  
  2000.      - Download count:                             (Logfile/Bi-directional)
  2001.           Same as RA.
  2002.      - Description count:                          (Logfile/Bi-directional)
  2003.           Same as RA.
  2004.  
  2005.      Up/Download control codes:
  2006.  
  2007.           *P:   Comport used
  2008.           *B:   Current baudrate
  2009.           *M:   Activate memory-swap option
  2010.           *AF:  Create a control-file with filenames which have to be
  2011.                 transferred.
  2012.           *CF: Is replaced by filename(s) on the command-line.
  2013.  
  2014.      All control codes are case-insensitive, but you CANNOT mix both kinds!
  2015.      So, "cf" and "CF" is allowed, but "Cf" isn't!
  2016.  
  2017.  
  2018.      ╒═════════════════════════════════════════════════════════════════════╕
  2019.      │░░░ Protocols (Internal) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2020.      ╘═════════════════════════════════════════════════════════════════════╛
  2021.  
  2022.      The internal protocols are exactly the same as in RA. The hotkeys
  2023.      which activate the protocols are the same and you can turn the use of
  2024.      these internal protocols on/off via RaConfig. Please note that the
  2025.      hotkeys you've entered in RafmEdit overrule the ones for the internal
  2026.      protocols. This way, you can still use RA's protocols for f.e. message
  2027.      uploading and install a different one in Rafm.
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.      ───────────────────────────────────────────────────────────────────────
  2050.                                                                    Page: 34
  2051.  
  2052.                      RemoteAccess File Manager version 1.21
  2053.      ───────────────────────────────────────────────────────────────────────
  2054.  
  2055.  
  2056.      ╒═════════════════════════════════════════════════════════════════════╕
  2057.      │░░░ Configuration ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2058.      ╘═════════════════════════════════════════════════════════════════════╛
  2059.  
  2060.  
  2061.      The configuration is divided into 6 different sections. Each section
  2062.      is discussed seperately.
  2063.  
  2064.      ╒═════════════════════════════════════════════════════════════════════╕
  2065.      │░░░ General ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2066.      ╘═════════════════════════════════════════════════════════════════════╛
  2067.  
  2068.  
  2069.           - Default extension:
  2070.                 Used when a user doesn't enter an extension. Normally this
  2071.                 would be the same as the "convert archive to" 
  2072.           - Logfile:
  2073.                 The name of the logfile Rafm should use. Since the logfile
  2074.                 isn't shared, multi-line systems may NOT enter a directory,
  2075.                 only a filename!
  2076.           - Allow automatic log-off:
  2077.                 When enabled, users can choose to log-off automatically
  2078.                 immediately after a file-transfer (up- or download). 
  2079.           - DateFormat:
  2080.                 There are 4 different formats to show dates.
  2081.  
  2082.                 DD/MM/YY (Day, Month, Year)
  2083.                 MM/DD/YY (Month, Day, Year)
  2084.                 YY/DD/MM (Year, Day, Month)
  2085.                 YY/MM/DD (Year, Month, Day)
  2086.  
  2087.                 You can choose between them using the [Enter] and
  2088.                 [BackSpace] keys.
  2089.            - Swapping:
  2090.                 This only refers to swapping when executing archivers. If
  2091.                 enabled, Rafm/RafmChk will swap to EMS or Disk to leave
  2092.                 enough memory free for the archiver to operate. 
  2093.           - Use EMS:
  2094.                 Rafm (and the other programs) will always use EMS (if
  2095.                 available) to store the .OVR files and for the memory-swap.
  2096.                 If you don't want Rafm to use EMS (f.e. because you need it
  2097.                 for other programs) you can disable this option. This will
  2098.                 however slow down Rafm.
  2099.           - Auto-Adopt text:
  2100.                 The default file-description to be used when auto-adopting
  2101.                 (only if no description is available in the files.bbs).
  2102.  
  2103.  
  2104.  
  2105.      ───────────────────────────────────────────────────────────────────────
  2106.                                                                    Page: 35
  2107.  
  2108.                      RemoteAccess File Manager version 1.21
  2109.      ───────────────────────────────────────────────────────────────────────
  2110.  
  2111.  
  2112.           - Stamp adopted:
  2113.                 Normally when RAFMCln adopts a file, the filedate will not
  2114.                 be changed. Some sysops however prefer these adopted files
  2115.                 to be displayed as new files. If you're one of them, you
  2116.                 should enable this option and the adopted files will be
  2117.                 automatically stamped with the current date. 
  2118.           - List-method:
  2119.                 There are 2 different kinds of listings. A new kind (Rafm)
  2120.                 and one similar to RA. You're free to choose the one you
  2121.                 like best.
  2122.           - New files scan:
  2123.                 When you set this to "Ask for date", a user has to enter a
  2124.                 complete date. "Ask # of days" will only ask the user how
  2125.                 many days to scan back up to a maximum of 365 days.
  2126.  
  2127.      ╒═════════════════════════════════════════════════════════════════════╕
  2128.      │░░░ Colors ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2129.      ╘═════════════════════════════════════════════════════════════════════╛
  2130.  
  2131.  
  2132.           Almost every color in Rafm can be changed if you want. Use the
  2133.           cursorkeys to move through the different fields, and [Enter] and
  2134.           [BackSpace] to change the colors as desired.
  2135.  
  2136.      ╒═════════════════════════════════════════════════════════════════════╕
  2137.      │░░░ Downloading ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2138.      ╘═════════════════════════════════════════════════════════════════════╛
  2139.  
  2140.  
  2141.           - Allow global downloads:
  2142.                 If enabled, Rafm will scan all areas for matching files. If
  2143.                 disabled, users can only download from the currently
  2144.                 selected area.
  2145.           - No Downloadhours:
  2146.                 If enabled, users can only download between the hours set
  2147.                 in "Starting hour" and "Ending hour". Useful for boards who
  2148.                 do not want users to download at peak times. 
  2149.           - Search in archives:
  2150.                 Determines whether or not users can search inside archives
  2151.                 when using the Keyword or Filename scan. If set to Yes,
  2152.                 Rafm will ask the user if he wants to search inside the
  2153.                 archives to see if a particular file is contained in
  2154.                 another archive. If set to No, the question will never be
  2155.                 asked, thus making it impossible to search inside the
  2156.                 archives. 
  2157.  
  2158.  
  2159.  
  2160.  
  2161.      ───────────────────────────────────────────────────────────────────────
  2162.                                                                    Page: 36
  2163.  
  2164.                      RemoteAccess File Manager version 1.21
  2165.      ───────────────────────────────────────────────────────────────────────
  2166.  
  2167.  
  2168.           - Show files in archives:
  2169.                 Should Rafm ask if a user wants to see files inside the
  2170.                 archives during a file-listing?
  2171.           - Show long comments:
  2172.                 Determines if Rafm will show full comments/descriptions, or
  2173.                 only partial (depending on the type of listing, 1 or 2
  2174.                 lines). 
  2175.           - Show downloadcounters:
  2176.                 Should Rafm display the downloadcounters? (Only in
  2177.                 available in an Rafm type listing).
  2178.           - Show filedates:
  2179.                 Should Rafm display the dates of the files? (Rafm listing
  2180.                 only)
  2181.           - Show Kb:
  2182.                 Should Rafm display the filesizes in Kb instead of bytes?
  2183.                 (Rafm listing only)
  2184.           - Show only new:
  2185.                 Determines if a user will be allowed to list only new files
  2186.                 in an area.
  2187.           - Text when missing:
  2188.                 This text is displayed when a user wants to download a file
  2189.                 which is missing from the disk, for files that are stored
  2190.                 offline for example.
  2191.           - Free Files (Kb):
  2192.                 If set to a level higher than 0, a user may download this
  2193.                 many Kb, before being confronted by his ratio. f.e.: is you
  2194.                 set it to 500 and the Kb-ratio is 1:10, a user may download
  2195.                 500Kb and after this, has to upload 50Kb to restore his/her
  2196.                 limits.
  2197.           - Free Files (#):
  2198.                 Similar to the previous option, but now for the number of
  2199.                 downloaded files.
  2200.           - Send infofile {+}:
  2201.                 If set to Ask, RAFM will ask the user if he/she wants to
  2202.                 download a file containing descriptions of the files to be
  2203.                 downloaded. This infofile is created automatically by Rafm
  2204.                 from the description entered in RafmEdit. 
  2205.           - Info header:
  2206.                 Should point to an ASCII file (f.e. your archive-comment).
  2207.                 RAFM will append the file-description to this file when a
  2208.                 user chooses to download the infofile.
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.      ───────────────────────────────────────────────────────────────────────
  2218.                                                                    Page: 37
  2219.  
  2220.                      RemoteAccess File Manager version 1.21
  2221.      ───────────────────────────────────────────────────────────────────────
  2222.  
  2223.  
  2224.      ╒═════════════════════════════════════════════════════════════════════╕
  2225.      │░░░ Uploading ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2226.      ╘═════════════════════════════════════════════════════════════════════╛
  2227.  
  2228.  
  2229.           - Private Uploads:
  2230.                 Whether or not you want to accept private uploads
  2231.                 (i.e.,sysop-only).
  2232.           - Check duplicates:
  2233.                 Should Rafm scan the database after every upload for
  2234.                 possible duplicate files?
  2235.           - Action duplicates:
  2236.                 Determines what you want to do with duplicate uploaded
  2237.                 files. Files can be killed, moved to a special area or you
  2238.                 can decide to leave the file untouched.
  2239.           - Move duplicates to:
  2240.                 If you want Rafm to move duplicate files, you must enter
  2241.                 the areanumber that Rafm will move the files to. 
  2242.           - Check on viri:
  2243.                 Should RafmChk check new uploaded files for viri? This is
  2244.                 done when RafmChk is run (in your daily event?). To scan a
  2245.                 file whilst the user is still online, see -Online check
  2246.                 later in this section.
  2247.           - Restrict uploads:
  2248.                 If Yes, all uploads will be placed in one area (see -Upload
  2249.                 area), if No, uploads are placed in the current area at
  2250.                 that moment.
  2251.           - Upload area:
  2252.                 When restrict uploads is set to Yes, all uploads will be
  2253.                 placed in this area (can be overruled by putting /F=xx on
  2254.                 the optional dataline in a type 33 menu). 
  2255.           - Credit Kb factor:
  2256.                 If set to non-0, the user's daily download limit will be
  2257.                 raised by Kb*factor%.
  2258.                 f.e.: if you set it to 200%, and a user uploads 100Kb, his
  2259.                 daily limit will be credited with 200Kb.
  2260.           - Credit time factor:
  2261.                 Similar to Credit Kb factor, but now regarding the users
  2262.                 daily time-limit. When using a batch-protocol, the time
  2263.                 needed to upload the file is calculated based on the real
  2264.                 efficiency.
  2265.                 Note: Rafm will freeze the system timer whilst a user is
  2266.                 uploading a file.
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.      ───────────────────────────────────────────────────────────────────────
  2274.                                                                    Page: 38
  2275.  
  2276.                      RemoteAccess File Manager version 1.21
  2277.      ───────────────────────────────────────────────────────────────────────
  2278.  
  2279.  
  2280.           - Minimum diskspace:
  2281.                 The minimum free diskspace to allow uploads. If your free
  2282.                 diskspace is equal to or less than this figure Rafm will
  2283.                 not allow a user to upload.
  2284.                 Note: Rafm can't prevent users uploading files via Bimodem.
  2285.           - Update Files.Bbs:
  2286.                 Whether of not Rafm should add new uploaded files to the
  2287.                 existing Files.Bbs (added for compatibility reasons).
  2288.           - Scan path:
  2289.                 Complete path to the virus-scanner, including the necessary
  2290.                 parameters. Since RAFM has to know where on the commandline
  2291.                 the directory to scan has to be placed, you have to put in
  2292.                 a %1 parameter, f.e.:
  2293.  
  2294.                 C:\UTIL\SCAN.EXE %1 /Nomem /SUB
  2295.  
  2296.                 The %1 is replaced by the directory to be scanned. 
  2297.                 Don't forget to let your virusscanner process sub-
  2298.                 directories too since RAFM will create them when the
  2299.                 archive contains directories!
  2300.           - Action on infected files:
  2301.                 Similair to duplicate files you can let RAFM move/kill
  2302.                 infected files.
  2303.           - Area to move infected files to:
  2304.                 When action on infected files has been set to move, you
  2305.                 must specify which area RAFM should move these files to.
  2306.           - Online Check {+}:
  2307.                 If set to Yes, uploaded files are scanned for viri
  2308.                 immediately after the upload is complete.
  2309.           - Online re-arch. {+}:
  2310.                 If set to Yes, uploaded files will be re-archived to the
  2311.                 default archive-type immediately after the upload is
  2312.                 complete. Please note that online rearchiving will cost
  2313.                 your users money! I personally dislike this option, it's
  2314.                 only there because many sysops asked for it.
  2315.           - Ask desc. first:
  2316.                 If set to Yes, RAFM will ask for a description of the file
  2317.                 before the actual upload takes place. Useful for the idiots
  2318.                 that upload a file and don't bother to enter a description!
  2319.           - Add Gif specs:
  2320.                 If set to yes, RAFM will add GIF specifications (Width,
  2321.                 Height and colors) to the description of uploaded .GIF
  2322.                 files.
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.      ───────────────────────────────────────────────────────────────────────
  2330.                                                                    Page: 39
  2331.  
  2332.                      RemoteAccess File Manager version 1.21
  2333.      ───────────────────────────────────────────────────────────────────────
  2334.  
  2335.  
  2336.           - Gif specification:
  2337.                 Determines the way RAFM will add GIF specifications to the
  2338.                 description.
  2339.                 Characters you can use:
  2340.                 B or A: Put specification Before or After description.
  2341.                 W : Width (in pixels) of the picture
  2342.                 H : Height (in pixels) of the picture
  2343.                 C : number of colors.
  2344.                 f.e.: 
  2345.  
  2346.                 B(W * H * C) will be translated into:
  2347.  
  2348.                 (640 * 480 * 256) and put before the description.
  2349.  
  2350.  
  2351.      ╒═════════════════════════════════════════════════════════════════════╕
  2352.      │░░░ Maintenance ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2353.      ╘═════════════════════════════════════════════════════════════════════╛
  2354.  
  2355.  
  2356.           - Move inactive files:
  2357.                 Should RafmCln move inactive files after a certain period?
  2358.                 Asset in -Days before move.
  2359.           - Days before move:
  2360.                 If move inactive files is set to Yes, inactive files are
  2361.                 moved if they are not downloaded within this number of
  2362.                 days. 
  2363.           - Area # to move to:
  2364.                 Determines the areanumber to which inactive files area
  2365.                 moved.
  2366.           - Kill inactive files:
  2367.                 Should RafmCln erase inactive files? If set to Yes, RafmCln
  2368.                 will erase from the disk any files that are set as being
  2369.                 inactive.
  2370.           - Days before kill:
  2371.                 If kill inactive files is set to Yes, inactive files will
  2372.                 be erased if not downloaded within this number of days.
  2373.  
  2374.                 Note: if a moved file has been downloaded from the inactive
  2375.                 area, RafmCln will automatically move the file back to its
  2376.                 original area.
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.      ───────────────────────────────────────────────────────────────────────
  2386.                                                                    Page: 40
  2387.  
  2388.                      RemoteAccess File Manager version 1.21
  2389.      ───────────────────────────────────────────────────────────────────────
  2390.  
  2391.  
  2392.      ╒═════════════════════════════════════════════════════════════════════╕
  2393.      │░░░ Archives ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2394.      ╘═════════════════════════════════════════════════════════════════════╛
  2395.  
  2396.  
  2397.           - Convert archives to:
  2398.                 Determines which type of archive new uploaded files should
  2399.                 be converted to. Rafm currently supports the following
  2400.                 types: ARC/PAK/ZIP/LZH (new and old)/ARJ and HYP. 
  2401.           - Re-archive SFX:
  2402.                 Nowadays more and more programs are spread in self-
  2403.                 extracting archives with security-envelopes. When processed
  2404.                 by RafmChk, these envelopes will be lost. If you want to
  2405.                 keep these kind of archives, you should disable this
  2406.                 option. 
  2407.                 Note: Rafm will still be able to perform all actions with
  2408.                 these files, although searching through SFX-archives takes
  2409.                 considerably more time than normal archives. 
  2410.           - Convert directory:
  2411.                 This should be an empty directory. It's used by Rafm and
  2412.                 RafmChk to convert or extract files from archives.
  2413.                 IMPORTANT: ALL FILES IN THIS DIRECTORY WILL BE DELETED WHEN
  2414.                 A USER EXTRACTS OR RE-ARCHIVES FILES AND WHEN RAFMCHK IS
  2415.                 RUN!
  2416.                 Multi-line systems will need to use a different directory
  2417.                 for each line!
  2418.           - Comment path:
  2419.                 Complete path to a standard ASCII file which can contain
  2420.                 your BBS-advertisement. This file will be used to comment
  2421.                 the archives created by RafmChk (only if the archive-type
  2422.                 can handle comments of course).
  2423.           - Archive area:
  2424.                 Determines in which area the converted archives are placed,
  2425.                 when a user uses the View Archive menu-type. 
  2426.           - Stamp archives:
  2427.                 Normally, uploaded files are stamped with the current time
  2428.                 and date immediately after the upload. If you turn this
  2429.                 option on, files are also stamped after converting with
  2430.                 RafmChk. 
  2431.           - Action bad archives:
  2432.                 Similar to duplicate files you can let RafmChk move/kill
  2433.                 bad archives. Useful for aborted uploads. 
  2434.           - Move bad archives to:
  2435.                 The area in which bad archives should be placed.
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.      ───────────────────────────────────────────────────────────────────────
  2442.                                                                    Page: 41
  2443.  
  2444.                      RemoteAccess File Manager version 1.21
  2445.      ───────────────────────────────────────────────────────────────────────
  2446.  
  2447.  
  2448.           - Use FILE_ID.DIZ:
  2449.                 Many archives nowadays contain a little textfile describing
  2450.                 the archive, RAFM can read this textfile and replace the
  2451.                 file's description with the contents of the textfile. 
  2452.                 Note: RAFM also recognizes a different standard: DESC.SDI.
  2453.           - Strip Hi-ASCII:
  2454.                 Unfortunately, many FILE_ID.DIZ files contain Hi-ASCII
  2455.                 characters (boxes etc.). You can let RAFM remove these
  2456.                 characters by setting this option to Yes.
  2457.  
  2458.  
  2459.      ╒═════════════════════════════════════════════════════════════════════╕
  2460.      │░░░ User Info ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2461.      ╘═════════════════════════════════════════════════════════════════════╛
  2462.  
  2463.           RAFM now even more supports the USERDOES.xxx file. The standard
  2464.           USERON.BBS file used and created by RA can only display very
  2465.           limited information about what the user is doing. USERDOES.xxx is
  2466.           much more flexible. 
  2467.  
  2468.           (P.S. RA doesn't support this file, you'll need a program like
  2469.           Gerard Hoogterp's USERON program)
  2470.  
  2471.           The usage of this USERDOES file is enabled by setting Use Info to
  2472.           Yes. You can also change the info RAFM writes to this file by
  2473.           editing the various messages.
  2474.  
  2475.  
  2476.      ╒═════════════════════════════════════════════════════════════════════╕
  2477.      │░░░ RafmCln ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2478.      ╘═════════════════════════════════════════════════════════════════════╛
  2479.  
  2480.  
  2481.      RafmCln is the maintenance part of the package. It will clean up the
  2482.      database and perform various extra functions (such as maintenance,
  2483.      creating new Files.Bbs and Auto-Adopting files). You should run it
  2484.      daily, normally in your maintenance event. 
  2485.      Multi-liners: please make sure that every line is down before you
  2486.      start RafmCln!!! Failure to do so can result in a corrupted database!!
  2487.  
  2488.      There are several parameters:
  2489.  
  2490.           -B:   Backup datafiles. Will create backup copies of the data-
  2491.                 and indexfile. The copies will be placed in the
  2492.                 Rafmdirectory with an extension of .BAK.
  2493.  
  2494.  
  2495.  
  2496.  
  2497.      ───────────────────────────────────────────────────────────────────────
  2498.                                                                    Page: 42
  2499.  
  2500.                      RemoteAccess File Manager version 1.21
  2501.      ───────────────────────────────────────────────────────────────────────
  2502.  
  2503.  
  2504.           -A:   Activate the Auto-Adopt function. This function will scan
  2505.                 all directories in RafmArea.Dat and if a file is found that
  2506.                 isn't in the database, it will add the file to it, if the
  2507.                 file passes the duplicate-check (same as in Rafm). If
  2508.                 RafmCln can find a Files.Bbs (the Listpath is supported)
  2509.                 then it will look there for a description. If not the
  2510.                 default description as defined in RafmEdit will be used.
  2511.           -AF:  Similar to the -A function, but only scans Files.Bbs for
  2512.                 new files. If you f.e. are connected to a file-echo (SDS
  2513.                 f.e.) the current utilities won't support Rafm, they will
  2514.                 however create a Files.Bbs. -AF will scan the Files.Bbs and
  2515.                 especially when used together with the -E parameter will
  2516.                 significantly speed things up. The -AF function also uses a
  2517.                 different duplicate routine. This routine doesn't check the
  2518.                 extension, so you can now add your nodediffs f.e.
  2519.                 automatically.
  2520.                 RAFMCln automatically detects whether your Files.BBS hold
  2521.                 sizes and dates of the files. When they do, RAFMCln will
  2522.                 not scan your drive to get this information. This will
  2523.                 speed up the auto-adopt routine, especially on slow media
  2524.                 like CD-ROMs.
  2525.           -E:   Together with the -AF function this function will truncate
  2526.                 the Files.Bbs after it has been scanned. Using the -E
  2527.                 function will dramatically increase the speed of the auto-
  2528.                 adopt function next time it is run.
  2529.           -U:   Update database. Compares the sizes and dates in the
  2530.                 database with the actual sizes and dates of the files on
  2531.                 the disk. If a file has been erased from disk, only the
  2532.                 size of the file is set to 0, the file will NOT be removed
  2533.                 from the database! This way, you can easily create an
  2534.                 offline-area or request-area.
  2535.           -N:   Creates a new index. Only use this if you've lost the index
  2536.                 or the index has been damaged.
  2537.           -M:   Activate the maintenance function (see RafmEdit)
  2538.           -S:   Sort the database. The files are sorted alphabetically on
  2539.                 filename.
  2540.           -O:   Optimize database. Normally, only the index will be sorted.
  2541.                 With this option the database will also be sorted, saving
  2542.                 lots of headmovements and decreasing the access time.
  2543.           -K:   Kill deleted records. Will remove deleted records from the
  2544.                 database. This function will not kill records in which
  2545.                 thier filesize=0 (see -D parameter) but only records which
  2546.                 have the Deleted bit set.
  2547.           -D:   Delete empty records. Will remove all records containing
  2548.                 files in which filesize = 0.
  2549.  
  2550.  
  2551.  
  2552.  
  2553.      ───────────────────────────────────────────────────────────────────────
  2554.                                                                    Page: 43
  2555.  
  2556.                      RemoteAccess File Manager version 1.21
  2557.      ───────────────────────────────────────────────────────────────────────
  2558.  
  2559.  
  2560.           -F:   Create new files.bbs from the database.
  2561.                 WARNING: using this option will erase ALL existing
  2562.                 files.bbs!!!
  2563.                 There is an extra option when using the -F parameter: the -
  2564.                 c parameter will create a new Files.RA using the paths in
  2565.                 RafmArea.Dat.
  2566.  
  2567.      Each extra parameter is considered to be an areanumber which has to be
  2568.      processed. By default, RafmCln will process every area, but when a
  2569.      valid areanumber is present on the commandline, only that area will be
  2570.      processed (you may enter more than just one areanumber!). 
  2571.      F.e. RafmCln -U /1 /196 will update files in areas 1 and 196 only!.
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.      ───────────────────────────────────────────────────────────────────────
  2610.                                                                    Page: 44
  2611.  
  2612.                      RemoteAccess File Manager version 1.21
  2613.      ───────────────────────────────────────────────────────────────────────
  2614.  
  2615.  
  2616.      ╒═════════════════════════════════════════════════════════════════════╕
  2617.      │░░░ RafmCD ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2618.      ╘═════════════════════════════════════════════════════════════════════╛
  2619.  
  2620.      RafmCD is a little program to convert your current Files.BBS to a
  2621.      special format. It's designed to be used with CD-ROMs but will in fact
  2622.      convert every type of listing. For more information: please read the
  2623.      RAFMCD.DEF file! 
  2624.  
  2625.      The special format looks like this:
  2626.  
  2627.      NAME  SIZE  DATE  DESCRIPTION
  2628.  
  2629.      Every line in your current listing should only contain 1 file!
  2630.      Listings which hold more than one file per line can NOT be processed
  2631.      by either RAFMCD or RAFMCLN!
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.      ───────────────────────────────────────────────────────────────────────
  2666.                                                                    Page: 45
  2667.  
  2668.                      RemoteAccess File Manager version 1.21
  2669.      ───────────────────────────────────────────────────────────────────────
  2670.  
  2671.  
  2672.      ╒═════════════════════════════════════════════════════════════════════╕
  2673.      │░░░ RafmChk ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2674.      ╘═════════════════════════════════════════════════════════════════════╛
  2675.  
  2676.  
  2677.      RafmChk will check all newly uploaded files, convert them to the
  2678.      archive-type of your choice (as defined in RafmEdit) and add a comment
  2679.      to it (if supported by the archiver being called). RafmChk only uses 1
  2680.      parameter, the -A which overrules the 'Swapping' option from RafmEdit.
  2681.      So, if you start RafmChk with the -A parameter, RafmChk will always
  2682.      swap whenever an external program has to be called.
  2683.      Any other parameter is (just like RafmCln) considered to be an
  2684.      areanumber.
  2685.      Even when you've enabled online scanning and rearchiving, it is still
  2686.      necessary to run RafmChk! Why? Because when the online operation fails
  2687.      because of technical problems (disk full etc.) RAFM will abort and the
  2688.      file will not be checked completely. That's why you still have to use
  2689.      RafmChk to process these files (it's for your (and your users)
  2690.      security!).
  2691.      An extra option is to let RAFM remove certain files from the archives.
  2692.      You can control this by placing a ASCII file called REMOVE.CTL in your
  2693.      system-directory. This file should contain filenames (wildcards are
  2694.      allowed) which you don't want to have in your archives. Please only
  2695.      enter one (1) filename/filemask per line! This option has been
  2696.      especially designed to remove BBS-advertisements from archives but can
  2697.      be used for anything else (just try and enter *.* ;-))
  2698.  
  2699.  
  2700.         DON'T FORGET: THE CONVERT-DIRECTORY WILL BE ERASED COMPLETELY!!!
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.      ───────────────────────────────────────────────────────────────────────
  2722.                                                                    Page: 46
  2723.  
  2724.                      RemoteAccess File Manager version 1.21
  2725.      ───────────────────────────────────────────────────────────────────────
  2726.  
  2727.  
  2728.      ╒═════════════════════════════════════════════════════════════════════╕
  2729.      │░░░ RafmAll ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2730.      ╘═════════════════════════════════════════════════════════════════════╛
  2731.  
  2732.  
  2733.      Since Rafm uses a database, you can't use any of the existing all-
  2734.      files creators (except when you first create new files.bbs using
  2735.      RafmCln -F) so I decided to write my own. RafmAll has it's own inbuilt
  2736.      configuration part, which you can activate by running RafmAll -C and
  2737.      can create upto 10 all/newfile listings at once. If you run RafmAll
  2738.      without any parameters, the actual all/newfiles listings will be
  2739.      created.
  2740.  
  2741.      Configuration:
  2742.  
  2743.      If you run RafmAll with the -C parameter, you'll first have to select
  2744.      the listing you want to edit, or an empty slot if you want to create a
  2745.      new listing. Use the cursorkeys and [Enter].
  2746.  
  2747.      After pressing the [Enter] key, a new window will open and you can
  2748.      edit the listing:
  2749.  
  2750.           - Areas to include:
  2751.                 Opens another window, in which you can select the areas. An
  2752.                 "*" indicates whether or not the area will be included in
  2753.                 the listing ("*" means include this area).
  2754.           - Allfiles path:
  2755.                 Full path and name to the allfiles listing. i.e where
  2756.                 should the allfiles list that is created be placed?
  2757.           - Newfiles path:
  2758.                 Full path and name to the newfiles listing. If you leave
  2759.                 this empty, no newfiles listing will be created.
  2760.           - Header path:
  2761.                 Full path and name to the header file. The header file is a
  2762.                 standard ASCII file, which is placed at the begining of the
  2763.                 all/newfiles listing. You can leave this empty. 
  2764.           - Trailer path:
  2765.                 Similar to the header path, except that the trailer is
  2766.                 placed at the end of the listings.
  2767.           - Days to include:
  2768.                 Files newer than this number of days will be placed in the
  2769.                 newfiles listing. If you set it to 0, no newfiles listing
  2770.                 will be created. Files older than this will ONLY be listed
  2771.                 in the Allfileslisting.
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.      ───────────────────────────────────────────────────────────────────────
  2778.                                                                    Page: 47
  2779.  
  2780.                      RemoteAccess File Manager version 1.21
  2781.      ───────────────────────────────────────────────────────────────────────
  2782.  
  2783.  
  2784.           - Separation char:
  2785.                 The character RafmAll should use between files. Please note
  2786.                 that anything other than a space will significantly
  2787.                 increase the size of the listing that is created.
  2788.           - Show long comments:
  2789.                 Should RafmAll process long comments? (i.e. more than 2
  2790.                 lines). Again as with the seperation character, enabling
  2791.                 this feature will significantly increase the size of the
  2792.                 listings that are created. 
  2793.           - Use ext. ASCII:
  2794.                 Is RafmAll allowed to use extended ASCII characters (above
  2795.                 128) in the listings? Be careful, remember users without
  2796.                 IBM machines can have great difficulty with these
  2797.                 characters. 
  2798.           - Show Xfertime:
  2799.                 Should RafmAll calculate and write the needed time to
  2800.                 download a file in the listings? Yet again, enabling this
  2801.                 option will increase the size of the listings that are
  2802.                 created.
  2803.           - Baudrate 1
  2804.             Baudrate 2
  2805.             Baudrate 3
  2806.                 The baudrates to use when calculating the needed time to
  2807.                 download files.
  2808.  
  2809.      Archiving the listings:
  2810.  
  2811.      After creating the listings RafmAll will call a batchfile called
  2812.      RAFMZIP.BAT for each individual listing. Please look in the
  2813.      RAFMarchive for an example of such a batchfile. You should edit this
  2814.      file to enable the creation of the archived listings you want.
  2815.  
  2816.      ╒═════════════════════════════════════════════════════════════════════╕
  2817.      │░░░ RafmLCom ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2818.      ╘═════════════════════════════════════════════════════════════════════╛
  2819.  
  2820.  
  2821.      RafmLCom is the language-compiler. It will read the standard ASCII
  2822.      language file and create a compiled version. The only parameter
  2823.      needed, is the number of the language file. 
  2824.      To create a new language file, you should copy the file 1.LNG
  2825.      (contained in the archive) to another file (f.e. 2.LNG). After doing
  2826.      this, you can edit the copied file and translate every prompt. Hotkeys
  2827.      are always put first on every line without any spaces between them.
  2828.      Leading and trailing spaces will be removed by RafmLCom, also, any
  2829.      line starting with a semi-colon will treated as a comment and be
  2830.      ignored. RAFM will always try to let the translated prompt fit the
  2831.  
  2832.  
  2833.      ───────────────────────────────────────────────────────────────────────
  2834.                                                                    Page: 48
  2835.  
  2836.                      RemoteAccess File Manager version 1.21
  2837.      ───────────────────────────────────────────────────────────────────────
  2838.  
  2839.  
  2840.      layout of the screen, however, it is still your responsibility to
  2841.      ensure the prompts are not too long!
  2842.      The number of the language file corresponds with the number of the
  2843.      language as defined in RaConfig.
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.      ───────────────────────────────────────────────────────────────────────
  2890.                                                                    Page: 49
  2891.  
  2892.                      RemoteAccess File Manager version 1.21
  2893.      ───────────────────────────────────────────────────────────────────────
  2894.  
  2895.  
  2896.      ╒═════════════════════════════════════════════════════════════════════╕
  2897.      │░░░ RafmCnvt ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2898.      ╘═════════════════════════════════════════════════════════════════════╛
  2899.  
  2900.  
  2901.      RafmCnvt will convert the old Files.Bbs and Files.RA into a database
  2902.      to be used by all Rafm-programs. RafmCnvt supports the separate
  2903.      Listpath for Files.bbs. Normally you should only need to run RafmCnvt
  2904.      once, so you can erase it afterwards if you want to. RafmCnvt will ask
  2905.      you some questions which you should answer. Most of the questions are
  2906.      pretty straight forward, so I will only explain one of them:
  2907.  
  2908.           Process missing files (y/n) ?: By default only existing files
  2909.           (i.e. files which RafmCnvt can find on your drive) from the
  2910.           files.bbs are processed, but if you want you can switch off this
  2911.           check so that all files in the files.bbs (wether on the drive or
  2912.           not) will be converted.
  2913.  
  2914.      RafmCnvt supports the extended comments used by QFF, RFW and several
  2915.      other packages (comments starting with a +). Downloadcounters are also
  2916.      converted, but only if they are placed between [] otherwise they will
  2917.      be treated as part of the file description.
  2918.  
  2919.      Some users of RAFM have asked me to add an extra parameter so that
  2920.      they can use RafmCnvt in their maintenance-event. If you add the /N
  2921.      parameter, all keyboard-calls will be disabled and the converting will
  2922.      take place fully automatically without the need for any intervention
  2923.      by you. Please note that running RafmCnvt a second time, will create a
  2924.      new database causing all extended information present in the database
  2925.      to be lost!
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.      ───────────────────────────────────────────────────────────────────────
  2946.                                                                    Page: 50
  2947.  
  2948.                      RemoteAccess File Manager version 1.21
  2949.      ───────────────────────────────────────────────────────────────────────
  2950.  
  2951.  
  2952.      ╒═════════════════════════════════════════════════════════════════════╕
  2953.      │░░░ Bugreports, address etc. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2954.      ╘═════════════════════════════════════════════════════════════════════╛
  2955.  
  2956.  
  2957.      First of all, if you have a question or a problem, please refer to the
  2958.      Common.Q-A file first! 
  2959.  
  2960.      Any bugreports, comments or compliments (:-)) can be sent to me by:
  2961.  
  2962.           - Posting a message in one of the following (Fidonet)
  2963.           echomailareas:
  2964.           RA_UTIL (intl) and RA.028 (dutch)
  2965.  
  2966.           - There is also a special RAFM-Echo called RAFM.SUP. For the time
  2967.           being only available at my node and on every support-node, but I
  2968.           hope that it will be on the backbone soon. If you want to receive
  2969.           this echo, please send a netmail to me.
  2970.  
  2971.           - Rene Van Hoorn at 2:283/506 or 27:3331/222.
  2972.  
  2973.           - Posting a message on my BBS:
  2974.             EyeS Delight, +31-35-231224
  2975.             24 hours daily, V22bis/V32/V32bis/HST
  2976.  
  2977.      You can also call one of the support-nodes and post a message there.
  2978.      All support-nodes carry the RAFM Support Echo too!
  2979.  
  2980.      The latest version of RAFM will always be available at my BBS. The
  2981.      magic name will be RAFM (of course...). Filerequests are allowed 24
  2982.      hours a day, except during ZMH (2.30-3.30 GMT).
  2983.  
  2984.  
  2985.                                --==[ THE END ]==--
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.      ───────────────────────────────────────────────────────────────────────
  3002.                                                                    Page: 51
  3003.  
  3004.