home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / acf515r2.arj / ACFILES.DOC < prev    next >
Text File  |  1991-04-26  |  37KB  |  972 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.      ┌───────────────────────────────────────────────────────────────────────┐
  11.      │               The Auto Control File System - AKA, ACFiles             │
  12.      │                    The Originator of File Tagging                     │
  13.      ├────────────────┬─────────────────────────────────────┬────────────────┤
  14.      │ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│          ACFiles Version 5.15       │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ │
  15.      │    ▀▀▀▀▀▀▀▀▀▀▀▀│      QuickBBS/RA File Replacement   │▀▀▀▀▀▀▀▀▀▀▀▀    │
  16.      │        ▀▀▀▀▀▀▀▀│         The Best File System        │▀▀▀▀▀▀▀▀        │
  17.      │             ▀▀▀│            By: Ray 'C'ole           │▀▀▀             │
  18.      └────────────────┴─────────────────────────────────────┴────────────────┘
  19.  
  20.  
  21.                                  Documentation By
  22.                              Ray Cole and Fred Rorex
  23.  
  24.  
  25.  
  26.  
  27.                          Thanks To the BETA Testing Team:
  28.  
  29.  
  30.            ╔══════════════════════════════════════════════════════╗
  31.            ║ ****   ACFILES SUPPORT BBS - HOME OF ACFILES    **** ║
  32.            ║ Ray 'C'ole    - Auto Control BBS      - QBBS/Binkley ║
  33.            ║                 1:382/83  (512) 778-6246  *9600 HST* ║
  34.            ╚══════════════════════════════════════════════════════╝
  35.              Fred Rorex     - MicroWorld BBS           - QBBS/Binkley
  36.                               1:382/78  (512) 259-3185   2400
  37.              Allen Andrews  - The ACADemy of Austin    - QBBS/Frontdoor
  38.                               1:382/56  (512) 445-6000  *9600 HST*
  39.              David Gordoa   - Heart O' Texas BBS       - RA/Binkley
  40.                               1:382/80  (512) 929-9107  *9600 HST*
  41.              Robbie Romano  -            QE2           - RA/Binkley
  42.                               1:382/58  (512) 328-1229   2400
  43.              Jim Watson     -       CyBorg ConTrol     - RA/Binkley
  44.                               99:9100/65 (512) 928-8840  2400/MultiLine(3)
  45.              Joe Wessels    - Phantom's Mansion        - QBBS/Frontdoor
  46.                               1:382/72  (512) 835-7282   2400
  47.              Johnny Pulliam - Far Point Station        - RA/Binkley
  48.                               1:382/77  (512) 259-4896  *9600 HST*
  49.              Jim Pefley     - The Suffold News         - RA/Frontdoor
  50.                               1:275/326 (804) 393-2199  *9600 HST*
  51.              Larry Stultz   - The Technical Connection - RA/D'Bridge
  52.                               1:3600/10 (904) 963-1342  *9600 HST*
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                     ACFiles
  74.                                Table of Contents
  75.  
  76.  
  77.      1 ..................................................... Overview
  78.  
  79.      2 ..................................................... Terminology
  80.  
  81.      2 ..................................................... Requirements
  82.  
  83.      3 ..................................................... Setup
  84.  
  85.      6 ..................................................... Other Setup
  86.  
  87.      7 ..................................................... Protocol Config
  88.  
  89.      9 ..................................................... Connecting w/ BBS
  90.  
  91.      9 ..................................................... Other Configs
  92.  
  93.      10 .................................................... Moving Files
  94.  
  95.      10 .................................................... Sysop Commands Menu
  96.  
  97.      11 .................................................... User Commands
  98.  
  99.      12 .................................................... Other Programs
  100.  
  101.      12 .................................................... External Protocols
  102.  
  103.      13 .................................................... Registration
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.      Introduction - ACFiles                                      Page 1
  135.     
  136.  
  137.      DISCLAIMER:
  138.  
  139.      ACFiles is only guaranteed to take up disk space if you have it on any
  140.      type of computer media.  However, if you or your system deletes it
  141.      then it is no longer guaranteed to do anything.
  142.  
  143.      OVERVIEW:
  144.  
  145.      Auto Control Files (ACFiles) is a unique full File System for QuickBBS
  146.      with a different twist.  It has a unique "Quick-Select" bar so that you
  147.      and users can select files while viewing a file list.  From there the
  148.      user can download the files without having to ever enter a filename.
  149.      The Sysop can use these "tagged files" to do such things as mass-file
  150.      movement to other areas, mass-deletion, un-hide the file for users,
  151.      and even edit the description.
  152.  
  153.      While ACFiles is a nice program for users, you will find it even better
  154.      from the SysOp side.  The status bar looks similar to QuickBBS's bar.
  155.      Setting it up is quite easy.  There are a variety of SysOp commands
  156.      available and it even includes a full-screen chat brought up by ALT-C.
  157.  
  158.      ACFiles can handle up to 120 file areas.  Each one is configured for
  159.      access security, upload area, configured FILES.BBS path and name (so
  160.      you aren't forced into having it 1 particular way), area Name, and even
  161.      area description.
  162.  
  163.      ACFiles also has a General Configuration for the BBS name, SysOp-level
  164.      security, screen write mode (BIOS or Direct), whether or not you want
  165.      uploaded files to be hidden from a user, inactivity timeout in seconds,
  166.      and an Upload Time Credit ratio.
  167.  
  168.      Tired of the way the MOVE commands are?  Well, configure your own!
  169.      ACFiles calls a batch file upon moving a file.  The batch file is
  170.      passed 4 variables that allow you to make it "smart" enough to convert
  171.      to various compression formats, scan for viruses, or whatever you want
  172.      it to do!  Samples are included.
  173.  
  174.      And finally, ACFiles is great for having a "File Section Co-SysOp" with
  175.      all of its powerful commands.  No longer does a Co-Sysop need to know
  176.      your paths to all your file areas..  Each area is easily identified.
  177.  
  178.      NEW FEATURES:
  179.  
  180.      File locking for multi-node setups
  181.      Checks for dupes
  182.      ALt-G, Alt-F, Alt-S SysOp keys
  183.      ASCII Selection in List
  184.      New Files marked with *.
  185.      Up to 100 files can now be tagged for download
  186.      If a user has ASCII, ACFiles will still display color locally.  Note that
  187.      the color will only show locally and will not effect the remote user.
  188.  
  189.      
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.      Terminology - ACFiles                                       Page 2
  201.  
  202.  
  203.      IMPORTANT TERMINOLOGY
  204.  
  205.      Even if you think you know all the terminology of a file system, I'd
  206.      suggest you read this to keep you from getting confused.  Some of these
  207.      may be new to you:
  208.  
  209.      Area Tag: This is a short 2-key code for a file area.  It consists of
  210.                the key combination pressed to get to the area.  For example,
  211.                B5 would refer to Set B, Number 5.  Area tags will be
  212.                displayed at the top of each area in ACFCONF.  Anytime
  213.                you see something asking for an Area Tag, it is NOT a path.
  214.                Throw that idea out of your mind and think about each area
  215.                being assigned a specific tag.
  216.  
  217.      Tagged File: This refers to a file that has been "tagged" using the
  218.                   selection bar in the file listing.  Tagged files can have
  219.                   many things done with them upon your command.
  220.  
  221.      FILES.BBS: This is the filename used by QuickBBS and other systems to
  222.                 refer to a file consisting of the filenames and
  223.                 descriptions of the files in a particular file area.  I
  224.                 will refer to those lists as FILES.BBS's.  However, ACFiles
  225.                 does not force you to name them this.
  226.  
  227.  
  228.  
  229.  
  230.      MISCELLANEOUS ITEMS AND REQUIREMENTS
  231.  
  232.      ErrorLevels: Upon exit, ACFiles exits with the following errorlevels:
  233.  
  234.                   0 - Exit Program (Normal)
  235.                   1 - General Error (File Not Found, Etc.)
  236.                   2 - Carrier Dropped
  237.                   3 - Time Up For User
  238.                   4 - Fossil Init Failure
  239.                   6 - Inactivity Timeout
  240.  
  241.  
  242.      Requirements: IBM or compatible computer running Dos 3.X and later.
  243.                    Quickbbs or Remote Access style bbs system, and the
  244.                    achivers (if you want to support these.)
  245.  
  246.                    PKPAK.EXE           PKWARE Inc.             ARC
  247.                    PKZIP.EXE           PKWARE Inc.             ZIP
  248.                    PAK.EXE             NoGate Consulting       PAK
  249.                    LHARC.EXE           Yoshi                   LZH
  250.                    ZOO.EXE             Rahul Dhesi             ZOO
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.      Setup - ACFiles                                             Page 3
  267.  
  268.  
  269.      STARTING OUT
  270.  
  271.  
  272.                            ! ! ! IMPORTANT ! ! !
  273.          *** ANSI MUST BE INSTALLED FOR ACFILES TO RUN CORRECTLY ***
  274.  
  275.      Place all of the ACFiles files into their own sub directory.  Run
  276.      ACFCONF.EXE.  You will notice a selection of either General or Area
  277.      configuration.  Select G first.
  278.  
  279.      If you want to run ACFiles multinode, create a directory for each node.
  280.      Setup ACFiles in each one.  ACFiles will do file locking for the file
  281.      lists, etc. to keep other programs from hurting them.
  282.  
  283.      You will now see a screen like this:
  284.  
  285.  
  286.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  287.      1)     BBS Name: The Auto Control BBS
  288.      2)  Master List: autoctrl.txt
  289.      3)   SysOp Sec.: 64000
  290.      4) Screen Write: DIRECT
  291.      5)     UpLoads Hidden: Yes
  292.      6) Inactivity Timeout: 120 Sec.
  293.      7) Upload Time Ratio: 2 Times
  294.      8) Auto-D/L File 1: g:\mail\autoctrl.txt
  295.               List of Master Files
  296.      9) Auto-D/L File 2:
  297.      0) Transfer Log Name: h:\acfiles\transfer.log
  298.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  299.      Selection:
  300.  
  301.      The fields for this may be empty right now.  First let's define your
  302.      BBS name.  Hit 1.  It will ask for your BBS name.  Enter in what you
  303.      want your BBS's name to be displayed as.
  304.  
  305.      Next let's tell it your Master File List.  This is a file produced by
  306.      ACMASTER if you choose to use it to make your Master Files List.  This
  307.      can consist of a full path and filename to a list you want created.  If
  308.      you do not run ACMaster then this field is unused.  It is suggested to
  309.      put something there anyway.
  310.  
  311.      Now define the SysOp Security level for the file door.  This is the
  312.      access level that all Hidden Files will be displayed and all SysOp
  313.      commands will be available.  I wouldn't make this low enough for normal
  314.      users to access, as the commands are VERY powerful..
  315.  
  316.      Next select 4 to modify the Screen Writes mode.  If you don't have an
  317.      old CGA card that produces Snow with direct writes, then tell it (2)
  318.      for Direct writes.  If this doesn't work right for you when ACFiles is
  319.      run then you may reset it to 1, BIOS Writes which is a bit slower..
  320.  
  321.      Uploads Hidden is the 5th selection.  Press 5.  If you want ALL
  322.      uploaded files to be hidden from users (Users are defined as those with
  323.      access lower than the SysOp security defined above) then simply tell it
  324.      that you do want the files to be hidden.  Else tell it No and all
  325.      uploaded files will appear normally to all using the file system.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.      Setup - Cont.                                               Page 4
  333.  
  334.  
  335.      The next two may seem stupid since they are defined in the QBBS/RA
  336.      configuration programs.  However, since it is a pain to support both
  337.      configuration types, these two options are only configurable here.
  338.  
  339.      Select 6 to tell ACFiles how many seconds ACFiles should wait until
  340.      hanging up on a user if no key is pressed in that amount of time.
  341.      360 seconds is usually a good number (3 minutes.)
  342.  
  343.      Number 7 is the Upload/Time Ratio multiplier.  This determines how much
  344.      time credit a user gets when they successfully upload a file.  For each
  345.      minute uploaded, they will receive the amount of minutes defined here.  So
  346.      if I specified 3 minutes here, and a user uploaded a 5 min. file, then it
  347.      would give them (3*5) minutes, or 15 minutes of extra time.
  348.  
  349.      8 and 9.  These are the options to select auto-download options.  This
  350.      allows the sysop to assign keys 1 and 2 in the Main Menu to transfer these
  351.      files without the user entering a filename.  The description is also
  352.      included.  This is useful so that the user can download your master file
  353.      list without knowing the name.
  354.  
  355.      Hit 8.  It'll ask for a filename.  Enter a complete path and filename.
  356.      Next enter a SHORT description for it - very short..  Then when you run
  357.      ACFILES you'll see it is on the Main Menu screen as 1 - <description>.
  358.  
  359.      Experiment around with that one.
  360.  
  361.      General configuration is now complete.  Hit enter to save it and return
  362.      to the main selection menu.
  363.  
  364.      Now you need to define your file areas.  Hit A.  You will see a screen
  365.      similar to this:
  366.  
  367.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  368.      Area Tag: A5
  369.      1 - Name: IBM Files
  370.      2 - Desc: This Is For IBM Files
  371.      3 - Path: F:\IBM
  372.      4 - FILE.BBS: F:\IBM\FILES.BBS
  373.      5 - Upload Area Tag:
  374.      6 - Sec.: 5
  375.      A - Flag A: --------
  376.      B - Flag B: --------
  377.      C - Flag C: --------
  378.      D - Flag D: --------
  379.      Regular File Area
  380.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  381.      [+] Next, [-] Previous [J] - Jump to Area [U] - Global U/L Tag Change
  382.      Enter # To Change:
  383.  
  384.      [A-D] - Edit Security Flags
  385.  
  386.      This allows you to specify the necessary flags needed for a user to
  387.      access these file areas.  All 4 flags sets are supported.
  388.  
  389.      The fields may be blank if you are starting out fresh without any
  390.      existing ACFPATH.CTL (a sample one is in the package for your
  391.      convenience.  This is the file you are editing with ACFCONF.)
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.      Setup Cont. - ACFiles                                       Page 5
  399.  
  400.  
  401.      The top line is that area's Area Tag.  Now if you read the terminology
  402.      earlier in this documentation then we are in good shape.  If you failed
  403.      to read it, then PLEASE read it now or you may be lost..
  404.  
  405.      The remaining lines are the Area's name, description, files path, file
  406.      area's list name, the Upload Area Tag [NOTE - NOT A PATH!!!!!!], and
  407.      the Security needed to access the area.  You will also see Regular File
  408.      Area displayed underneath.  This will always be there UNLESS you have
  409.      the term "GIF" in the Area name.  Then it will say it is a .GIF area
  410.      and ACFILES will replace the View Archive command in the area's command
  411.      set to View GIF header.
  412.  
  413.      Let's go through the configuration of a file area.. [Oh, boy..what
  414.      fun!]
  415.  
  416.      Hit 1 to edit the area's name.  Simply type in the area's name.  If you
  417.      wish for this area to be deleted, then hit enter on the line leaving a
  418.      blank line.  The configuration will show it to be a deleted area.
  419.      Let's type in a name for now.  After entering the area's name, press
  420.      enter and you will see the above screen again.
  421.  
  422.      Now hit 2 to give the area a description.  From this configuration line
  423.      and on, pressing Enter on the input prompt will cause ACFiles to accept
  424.      it as "no change" to the line.  Type in the area's description here and
  425.      press enter.  You will note it has been updated.
  426.  
  427.      Now hit 3 and give it a path.  The path may be ended with a \ or you
  428.      can leave it off - it really doesn't make a difference.  Hit enter
  429.      after entering the path.
  430.  
  431.      Now hit 4 to edit the Files List path/name.  Note that this MUST be a
  432.      full path and filename of the file area's list.  It defaults to the
  433.      area's path and FILES.BBS as the name for your convenience.  This may
  434.      be ANYTHING you want - even down to the name.  However, if you decide
  435.      to name it differently from conventional methods, then my utils. will
  436.      be the only ones that will get the list names correct..
  437.      If you are new to this or want to be able to use your previous
  438.      utilities then leave it as the Path\FILES.BBS.
  439.  
  440.      Next hit 5 to define the area's Upload Tag.
  441.  
  442.      NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE  NOTE
  443.  
  444.      THIS IS NOT A PATH NAME!!!!  IT IS AN AREA TAG!  ENTERING A PATH NAME
  445.      OR AN INVALID TAG WILL CAUSE ACFILES TO KICK YOU RIGHT BACK TO THE BBS.
  446.  
  447.      ACFiles allows you to make files go to any defined area you want when
  448.      they hit [U]pload in the area you are configuring.  Let's say that you
  449.      want all your files in this area to go to your Uploads Directory that
  450.      just happens to be area tag A0 (area tags are displayed at the top of
  451.      each area's configuration.  See above example.)  You would simply put
  452.      A0 here.  This allows you to make uploads go wherever you want.
  453.  
  454.      Press enter when through with this.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.      Setup Cont. - ACFiles                                       Page 6
  465.  
  466.  
  467.      Finally press 6 to edit the area's security level.  This is the minimum
  468.      security required for a person to access this file area.  Note that
  469.      this area won't even be displayed in the menus in ACFiles for those
  470.      that don't have a high enough access level.
  471.  
  472.      You've now configured your first file area.  Hit + to go to the next
  473.      file area until you have configured all the areas you want for your
  474.      system.  Areas do not have to be contiguous.
  475.  
  476.      You will also notice the J and G commands.  J allows you to Jump To a
  477.      file area by entering it's tag.  So if I am in area A0 (the first area
  478.      that appears when you go to the Areas Edit) and I want to go to area
  479.      H8, I would hit J and enter in H8.
  480.  
  481.      G allows you to globally change EVERY file area's upload directory to 1
  482.      area tag.  Use this with care..
  483.  
  484.      Once you are satisfied with your area configuration, hit Enter to save
  485.      your changes.  Then press Q to Quit the configuration program.
  486.  
  487.      I know this seems like a lot, but you'll get the hang of it.
  488.  
  489.      There is more..
  490.  
  491.  
  492.  
  493.      OTHER SETUP
  494.  
  495.      K-Byte limits are defined in RA's/QBBS's configurations.  Usually this
  496.      is via. LIMITS.CTL.  Read your BBS packages documentation on this.
  497.      This data is passed to ACFiles via. EXITINFO.BBS, so the limits are
  498.      defined with your BBS package's method.
  499.  
  500.      Go into your AUTOEXEC.BAT and create the following lines in the start
  501.      of your AUTOEXEC.BAT.
  502.  
  503.      SET DSZLOG=C:\ACFILES\DSZ.LOG
  504.      SET DSZPORT=2
  505.  
  506.      DSZLOG is the full path and filename to your DSZ.LOG.  This MUST be in
  507.      the same directory as ACFILES and named DSZ.LOG.  Failure to have this
  508.      set right will result in NO download counters/time ratios, etc. to be
  509.      updated..  So if I have ACFILES in the directory C:\ACFILES, then the
  510.      command above is the one I would use.
  511.  
  512.      DSZPORT is the COM port for your modem.  2 is for COM2.
  513.  
  514.      If you are multitasking then these can be done inside of DV also..
  515.  
  516.      You may also specify the ACFiles log name.  Simply select 0 on the General
  517.      Configuration to tell the log name.  Default is TRANSFER.LOG
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.      Protocol Configuration - ACFiles                            Page 7
  531.  
  532.  
  533.      PROTOCOL CONFIGURATION
  534.  
  535.      In the ACFCONF program you'll notice a Protocol editor. For those that
  536.      don't need anything other than what is pre-configured with ACFiles, I'd
  537.      suggest leaving it alone.  However, if you want to add a protocol..
  538.  
  539.      I've tried to make this as easy as possible.  ACFiles calls the external
  540.      protocols and MUST be able to read a log file which IT creates telling what
  541.      it transferred, if it was successful, and how many bytes were transferred.
  542.      For that reason, there may be 1 or two external protocols that won't work.
  543.  
  544.      If you have troubles, please send me a copy of the protocol you are
  545.      installing and I'll get you a configuration for it.
  546.  
  547.      You'll notice a screen containing "slots" for each external protocol.
  548.      Select the letter of the slot you wish to edit.
  549.  
  550.      It will now ask for the Protocol Name.  This is how the name will appear to
  551.      the user when they select the protocol.  This should be short.
  552.      Enter - by itself on the line will delete the protocol.
  553.  
  554.      Next it'll ask if it is a batch protocol.  This is for protocols like
  555.      Zmodem that allow multiple files to be transferred.  Answer Yes or No
  556.      accordingly.
  557.  
  558.      Now it'll ask if it is a two-way protocol.  This is like Bimodem.  Set this
  559.      to Yes or No if this protocol allows receiving and transmitting of files at
  560.      the same time.
  561.  
  562.      The next statement is the command to send a file.  This and the next one,
  563.      command to receive, are explained in detail below.  Generally, call a batch
  564.      file with %1 %2 %3 %4 %5 %6 %7 %8 %9 and it'll be easier on you.
  565.  
  566.      ACFiles will call these lines exactly as entered.  The following symbols
  567.      are special for ACFiles and causes it to substitute information in place:
  568.  
  569.  
  570.      %1 - Filename(s) to send
  571.      %2 - Baud Rate
  572.      %3 - Com Port
  573.      %4 - File Containing List Of Files To Send
  574.      %5 - Upload Path
  575.      %6 - Download Path
  576.      %7 - Time Left in Minutes
  577.      %8 - Drive Of Upload Path - Ex.   F:
  578.      %9 - Path of Upload Path -  Ex.   IBM\RECEIVE
  579.  
  580.      Where does %8/%9 come in handy??
  581.  
  582.      If you are NOT a registered DSZ user then you will NOT be able to specify a
  583.      path for where uploaded files go.  Therefore you can call the batch file
  584.      with the %8/%9 parameters and do:
  585.  
  586.          %8
  587.          cd%9
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.      Protocol Configuration - Cont.                              Page 8
  597.  
  598.  
  599.      NOTE: Once these parameters are passed to a batch file the numbers will
  600.      probably be reassigned by DOS.  I'd suggest that if you call a batch file
  601.      (unlike what my examples show..) to call it with ALL 9 parameters in a row
  602.      and do the command line in the batch file with the %'s in there to make it
  603.      less confusing.
  604.  
  605.      Example Command:
  606.  
  607.        xmodup.bat %1 %2 %3 %4 %5 %6 %7 %8 %9
  608.  
  609.        XMODUP.BAT:
  610.  
  611.        %8
  612.        cd%9
  613.        DSZ port %1 estimate 0 %2 rx
  614.  
  615.      My PROTOCOL.CFG contains this for Xmodem:
  616.  
  617.        xmodup.bat %3 %2 %1 %8 %9
  618.  
  619.        XMODUP.BAT
  620.  
  621.        %4
  622.        cd\%5
  623.        DSZ port %1 estimate 0 %2 rx
  624.  
  625.      Note that the statements in the batch file change because the batch file
  626.      uses the %'s that you sent and renumbers them from %1 on.  So it is MUCH
  627.      easier to just send all %'s to a batch file and that way you don't have to
  628.      do any conversion.
  629.  
  630.      Now we are down to the log file format.  It is explained here:
  631.  
  632.      Log File Format:
  633.  
  634.      This is the ONLY way that ACFiles will know if a file is sent or not.  It
  635.      will NOT update your counters, etc. correctly if this is not set correctly.
  636.  
  637.      You must know what type of log entries your external protocol makes.
  638.  
  639.      Example of DSZ.LOG:
  640.  
  641.      Z 149372   2400 bps  217 cps    0 errors  506 1024 F:\10\21.ZIP -1
  642.  
  643.      The Log Format statement in PROTOCOL.CFG represents a "format" of the log
  644.      file's lines.  It has a few flags that represent various things:
  645.  
  646.      %s - Status Flag Location
  647.      %b - Bytes Sent
  648.      %f - Filename - With or Without a Path
  649.      %g - Garbage
  650.  
  651.      These represent locations.  Spacing between them doesn't matter.  So, for
  652.      the above log entry, the format would be:
  653.  
  654.      %s %b %g %g %g %g %g %g %g %g %f
  655.  
  656.      This means the first word will be the flags, which are checked with the
  657.      Sent Good/Received Good flags defined in Protocol.cfg.  They are case
  658.      sensitive.
  659.  
  660.  
  661.  
  662.      Connecting with the BBS - ACFiles                           Page 9
  663.  
  664.  
  665.      The second word is expected to be the # Bytes sent/received.
  666.      The next 8 works are garbage and not need by ACFiles.
  667.      The 11th spot if the filename
  668.      Since the rest of the log entry isn't needed, there are no other "format"
  669.      flags in the log format line and the rest is ignored.
  670.  
  671.      Good Flags:
  672.  
  673.      The next information asked for is what the protocol will put in it's log
  674.      file for the %f slot if it is successful at transfer.  ACFiles checks these
  675.      case sensitive.  These are allowed for both send and receive flags.  Z in
  676.      the log example above would be a Receive good flag.
  677.  
  678.      Next is the protocol log name.  THIS IS NOT a log file for you...This is
  679.      telling ACFiles what the log file name is that the external protocol
  680.      creates for it to read in needed information.  Failure to have this set
  681.      right as well as the flags will cause the Byte counters and Download #
  682.      counters to not be updated..
  683.      That is it.  For more information or help, call the support BBS.
  684.  
  685.  
  686.      CONNECTING IT WITH THE BBS
  687.  
  688.      Make a Type 15 (or Type 7 if you are using QuickBBS 2.75 or above) that
  689.      calls the door like the following:
  690.  
  691.       C:
  692.       CD\ACFILES <c:\QuickBBS>
  693.         -You may specify the path to the EXITINFO.BBS and DORINFO1.DEF.  Simply put
  694.         -the path when calling ACFiles.  Ex.  ACFILES C:\QUICKBBS
  695.         -Trailing backslash is optional.
  696.       EGA43      <---------  This statement is to switch to 43 line mode
  697.       ACFILES                IF you have EGA/VGA. Use whatever comes with
  698.       C:                     your video card!
  699.       CD\QUICKBBS
  700.          {call QuickBBS again}
  701.  
  702.      You are now ready to try it out.  Either run the BBS and call ACFiles
  703.      with the menu you have just created or go to the ACFiles directory and
  704.      type ACFILES L.
  705.  
  706.      If you have EGA or VGA, I'd suggest you have your batch file make your
  707.      screen length 43/50 lines upon start up. That way you can use all the lines
  708.      yourself as well as viewing the file list properly when a remote is
  709.      on-line.  ACFiles will figure out your screen length for both remote and
  710.      local.
  711.  
  712.      OTHER CONFIGURATIONS
  713.  
  714.      If a batch file FREQDOOR.BAT exists, then ACFiles will be triggered to
  715.      display a [R]equest Door command for users.  ACFiles will call
  716.      Freqdoor.bat to run the door.  This is in case you like one of those.
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.      Moving Files - ACFiles                                      Page 10
  729.  
  730.  
  731.      MOVE.BAT is the batch file QuickBBS calls when moving files.  3
  732.      examples are given - MOVE.BAT does nothing (will act like QuickBBS's
  733.      Move command), TOZIP.BAT will convert all files to .ZIP, and
  734.      SCANZIP.BAT will scan the files being moved for Viruses and convert to
  735.      .ZIP format.  See the MOVE.BAT section elsewhere.  DO NOT MESS WITH
  736.      THIS FILE UNLESS YOU FEEL YOU KNOW WHAT YOU ARE DOING!
  737.  
  738.      DSZ.EXE (or .COM) must exist in the ACFiles directory or the current path
  739.      in order for the uploads/downloads to work.
  740.  
  741.      MOVE.BAT CONFIGURATION
  742.  
  743.      MOVE.BAT is a batch file called from ACFiles when a file is moved.  It
  744.      is passed the following parameters:
  745.  
  746.      move.bat {filepath} {filename} {filename WITHOUT .EXT} {filename .EXT}
  747.  
  748.      So let's say I'm moving a file TEST.ZIP from area A2 (which you have
  749.      configured as having a files path of D:\BBS).  ACFiles would pass the
  750.      following:
  751.  
  752.      move.bat D:\BBS\ TEST.ZIP TEST ZIP
  753.  
  754.      Therefore you can check %1, %2, %3, and %4 in your batch file to do all
  755.      sorts of things.
  756.  
  757.      Upon exiting, MOVE.BAT must create a file called FILENAME that
  758.      contains the file's name.  This allows you to change to filename during
  759.      a conversion from .PAK to .ZIP.  If the filename above was not
  760.      modified, then you could do ECHO %2.%3 >FILENAME.  That would put
  761.      the name TEST.ZIP into the file FILENAME.  ACFiles will read this in
  762.      and put that name in the file area's list.  Let's say we changed the
  763.      extension to .PAK.  We'd do an ECHO %2.PAK >FILENAME and QuickBBS would
  764.      know that the file's name has been modified and will use it in the new
  765.      file list.
  766.  
  767.      Look at TOZIP.BAT and SCANZIP.BAT for good examples.
  768.  
  769.      SYSOP COMMANDS MENU
  770.  
  771.      Hitting * in a file area (for SysOp's) causes ACFiles to display a
  772.      complete sysop menu.  Here you can Move a file (up to 6 or 7 at a
  773.      time), delete a file(s) (up to 6 or 7), Hide/Unhide a file (6 or 7 at a
  774.      time..), or edit a file's description (6 or 7 at a time..)
  775.  
  776.      The move command will ask for files to move.  If you have selected
  777.      files in the file list using the selection bar then it will have these
  778.      names on the name prompt already.  In either case, enter the names of
  779.      the files you want to move and hit Enter.  If the names were valid, it
  780.      will ask you which area you want to move the file(s) to.  A complete
  781.      list of file area names and their tags are displayed.  Enter the area
  782.      tag associated with the file area you want to move the file(s) to.
  783.      ACFiles will then move the files calling the MOVE.BAT for any
  784.      conversions you want.
  785.  
  786.      Delete works in the same manner as above in enter the filenames.  Hit
  787.      enter on the filenames you want to delete and it will delete them.
  788.      Space out the prompt and it will abort.
  789.  
  790.  
  791.  
  792.  
  793.  
  794.      User Commands - ACFiles                                     Page 11
  795.  
  796.  
  797.      Hide/Unhide works the same way with entering the filenames.  For each
  798.      one entered it will tell you if it is currently hidden or not and then
  799.      asks if you want it Hidden or Unhidden.  Hidden files will only be
  800.      displayed to those with SysOp access.  What may be helpful to know is
  801.      that ACFiles does this by placing a @ in the front of the filename in
  802.      the area's list.  This tells ACFiles (and it's utils) that these are
  803.      hidden files.  This also works for comment lines, but comment lines can
  804.      not be hidden from this menu.  You can go in and manually edit the list
  805.      with an ASCII editor to do this.
  806.  
  807.      Edit Descriptions: All files entered here will be displayed and you
  808.      will be asked to edit the description.  Hit enter after it is how you
  809.      want it to be and that becomes the file's new description.
  810.  
  811.      A - Add a filename.  This option allows you to add a filename into the
  812.      listing.  Upon hitting A it will search the directory for any files that
  813.      are not listed in the FILES.BBS.  It'll display their filenames.  You can
  814.      then enter in the filenames you want to add.  After entering the filenames
  815.      to add it'll ask for descriptions.  Hitting enter on the descriptions skips
  816.      the addition of the files.
  817.  
  818.      V - View Log File.  This lets you view the log file.  This is useful to
  819.      tell who has uploaded and downloaded throughout the day.
  820.  
  821.      R - Remove Log File.  This lets the sysop remove the log file.
  822.      Confirmation of answering Yes is required before it'll be deleted to keep
  823.      away from accidents.
  824.  
  825.      User Commands:
  826.  
  827.      Most of these are self-explanatory.  The tagged file lists may be
  828.      confusing though.  While viewing a file listing, you can tag files.
  829.      Being a sysop you can use these marked filenames to do the SysOp
  830.      commands.  A user can use this to mark files for download.  A status of
  831.      the time estimate and K marked are displayed at the bottom.
  832.  
  833.      This brings 3 different commands to the menus.  [C]lear tagged files
  834.      will clear the list of tagged files for the current area or for all the
  835.      file areas.  This allows you to reset the list.  [E]dit list will let
  836.      you edit what files are marked or not.  Wildcards are accepted and
  837.      converted into real filenames. [R]eview tagged file
  838.      lists allows you to see what files you have marked in all areas.
  839.      ! togglea ANSI On/Off
  840.  
  841.      While doing a Type a Textfile, View Contents of Archive, or View GIF
  842.      Header, you may hit the Space Bar to toggle between your marked filenames.
  843.      It'll default to the first marked filename.
  844.  
  845.      The Phrase Search (was Keyword Search) searches for a full phrase, not just
  846.      1 single word.  You could enter in "Better Chat" and it would search the
  847.      lists for that phrase.  Whatever you enter is what it'll search for.  Some
  848.      systems only allow 1 word.
  849.  
  850.      ON-LINE COMMANDS
  851.  
  852.      HOME will increase a user's time by 1 minute.
  853.      END will decrease a user's time.
  854.  
  855.      Other keys work like QuickBBS's status bar commands.  PgDn will move
  856.      through the different status bars.  F9 will display the available keys.
  857.      They should be self-explanatory.
  858.  
  859.  
  860.      Other Programs - ACFiles                                    Page 12
  861.  
  862.      ALT-C calls BCHAT.EXE.  Therefore, Bchat must be in the ACFiles
  863.      directory.  This can also be used for your BBS's chat via. a Type 7
  864.      command.  But I think by now all the BBS packages have built-in chat
  865.      programs.
  866.  
  867.      You may edit a user's flags and security while on-line.  Hit ALT-F and
  868.      ALT-S just like in QuickBBS.  These settings are saved.
  869.  
  870.      ALT-T allows you to edit the time instead of adding or subtracting it.
  871.  
  872.      OTHER PROGRAMS:
  873.  
  874.      ACMAINT.EXE
  875.  
  876.      This is the maintenance program.  It reads in the area's lists and
  877.      neatens them up a bit by making the first letter of each word in
  878.      Upper-case, Like This Line Is..  It also sorts the filenames underneath
  879.      the comment lines.  This should cut down on your maintenance.
  880.  
  881.      ACMASTER.EXE
  882.  
  883.      This creates a human-readable file of all the files and descriptions in
  884.      your file system.  It creates a file by the name specified in the
  885.      General configuration of ACFCONF.
  886.  
  887.      If you run ACMaster then you can now check for duplicate uploads.  After
  888.      upload, ACFiles will scan the master list for the newly uploaded file's
  889.      name.  If it exists it'll mark the file as a duplicate by putting DUPLICATE
  890.      FILE!! in the description.
  891.  
  892.      ACMASTER.HED is the text file displayed at the top of the ACMASTER
  893.      list.  ACMASTER.EXL is an "exclude" area list consisting of the area
  894.      tags you want ACMASTER to NOT put in the list.  Format is:
  895.  
  896.         A5
  897.         B7
  898.         C5
  899.  
  900.      FD2ACF.EXE is a program to convert FileDoor-Style FILES.BBS's to ACFiles
  901.      format.  The formats are 99% the same with the exception of the # Times a
  902.      file has been downloaded counter.  This will make the conversion.
  903.  
  904.  
  905.      EXTERNAL PROTOCOLS:
  906.  
  907.      Due to ACFiles having to read a log file and determine if a file has
  908.      been sent/received, I have delayed the External Protocols option until
  909.      a future release.  This is going to be added, so don't worry.  I hope
  910.      the other features will make up for this.
  911.  
  912.  
  913.      That should be it.  If you have any questions then please contact Ray
  914.      Cole at 99:9100/8, 1:382/83, or 50:5512/0.  He'll be glad to hear from
  915.      you!  If the demand is large enough I will create a Fido echo for
  916.      ACFILES support.  Any responses to your netmail will be left in Hold
  917.      for your system to pick up from me.  I usually respond within 24 hours.
  918.      Or you may call (512)778-6246 at 300-14.4K HST and leave a message/page
  919.      me there.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.      Registration -ACFiles                                       Page 13
  927.  
  928.  
  929.  
  930.      REGISTERING:
  931.  
  932.  
  933.                        ACFiles Version 5.15 Registration
  934.                                By Ray 'C'ole
  935.  
  936.  
  937.  
  938.      First Name, Last Name: ___________________________________
  939.  
  940.                    Address: ___________________________________
  941.  
  942.                             ___________________________________
  943.  
  944.                             ___________________________________
  945.  
  946.           Telephone Number: ___________________________________
  947.  
  948.      BBS Software Configuration: ______________________________
  949.  
  950.      Are you a member of a network?  Yes/No   (circle)
  951.    
  952.      If so, please give your primary address: _______________
  953.    
  954.      Name of network: ____________________________________
  955.  
  956.      Where did you hear about ACFiles?
  957.  
  958.      __________________________________________________________
  959.  
  960.  
  961.      Please send $15 to:            Ray Cole
  962.                                     Route 6 Box 255
  963.                                     Leander, TX  78641
  964.  
  965.      USA Currency only please
  966.  
  967.  
  968.      Thanks for your support!
  969.  
  970.      Future programs by me will be released in support for ACFiles.  By
  971.      registering you will help me to be encouraged to keep on with this!
  972.