home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / flm213s.zip / FLM2.DOC < prev    next >
Text File  |  1992-12-12  |  102KB  |  2,249 lines
  1.  ┌─────────────────────────────────────────────────────────────────────────┐
  2.  │▒▒▒▒▒▒▒▒ File Library Manager (FLM)    by Derek Bryant  (c) 1992 ▒▒▒▒▒▒▒▒│
  3.  └─────────────────────────────────────────────────────────────────────────┘
  4.  
  5.                     Copyright (c) 1992 by Derek Bryant
  6.                             All Rights Reserved
  7.  
  8.  
  9.     The Total Filebase Manager for RA/QBBS/SBBS Bulletin Board Systems
  10.  
  11.  
  12.  
  13.  
  14.                       Shareware Edition Documentation
  15.  
  16.  
  17.                                Release 2.10
  18.  
  19.  
  20.  
  21.  
  22.   ─────────────────────────────────────────────────────────────────────────
  23.   ▒▒ TABLE OF CONTENTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  24.   ─────────────────────────────────────────────────────────────────────────
  25.  
  26.       Chapter 1 - License and Registration
  27.  
  28.                   License
  29.                   Registration
  30.                   Warranty
  31.  
  32.       Chapter 2 - Introduction and Installation
  33.  
  34.                   Preface
  35.                   Introduction
  36.                   Installation
  37.                   Subscription System
  38.  
  39.       Chapter 3 - Configuration Menu
  40.  
  41.                   File Storage
  42.                   File Lists
  43.                   Menu
  44.                   Protocols
  45.                   Archivers
  46.                   Externals
  47.                   System
  48.                   BBS Options
  49.                   BBS Colours
  50.                   Allfiles Lists
  51.  
  52.       Chapter 4 - Viewer/Editor
  53.  
  54.                   Area Lists
  55.                   Global Lists
  56.                   The Record Card
  57.                   Moving/Copying/Deleting Files
  58.                   Block Marking
  59.                   Deleting The ScrapList
  60.                   Adding Newfiles
  61.  
  62.       Chapter 5 - Utilities
  63.  
  64.                   Adopting Files
  65.                   Verifying File Information
  66.                   Re-Sorting Alphabetic
  67.                   Verifying Counts
  68.                   Automatic Check For Virus
  69.                   Sorting Area Lists
  70.                   Creating Allfiles Lists
  71.                   Creating Newfiles Lists
  72.                   Creating ANS/ASC Reports
  73.                   Exporting to Files.bbs
  74.  
  75.       Chapter 5 - Running FLM in BBS Mode
  76.  
  77.                   List Viewing
  78.                   File Searching
  79.                   Newfiles Listing
  80.                   Downloading
  81.                   Uploading
  82.                   Support ANS/ASC Files
  83.  
  84.       Chapter 6 - Statistics
  85.  
  86.                   Upload Sessions
  87.                   Uploaders File
  88.                   Download Sessions
  89.                   Downloaders File
  90.                   Usage Statistics
  91.                   Filebase Information
  92.  
  93.       Chapter 7 - Credits
  94.  
  95.       Chapter 8 - Appendix
  96.  
  97.                   A - Extended use of FLSEARCH.CTL File
  98.                   B - FILES.BBS description files
  99.  
  100.  
  101.   ─────────────────────────────────────────────────────────────────────────
  102.   ▒▒ LICENCE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  103.   ─────────────────────────────────────────────────────────────────────────
  104.  
  105.   FLM2 is SHAREWARE, user supported software.  FLM2 is made available for a
  106.   free  30  day  trial period.   If you find the program of use and wish to
  107.   continue using it, you are obliged to purchase a personal license.
  108.  
  109.   FLM2 is copyrighted software, and all rights are reserved.   FLM2 may not
  110.   be changed or  modified  in  any  way  except  by  the  author.   FLM2 is
  111.   SHAREWARE,  and may be freely distributed without permission,  as long as
  112.   it remains in its complete form with all support and documentation files.
  113.   No files may be added or taken away from the original  Archived  form  in
  114.   which FLM2 is distributed.  Regardless of how the copy is obtained, it is
  115.   requested  that  all  users  comply  with  the licensing and registration
  116.   provisions  if  they  continue  to  use  FLM2  after  an  initial  30 day
  117.   evaluation period.
  118.  
  119.  
  120.   ─────────────────────────────────────────────────────────────────────────
  121.   ▒▒ REGISTRATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  122.   ─────────────────────────────────────────────────────────────────────────
  123.  
  124.   Registration of FLM2 provides you with the License to continue using FLM2
  125.   after  the  30  day  Evaluation  period.    Registration of the SHAREWARE
  126.   Edition costs UK Stg 19.00
  127.  
  128.   See accompanying file REGISTER.TXT for a registration  form  and  payment
  129.   details.
  130.  
  131.   There  is  a  Professional  Edition  of  FLM2 with many more features and
  132.   enhancements than the SHAREWARE Edition.  The Professional Edition IS NOT
  133.   Shareware,  it is a fully  commercial  product only available direct from
  134.   the Author or approved Vendor sites.   The Professional Edition costs  UK
  135.   Stg 39.00 and will not work without a Personal Registration Code.   Users
  136.   who  have  previously registered the Shareware Edition can upgrade to the
  137.   Professional Edition for UK Stg 20.00
  138.  
  139.  
  140.   ─────────────────────────────────────────────────────────────────────────
  141.   ▒▒ WARRANTY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  142.   ─────────────────────────────────────────────────────────────────────────
  143.  
  144.   The author makes no warranty  of  any kind,  either expressed or implied.
  145.   This  includes,   but  is  not  limited  to,    implied   warranties   or
  146.   merchantability,   and fitness for any particular purpose with respect to
  147.   both the software and the documentation included in this package.
  148.  
  149.   IN NO  EVENT  SHALL  THE  AUTHOR  BE  LIABLE  FOR  ANY DIRECT,  INDIRECT,
  150.   CONSEQUENTIAL,  OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  151.   TO USE  THIS  PRODUCT  EVEN  IF  THE  AUTHOR  HAS  BEEN  ADVISED  OF  THE
  152.   POSSIBILITY OF SUCH DAMAGES OR CLAIM.
  153.  
  154.  
  155.   ─────────────────────────────────────────────────────────────────────────
  156.   ▒▒ PREFACE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  157.   ─────────────────────────────────────────────────────────────────────────
  158.  
  159.   There were three prime objectives for writing FLM.
  160.  
  161.     1) a system where I could interrogate the files in my filebase, be able
  162.        to describe files,  and manage  the  lists and location of each file
  163.        quickly and easily.
  164.  
  165.     2) Provide an easy and fast system for my users,  so they could  locate
  166.        the files they wanted and download quickly.
  167.  
  168.     3) Provide  a  system  that  could be built on,  with adaptation to new
  169.        storage medias, such as CD-Rom and offline tape streamers, etc.
  170.  
  171.   In all respects, I think we have surpassed all expectations.   For me FLM
  172.   is  a  angel  from  heaven.   Now I have 25,000 files and spend less time
  173.   managing the filebase than I did  when  I only had 1,000 files.   Safe in
  174.   the knowledge that the files have all been Virus checked,  and  put  into
  175.   the format I like.
  176.  
  177.   I  hope  FLM allows you to manage your filebase equally as well,  leaving
  178.   you more time to provide a quality service for your users.
  179.  
  180.  
  181.   ─────────────────────────────────────────────────────────────────────────
  182.   ▒▒ INTRODUCTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  183.   ─────────────────────────────────────────────────────────────────────────
  184.  
  185.   FLM is both a file 'Door' for  your  BBS and a manager for your filebase.
  186.   The system operates independently of any existing file systems  you  have
  187.   already setup on your BBS,  but routines are provided to install FLM from
  188.   what you have.
  189.  
  190.   FLM2 works on the basis that a filebase consists of :
  191.  
  192.     a)  Storage  Areas  where  files  are actually stored,  whether they be
  193.         directories on your Hard Disk,  or CD-Rom,  or floppy disks or Tape
  194.         Streamers.   Flm2 provides for upto 65,000 different Storage Areas,
  195.         with a security system against each.
  196.  
  197.     b)  File Lists are  displayed  to  the  user.    FLM provides powerfull
  198.         facilities for editing these lists so that users can see what files
  199.         you have.   FLM allows you to have upto 65,000 lists,  thay usually
  200.         are linked to a particular Store,  but they don't have to be.   For
  201.         instance,  you could define 50 file stores covering files you  have
  202.         on 50 floppy disks, but could list them all on just the one list.
  203.  
  204.     c)  Menus  - which give a structure to your filebase.   FLM allows upto
  205.         250 different Menus,  and  each  menu  can  have upto 200 different
  206.         options on it.  So you could contain your existing RA/Qbbs filebase
  207.         all on one Menu.
  208.  
  209.     d)  Security - determines what a specific user  is  allowed  to  access
  210.         from your filebase.  FLM has security systems to govern what a user
  211.         is allowed to see, download and upload.
  212.  
  213.   The idea of defining Lists and Storage Areas as separate objects may seem
  214.   over  the  top,   but  it  does provide FLM2 with features not previously
  215.   available to a BBS filebase.  Take the example of a Sysop who has aquired
  216.   a CD-ROM disc for his BBS.    The  disc contains thousands of programs he
  217.   didn't previously have, but at the same time it contains many files which
  218.   the sysop now has newer versions.   The sysop could setup  separate  file
  219.   areas for both the CD-ROM and his existing directories, in which case his
  220.   users  would then have to look in two separate but similar file areas for
  221.   the files they want.   Alternatively with FLM2,  you could show the users
  222.   just one List  even  though  files  are  stored in different directories.
  223.   Having just the one List,  as sysop you would then be able to  see  where
  224.   duplications exist and delete the duplicate files from your Hard Disk, or
  225.   delete  the  record  in  the  FLM  database for the older versions on the
  226.   CD-Rom disc.
  227.                                    
  228.   Please note,  having 4  sets  of  security  levels  to  set can get a bit
  229.   confusing, so to emphasise what governs what here's a brief breakdown.
  230.  
  231.   - The Security Levels set for a Storage area govern whether the user will
  232.     be allowed to download or see the file.
  233.  
  234.   - The Security Levels set against a List,  govern whether that List  will
  235.     be offered as an option on a Menu.
  236.     
  237.   - The Security Levels set against a Menu, govern whether that Menu will be
  238.     offered as an option to    the user. 
  239.  
  240.  
  241.   Whether  on  multi  or single line systems,  FLM2 uses a central database
  242.   stored usually in a directory  \FLM2DATA  Each  line however has it's own
  243.   configuration file FLM2CFG.DTA stored in the  directory  from  which  the
  244.   program is run.
  245.  
  246.   With this briefly in mind, lets now go on and actually get FLM installed.
  247.  
  248.  
  249.   ─────────────────────────────────────────────────────────────────────────
  250.   ▒▒ INSTALLATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  251.   ─────────────────────────────────────────────────────────────────────────
  252.  
  253.   Having now un-archived  the  distribution  archive,  locate the following
  254.   files into the directory where you have your BBS software,  alternatively
  255.   locate them somewhere in your DOS path.
  256.  
  257.     FLM2.EXE      FLM2.OVR     FLM2HELP.LBR
  258.  
  259.   Now create a data  directory  for  FLM,   say \FLM2DATA.   Locate in this
  260.   directory the following files:
  261.  
  262.     ARCHIVER.FLM  PROTOCOL.FLM
  263.  
  264.  
  265.   FLM2 is designed to work on both Single and Multiline systems,   but  you
  266.   will need to allow FLM2 to create a config file for each line.  This file
  267.   FLM2CFG.DTA  will reside in the directory from which FLM2 is run for that
  268.   line.   It  contains  the  paths  to  your  various  directories and most
  269.   important the path to FLM2's central database.
  270.  
  271.   On  initial  installation the config input screen will show,  but you are
  272.   able to later make any changes to it by running from the DOS command line
  273.  
  274.    FLM2 editcfg
  275.  
  276.   The Paths Definitions window asks you to enter the following:
  277.  
  278.    FLM Data Path :  a directory where all of FLM's datafiles are stored.
  279.                     when using FLM on a multiline system, have each config
  280.                     pointing to the same directory.
  281.  
  282.    BBS Type      : the options are   R  for Remote Access
  283.                                      S  for SuperBBS
  284.                                      E  for EasiHost
  285.  
  286.    BBS Syst Path : the directory where your BBS system files are stored.
  287.                    at the moment, the only file FLM will be looking for
  288.                    in here is the USERON.BBS file.
  289.  
  290.    TXT File Path : the directory where FLM is to locate the ANS/ASC reports
  291.  
  292.    MSG Base Path : - not used -
  293.  
  294.    Work Drive    : the drive FLM is to use for all intermediate work.
  295.                    don't set this to a RAM drive.
  296.  
  297.    Log Format    : Logfile style that FLM is to create. There are 3 options
  298.                    N - FLM will not log anything
  299.                    O - FLM will create a Opus style log
  300.                    F - FLM will create a FrontDoor style log
  301.  
  302.    Log Filename  : fully qualified filename for the logfile
  303.  
  304.    Use UserOn    : on a multiline system, FLM will update the USERON.BBS
  305.                    file to indicate what each user is doing as they use FLM
  306.                    There are 3 options, but only 2 are operable:
  307.                    N - don't update USERON file
  308.                    Y - do update it
  309.  
  310.    Use Drive Redirection :  set to No for the moment. This is described
  311.                             fully later.
  312.  
  313.  
  314.  
  315.   For other command line options, run  FLM2 help  or FLM2 ?
  316.  
  317.   You could now just run the program and FLM would create blank files.  You
  318.   would then go to the configuration menu,  and setup your filebase details
  319.   from scratch.   But I expect you already have a  filebase,   so  let  FLM
  320.   install from that instead.
  321.  
  322.   To  get  FLM  to  auto install,  you will need a FLSEARCH.CTL file in the
  323.   current directory and FILES.BBS files in each directory.  (see Appendix A
  324.   for a further description of  these  files  and enhancements to read from
  325.   CD-ROM discs) If you don't have FILES.BBS files in each  directory,   FLM
  326.   will  ask  for an alternative list to use.   Included in the distribution
  327.   file,  is a utility to create a FLSEARCH.CTL file from the FILES.RA file.
  328.   This utility is provided by Peter Burnett,  Piston Popper BBS and is free
  329.   to use.
  330.  
  331.   Simply now run the program, with the command line parameter INSTALL
  332.  
  333.    ie.   FLM2 install       (case is not important)
  334.  
  335.  
  336.  
  337.   FLM2 reads your FLSEARCH.CTL file obtaining all of the  directory  paths,
  338.   security  levels and file area descriptons.   FLM then imports all of the
  339.   files in each directory  adding  them  to  it's database,  then reads the
  340.   FILES.BBS files grabbing the descriptions and creating a File List out of
  341.   the FILES.BBS.   Finally FLM creates a Menu based on the file  areas  you
  342.   have.   If at any stage you need to re-install, delete all the files FLM2
  343.   has created and start from scratch.
  344.  
  345.   Possible  problems that may occur,  most likely will stem from the format
  346.   or size of the FILES.BBS  files  which  FLM2  will import from.   FLM2 is
  347.   unable to  import  descriptions  longer  than  250  characters  and  will
  348.   possibly run out of buffer memory if there are many lines which have file
  349.   descriptions longer than 96 characters or many comment lines. Don't panic
  350.   as I myself have many lists with 1500 files on the 1 list.
  351.  
  352.   If all goes well,  simply now run FLM2 and go into the Configuration Menu
  353.   and alter things to your liking.
  354.  
  355.   FLM  also  being  a  'Door'  program  for  your RA Bulletin Board,  would
  356.   normally be run from the directory  from  which you run the BBS software.
  357.   In a single line system this would be the \RA directory,   on  multi-line
  358.   systems this would be say \RA\LINE1
  359.  
  360.   Add to your TOP menu, either a Type 7 or Type 15 option.   On a RA system
  361.   I use the command line
  362.  
  363.       *M flm2 bbs *P *N
  364.  
  365.        where *M  tells RA to swap itself to disk before loading FLM
  366.              *P  is substituted by with the COM port number
  367.              *N  is the Node number on Multi-Line systems.  Set to 1
  368.                  if using on a single line system.
  369.  
  370.  
  371.   ─────────────────────────────────────────────────────────────────────────
  372.   ▒▒ SUBSCRIPTION SYSTEM ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  373.   ─────────────────────────────────────────────────────────────────────────
  374.  
  375.   FLM2  provides  facilities  for  a  Subscription System to be operated on
  376.   files downloaded from your BBS.    The  system  works  on the basis of an
  377.   amount  being  charged  to  the  user  per  Megabyte  or  part   actually
  378.   downloaded.    As an example I charge users 100 pence per Megabyte,  ie 1
  379.   pence per 10k The system  can  be  enabled  in the BBS Mode Configuration
  380.   screen,  and each storage area can be marked as being a Subscription Area
  381.   or not.
  382.  
  383.  
  384.  
  385.   ─────────────────────────────────────────────────────────────────────────
  386.   ▒▒ COMMAND LINE OPTIONS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  387.   ─────────────────────────────────────────────────────────────────────────
  388.  
  389.   These are the  command  line  parameters  that  can  be used when running
  390.   FLM2.   We list here only brief details for each,  they  are  covered  in
  391.   detail further into the manual.
  392.  
  393.     FLM2 HELP
  394.     FLM2 ?
  395.  
  396.          displays a Help screen detailing the Command line options
  397.          available.
  398.  
  399.     FLM2 BBS <ComPort> <NodeNumber>
  400.  
  401.          to put FLM2 into the BBS mode of operation.
  402.  
  403.     FLM2 EDITCFG
  404.  
  405.          to edit the file FLM2CFG.DTA, which contains the directory
  406.          paths to the central database and BBS directories
  407.  
  408.     FLM2 INSTALL
  409.  
  410.          to Install FLM2 for the first time.
  411.  
  412.     FLM2 VERIFYCOUNTS
  413.  
  414.          maintenance routine where FLM rechecks the Lists On counts and
  415.          the number of files and sizes per list counters.
  416.  
  417.     FLM2 SORTFILEBASE
  418.  
  419.          maintenance routine where FLM re-sorts Index file
  420.  
  421.     FLM2 RENUMBER
  422.  
  423.          routine that purges and renumbers the filebase
  424.  
  425.     FLM2 SORTLISTS
  426.  
  427.          routine that sorts the File Lists so that files are listed in
  428.          Alphabetical order on the filename
  429.  
  430.     FLM2 ADOPT
  431.  
  432.          to adopt unknown files in the selected directories, adding them
  433.          to the default lists as set for the Storage Area.
  434.  
  435.     FLM2 ADOPTALL
  436.  
  437.          to adopt unknown files from every directory, and add to the
  438.          default Lists of the Storage Area.
  439.  
  440.     FLM2 ADOPTOLD
  441.  
  442.          to adopt unknown files in the selected directories, but marking
  443.          the upload date as the system date of the file.
  444.  
  445.     FLM2 FILECHECK <nnn>
  446.  
  447.          rechecks the file size and date of files in Store # nnn
  448.  
  449.     FLM2 FILECHECK ALL
  450.  
  451.          rechecks the file size and date of files in every Storage Area
  452.  
  453.     FLM2 FILECHECK
  454.  
  455.          rechecks the file size and date of files in all Storage areas,
  456.          except those marked is being ReadOnly areas
  457.  
  458.          with the three systems above,  an additional parameter can be
  459.          added to the command line.   /D  will force FLM2 to update the
  460.          Description and Upload date of the file, if the System date of
  461.          the file is newer
  462.  
  463.     FLM2 DELETEAWAY
  464.  
  465.          will delete records of 0 byte files.  ie, those indicated as
  466.          being 'away'
  467.  
  468.     FLM2 SCAN <minutes>
  469.  
  470.          start the Automatic Virii detection system, and run for the number
  471.          of minutes specified
  472.  
  473.     FLM2 CONVERT <minutes>
  474.  
  475.          start the Automatic Archive Converting system, and run for the
  476.          number of minutes specified
  477.  
  478.     FLM2 BANNER <minutes>
  479.  
  480.          start the automatic Bannering of Archive files, and run for the
  481.          number of minutes specified
  482.  
  483.     FLM2 AF <Number>
  484.  
  485.          to create the Allfiles List specified by <Number>, if set to 0
  486.          then all of them configured are created.
  487.  
  488.     FLM2 AREALISTS
  489.  
  490.          to create nicely formated filelists in each directory
  491.  
  492.     FLM2 TOP20
  493.  
  494.          to create an ANS/ASC display of the Top 20 files downloaded,
  495.          and a summary of all the files for each Storage Area.
  496.  
  497.     FLM2 WKLYGRAPH
  498.  
  499.          to create the ANS/ASC graphs of the number and size of files
  500.          added to the filebase over last year.
  501.  
  502.     FLM2 NEWFILES
  503.  
  504.          to create a list of all the Newfiles added to the database over
  505.          the number of days configured
  506.  
  507.     FLM2 MASTER
  508.  
  509.          creates an alphabetical list of every file in database, formatted
  510.          with all details listed
  511.  
  512.     FLM2 EXPORT
  513.  
  514.          creates FILES.BBS lists as configured
  515.  
  516.     FLM2 EXPORTFLSEARCH
  517.  
  518.          creates an FLSEARCH.CTL file of the Storage Areas configured
  519.  
  520.     FLM2 EXPORTFILESRA
  521.  
  522.          creates/updates FILES.RA from Storage Area information in FLM
  523.  
  524.  
  525.   ─────────────────────────────────────────────────────────────────────────
  526.   ▒▒ CONFIGURATION MENU ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  527.   ─────────────────────────────────────────────────────────────────────────
  528.  
  529.   Whenever an external program is called by FLM2, it is usually called with
  530.   FLM2 still occupying memory in your computer.  With some smaller programs
  531.   that don't need say more than 100k of memory to run this  is  fine.    If
  532.   more memory is required to run an external program, FLM2 has the facility
  533.   to  swap itself out of main memory to either EMS/XMS or Disk.   To enable
  534.   this feature,  simply add a  +  character  as  the first character of the
  535.   command line.
  536.  
  537.  
  538.   ▒▒ FILE STORAGE ▒▒
  539.  
  540.   Before files from a directory can be added to the filebase,  you need  to
  541.   create  a record for the storage directory/area where the files are kept.
  542.   Each directory normally  has  a  default  List  linked  to  it> These are
  543.   created in the config/Lists.
  544.  
  545.   Ammend the options available on this screen to suit your setup.
  546.  
  547.    Store Tag Name   : a 20 character  name for this store,  used as a short
  548.                       descriptive name.   This TagName isn't fully used yet
  549.                       but  is  reserved  for future enhancements.   For the
  550.                       moment it is used to identify the area on some of the
  551.                       reports.
  552.  
  553.    Storage Path     : full  path to the directory where files are stored in
  554.                       this area.   FLM2  will  check  that  the  directory
  555.                       exists and offer to create it if needed.  The Storage
  556.                       area is expected to be a directory, not a path to the
  557.                       Root of the drive.
  558.  
  559.    Is Media Online  : Yes or No.   If  you  specify No,  then any operation
  560.                       requiring access to  files  in  this  Store  will  be
  561.                       denied.
  562.  
  563.    Is Media ReadOnly: Yes or No.   If you specify No, then copying files to
  564.                       this  store,   or  changing the files already in this
  565.                       store will be denied.
  566.  
  567.    Download SecL    : Specify the security level the users are required
  568.    Download Flags   : to have to be able to download files stored in here.
  569.  
  570.    Viewing SecL     : Specify the security level the users are required to
  571.    Viewing Flags    : have to be able to see the files stored in this area.
  572.  
  573.    Adopt files from : if  Yes,  then this Store will be checked for unknown
  574.           this area : files and any new ones added to the database.
  575.  
  576.    Export to        : if Yes, FLM will create a standard format description
  577.     Files.BBS         file.  This file is not physically required  by FLM2,
  578.                       but is  required  by  other  programs  that  need  to
  579.                       access the files in your filebase. Ie. your mailer.
  580.  
  581.  
  582.    Default List No  : set to the List where the files in this Storage  Area
  583.                       would  normally  be  listed.   This is primarily used
  584.                       when FLM2 is adopting  files,  it needs to know which
  585.                       List to put the files on.
  586.  
  587.  
  588.    Subscription Area: set to No if you're not using the subscription system.
  589.  
  590.    Include on Report: if set to  YES,   then  the  files  in this area will
  591.                       included in the Newfiles and Top20 reports.
  592.  
  593.    Preferred Archive: after you've defined the ARChive  programs  you  have
  594.                       available,   set  this  to  the one preferred for the
  595.                       files  stored in this Area.
  596.  
  597.  
  598.    Throughout this screen, the following Keys are available to you:
  599.  
  600.      ESC    - quits from this screen and saves the information as currently
  601.               set.
  602.  
  603.       F1    - brings up a Help Screen for the area.
  604.  
  605.       F2    - brings up a Pick List screen,  showing all the Storage  Areas
  606.               so  far  defined.    Use  your cursor keys to move to another
  607.               Area,  press Return and FLM2 will immediately bring that Area
  608.               onto the screen.
  609.  
  610.       F6    - allows you to define a new Storage Area to your filebase.
  611.  
  612.       F8    - allows you  to  delete  this  Storage Area from  the FLM2
  613.               filebase.
  614.  
  615.      F10    - makes FLM2 scan through the files stored in this Area, and
  616.               add unkown files to the database.
  617.  
  618.  
  619.  
  620.   ▒▒ FILE LISTS ▒▒
  621.  
  622.   Having defined the Storage Areas where your files are kept,  we  can  now
  623.   create Lists which are actually displayed to the user.
  624.  
  625.   List Tag Name   :  a 20 character short description for this list.   This
  626.                      TagName is used on the reports to identify this List.
  627.  
  628.   List Title      :  a longer description  or  Title  for this List.   This
  629.                      Title is used as the header at the  beginning  of  the
  630.                      list.
  631.  
  632.   List SecL       :  this  is  the  security  levels the user needs to have
  633.   List Flags      :  before this List will be  offered to them as an option
  634.                      on a Menu.
  635.  
  636.   Default Store   :  set to the Storage Area this List is linked to.   This
  637.                      is used by FLM2 when you are  editing  the  Lists  and
  638.                      moving  files  from  List to List.   The default Store
  639.                      defines what Storage Area is used.
  640.  
  641.   After defining a List,   you  need  to  initialise  or  create it from an
  642.   existing FILES.BBS file by pressing the F10 key.    You'll  notice  after
  643.   doing  this  that  the Title line appears on a line in the second half of
  644.   the screen.   This is the description now  used as the Title to the list.
  645.   You can alter this by pressing the F8 key.
  646.  
  647.  
  648.    Throughout this screen, the following Keys are available to you:
  649.  
  650.      ESC    - quits from this screen and saves the information as currently
  651.               set.
  652.  
  653.       F1    - brings up a Help Screen.
  654.  
  655.       F2    - brings up a Pick List  screen,   showing all the Lists so far
  656.               defined.  Use your cursor keys to move to another List, press
  657.               Return and FLM2 will immediately bring  that  List  onto  the
  658.               screen.
  659.  
  660.       F5    - allows you to define a new List.
  661.  
  662.       F8    - allows you to alter the List Header Title, shown in the lower
  663.               half of the screen.
  664.  
  665.      F10    - makes FLM2 create & initialize a new List.
  666.  
  667.  
  668.    When creating a new file area,  first setup a Sorage Area then enter the
  669.    details above for the List.   After  the  two have been linked using the
  670.    default Store / default List  fields  press  F10  in  the  Lists  Config
  671.    screen.    Flm2  will  create a blank List file.   If you have defined a
  672.    Files.BBS file in the associate Storage Area, and that file exists, FLM2
  673.    will read through it and create  a  List based on it,  adding the listed
  674.    files to the database.
  675.  
  676.  
  677.   ▒▒ MENUS ▒▒
  678.  
  679.   Here you are able to setup the Menus which provide users with the options
  680.   to select which Lists to view.   You can have upto 256  different  Menus,
  681.   and  200  options  are  available  on each Menu.   If you use an existing
  682.   RA/Qbbs file system, then you could have the entire RA file system on one
  683.   Menu.   Creating a Menu structure with  Sub-Menus enables you to split up
  684.   your filebase as shown to the user.   Sub-Menus work in a tree like style
  685.   whereby a Sub-Menu always provides access back to the Menu from which  it
  686.   was called.
  687.  
  688.   When  a  Menu is defined all options will be available to you as sysop in
  689.   the Viewer/Editor section on FLM2,   but  when  the user is accessing the
  690.   Menu the options are only available if the users Security  Level  matches
  691.   that  as  specified  in  the  List  of the option.   The numbering of the
  692.   options are re-calculated everytime the  Menu  is  shown to the user,  so
  693.   although Option 1 might be List 1, if  the  user  doesn't  have  security
  694.   access  to  List  1 then Option 1 will then become the first List defined
  695.   that the user does have access to.
  696.  
  697.  
  698.   An example of the Config Screen:
  699. ╔════════════════════════════ Menus Configuration ══════════════════════════╗
  700. ║ Menu Number         :   0  File Library Manager List Menu                 ║
  701. ║ Menu Security Level :   5                                                    ║
  702. ║ Menu Security Flags : A -------- B -------- C -------- D --------            ║
  703. ║ Customized Display  : No        number of Screens   :   3                 ║
  704. ║ Dual Display        : Yes       Vertical numbering  : Yes                 ║
  705. ║                                                                           ║
  706. ║   L  1L 13L 25L 37L 49L 61L 73L 85   0   0   0   0   0   0   0   0   0    ║
  707. ║   L  2L 14L 26L 38L 50L 62L 74L 86   0   0   0   0   0   0   0   0   0    ║
  708. ║   L  3L 15L 2╔════╗────────────────────────────────╖ 0   0   0   0   0    ║
  709. ║   L  4L 16L 2╟L 40║ indicates List 48              ║ 0   0   0   0   0    ║
  710. ║   L  5L 17L 2╚════╝────────────────────────────────╜ 0   0   0   0   0    ║
  711. ║   L  6L 18L 30L 42L 54L 66L 78L 90   0   0   0   0   0   0   0   0   0    ║
  712. ║   L  ╔════╗──────────────────────┐   0   0   0   0   0   0   0   0   0    ║
  713. ║   L  ║M  2║ indicates Sub-Menu 2 │   0   0   0   0   0   0   0   0   0    ║
  714. ║   L  ╚════╝ ─────────────────────┘   0   0   0   0   0   0   0   0        ║
  715. ║   L 10L 22L 34L 46L 58L 70L 82M  1   0   0   0   0   0   0   0   0        ║
  716. ║   L 11L 23L 35L 47L 59L 71L 83   0   0   0   0   0   0   0   0   0        ║
  717. ║   L 12L 24L 36L 48L 60L 72L 84   0   0   0   0   0   0   0   0   0        ║
  718.  
  719.  
  720.   First create the options which will be available on this Menu.  These are
  721.   defined in the bank of 200  options  which  initially are set to 0, ie no
  722.   option specified.   Each option can be set so that either  a  List  or  a
  723.   Sub-Menu  is displayed to the user.   These states are represented by the
  724.   letters L or M next to the number.
  725.  
  726.   To configure the Menu,  move the Highlight Bar to an option,  then to set
  727.   the option to a List,  you would press  F5 to bring up a Pick List of all
  728.   the Lists.   From here,  select a specific List and  then  press  Return.
  729.   This will then set that option to the List that you chose.
  730.  
  731.   To  create a Sub-Menu,  then press F7.   This will bring up a fresh Blank
  732.   Menu,  you will notice that the  Menu number will have automatically been
  733.   chosen to be the next one available.   You would configure this  sub-menu
  734.   as you like.   After finishing, press ESC and you will be returned to the
  735.   previous Menu.
  736.  
  737.   The keys available when cursor is in one of the 200 options are:
  738.  
  739.      ESC - quit from the screen and save the Menu.
  740.  
  741.       F1 - a Help screen
  742.  
  743.       F2 - a Pick List of all the Menus so far setup, and you can jump to
  744.            any directly.
  745.  
  746.       F5 - sets this option to a List, and brings up a Pick List of the
  747.            defined Lists for you to choose which one.
  748.  
  749.   Alt+F5 - to setup all the options to all the Lists you have.
  750.  
  751.       F7 - sets  this  option  as a Sub-Menu.   If it is already defined as
  752.            one,  then that Sub-Menu is  brought onto the screen,  otherwise
  753.            the next available Menu number is used and a Blank Sub  Menu  is
  754.            displayed.    A  link  is  made between the calling Menu and the
  755.            Sub-Menu so that a route back is available.
  756.  
  757.       F8 - brings up a list of the Sub-Menus already defined so that you can
  758.            select one for this option.
  759.  
  760.   InsKey - inserts blank option at this position.
  761.  
  762.   DelKey - deletes the Highlighted option.
  763.  
  764.      F9  - enables you to edit the description given to that option
  765.  
  766.      F10 - enables you to select the colour of the description line.
  767.  
  768.  
  769.   FLM2 will create it's own screen which is displayed to the users, however
  770.   you are able to create  your  own  ANS/ASC  screens and have FLM2 display
  771.   these instead.  To use your own self designed screens, set the Customised
  772.   Display question to Yes.   You can also specify the number of screens you
  773.   have desinged to cover the number of options on this 1 Menu.
  774.  
  775.   Then  locate in the \FLM2DATA directory the ANS/ASC screens that you have
  776.   created.   Keep the displays to less than  23 lines so as not to mess the
  777.   screen up.   The files will  need  to  be  named  very  strictly  to  the
  778.   following system:
  779.  
  780.     Filenames are to be in the form    M-xxx-yyy.A??
  781.  
  782.       xxx   represents the Menu Number with no leading 0's
  783.       yyy   represents the Screen Number with no leading 0's
  784.  
  785.       so as an example,  if you specify that Menu 0  (the Top Menu) is
  786.       customised,  and that there is only 1 screen.   Then you will need 2
  787.       display files available.
  788.  
  789.     M-0-1.ANS      and      M-0-1.ASC
  790.  
  791.    When creating your own screens,  remember that you will need to show all
  792.    the  options that FLM2 will physically make available.   Particularly be
  793.    carefull with the  numbering  of  the  options.   FLM2 re-calculates the
  794.    option numbering for each user depending on the secuirty  level  of  the
  795.    user at the time of loading the Menu.
  796.  
  797.    I  have  included as an example,  the screen I have been using on my BBS
  798.    here.   You are free to use these screens for yourself,  just change the
  799.    name of the Bulletin Board.
  800.  
  801.  
  802.   ▒▒ PROTOCOLS ▒▒
  803.  
  804.   FLM2 uses third party protocol engines for downloading and uploading.  My
  805.   personal favourite is DSZ.COM,   which  provides  the Xmodem,  Ymodem and
  806.   Zmodem protocols.   You can configure up to 30 protocols,  and  FLM2  has
  807.   been  designed  to  allow  the  use  of  any  of  the  different programs
  808.   available.
  809.  
  810.   Because the protocols are external  to  FLM2,  there has to exist methods
  811.   for FLM2 to  tell  the  program  it's  calling  what  files  need  to  be
  812.   transfered either Received or Sent, and likewise there need to be methods
  813.   for FLM2 to determine whether the files have indeed been sent or received
  814.   correctly.
  815.  
  816.   Effectively, all protocols are given instructions what to transfer either
  817.   via the Command Line when calling the program, or by the use of a Control
  818.   File.  On return, all protocols either exit with an ErrorLevel to signify
  819.   a  successful  transfer or by creating a Logfile which indicates what was
  820.   transfered.  FLM2 can operate with any of these methods.
  821.  
  822.   When  setting  up  the  protocols  for  your  system,   PLEASE  read  the
  823.   documentation of the protocol  you  are  using.   They all have different
  824.   command line directives,  and you'll  need  to  be  familiar  with  their
  825.   operation in order for transfers to be succesfull.
  826.  
  827.   Enclosed  in  the distribution archive is a file PROTOCOL.FLM Locate this
  828.   file in the \FLM2DATA directory.    These  are the configurations for the
  829.   protocols I currently use on my BBS.   They have been tried here and seem
  830.   to work Ok.  You can use the same if you like, but you may need to change
  831.   the path to the one  where  you  have  your  protocol  programs  located.
  832.   Please note,  the command 'restrict' in the U/L command lines for the DSZ
  833.   protocols,   is  only  available  to registered users of the DSZ program.
  834.   Remove it if you are not yet a registred user of DSZ.   It's action is to
  835.   prevent remote sites from specifying which  directory the files are to be
  836.   received into, this being an important security measure.
  837.  
  838.  
  839.   Selection     : is the character the user needs to press to choose
  840.   Character       this protocol
  841.  
  842.   Description   : give a 30 character description for the protocol
  843.  
  844.   U/l command   : specify the full path and name and command line to invoke
  845.          line     the protocol program in receiving files from  the  remote
  846.                   site.
  847.  
  848.   D/l command   : specify the full path and name and command line to invoke
  849.          line     the protocol program in sending files to the remote site.
  850.  
  851.    in  the  command  line,  the following codes can be inserted and will be
  852.    substituted by FLM2 with the relevent information at the time
  853.  
  854.    *P     will be substituted with the COM port number currently being used
  855.  
  856.    *F     will be substituted with the path and filename of the file to send
  857.  
  858.    *D     will be substituted with the directory name FLM2 wishes any
  859.           received files to be stored.
  860.  
  861.  
  862.    FLM2 creates a unique  upload  directory  for  each  user,  based on the
  863.    record Number of the  user.    The  directory  names  are  of  the  form
  864.    FLMnnnnn.RCV  where  nnnnn is the users record number.   This allows the
  865.    situation of failed uploads being able to continue for that user.
  866.  
  867.   Use Control File  : if set to  YES,   FLM2  will  create  a  file for the
  868.                       protocol program,  listing the files which are to  be
  869.                       transfered.
  870.  
  871.       Control File  : specify  the  filename of the Control File FLM2 is to
  872.           Filename    create.  Normally this filename is also listed on the
  873.                       command line when calling the protocol.
  874.  
  875.        U/L Control  : some protocols,  in  addition  to  the list of files,
  876.             String    require a Control  String  to  be  added  before  the
  877.                       filename.  ie: SEND c:\files\Filename.zip add to this
  878.                       field  the  Control  String  required  to  invoke the
  879.                       protocol in receiving  files  from the remote.   Note
  880.                       that DSZ doesn't need it, so you can leave it blank.
  881.  
  882.        D/L Control  : the Control String required to invoke the protocol to
  883.             String    send files to the remote site.
  884.  
  885.    Batched transfers: some protocols such as Zmodem,  can send more than  1
  886.                       file  on  each call,  this is termed Batch Transfers.
  887.                       Set to Yes,  if it applies to this protocol, and FLM2
  888.                       will list  more  than  file  on  the  command line or
  889.                       Control File,  if the user has requested more than  1
  890.                       file to transfer.
  891.  
  892.  
  893.    Use Log File     : if  set  to  NO,   then  FLM2  will  require that the
  894.                       protocol Exit with an Errorlevel to indicate that the
  895.                       transfer was successfull.   If set to YES,  then FLM2
  896.                       will read the log  file  specified to determine which
  897.                       files have been transfered Ok.
  898.  
  899.  
  900.       Log filename  : the complete path and  name  of  the Logfile that the
  901.                       protocol  will  create.    You  can  also get FLM2 to
  902.                       obtain the filename if  you have already specified it
  903.                       in an environment variable required by the  protocol.
  904.                       To do this,  simply put a '*' as the first character,
  905.                       and then the environment variable.
  906.  
  907.                       ie.  *DSZLOG
  908.  
  909.                       to enable DSZ to  use  the  same,  you would have set
  910.                       this is your startup batch file.
  911.  
  912.                       ie SET DSZLOG=c:\DSZ.LOG
  913.  
  914.  
  915.       The next two options specify a string sequence FLM2 is to look for at
  916.       the beginning of each line in the logfile, that indicates the success
  917.       of the transfer.   Case is important.
  918.  
  919.       U/L Keyword   : set this to a string sequence which FLM  can  use  to
  920.                       recognise an  Upload  was performed succesfully.
  921.                       From  the  logfile  shown below, Z would be used.
  922.  
  923.       D/L Keyword   : set this to a string sequence which FLM  can  use  to
  924.                       recognise that a download was successfully done.
  925.  
  926.  
  927.       The  next 2 options specify which word number from the Logfile,  FLM2
  928.       can find the filename transferred, and the speed of the transfer.  An
  929.       example of a DSZ logfile is shown.  I've indicated with the numbers 1
  930.       to 12,  how the logfile  is  split  up.   The word number referred to
  931.       above,  would be one of these numbers.   In other words, which column
  932.       FLM2 can find the information it needs.
  933.  
  934.       Word Numbers:
  935.       1    2     3    4   5    6    7   8        9  10    11     12
  936.  
  937.       Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  938.       Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  939.                           │
  940.       │                   └ Efficiency (ie word 5)
  941.       │                                                  │
  942.       └ U/L or D/L Keyword      Keyword for Filename     │
  943.                                    (ie word number 11)   ┘
  944.  
  945.  
  946.      Keyword No.    : this  field  requires  a number,  which indicates the
  947.         for Name      column  in  the  logfile  where  FLM  will  find  the
  948.                       filename of the file transfered.
  949.  
  950.       Keyword No.   : this field requires  a  number,   which indicates the
  951.         for Efcy:     column  in  the  logfile  where  FLM  will  find  the
  952.                       transfer rate achieved.   The result is  expected  in
  953.                       CPS.
  954.  
  955.  
  956.       Two-way       : set   to   YES,    only   if  this  protocol  can  do
  957.         transfers     bi-directional  transfers.     such   as  HSLINK  and
  958.                       BiModem.
  959.  
  960.       Efficiency %  : set to the approximate efficiency  of  the  protocol.
  961.                       FLM will use this field,  with the current baud rate,
  962.                       to calculate how long the transfer will take.
  963.  
  964.  
  965.   If  you  specify  not  to use the logfile,  then FLM will ask for an Exit
  966.   Errorlevel to look for from the  protocol to determine the success of the
  967.   transfer.  It's usually not a good idea to use this method with protocols
  968.   that can do Batch transfers.
  969.  
  970.   Note,  that the example included,  PROTOCOL.FLM,   was  designed  for  my
  971.   multi-line BBS.   If running on a single line,  you'll need to change the
  972.   Logfile  name,  by removing the *N.   Most failed transfers exist because
  973.   the filename given to FLM2 doesn't match up with the one your protocol is
  974.   creating.  You will see that this is recorded in the FLM2 Logfile, so you
  975.   can help resolve an problems.
  976.  
  977.  
  978.  
  979.   ▒▒ ARCHIVERS ▒▒
  980.  
  981.   You can specify up to 30 Archiving systems.   First specify the Extension
  982.   that FLM2 is to look for to recognise that this file is an ARChived file.
  983.   Then specify the  command  lines  to  use  for  each  of the 5 situations
  984.   listed.
  985.  
  986.     Pack Command Line   : command line to Pack Up file, without directory
  987.                           pathnames.
  988.  
  989.     Pack Command Line   : command line to have archiver Pack Up files
  990.          with Paths       including recursing into directories and storing
  991.                           path names in ARChive.
  992.  
  993.     UnPack Command Line : command line to have archiver Unpack files,
  994.                           without creating any directories stored in
  995.                           archive.
  996.  
  997.     UnPack Command Line : command line to have archiver UnPack files,
  998.         with Paths        including creating directories stored in archive.
  999.  
  1000.     Delete from Archive : command line to have archiver delete files
  1001.         Command Line      from archive.
  1002.  
  1003.  
  1004.   Finally,  you have the option of specifying a Command Line to  Banner  an
  1005.   archive.
  1006.  
  1007.    on  each  of  the  command lines,  you can specify the following control
  1008.    codes,  which FLM  will  substitute  with  the required information when
  1009.    called:
  1010.  
  1011.      *F     will be substituted with the full path and filename of the
  1012.             archived file.
  1013.      *L     will be substitured with the files or list of files that are to
  1014.             be packed, unpacked or deleted.
  1015.  
  1016.   I have included an example setup,  ARCHIVER.FLM,  however you can change
  1017.   this to suit your preferances.
  1018.  
  1019.  
  1020.   ▒▒ EXTERNALS ▒▒
  1021.  
  1022.   FLM2 provides you with the  ability  to specify upto 10 external programs
  1023.   to run on any file in your filebase.   These are  used  be  pressing  the
  1024.   Shift+F?   keystrokes, where ?  is the Function Key number, when the file
  1025.   is highlighted in the Viewer/Editor.
  1026.  
  1027.   Specify the Command Line to use for this external program.  The following
  1028.   control  codes  are  available  and  substituted  when  called  with  the
  1029.   appropriate information.
  1030.  
  1031.     *P    the complete path to the file in your filebase (NB. a trailing
  1032.           Backslash is not provided)
  1033.  
  1034.     *F    the Filename only.
  1035.  
  1036.       - therefore if you want to specify the complete path+filename
  1037.         use  *P/*F
  1038.  
  1039.   You  can  specify the Extension the file has to have before this external
  1040.   is called.   This is more usefull  on  say  image files which can only be
  1041.   called with a certain image viewer.
  1042.  
  1043.  
  1044.   ▒▒ SYSTEM OPTIONS ▒▒
  1045.  
  1046.   This set of options,  don't quite  fit  into  any  of  the  other  config
  1047.   screens.
  1048.  
  1049.   Newfiles Filename : FLM2  can create a list of the newfiles added to your
  1050.                       filebase.   Specify here  the  name  of  the file FLM
  1051.                       should create.
  1052.  
  1053.   Days back for New : and specify how many days back FLM is to report on.
  1054.  
  1055.   Files Not         : you can list up to 9 files, Wildcard specification is
  1056.    to Adopt:          acceptable,  which FLM will not adopt to the filebase
  1057.                       if you have these  files  in  the  directory  of  the
  1058.                       Storage  Area.   As a default,  we have set it to not
  1059.                       adopt FILES.BBS *.BAK and *.DIR files.
  1060.  
  1061.   Extensions to     : These are the extensions files must have before FLM2
  1062.          Convert      will attempt to convert them into another archive
  1063.                       format.
  1064.  
  1065.   Extensions Not    : FLM2 has the facility to convert archive formats at a
  1066.       to convert      keystroke.  However, there are some files you may not
  1067.                       want converted.    Specify  upto  10  file Extensions
  1068.                       which FLM2 is not to attempt to try convert.
  1069.  
  1070.   Counts on         : if YES,  Flm2  will  add  download  counters  to  the
  1071.     Files.bbs         Files.bbs  when  it  is  asked to export the filebase
  1072.                       details to these files.
  1073.  
  1074.   Upload Store      : specify the Storage Area that uploaded files will
  1075.                       be put.
  1076.  
  1077.  
  1078.   ▒▒ BBS OPTIONS ▒▒
  1079.  
  1080.   Minimum           : specify in bytes, the minimum Disk space that must be
  1081.   Disk Space:         available on the local  drive  to enable FLM to allow
  1082.                       an upload to go ahead.
  1083.  
  1084.   Max files to d/l  : specify the Maximum number of files a user is allowed
  1085.                       to download in one call to the  protocol.    This  is
  1086.                       mainly  of  use to limit users who attempt to specify
  1087.                       downloading *.* as a default it is set to 100.
  1088.  
  1089.   Ul Time           : after a user has uploaded files to you, this ratio is
  1090.   Ratio Credit:       used to award the  time  spent  uploading back to the
  1091.                       user.
  1092.  
  1093.   Check upload      : there are three  options  available,   toggle each by
  1094.          dupes:       pressing the Return key.
  1095.  
  1096.                       'ask user' - FLM2 will  ask  the  user  whether  they
  1097.                                    would  like  to  check  whether the file
  1098.                                    they are going  to  upload is already in
  1099.                                    the filebase.
  1100.  
  1101.                       'don't check' - FLM2 will  proceed  with  the  upload
  1102.                                       without  checking  if  the file being
  1103.                                       uploaded is a duplicate.
  1104.  
  1105.                       'force check' - FLM2  will  ask  the  user  for the
  1106.                                       filename they  are  uploading,   and
  1107.                                       check  to  see  if  it is already in
  1108.                                       your filebase.
  1109.  
  1110.  
  1111.   Withold           : if YES,  Flm2  will  re-check  to  see that the files
  1112.    Credit/Dupes       received are not already in your filebase,  and  will
  1113.                       not credit the user if they are.
  1114.  
  1115.  
  1116.   Use Charging      : if  YES,   this  will  enable the subscription system
  1117.         System        built into FLM2.    also  specify  the Charge per Meg
  1118.                       downloaded,  the Credit per Meg for uploads  and  the
  1119.                       description  of the unit being used.   I've defaulted
  1120.                       the unit to pence,  but you could change it to points
  1121.                       to enable a ratio type system on your board.
  1122.  
  1123.   Allow             : if YES,  then  before  download transfers start,  FLM
  1124.    Auto-Logoffs       will  ask  the  user  if  they  would  like  FLM   to
  1125.                       automatically  log  them  off  when  the transfer has
  1126.                       finished.
  1127.  
  1128.   Upload Security Lev : specify the security level the user must have before
  1129.   Upload Security Flgs: they will be allowed to upload to your system.
  1130.  
  1131.  
  1132.   You can also configure the descriptions and selection keys to use on many
  1133.   of the menu options available to the users.  Use the TAB key to move from
  1134.   the selection Character to the Description of that Option.
  1135.  
  1136.  
  1137.   ▒▒ BBS COLOURS ▒▒
  1138.  
  1139.   You can configure the colours  used  by  FLM2  in  many of the text lines
  1140.   displayed to the user.
  1141.  
  1142.   Use the PageUp and PageDown keys to move up and down  the  text  prompts.
  1143.   To alter the colour, use the Colour Selector, moving around the available
  1144.   colours  with  your cursor keys.   To select the colour,  press the Enter
  1145.   key.
  1146.  
  1147.   If all doesn't go well, you can always go back to the default by pressing
  1148.   F1 function key.
  1149.  
  1150.  
  1151.   ▒▒ ALLFILES LISTS ▒▒
  1152.  
  1153.   You are able to specify upto  20  Allfiles Lists which FLM can create for
  1154.   you.   These Allfiles Lists are  usually  made  available  for  users  to
  1155.   download  and view offline.   Being able to create 20 varieties means you
  1156.   can have subsets of your  filebase,   say  one for all the Windows Files,
  1157.   another for all the Games.
  1158.  
  1159.   The specification of what to have on the Allfiles  List  is  exactly  the
  1160.   same  as the specification of your Menus.   You are able to have upto 200
  1161.   areas on each Allfiles List.
  1162.  
  1163.   First, specify a TagName.  This TagName is used to identify a Header file
  1164.   which is simply a text based file,  say a logo for your BBS, which can be
  1165.   added to the beginning of an Allfiles List when it is created.   If there
  1166.   is a file in the  FLM  Data  Directory  of  the  same name as the TagName
  1167.   specified and with the extension .HDR,  then this file will be  added  to
  1168.   the top of the Allfiles List created.
  1169.  
  1170.   Then  specify the Path and Filename of the file to be created.   And then
  1171.   the age of the files to be included in the report, specified as days old.
  1172.  
  1173.   The bank of 200 options are used  to  define which of your File Lists are
  1174.   to be used to make up this Allfiles List.   Initially all the options are
  1175.   set to 0 indicating no List specified.   In the same way that  the  Menus
  1176.   are created, highlight one of the options and press F5 to select from one
  1177.   of your File Lists.   To quickly set up an Allfiles List, press Alt+F5 to
  1178.   set all the options to all the File Lists.   As required,  you can delete
  1179.   or insert File Lists by using the Delete and Insert keys.
  1180.  
  1181.  
  1182.   The  actual  creation  of the Allfiles Lists is done by running FLM2 with
  1183.   the command line AF
  1184.  
  1185.   ie:  to create Allfiles List No. 1  then the command line would be
  1186.  
  1187.        FLM2 AF 1
  1188.     or FLM2 AF 0   to create all of them
  1189.  
  1190.  
  1191.   ▒▒ DRIVE REDIRECTIONS ▒▒
  1192.  
  1193.   FLM has the facility of altering the Drive letter in the Storage Path
  1194.  
  1195.   If you're running the BBS  on  a  network with multiple servers,  you may
  1196.   have configured your Network so that the Workstations use different Drive
  1197.   Letters as to the Host machine.   In this situation,   when  using  FLM's
  1198.   central database the Drives letters on the host  would  be  different  to
  1199.   those on the workstations.  To have FLM redirect, or think it is to use a
  1200.   different drive letter,  simply set the drive letters that are to be used
  1201.   by the workstation.
  1202.  
  1203.   This is set, by running
  1204.  
  1205.     FLM2 editcfg     on each of the workstations, and set the drive letters
  1206.                      that apply for that workstation.   This redirection of
  1207.                      drive  letters  is only applied by FLM2 to the Storage
  1208.                      Area paths.
  1209.  
  1210.  
  1211.   ─────────────────────────────────────────────────────────────────────────
  1212.   ▒▒ VIEWER/EDITOR ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1213.   ─────────────────────────────────────────────────────────────────────────
  1214.  
  1215.   The Viewer/Editor section  of  FLM  is  the  core  of your management and
  1216.   viewing of your filebase.   There are two parts to it,  the Global  Lists
  1217.   and  the File Lists.   The Global Lists show every file in your filebase,
  1218.   either in  alphabetical  or  numerical  order.    The  numerical order is
  1219.   usefull as it's also the order in  which  the  files  are  added  to  the
  1220.   filebase, thus if you want to see quickly what the latest files are, they
  1221.   will always be at the bottom of the numerical list.
  1222.  
  1223.   In  both  sections full facilities are provided to inspect and manage the
  1224.   files in the filebase.   Most  keystrokes  are similar in both the Global
  1225.   List and File List, although there are some subtle differences on some.
  1226.  
  1227.  
  1228.   The selection of any of your File Lists is done by moving  the  highlight
  1229.   bar  to  that  List then pressing Return,  or by typing the number of the
  1230.   list.  Selecting the Global Lists is done by pressing:
  1231.  
  1232.     F1  -  for the Alphabetical List
  1233.     F2  -  for the Numerical List
  1234.  
  1235.   If you have setup up Sub-Menus  for  your filebase,  you will notice that
  1236.   those options are displayed in Yellow,  and selecting a  Sub-Menu  option
  1237.   takes you to that Sub-Menu.
  1238.  
  1239.   Pressing  the  ESCape  key,   will  always exit the current screen to the
  1240.   previous Menu or screen.
  1241.  
  1242.  
  1243.   We'll now introduce you to each of these sections,  note that most of the
  1244.   keystrokes described in the Area Lists  are also applicable in the Global
  1245.   Lists.  So we'll only cover the differences in that section.
  1246.   Then  we'll  briefly describe how to perform some of the usual operations
  1247.   one normally does to manage your filebase and Lists.
  1248.  
  1249.  
  1250.   ▒▒ AREA LIST ▒▒
  1251.  
  1252.   After selecting a list to view,  from the Menu Selection screen, the List
  1253.   selected is displayed on the screen.    The  Top Line shows the List Name
  1254.   and a count of the files and size of the files on that list.   The second
  1255.   line shows the headings of the information being displayed at the time.
  1256.  
  1257.     A Help screen is available at anytime by pressing  F1
  1258.  
  1259.   There are currently,  six screens available  for  you  to  view  all  the
  1260.   information  known  on  each  file.   You can select these six screens by
  1261.   simply pressing the numbers 1 to  6,  or you can circle thru the displays
  1262.   by using Ctrl+RightCursor or Ctrl+LeftCursor keystrokes.
  1263.  
  1264.   All six screens will show the FileNumber and the  Filename  and  the  Tag
  1265.   indicator if the file has been tagged.  In addition, the six screens show
  1266.   the following:
  1267.  
  1268.    Display 1 : FileSize in Kilobytes,  File Description.   This screen is
  1269.    exactly the same as would be seen by your users in the BBS mode.
  1270.  
  1271.    Display 2 : Archive Explosion, a blue window will show on the right side
  1272.    and the program will show the  contents  of  the file if an ARChive,  or
  1273.    detailed Size, Time and Date details if not.
  1274.  
  1275.    Display 3 : FileSize in bytes, Date of the File as per DOS, the date the
  1276.    file was added or uploaded to the filebase and the  Directory  in  which
  1277.    the file is stored.
  1278.  
  1279.    Display 4 : The Name of the person who uploaded the file,  or 'Sysop'
  1280.    will show if the file was  adopted.    The  number of times the file has
  1281.    been downloaded, and the last date that the files was downloaded.
  1282.  
  1283.    Display 5 : The status of the three control Flags.  Initially 'Untested'
  1284.    and 'Unbannered' will show,  but as you  use  the  facilities  to  Virus
  1285.    Check,   Archive  convert  and Archive Banner,  then these displays will
  1286.    change to show what operations have been done on the files so far.
  1287.  
  1288.    Display 6 :  Download History,  shows  the name,  Date & Time,  Download
  1289.    Length and CPS rate for every occasion that this file was downloaded.
  1290.  
  1291.  
  1292.   Each line displayed is either a Comment Line or a File Line.   Using your
  1293.   cursor keys,  you are able to move the Highlight Bar  up  and  down  your
  1294.   list.
  1295.  
  1296.           UpArrow   - move up one line
  1297.         DownArrow   - move down one line. if you attempt to move down
  1298.                       beyond the bottom of the list, Flm2 will ask if
  1299.                       you want to add a Blank line to the bottom.
  1300.            PageUp   - move upwards one complete screen
  1301.          PageDown   - move downwards one complete screen
  1302.          Home       - move cursor to the top line of screen
  1303.           End       - move cursor to the bottom line of screen
  1304.         Ctrl+Home   - move cursor to the Top of the List
  1305.          Ctrl+End   - move cursor the last line of the List
  1306.  
  1307.   To  Edit  any line,  press the RETURN key.   The highlight bar and cursor
  1308.   will move to the beginning of  the  text to be edited.   Press the RETURN
  1309.   key again to finish the editing of the text.   Initially,  you are always
  1310.   put into an Overwrite mode where all characters typed will overwrite  any
  1311.   that were there before.  You can change into the Insert mode, by pressing
  1312.   the INSert key, and a large block cursor will show.  Pressing the END key
  1313.   will move to the end of the text,  likewise the HOME key will move to the
  1314.   beginning.
  1315.  
  1316.   You are able to  define  the  colour  of  a  comment.   While editing the
  1317.   comment line,  press F10 and a colour selector will show.   Choose one of
  1318.   the colour combinations and select it by pressing the RETURN key.
  1319.  
  1320.  
  1321.   The following keys are available to edit the List.
  1322.  
  1323.            I      - insert a Blank line at the current position
  1324.  
  1325.            D      - delete current line. FLM2 will ask if you want to
  1326.                     Physically delete this file.  If you say 'No', then FLM
  1327.                     will move  the  deleted  line  to  the ScrapList.   The
  1328.                     bottom of the screen will indicate the  status  of  the
  1329.                     ScrapList,   and  the  last file copied or deleted will
  1330.                     show on the status line.
  1331.  
  1332.            C      - copy current line to the ScrapList.
  1333.  
  1334.            R      - restore the current line in the ScrapList indicated
  1335.                     at the bottom of the screen, into the List at the
  1336.                     current position.
  1337.  
  1338.            W      - switch the display to the ScrapList. yo'll notice that
  1339.                     the  display  at  the  bottom  now becomes the List you
  1340.                     were previously looking  at.    To switch back,  simply
  1341.                     type W again.   When the  ScrapList  is  on  screen  it
  1342.                     behaves  like  any  other list.   Thus all the keys are
  1343.                     available,  although it's safer  not to use the Delete,
  1344.                     Copy fuctions as they will simply copy and delete files
  1345.                     to your proper List.
  1346.  
  1347.            +      - mark the start of a block
  1348.  
  1349.            -      - mark the end of a block
  1350.  
  1351.            *      - if current line is on a file, then a block will be
  1352.                     marked of all the files upwards until a comment line
  1353.                     and downwards of all files until a comment line
  1354.  
  1355.            Ctrl+D - delete the block to the ScrapList
  1356.  
  1357.            Ctrl+C - copy the block to the ScrapList
  1358.  
  1359.            Ctrl+R - restore a block in the ScrapList to the current
  1360.                     position.
  1361.  
  1362.            Ctrl+N - delete the ScrapList
  1363.  
  1364.            Return - will allow you to Edit the current Comment or
  1365.                     first line description of the File.
  1366.  
  1367.            F10    - if on a file, this will bring up the record card
  1368.                     for that file, and you can then edit the second line
  1369.                     description and other details.  It will also show
  1370.                     you most of the details recorded about each file.
  1371.  
  1372.              T    - tags a file for possible deletion in the Global lsit.
  1373.              U    - removes the Tag.
  1374.  
  1375.             F3    - to search for a keyword in the file descriptions of
  1376.                     the files in the List.
  1377.  
  1378.         Alt+F3    - to continue the keyword search started with F3
  1379.  
  1380.     When editing a Comment Line,  you could specify  that  the  comment  is
  1381.     actually  an  extended description of the file above.   This is done by
  1382.     making the first character a >
  1383.     FLM will indent the line to match the description of  the  file  above,
  1384.     both  on  the  current  List displayed and also to the users in the BBS
  1385.     mode.  Note, no checking is done as to the length of the comment line.
  1386.  
  1387.   The following keys allow management of the file:
  1388.  
  1389.     Ctrl+F5  - to rename the file.
  1390.  
  1391.     Ctrl+F6  - to use McAffee's SCAN to do a Virus Check on the file.
  1392.                after doing so, the results will be noted for future use
  1393.  
  1394.     Ctrl+F7  - to convert or  archive  the  file  to  the  compression  type
  1395.                specified.   Also, this is noted so future conversions won't
  1396.                be done again.
  1397.  
  1398.     Ctrl+F8  - to  banner  the  file  using  the  program specified in the
  1399.                Archiver/config
  1400.  
  1401.          F9  - to copy the file somehwre. You are prompted to enter a
  1402.                destination path.
  1403.  
  1404.      Alt+F9  - to copy the file to the A: drive.  In doing so, FLM2 also
  1405.                increases the download counter by 1, as also creates a
  1406.                file on the A:  drive  called  PACKING.LST which details the
  1407.                files that have been copied there listing dates, size and
  1408.                file description.
  1409.  
  1410.     Alt+F10  - shows a list of other files the user who uploaded this file
  1411.                has uploaded.
  1412.  
  1413.           P  - toggles  the 'Private' status of the file.   On marking the
  1414.                file, the filename is displayed in a low intesity Brown
  1415.                instead of  yellow.    As  soon  as  the  file  is marked as
  1416.                Private,  users are unable to access the file regardless  of
  1417.                their security status.
  1418.  
  1419.           F  - toggles  the  Freefile  status  of the file.   If marked as
  1420.                'Free',  then users will not be charged for downloading this
  1421.                file.
  1422.  
  1423.           N  - so you can mark file as having a replacement version.
  1424.                This option brings up a Pick List of all the files
  1425.                Alphabetically close, where you can select one which replaces
  1426.                this current file.
  1427.  
  1428.  
  1429.   The following keys allow you to look at the file highlighted:
  1430.  
  1431.    Shift+F?  - ? being one of the Function keys 1 to 10, will invoke the
  1432.                external program you have defined in config/externals.
  1433.  
  1434.          F5  - invoke the archive manager SHEZ on the file.
  1435.  
  1436.      Alt+F5  - unpack or copy the file to the \FLMWORK directory and
  1437.                invoke a DOS shell located to that directory.   Here you can
  1438.                then run the program or look at it in some other way.
  1439.  
  1440.          F6  - invokes the excellent file browser LIST on the file
  1441.  
  1442.          F8  - invokes the GIF viewer VPIC
  1443.  
  1444.      Alt+F8  - invokes the ANSI file viewer A_TYPE on the file
  1445.  
  1446.  
  1447.   ▒▒ GLOBAL LIST ▒▒
  1448.  
  1449.   There are two Global  Lists  available  all  the time,  Alphabetical and
  1450.   Numerical.   Each you will find as  you  use  them  has  their  different
  1451.   benefits. We'll try to identify some for you here.
  1452.  
  1453.   First though, we'll talk about the extra key functions available.
  1454.  
  1455.     Alt+N  - switches to the Numerical List, placing the cursor on the
  1456.              first file.
  1457.  
  1458.     Alt+A  - switches to the Alphabetical List, placing the cursor on the
  1459.              first file.
  1460.  
  1461.         W  - switches to the other List (either Numerical or Alphabetical)
  1462.              at  the  position  in  the  other  List  where  the  currently
  1463.              highlighted file is located.
  1464.  
  1465.    Ctrl+D  - deletes all the TAGGED files.   FLM" will ask you to confirm
  1466.              that you want to proceed.
  1467.  
  1468.        F2  - searches for a  file.   Enter  the filename or part,  and FLM2
  1469.              will locate to that position in the Alphabetical  List.    You
  1470.              will find that it  auotmatically  switches to the Alphabetical
  1471.              list.
  1472.  
  1473.    Alt+F2  - searches for a Part Filename.  ie if you are looking for say a
  1474.              .EXE file.
  1475.  
  1476.        F3  - searches the file descriptions and filenames for a Keyword.
  1477.              After being prompted, enter a keyword to search for and FLM2
  1478.              will locate you to the first match.   If there are no matches,
  1479.              the cursor will stay on the current file.   If found,  you are
  1480.              switched to the Numerical List.
  1481.  
  1482.    Alt+F3  - continues the keyword search starting at the next file.
  1483.  
  1484.         X  - to use you will need to be located on the Alphabetical List.
  1485.              FLM2 will search for the first set  of  files  with  identical
  1486.              filenames,  and locate you to that position.   You will notice
  1487.              that  FLM will always put the 2 sets of identical filenames at
  1488.              the top of the screen,  and locate the cursor on the second of
  1489.              these.   This is used  to  locate possible duplicated files on
  1490.              your system.   Bear in mind that the  match  is  only  against
  1491.              filenames, so you do need to identify if the files are in fact
  1492.              the same.
  1493.  
  1494.  
  1495.   ▒▒ THE RECORD CARD ▒▒
  1496.  
  1497.   Every  file has a data record,  with various bits of information recorded
  1498.   for each file.   The File Record  Card  screen is reached by pressing F10
  1499.   whenever your cursor is located over a filename.
  1500.  
  1501.   On entry to the screen,  the cursor is located over the 1st line  of  the
  1502.   file  description.    This screen is the only place where you are in fact
  1503.   able to edit the second description  line.   The fields that you are able
  1504.   to alter are:
  1505.  
  1506.    The 2 descriptions lines.
  1507.  
  1508.    Public file status,  or 'Private' status.   if Public is set to No, then
  1509.    no  user  will be able to download or see this file listed.   This field
  1510.    can also be toggled by pressing  P  from the full list screen.
  1511.    A file may also be marked as 'Private' by FLM, is it finds that the file
  1512.    contains a Virus during it's Virus check system.
  1513.  
  1514.    Free file status, which determines whether users will be debited for the
  1515.    download of the file.    I  usually  mark  all  the Allfile Lists or the
  1516.    Archiver files to being Free,  thus users won't be charged.    FLM  will
  1517.    still update the download counter for the file,  and log the download in
  1518.    the transfer tracking logs.
  1519.  
  1520.    Passworded and Detailed Description fields are not yet implemented.
  1521.  
  1522.    Lists On, refers to the number of Lists where this file is listed.  This
  1523.    counter can unfortunately be messed up  with some operations,  but it is
  1524.    used to determine whether FLM offers the option  of  'Physically  Delete
  1525.    File' when you select to delete a line from a List.   ie FLM only offers
  1526.    this option if the Lists On counter is set to 1.
  1527.    You  wouldn't  under normal use alter this field,  but it's available to
  1528.    force FLM into allowing a file  to  be  physically deleted even if it is
  1529.    listed more than once.
  1530.  
  1531.    Expiry date isn't yet used,  but future use will  mean  that  FLM  would
  1532.    automatically delete a file that has passed it's expiry date.
  1533.  
  1534.    Upload  Date,   as  it's  name  suggests  is the date when this file was
  1535.    adopted to the filebase or uploaded by a user.
  1536.  
  1537.    Times downloaded,  as it's name  suggests,   is the number of times this
  1538.    file was succesfully downloaded by your users.
  1539.  
  1540.    Last Access, is the date of the last download of the file.
  1541.  
  1542.    Who Uploaded,  contains the record number for the user who uploaded this
  1543.    file.   All adopted files are given the record number 1, which is set to
  1544.    being the Sysop.
  1545.  
  1546.    Replacement Id,  is an interesting feature of FLM,  and will possibly be
  1547.    under used.   It is used to indicate to users that a newer version of  a
  1548.    file is now available.   To set this field, either enter the file number
  1549.    of  the replacement file,  or use one of the two Pick Lists to select it
  1550.    quickly.
  1551.  
  1552.      F2 - offers  a  Pick  List  of  all  the  files in Alphabetical order.
  1553.           Usually a replacement file would be next in  Alphabetical  order,
  1554.           so this Pick List is the quickest in finding it.
  1555.  
  1556.      F3 - offers a Pick List in Numerical order,  but lists the files with
  1557.           their descriptions.
  1558.  
  1559.   When a file has this Replacement Id set,  the user will be  notified  and
  1560.   offered the option of downloading the replacement file instead.  Use this
  1561.   feature  on all those files that seem to get updated each week,  and your
  1562.   users will certainly appreciate it.
  1563.  
  1564.   File Status  1,  is  used  as  a  control  flags  for  FLM's various test
  1565.   processes.  ie Virus checking, Archive converting and Bannering.
  1566.  
  1567.   File Status 2, is not used in the Shareware Edition of FLM2
  1568.  
  1569.   File Attributes, are those of the file from DOS.
  1570.  
  1571.  
  1572.   ▒▒ MOVING/COPYING/DELETING FILES ▒▒
  1573.  
  1574.   Moving or copying a file from one List to another is done  by  using  the
  1575.   ScrapList (List No. 999) in a kind of 'cut and paste' method.
  1576.  
  1577.   First highlight the file you want  to  move.    Then,   if  you  want  to
  1578.   duplicate that line onto the other List, select C to copy the line to the
  1579.   ScrapList,   or  select  D  to  delete  it  from  the Cuurent List to the
  1580.   ScrapList.   Note,  when delete is selected you will be asked if you want
  1581.   to physically delete the file, to which you would answer 'No'.
  1582.  
  1583.   Then,  locate your cursor to  the  New  List  where you want the file and
  1584.   select R to recover the line from the ScrapList.  On doing so, and if the
  1585.   default storage area for this list is available and is not ReadOnly,  you
  1586.   will be offered the prompt of whether you Physically  want  to  move  the
  1587.   file  to  the  new  directory.    To  this you would answer Yes,  if your
  1588.   intention was also to move the file to the List's linked Storage Area.
  1589.  
  1590.   In a similar fashion, you can delete files from the filebase altogether.
  1591.   After highlighting the file,  press  D,  and  then FLM will prompt you to
  1592.   confirm that you want to delete the file physically.  On selecting 'Yes',
  1593.   FLM will delete the file and mark it's record that file is deleted.   FLM
  1594.   doesn't physically remove it's own record until you  purge  the  database
  1595.   using the renumbering facility.
  1596.  
  1597.  
  1598.   ▒▒ BLOCK MARKING ▒▒
  1599.  
  1600.   Using the Scraplist,  you are able  to copy/move many files at once.   We
  1601.   have provided the facility of marking  a  Block  of  files  to  make  the
  1602.   process easier.   To block a set of lines, first locate to the first line
  1603.   and press  +   then locate to the last line and select -
  1604.   Once  done,   you  will  see  that  the  lines  are  now shown in a light
  1605.   background.   To move this block to the ScrapList, again use similar keys
  1606.   as above: Ctrl+C to copy the block to the ScrapList,  or Ctrl+D to delete
  1607.   them from the Current List  to  the  ScrapList.    If you select to Block
  1608.   Delete them,  you are then asked if you want to default to  NOT  deleting
  1609.   the files.  Select 'Yes', by selecting 'No', you will be asked to confirm
  1610.   the deletion of each file that FLM wants to physically delete.
  1611.  
  1612.   FLM has another feature of marking a Block of files. You can select the *
  1613.   key,   and  a  block  of files will be marked from the first comment line
  1614.   above to the first below the  currently highlighted file.   The effect is
  1615.   to Block all files listed next to each other.
  1616.  
  1617.  
  1618.   ▒▒ DELETING THE SCRAPLIST ▒▒
  1619.  
  1620.   The ScrapList will often  get  full  of  lines  you  no longer need,  and
  1621.   therefore you'll want to delete it.   This is done by first  bringing  up
  1622.   onto  the  screen  any of your Lists,  and then with the ScrapList status
  1623.   line at the bottom  indicating  that  there  are  files in the ScrapList,
  1624.   select the keys Ctrl+N.   FLM deletes the ScrapList,  which  is  actually
  1625.   List No. 999, and clears the status line.
  1626.  
  1627.  
  1628.   ▒▒ ADDING NEWFILES ▒▒
  1629.  
  1630.   Newfiles are added to FLM's database during the adopt procedure.  First
  1631.   FLM2 scans the directory looking for any files it doesn't know about, and
  1632.   any found are first added to the filebase and then added to the default
  1633.   list for that storage area.
  1634.  
  1635.  
  1636.  
  1637.   ─────────────────────────────────────────────────────────────────────────
  1638.   ▒▒ UTILITIES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1639.   ─────────────────────────────────────────────────────────────────────────
  1640.  
  1641.   There are a collection of utilities/functions available to you.  Some are
  1642.   available  from the Utilities Menu,  and others available on specifying a
  1643.   command line parameter.
  1644.  
  1645.  
  1646.   ▒▒ ADOPTING FILES ▒▒
  1647.  
  1648.   You have the choice of doing an Adopt of only the storage areas marked to
  1649.   be checked,  this  is  specified  in  the  config/storage options,  or of
  1650.   adopting file from every Storage Area.
  1651.  
  1652.   FLM first scans all the files in the  Storage  Area  and  checks  to  see
  1653.   whether  it is known,  adding them to the filebase if it doesn't.   As it
  1654.   finds new files in the directory, it will check the Files.bbs description
  1655.   file to see if there is a description it can grab.
  1656.   After this, FLM2 adds the file to the appropriate List for that
  1657.   Storage area.  If the Storage area has a default List setting of 0,
  1658.   the file is not added to any List.
  1659.  
  1660.   ▒▒ VERIFY FILE INFO ▒▒
  1661.  
  1662.   This process can take some time if you have a large collection of files.
  1663.   On selection, FLM will re-check the file sizes, dates it has recorded for
  1664.   every file you have in your filebase.  It doesn't skip the files you have
  1665.   marked as being in ReadOnly Storage areas.
  1666.  
  1667.   Although FLM records any changes in  file sizes and dates in processes it
  1668.   performs, it doesn't know of changes that have been made externally.   If
  1669.   you have a small filebase,  then running this once a week  is  fine,   if
  1670.   you've  got a large collection,  run say once a month or if you have made
  1671.   any major changes to the files external to FLM.
  1672.  
  1673.  
  1674.   ▒▒ RE-SORT ALPHABETIC ▒▒
  1675.  
  1676.   Hopefully you won't need to run  this routine often,  but it's purpose is
  1677.   to re-sort FLM's database into  the  correct  alphabetical  order.    The
  1678.   process also seems to tidy up the filebase.
  1679.  
  1680.   If  you  notice that FLM is having problems finding files,  then run this
  1681.   routine to clear it up.
  1682.  
  1683.  
  1684.   ▒▒ VERIFY COUNTS ▒▒
  1685.  
  1686.   As mentioned earlier,  FLM maintains  a  record  of the number of times a
  1687.   file is listed,  and it's only when a file is Listed once that FLM offers
  1688.   you the facility to delete a file physically.
  1689.  
  1690.   However,   when deleting files from one of the Global Lists,  FLM doesn't
  1691.   also delete the corresponding pointer  from  any of the Lists.   So,  you
  1692.   need to run this routine if you have done some  major  deletions  in  the
  1693.   Global Lists.   As well,  as re-checking the number of times each file is
  1694.   Listed,  FLM also cleans up the Lists removing any references to 'Deleted
  1695.   Record'.    In addition,  FLM re-checks the number and total bytes of the
  1696.   files listed in the Lists.
  1697.  
  1698.  
  1699.   ▒▒ AUTOMATIC CHECK FOR VERII ▒▒
  1700.  
  1701.   FLM has three automatic systems of looking after your files.
  1702.  
  1703.   The first is to SCAN each  file  looking  for Viruses,  for which it uses
  1704.   McAfee's SCAN system.  You can manually SCAN a file by using the Ctrl+F6
  1705.   function in the Viewer/Editor,  but here with this  option  a  system  of
  1706.   automatically checking all the files in your filebase is started.
  1707.  
  1708.   After  selection,   you  will see that FLM has started to check the files
  1709.   from the last added to the first.   It knows which ones have already been
  1710.   checked,  so it skips those.    The  system  only checks files with the
  1711.   extensions of .EXE .COM .SYS or .OVR.   Having copied or extracted  files
  1712.   to the work directory, SCAN is invoked, and the result analysed.
  1713.  
  1714.   You  will see a progress indicator both in how long FLM has been checking
  1715.   and how many file have been checked.   These factors bear more importance
  1716.   when the Virii checking system is run  from the Comamnd line,  as you are
  1717.   also able to tell FLM how long to run this routine for.
  1718.  
  1719.   To run from the comamnd line:
  1720.  
  1721.     FLM2 scan <minutes>
  1722.  
  1723.   FLM will start the system, and run for the number of minutes specified.
  1724.   If you don't specify a time period,  it will just continue running  until
  1725.   it's finished checking all your files.
  1726.  
  1727.   The  way I use this,  is by having FLM scan the files for 20 minutes each
  1728.   night in an Event.   As FLM notes  which it has already checked,  it only
  1729.   continues with files it hasn't looked at,  and as it always starts at the
  1730.   last files uploaded, it very quickly checks all the recent uploads during
  1731.   the day.   If a VIRUS is found,  FLM marks  the  file  as  'Private'  and
  1732.   changes  the  first  line  of the description to ' VIRUS VIRUS VIRUS' and
  1733.   also beeps the same message on the screen.
  1734.  
  1735.   When you want to re-scan all your files using a New version of SCAN,  you
  1736.   can reset the control file using the 'Reset Control Flag' option.    This
  1737.   causes FLM to forget the files which it has already checked, thus forcing
  1738.   it  to  start  again.   If you run the Virii Checking System in a nightly
  1739.   event for a period of  time,   you'll  find that FLM eventually will have
  1740.   re-scanned all the files again.  How many nights obviously depends on the
  1741.   number of files you have.   For me,  when I get a new version of SCAN,  I
  1742.   change the time I give it to 2 hours,  and find that after about 10  days
  1743.   it's re-checked them all again.  (ready for another version :-)
  1744.  
  1745.   ▒▒ AUTOMATIC ARCHIVE CONVERTING ▒▒
  1746.  
  1747.   This  second  automatic  system  which is used in exactly the same way as
  1748.   above, will attempt to convert files into your prefered ARChive format.
  1749.  
  1750.     This option is also available from the command line as:
  1751.  
  1752.     FLM2 CONVERT <minutes>
  1753.  
  1754.  
  1755.   ▒▒ AUTOMATIC ARCHIVE BANNERING ▒▒
  1756.  
  1757.   This is the third automatic system,  and causes all the ARChived files to
  1758.   be bannered.   For files to be bannered, you will need to have configured
  1759.   the ARChives as such.
  1760.  
  1761.     This option is also available from the command line as:
  1762.  
  1763.     FLM2 BANNER <minutes>
  1764.  
  1765.  
  1766.   The flags which control these three  automatic systems can be reset using
  1767.   the either of the three 'Reset' options.
  1768.  
  1769.  
  1770.  
  1771.   ▒▒ SORTING LISTS ▒▒
  1772.  
  1773.   Most BBS's like to have their file lists sorted Alphabetically or even in
  1774.   date  order.    The  Shareware  Edition  of  FLM  only offers this former
  1775.   method.   By running the  Sort  Lists  option,  either from the Utilities
  1776.   menu,  or from the command line,  FLM will go thru each list  identifying
  1777.   blocks  of  files  listed  together,   and then sorting those blocks into
  1778.   Alphabetic order.   By sorting the blocks,   FLM doesn't put out of place
  1779.   any comment lines you have placed in the Lists.
  1780.  
  1781.   To run from the command line:
  1782.  
  1783.     FLM2 sortlists
  1784.  
  1785.   As FLM sorts the lists,  it indicates the List,   and  the  block  it  is
  1786.   currently doing, in the Progress Window.
  1787.  
  1788.  
  1789.   ▒▒ CREATING ALLFILES REPORTS ▒▒
  1790.  
  1791.   The Allfiles reports are configured in the config/allfiles section.   One
  1792.   done, you are able to create them from the command line, as:
  1793.  
  1794.     FLM2 AF <nnn>
  1795.  
  1796.    <nnn>  refers  to  the  record  number  of  the  Allfiles  List you want
  1797.           created.  Setting this to 0, will force FLM to create all of them
  1798.           specified.
  1799.  
  1800.  
  1801.   ▒▒ CREATING NEWFILES REPORT ▒▒
  1802.  
  1803.   FLM is able to create a  list  of all the Newfiles uploaded/adopted to the
  1804.   system within a period.   Configure the filename and period to report  on,
  1805.   in the config/system section.
  1806.  
  1807.   To run from the command line:
  1808.  
  1809.     FLM2 newfiles
  1810.  
  1811.  
  1812.   ▒▒ CREATING ANSI/ASCII REPORTS ▒▒
  1813.  
  1814.   There  are four .ASC/.ANS reports that FLM can create for you,  which you
  1815.   can use on your BBS to show users of the state of  your  filebase.    All
  1816.   these reports are located in the TXT File Path specified.
  1817.  
  1818.   From the command line, run :
  1819.  
  1820.     FLM2 top20        - this will create 2 of them, the first showing
  1821.                         a list of the Top 20 files downloaded from your
  1822.                         system.   The reports  name  FLMTOP20.A??
  1823.                         the  2nd,   is  a list of all the Storage Areas you
  1824.                         have defined with  some  interesting stats for each
  1825.                         area,  like the number of files,  size,  number  of
  1826.                         downloads etc. The reports name FLMLISTS.A??
  1827.  
  1828.     FLM2  wklygraph  -  create  the  other 2 reports,  which are actually a
  1829.                         visual graph of the quantity of files and kilobytes
  1830.                         being added to your filebase over the last year.
  1831.                         The two reports are  FLM#NEWF.A?? and FLM#NEWB.A??
  1832.  
  1833.  
  1834.   ▒▒ EXPORTING TO FILES.BBS FILES ▒▒
  1835.  
  1836.   FLM can export all it's information to standard Files.BBS format files.
  1837.   If required, the filenames will have been specified in the config/Storage
  1838.   section.
  1839.  
  1840.   To run from the command line:
  1841.  
  1842.     FLM2 export
  1843.  
  1844.  
  1845.  
  1846.   ─────────────────────────────────────────────────────────────────────────
  1847.   ▒▒ RUNNING IN THE BBS MODE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1848.   ─────────────────────────────────────────────────────────────────────────
  1849.  
  1850.   As  previously  mentioned,  FLM2 is also a 'door' or external program for
  1851.   your BBS.   In an RA/QBBS/SBBS environment, it can be called using either
  1852.   a Type 7 or 15 exit.  Please refer to your BBS manuals for information on
  1853.   the use of doors and how they are called.
  1854.  
  1855.   The most important factor for  FLM2  to  operate  in the BBS mode is it's
  1856.   requirement for the file  EXITINFO.BBS  to  be  located  in  the  current
  1857.   directory.   This file,  as previously stated.   is created by RA/SBBS on
  1858.   exits, and contains the Users Record so far.  FLM2 on exit will update it
  1859.   with  any changes the user has selected,  most importantly updates of the
  1860.   users download and upload statistics.
  1861.  
  1862.   The command line I use with my RA system is:
  1863.  
  1864.     *M c:\ra\flm2.exe BBS *P *N
  1865.  
  1866.       - BBS is a parameter to FLM, to take it into the BBS mode.
  1867.  
  1868.       - the *M forces RA to swap itself to Disk before calling FLM
  1869.  
  1870.       - the *P is substituted with the COM Port number being used
  1871.  
  1872.       - the *N is substituted with the Line or Node number.   Normally used
  1873.                only by Multi-line systems,  but please  set to 1 if you are
  1874.                running FLM on a single line BBS.
  1875.  
  1876.  
  1877.   Note,  that if FLM is called with the BBS parameter and you have  an  old
  1878.   EXITINFO.BBS file in the directory from a previous user,  it will read it
  1879.   and  most  likely  detect  that  that user has now hung up,  and FLM will
  1880.   subsequently close and return to the DOS command line.
  1881.  
  1882.   All communication with the COM port is done via a fossil driver, both BNU
  1883.   and X00 have been tested and found to work reliably with FLM.  It doesn't
  1884.   matter to FLM whether the COM port is locked, as it follows the speed as
  1885.   set by the fossil.
  1886.  
  1887.   FLM will honour the users settings as for the screen size and settings
  1888.   prefered, ie use ANSI or ASCII displays.  As yet, FLM does not utilise
  1889.   AVATAR screen codes.
  1890.  
  1891.   If  FLM  finds that the user has logged onto your BBS less than 5 times,
  1892.   it  will  display the FLM introduction screen FLMINTRO.A??.   This screen
  1893.   was created to introduce the newish user to your file section, and inform
  1894.   them how quick and easy it is to use your file areas.
  1895.  
  1896.   Then,  the main menu will be displayed.   Note,  you  can  customize  the
  1897.   default screens that FLM displays,  by altering your Menu and BBS options
  1898.   configurations.   The layout of the menus displayed will be those exactly
  1899.   as you have defined,  and FLM will check at each stage that the user does
  1900.   have security access to the Lists, or Files as you have set.
  1901.  
  1902.   You  will  see  that  there is a Status Line at the bottom of the screen,
  1903.   which updates once a minute showing slightly different information on the
  1904.   user currently online.
  1905.  
  1906.   While the user is online, you can see everything that the user is seeing,
  1907.   and can type into the keyboard just as the user can.  Characters received
  1908.   from the COM port however,  are  limited  to the options available on the
  1909.   screen at the time, and never allows characters above ASCII 127.
  1910.  
  1911.   From the Sysops keyboard, the additional keystrokes are available:
  1912.  
  1913.     Alt+C - forces user into Chat Mode with the Sysop.
  1914.  
  1915.     Alt+J - allows the Sysop to drop to a DOS shell.  You must type EXIT to
  1916.             return to FLM.   When invoked,  the user is informed to Wait as
  1917.             you have dropped to DOS.
  1918.  
  1919.    Ctrl+J - as above,  but FLM swaps  itself  to  EMS/XMS  or  Disk  before
  1920.             opening the DOS shell, giving you more RAM.
  1921.  
  1922.     Alt+E - FLM  updates  the EXITINFO.BBS file,  and then calls the User
  1923.             Record Editor FLMUSER.   See  separate documentation for this
  1924.             program, written by Andy Williams.
  1925.  
  1926.          - increases the users Time Limit by One minute
  1927.          - decreases the users Time Limit by One minute
  1928.  
  1929.    PageUp - increases the users Credits by One unit
  1930.    PageDn - decreases the users Credits by One unit
  1931.  
  1932.    Ctrl+RightArrow    - scrolls the Status Line to the next display. There
  1933.                         are three of these lines, each with different
  1934.                         information.
  1935.  
  1936.    Ctrl+LeftArrow     - redisplays the Status Line.
  1937.  
  1938.  
  1939.      ESC  - takes you as Sysop into the Viewer/Editor section of FLM.
  1940.             you must return by selecting  the  BBS  Mode  option  from  the
  1941.             screen there.
  1942.  
  1943.  
  1944.   ▒▒ LIST VIEWING ▒▒
  1945.  
  1946.   After the user has selected an option from the main menu,  the configured
  1947.   List will be displyed.   If the user has the Page Pausing option set, the
  1948.   first  screen  full  will  show and then a Prompt asking whether the user
  1949.   wishes to continue.
  1950.  
  1951.   The Prompt offers the following options:
  1952.  
  1953.      Yes          to continue showing the List
  1954.  
  1955.      No           to skip to the end
  1956.  
  1957.      Back         to redisplay the previous screen page
  1958.  
  1959.      TagFile      prompts the user for a Filename or Number, thus adding
  1960.                   that file to the users Download selection
  1961.  
  1962.      ViewArchive  prompts the user for a Filename or Number. FLM2 will then
  1963.                   examine  the  file  selected  and  display  the   ARChive
  1964.                   contents  in  a  prioritised  order whereby Textfiles are
  1965.                   displayed first in Yellow.    In most circumstances,  all
  1966.                   the document or textfiles are listed first.
  1967.                   The ViewArchive section provides the user with facilities
  1968.                   to read textfiles contained within the ARChive,   and  to
  1969.                   extract for download any individual file.
  1970.  
  1971.      DisplayFile  prompts the user for a Filename or Number. FLM2 will then
  1972.                   check if the file is an archive.   If it is,  the user is
  1973.                   prompted to use the ViewArchive option instead, otherwise
  1974.                   the file is displayed.
  1975.                   If  the  file selected has the extension .ANS,  then FLM2
  1976.                   will display the it without the Page Pausing enabled.
  1977.  
  1978.   Once the end of the list is reached, FLM2 also offers the options:
  1979.  
  1980.      +            switches to the previous List offered from the Menu.
  1981.  
  1982.      -            switches to the next List offered from the Menu.
  1983.  
  1984.  
  1985.   ▒▒ FILE SEARCHING ▒▒
  1986.  
  1987.   We are sure that your users  will most benefit from FLM2's extremely fast
  1988.   Searching section.   The user is offered the option of  searching  either
  1989.   for a Filename or for Keywords.
  1990.  
  1991.   The filename search, is done using a fast binary search and therefore any
  1992.   files found will be  displayed  almost  instantaneously.   Some users are
  1993.   fooled by the speed when FLM2 doesn't find any files and  shows  0  files
  1994.   found, the users believe the search hasn't actually been done !
  1995.  
  1996.   The Keyword search looks for the existance of the Keyword entered, either
  1997.   in the filename or the file descriptions.   As the search progresses, the
  1998.   users are shown the progress  by  displaying  the file number of the last
  1999.   file in the block of files just checked.  The speed is maintained because
  2000.   FLM2 checks 250 files at a time.
  2001.  
  2002.  
  2003.   ▒▒ NEWFILES LIST ▒▒
  2004.  
  2005.   On selecting this option, the user is asked to specify the number of days
  2006.   back FLM2 is to report.   The date used is that of the Upload Date in the
  2007.   Files Record Card.   If you want a specific file to always be shown, then
  2008.   simply change it's upload date to somewhere in the future.    ie  if  you
  2009.   want your Allfiles Lists to always be shown as new.   The user is offered
  2010.   the option of pressing RETURN,  where FLM2 will then search from the last
  2011.   date the user was logged on.
  2012.  
  2013.   ▒▒ DOWNLOADING ▒▒
  2014.  
  2015.   The user is first asked for a protocol method,  with Quit being an option
  2016.   available.   Then FLM2 will  display  any  files  which have already been
  2017.   Tagged, and prompt the user to enter any further ones.   If you are using
  2018.   the subscription system,  you will see that FLM2 also displays the amount
  2019.   the user will be charged for each file.
  2020.  
  2021.   After  the user has completed entering the files to be download,  a check
  2022.   is made that the files  selected  are  within the Time and Download Limit
  2023.   and Credit Limit you have set.   After the  user  selects  to  start  the
  2024.   download,   FLM2  will  if  configured  ask  the  user if they wish to be
  2025.   automatically logged-off after the download.
  2026.  
  2027.   The protocol selected will be started.   On return the logfile created or
  2028.   ErrorLevel set determines the success of the  transfer.    FLM2  is  very
  2029.   exact with the success of the download, indicating to the user the number
  2030.   of  files  that have been transfered correctly,  and offering to continue
  2031.   with those that weren't transfered fully.  FLM2 does update it's database
  2032.   immediately,  so you'll find that your users won't get away with supposed
  2033.   free downloads if they deliberately hang up in the middle of the download.
  2034.   If you are having problems with failed transfers,  check the setup of the
  2035.   protocol, particularly that the log filename is correct.
  2036.  
  2037.  
  2038.   ▒▒ UPLOADING ▒▒
  2039.  
  2040.   You  can  disallow  uploads  to  your  system  in  the config/BBS Options
  2041.   section.
  2042.  
  2043.   On the basis that uploads are allowed,   the user is asked to select from
  2044.   one of the protocols.   After selected the protocol, the next question to
  2045.   the user depends on  whether  you  have  configured  FLM2  to  check  for
  2046.   duplicate uploads.  If you have configured for 'Force Check', the user is
  2047.   asked for the filename of the file they are about to upload.  An input of
  2048.   a Wildcard or a input whish is obviously false is disallowed and the user
  2049.   will  be prompted again to enter a valid filename.   FLM2 then checks the
  2050.   filebase and if any matching files  are  found,  these will be listed and
  2051.   the user asked to confirm that the file they are going to upload is not a
  2052.   duplicate.
  2053.  
  2054.   Before starting the protocol,  a  'Receive'  directory is created by FLM2
  2055.   uniquely for this user,  and then  FLM2  loads  the  protocol  from  that
  2056.   directory.   On return,  FLM2 checks the directory for received files and
  2057.   asks the user to describe each of the files uploaded.   After this,  then
  2058.   moving the files to the Upload Storage Area,  and adding the file to that
  2059.   List.
  2060.  
  2061.   ▒▒ SUPPORT ANS/ASC FILES ▒▒
  2062.  
  2063.   The  following  .ASC/.ANS files can be located in the FLM Data Directory,
  2064.   and FLM2 will display them as indicated:
  2065.  
  2066.    FLMINTRO.A??   - is displayed to users who have logged onto your BBS
  2067.                     less than 5 times.  This can introduce them to your
  2068.                     filebase and indicate the best way to use it.
  2069.  
  2070.    FLM#nnnn.A??   - the nnnn represents a List Number.
  2071.                     This file is appended to the Top of List nnnn, as it is
  2072.                     being displayed and replaces  the normal Header display
  2073.                     that FLM2 shows.
  2074.  
  2075.    FLM#DEF.A??    - this file is appended to the Top of all Lists except
  2076.                     lists with their own FLM#nnnn.A?? file.
  2077.  
  2078.    CHARGES.A??    - if you are using the subscription system, this file is
  2079.                     displayed to the users who  attempt  to  download  more
  2080.                     than their current Credits.   Use to inform them how to
  2081.                     they can get their account back into credit.
  2082.  
  2083.  
  2084.   ─────────────────────────────────────────────────────────────────────────
  2085.   ▒▒ FILEBASE STATISTICS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  2086.   ─────────────────────────────────────────────────────────────────────────
  2087.  
  2088.   ▒▒ FILE TRANSFER TRACKING SYSTEM ▒▒
  2089.  
  2090.   Every download and upload is logged within FLM2,  and the first four menu
  2091.   options  gives  access to these logs.   Uploads and Downloads are treated
  2092.   independantly,  and there are no links between the user who has  uploaded
  2093.   against the same users downloads.
  2094.  
  2095.   Upload Sessions, will show starting from the last file uploaded, a record
  2096.   of every file either adopted or uploaded.   The log shows the Date & Time
  2097.   the file was added,  the User who Uploaded and the time it took to upload
  2098.   to your system.   You are able to scroll through the log by pressing  the
  2099.   RETURN key.   Any files which have subsequently been deleted will show as
  2100.   'deleted',   and  any  records which have now been removed will show as a
  2101.   null line.
  2102.  
  2103.   Uploaders Records, will initially show the Uploading log for the 'Sysop'.
  2104.   Pressing the F1 key will enable a Pick List of all the Uploaders and from
  2105.   this window,  you can select a  user whose record will then be displayed.
  2106.  
  2107.   Download  Sessions,  will show starting with the last file downloaded,  a
  2108.   record of every  file  downloaded.    The  log  details  the  Date & Time
  2109.   together with the Time Taken and CPS rate attained and the users name who
  2110.   made the download.   You can continue to scroll down the log of downloads
  2111.   by pressing the RETURN key.
  2112.  
  2113.   Downloaders Records,  indicate the  downloads  performed  by  each  user.
  2114.   Press the F1 key to enable a  Pick  List and select from any of the users
  2115.   names shown.   The users names are added to the database after they  have
  2116.   performed their first download,  therefore the newer users will be listed
  2117.   last.
  2118.  
  2119.  
  2120.   ▒▒ USAGE STATISTICS ▒▒
  2121.  
  2122.   The 3 statistics  screens  display  the  amount  of  Usage your users are
  2123.   making of the FLM2 filebase.   With data recorded over five time periods.
  2124.   Each column is headed with the time period it represents,  also the  date
  2125.   the time period started is shown.
  2126.  
  2127.   Each of the pages are accessed by pressing the PageUp or PageDown keys.
  2128.  
  2129.  
  2130.   ▒▒ FILEBASE INFORMATION ▒▒
  2131.  
  2132.   On  selecting  this  option,   an  initial  scan through all the database
  2133.   records is done.   This should only take a moment.   On completion,  FLM2
  2134.   displays a summary for you to review.
  2135.  
  2136.   There are 3 further displays, each enabled by pressing :
  2137.  
  2138.     F1  - Extension List
  2139.  
  2140.           A complete  record  of  all  the  file  extensions  used  in your
  2141.           filebase with a count of the number of  files,   total  size  and
  2142.           number  of  downloads recorded for each extension.   The list may
  2143.           extend  over  several  screens  and   FLM2  will  prompt  you  to
  2144.           continue.
  2145.  
  2146.     F3  - Dates Analysis
  2147.  
  2148.           The  screen  details  the  age of all the files in your filebase.
  2149.           The dates are split into 17 year periods, and for each year there
  2150.           are counts of the number of  files,  the sizes and the percentage
  2151.           of the filebase.
  2152.  
  2153.  
  2154.  
  2155.  
  2156.   ─────────────────────────────────────────────────────────────────────────
  2157.   ▒▒ CREDITS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  2158.   ─────────────────────────────────────────────────────────────────────────
  2159.  
  2160.   RemoteAccess is a trademark of Andrew Milner & Continental Software
  2161.   SuperBBS     copyright Risto Virkkala and Aki Antman
  2162.  
  2163.   FLMUSR   - Files Library Manager User Editor,    by Andy Williams
  2164.  
  2165.   RAFI2FLS - RemoteAccess Flsearch.ctl Generator,  by Peter Burnett
  2166.  
  2167.   PKZIP    -   copyright PkWare Inc
  2168.   ARJ      -   copyright Robert K Jung
  2169.   LHA      -   copyright Haruyasu Yoshizaki
  2170.  
  2171.  
  2172.   DSZ      -   copyright Omen Technology
  2173.   BIMODEM  -   copyright Erik Labs
  2174.   HSLINK   -   copyright Samuel H Smith
  2175.  
  2176.   SHEZ     -   copyright Jim Derr
  2177.   VPIC     -   copyright Bob Montgomery
  2178.   A_TYPE   -   copyright Ron Huiskes / Intersoft
  2179.  
  2180.  
  2181.   Credit due to the many BETA testers,  and continual encouragement offered
  2182.   by them and users of the 1.xx series.
  2183.  
  2184.  
  2185.   ─────────────────────────────────────────────────────────────────────────
  2186.   ▒▒ APPENDIX ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  2187.   ─────────────────────────────────────────────────────────────────────────
  2188.  
  2189.   ▒▒ A - Extended Use of FLSEARCH.CTL ▒▒
  2190.  
  2191.    On installation from an originally setup system,  FLM2 utilises the file
  2192.    FLSEARCH.CTL  to obtain the directories of your filebase.   FLM2 can use
  2193.    and extension of the normal format for this file,  allowing installation
  2194.    of CD-ROM discs much easier.  This extension is purely the fourth column
  2195.    of information, an alternative description file to read.   Normally FLM2
  2196.    would look for a FILES.BBS file in the File Area directory, but with the
  2197.    additional column you can get  round  this  with CD-ROM discs that don't
  2198.    use this normal method.
  2199.  
  2200.    The extended format is.
  2201.  
  2202.    Directory    Security Area Description        Alternative Files.bbs
  2203.    ------------ -------- ---------------------   ---------------------
  2204.    u:\010a       5       Window_Demo's             e:\text\dir10
  2205.    u:\011a       5       Personal_System Utils     e:\text\dir11
  2206.    u:\012a       5       Windows                   e:\text\dir12
  2207.    u:\012b
  2208.    u:\012c
  2209.    u:\013a       5       Windows_Games             e:\text\dir13
  2210.    u:\014a       5       CAD_Programs_&_Utils      e:\text\dir14
  2211.  
  2212.    In this case,  the text file dir12  is  a  list  of  all  the  files  in
  2213.    directories 012a,  012b, 012c.   FLM2 will create Storage Areas for each
  2214.    of  the directories,  but only create Lists for the Lines where there is
  2215.    an Area Description.   If you haven't specified an Alternative files.bbs
  2216.    then Flm2 will look for one in the Storage Area directory,  if one isn't
  2217.    found then it will finally ask for  you  to enter a name of one,  or you
  2218.    could leave it blank.
  2219.  
  2220.  
  2221.    ▒▒ B - FILES.BBS description files ▒▒
  2222.  
  2223.    If you're not already familiar with the FILES.BBS files,  you soon  will
  2224.    be  as  Sysop.    They  are  text  based files,  usually located in each
  2225.    directory where your files are stored,   and form a kind of directory of
  2226.    each file in the directory, with a description to what that file is.
  2227.  
  2228.    The format is simply:
  2229.  
  2230.      FILENAME.EXT  This is the description to this file
  2231.      FILE2.ZIP     Another descriptive file.
  2232.  
  2233.      each line contains a filename, and then the description.  You can also
  2234.      have lines containing comments,  which normally need to be indented by
  2235.      one or more space characters.
  2236.  
  2237.    FLM's use of these files is purely to build your filebase initially, and
  2238.    then subsequently to obtain the descriptions for files  adopted  to  the
  2239.    filebase.   You'll find that many file based programs either maintain or
  2240.    make   use   of   FILES.BBS   files.     For   example,    your   Mailer
  2241.    (FrontDoor/D'Bridge  etc),   will use them to obtain the descriptions of
  2242.    files being file requested from  your  system.   Also programs like TICK
  2243.    will add descriptions to it when files are imported to your system.
  2244.  
  2245.    FLM will maintain a FILES.BBS file for you, by using the EXPORT command,
  2246.    but doesn't itself use them.
  2247.  
  2248.  
  2249.