Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/QF11RA.ZIP/QF.DOC

Text File | 1995-08-06 | 13.5 KB | 305 lines

                     QUIKFILER 1.1 for RemoteAccess 2.x!
            Copyrighted Multiboard Communications Centre, 1994-95
                        All rights reserved, worldwide.


╓───────────────────────────────────────────────────────────────────────────╖
║ What is it?                                                               ║
╙───────────────────────────────────────────────────────────────────────────╜

    Sick of the 100's of files sitting in your \UPLOADS directory?  It
    takes forever to update and move them all to their right locations,
    doesn't it?  Not anymore!!!

    The BEST feature of QuikFiler is the ability for it to suggest or
    automatically move files into their appropriate directories by
    reading their descriptions!

    Allows you to import the FILE_ID.DIZ/DESC.SDI files into the file
    base descriptions with a single keystroke, as well as the option to
    filter out high-ASCII and make descriptions more readable.

    Includes a description editor, and you can define altfunction keys
    also.  Manual "hurl" files is also supported in QuikFiler.


╓───────────────────────────────────────────────────────────────────────────╖
║ QF.CFG - Configuration                                                    ║
╙───────────────────────────────────────────────────────────────────────────╜

   Configuration, although it may look a bit tricky, is pretty simple
   actually.  There are a few different sections to touch upon:


   ALTKEY <number> <info>
   ────────────────────────────────────────────────────────────────────────
   The <number> is simply a number from 1 to 9 that corrosponds with
   the number of the key you want to define.  The <info> is the command
   you want to execure when the alt key is pressed.  You can put in
   certain metastrings that expand when executed...

      *C = Command shell
      *F = Full path and file name
      *P = Path of the file area
      *A = Area number
      *M = Swap memory on shell

   So for example, the command "*C /C SHEZ.BAT *F *M", might turn out to
   be: "C:\COMMAND.COM /C SHEZ.BAT C:\FILE\GAME.ZIP" with memory swap
   active before running this batch file.


   INCLUDE <option> [value]
   ────────────────────────────────────────────────────────────────────────
   There are currently four <option> settings you can have.  The first one
   is CDROM.  By default CDROM areas are not included in your active area
   listing, since you cannot hurl files to them..  Setting this option
   changes that if you need.

   The second option is the REGISTRATION number, simply place the number
   in here, that you receive when you register the program.

   The third option is REPORT, and setting this value to point to a JAM
   message base will cause a nice report to be posted to you when you
   move files automatically with the /AUTO switch (registered feature)

   The fourth option is COPY, and if you set this option, the Alt-P
   key will copy the current file into the [value] directory.  This is
   good for quickly copying files that you might want to look at later.


   <command> <value> [value]
   ────────────────────────────────────────────────────────────────────────
   Although QuikFiler is a great program by itself to import and clean up
   your file descriptions, one of the more powerful functions of it, is to
   be able to suggest or automatically move files into their proper areas
   by looking at their description, and matching them with search lines
   you can define.

   The options are:

   MOVE <areanum> <searchline> - sets up a move link to the selected area
   DELETE         <searchline> - sets up a delete upon match link
   HIDE           <searchline> - sets up a hide upon match link

   The <searchline> can look confusing but after a couple of tries, you
   will have your file upload/import system finally working for you!  The
   lines consists of words you want to match, and you can perform and/or
   operations on them.

   When defining the strings, & means AND and | means OR.  Brackets
   operate the same way as mathematics.

   For example:

   MOVE 21  remoteaccess | ra | ra2 | (remote & access)

   If the description/filename contains "remoteaccess" OR "ra" OR "ra2"
   OR BOTH "REMOTE AND ACCESS" then this file would be suggested/moved
   to area #21 which happens to be the [BBS] RemoteAccess 2.x section.

   Another example:

   We don't allow any types of x-rated graphics and such be uploaded
   to our system, so to automatically handle these files, we...

   DELETE   (*.gif | *.pcx | *.jpg | *.bmp) & (porno* | naked | nude)

   This DELETEs any files that have any of the extensions "gif OR pcx
   OR jpg OR bmp", AND have any words starting with "porno" OR have
   the words "naked" OR "nude" in the description.

   As you can see the asterisk works as a wildcard, otherwise words
   are considered only to match when it's a complete word.


   REFERENCE
   ────────────────────────────────────────────────────────────────────────
   These reference lines are generated using the QF.EXE /GENERATE option.
   They are simply here to help you remember what the appropriate area
   numbers are when defining your COMMANDS.

   To generate REFERENCE lines for your system, simply run QF.EXE with
   the /GENERATE switch.


╓───────────────────────────────────────────────────────────────────────────╖
║ QF.EXE - QuikFiler (The Program)                                          ║
╙───────────────────────────────────────────────────────────────────────────╜

    QF can be run with a few different command line parameters.
    QF.EXE [areanum] [/AUTO | /GENERATE]

    ■ The [areanum] is simply the area number you want to process.
    ■ The /AUTO switch causes QF.EXE to run on it's own, selecting
      the first match that it comes across for the file.
    ■ The /GENERATE function simply updates the REFERENCE lines
      in your QF.CFG file to reflect your current file areas.

    When you are in QuikFiler, simply press F1 for a list of your
    available options.  The keys are simple to use, and quite self-
    expanitory.  Try a few of them out, and see how they work.  In
    addition to the keys listed in the help screen, the Alt-J key
    will perform a DOS shell.


╓───────────────────────────────────────────────────────────────────────────╖
║ License and Disclaimer                                                    ║
╙───────────────────────────────────────────────────────────────────────────╜

    "QuikFiler" is NOT free, it  is being marketed under the "try before
    you buy" or shareware concept.   You are entitled to use "QuikFiler"
    for a period up to forty-five days, after which you MUST register or
    stop using the program.

    Registration entitles you to use this version of "QuikFiler" as well
    as any future versions of the program that may be released.

    Registration benifits:

       ■ Remove the unregistered delay and message at startup
       ■ Allow you to define 9 alt-keys
       ■ Allow you to create reports when using the /AUTO switch
       ■ Allow 100 search command defines
       ■ Help continue the development of more quality programs
       ■ Maintain the legality of your license agreement

    By running any of the  executable programs included,  you agree that
    Multiboard Communications Centre nor any affiliates or  staff of the
    above mentioned  are responsible  for any  damage ever  experienced,
    however so created. If you cannot agree to this, then your privilege
    to use any of these programs  is revoked  and it becomes illegal for
    you to execute any programs included with this documentation.

    You may freely copy and distribute QuikFiler as long as its original
    archived contents are not modified in any way.  You may not give out
    your registration number to anyone else.  Licenses are non-transfer-
    able. You may not use a registration key that is not licensed to you
    by Multiboard Communications Centre.

    It is illegal to edit, alter, hack, reverse engineer and / or modify
    any components of the archive in any manner.

    If dispute of any issues on legal grounds said above, then governing
    law of Ontario, Canada will rule.  If you agree to all of the above,
    then you may use this program.

    * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU GET! *


╓───────────────────────────────────────────────────────────────────────────╖
║ Support                                                                   ║
╙───────────────────────────────────────────────────────────────────────────╜

   If you have any questions or comments, you can netmail us at our Fido
   address 1:2401/305 (CM,VFC,V32).    Please poll back for your replies
   as we get dozens of messages a day, and crashing them all out is just
   too expensive -  or optionally,  make a note that you would like your
   message routed back to you.  You can also contact us via the Internet
   for faster responses, and directly sent out replies.   The address is
   "[e-mail]"   Normally you will find us in the RA_UTIL FidoNet
   area as well, as well as the MCC_SUPPORT echo of course.   The latest
   version can always be FREQ'd from us with the magic name QF.

   You can FREQ the files from us via Fidonet also, the magic names to
   file request are: OLMS, UPCHECK, SPORTS, ISERVER, GIFSEE, VOTEBOX,
   QF and CVS.

   Also the following locations have our files available:

   www: www.uti.com/mcc
   ftp: ra.uti.com/sys/bbs/bbs/mcc
   ftp: ra.fileshop.com/ra/mcc
   bbs: 519-660-8981
   frq: 1:2401/305


╓───────────────────────────────────────────────────────────────────────────╖
║ Registration                                                              ║
╙───────────────────────────────────────────────────────────────────────────╜

    ■ REGISTER.CAN - registration form for Canada
    ■ REGISTER.USA - registration form for USA
    ■ REGISTER.ASA - registration form for ASIA
    ■ REGISTER.AUS - registration form for Australia
    ■ REGISTER.EUR - registration form for Europe


╓───────────────────────────────────────────────────────────────────────────╖
║ Error Messages                                                            ║
╙───────────────────────────────────────────────────────────────────────────╜

    Below is a table that references the possible  error messages values
    that you may see.

       ═════╤════════════════════════════════════════════════════════
       Code │ Section = Swapping routines
       ═════╪════════════════════════════════════════════════════════
        0-x │ Every program has its own return codes.  Consult its
            │ documentation regarding the (x) return code.

       ═════╤════════════════════════════════════════════════════════
       Code │ Section = Swapping routines
       ═════╪════════════════════════════════════════════════════════
        1-1 │ No space for swapping
        1-2 │ Program is too low in memory
        4-0 │ Error allocating environment
        5-0 │ Error calling swap
        5-1 │ Could not return from swap
        5-2 │ Could not swap out
        6-x │ Error caused during redirection

       ═════╤════════════════════════════════════════════════════════
       Code │ Section = Program being called
       ═════╪════════════════════════════════════════════════════════
        2-0 │ Not found
        2-1 │ Invalid drive
        2-2 │ Invalid path
        2-3 │ Invalid name
        2-4 │ Invalid drive letter
        2-5 │ Path too long
        2-6 │ Drive not ready

       ═════╤════════════════════════════════════════════════════════
       Code │ Section = Dos error codes
       ═════╪════════════════════════════════════════════════════════
        3-2 │ File not found
        3-3 │ Path not found
        3-5 │ Access denied
        3-6 │ Invalid handle
        3-8 │ Not enough memory


╓───────────────────────────────────────────────────────────────────────────╖
║ Acknowledgments                                                           ║
╙───────────────────────────────────────────────────────────────────────────╜

    This program has been tested on  MS-DOS 3.3 through 6.22,  DESQview
    2.40 through 2.63, DESQview/X 1.2 and 2.0, Windows 3.1 to 4.0 beta,
    WindowsNT 3.x, OS/2 2.0 through OS/2 3.0 warp,  and Novell DOS 7.0.
    Other  operating  environments should work fine,  but they have not
    been fully tested.  Requires at least DOS 3.3.

    The JAM message base format is used in "QuikFiler" and  this is the
    JAM license header:  "JAM(mbp)-Copyright 1993 Joaquim Homrighausen,
    Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED."   The
    RemoteAccess filebase format, RemoteAccess and RA are (C) Copyright
    Andrew Milner and Wantree Development, 1993.   All rights reserved.

    PKZIP/PKUNZIP, Copyright PKWARE; ARJ, Copyright Robert K Jung; LZH/
    LHA, Copyright Haruyasu Yoshizaki;  X00, Copyright Ray Gwinn;  BNU,
    Copyright David Nugent & Unique Computing; DESQview, Copyrighted by
    Quarterdeck Software;  MS-DOS, MS-Windows, Copyrighted by Microsoft
    Corporation; OS/2, Copyright International Business Machines Corp.,
    Thanks to the  public domain swapping  utilities that required very
    little in the way of tweaking, by Thomas Wagner.   QuikFiler (c) by
    Multiboard Communications Centre.

    Thanks to you,  the user,  for actually reading to the  end  of the
    documentation, and remember, please register, it's cheap!