home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / RA / AM_60_G3.ZIP / AM_60.DOC next >
Text File  |  1994-03-30  |  23KB  |  515 lines
  1.  
  2.   ────────────────────────────────────────────────────────────────────────────
  3.  
  4.   ▀█▀▀▀▄  ▄▀▀▀▀▀▀
  5.    █ █ █  █ █▀▀▀ Dykstra
  6.    █ █ █  ▀▄▄▄▄   Software
  7.    █ ▀ █     ▄ █
  8.   ▀▀▀▀▀  ▀▀▀▀▀ █  (C) Copyright 1993, 1994 William J. Dykstra
  9.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  10.  
  11.   ────────────────────────────────────────────────────────────────────────────
  12.  
  13.                           Online
  14.                           ▄▄▄▄▄               ▄▄▄       ▄▄▄
  15.                          ▄▄   ▄▄              ▄▄ ▄▄   ▄▄ ▄▄
  16.                         ▄▄     ▄▄             ▄▄  ▄▄ ▄▄  ▄▄
  17.                        ▄▄       ▄▄            ▄▄   ▄▄▄   ▄▄
  18.                       ▄▄ ▄▄▄▄▄▄▄ ▄▄           ▄▄         ▄▄
  19.                      ▄▄           ▄▄          ▄▄         ▄▄
  20.                     ▄▄             ▄▄         ▄▄         ▄▄
  21.                    ▄▄               ▄▄ rchive ▄▄         ▄▄ aster
  22.  
  23.                            version 6.0 Public Gamma 3
  24.  
  25.                           (C) 1993, William J. Dykstra
  26.  
  27.                        ─────────────────────────────────
  28.                             version 6.0 is designed
  29.                        Exclusively for RemoteAccess 2.0x
  30.                        ─────────────────────────────────
  31.  
  32.                              If you are upgrading...
  33.     ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  34.     ■                                                                      ■
  35.     ■ *** REMOVE THE FIRST THREE LINES FROM YOUR CONFIGURATION FILE ***    ■
  36.     ■                                                                      ■
  37.     ■ The SysOp name, BBS name, and Registration code fields are no longer ■
  38.     ■ used!  REMOVE THESE LINES FROM THE CONFIGURATION FILE!               ■
  39.     ■                                                                      ■
  40.     ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  41.  
  42.  
  43.  
  44.  
  45. What is it?
  46. ──────────
  47.     Online Archive Master is a program that allows a user on a BBS to
  48.     view the contents of archive files while online.   Many archives are
  49.     very large, and may take upwards of 30 minutes to download.   By
  50.     using this program, a person can read the documentation included
  51.     with a file to help determine if they would like to spend that much
  52.     time downloading it.
  53.  
  54.     This program will display the contents of the archive to the user.
  55.     The user may then choose to read a file or files within the archive,
  56.     or to extract individual files to download separately.
  57.  
  58.     There are several programs similar to this one available, however
  59.     most only support one archive method (namely, ZIP).  Online Archive
  60.     Master supports ZIP, ARJ, LZH, LHA, ARC, SQZ and PAK formats.  Any
  61.     file(s) that are extracted are stored in ZIP format.
  62.  
  63.     Versions of Online Archive Master up to and including version 3.8
  64.     should run on any BBS that supports DORINFO1.DEF.  Version 4.0+ is
  65.     EXCLUSIVELY for RemoteAccess BBSes, and will not run on any other
  66.     BBS (as far as I know).
  67.  
  68.     Version 6.0 is the first release that supports the RemoteAccess 2.0x
  69.     File DataBase.   Version 6.0 will NOT work with RemoteAccess 1.11.
  70.  
  71.     Online Archive Master 6.0 can be used in two ways.  First, it can be
  72.     used as a door, which users should be able to access from your file area
  73.     menu whenever they wish to view the contents of an archived file.
  74.     Second, it may be used as your EXTERNAL ARCHIVE VIEWER, as defined in
  75.     RACONFIG.
  76.  
  77.     X00 FOSSIL DRIVER IS RECOMMENDED, AS BNU tends to lockup with some
  78.     versions.  If you load BNU.SYS instead of BNU.COM, then you may be
  79.     able to run Online Archive Master.
  80.  
  81.  
  82.     Online Archive Master has the following features:
  83.  
  84.         - Allows users to view contents of archive files
  85.         - Users may read files within archives
  86.         - Users may extract files for separate downloading
  87.         - Supports Nested Archives!
  88.         - Fully aware of time limits and carrier detection is enabled.
  89.           Keyboard inactivity is also tracked.
  90.         - Uses the RemoteAccess 2.0x file database.
  91.         - Allows users to view file area listings for each file area and
  92.           group that they are allowed to access.
  93.         - Status bar shows who's online (NOTE: STATUS BAR is NOT shown when
  94.           the sysop is on locally)
  95.         - Supports ZIP, ARJ, PAK, LHA, LZH, ARC, and SQZ
  96.           (ARJ files with the .SDN extension are also supported.)
  97.         - ALL RemoteAccess limits and security settings are checked.
  98.             * File passwords are enforced.  A user may not view an
  99.               archive that is protected with a password unless s/he
  100.               knows the password.
  101.             * Files flagged as OFFLINE may not be viewed.
  102.             * Files flagged as DELETED or UNLISTED will NOT be shown
  103.               in the file listing, and may not be viewed.
  104.             * Files flagged as Not Available MAY be viewed, but users
  105.               may NOT extract files from them for downloading.
  106.             * The user's security level is compared to both Download
  107.               and List security levels for each file area.  The download
  108.               and list flag settings are also checked.   If a user does
  109.               not have List security to a file area, that area will not
  110.               be made available to them.  If they DO have list security,
  111.               but do not have Download security to an area, then they will
  112.               be able to view the files from that area, but they will not
  113.               be able to extract files for downloading.
  114.               (Note: both normal and NOT flags are checked.)
  115.  
  116.  
  117.  
  118.                     Disclaimer (and some other blab...)
  119.                     ───────────────────────────────────
  120.  
  121.         This is where I say I will not be held responsible for any
  122.         damages incurred by the use of this program, etc etc etc.
  123.         I'll skip all that legal blab... What I'm saying is, USE
  124.         THIS PROGRAM AT YOUR OWN RISK.  If it chews your harddrive,
  125.         fries your RAM, sizzles your video card, makes your favourite
  126.         team lose their ball game, or in any other way makes you hate
  127.         me or my program, IT IS YOUR PROBLEM AND NOT MINE!
  128.         The program works very well on my system, so hopefully it will
  129.         also work on yours!
  130.  
  131.         WARNING:  Due to the nature of this program, files are frequently
  132.         archived and unarchived into temporary directories, which are
  133.         created on-the-fly by the program, and removed when no longer
  134.         needed.  Because of this, files are often deleted from the temporary
  135.         directories.   I have gone to great lengths to try to be as sure
  136.         as possible that the files being deleted are files that SHOULD be
  137.         deleted, but there is always the very remote possibility that the
  138.         program will screw up somewhere, and delete a directory that you
  139.         really wanted to keep!   If something like this was ever to occur,
  140.         it would most likely happen to either the root directory or the
  141.         directory directly below the Archive Master directory.  Where
  142.         possible, KEEP A BACKUP of your files!
  143.  
  144.         Again, I've used and tested the heck out of this program, and the
  145.         only time I nuked a directory that I shouldn't have was early in
  146.         the program's development.  That was due to a very serious
  147.         programming flaw on my part, and I almost lost 2 years worth of
  148.         source code because of it.   I've never had any problems since this
  149.         incident, and this nearly fatal accident forced me to be extra
  150.         careful in checking that it will never happen again.
  151.  
  152.         ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  153.         ■  NOTICE:  Some extra checks were added to ensure that the wrong  ■
  154.         ■  files do not get deleted.  It seems that the only time an error ■
  155.         ■  did occur, it nuked the root directory, so I've added code to   ■
  156.         ■  be sure that this can NOT happen again.                         ■
  157.         ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  158.  
  159.  
  160.  
  161.         Now that I've probably scared the heck out of you and you're about
  162.         to delete the thing, please read on before doing so...   :)
  163.  
  164.         I think your users will love having this program online, as
  165.         it can save them a LOT of time in wasted downloads if they
  166.         check out the file BEFORE they download it.  With this
  167.         program they can do just that...  they'll love you.  What
  168.         will it cost you for this extra step towards being sysop of
  169.         the year?  NOTHING!  That's right, this is FREEWARE!
  170.  
  171.         I hope your users get a lot of use out of this program.
  172.         Some of the users on my BBS check out just about every file
  173.         thoroughly (read the docs, etc) before downloading them.  A
  174.         few people even paged to ask where the door was when I was
  175.         working on some enhancements.   I know this isn't the only
  176.         door of its kind floating around, but this is the only one
  177.         that I know of that is FREE while having all the features
  178.         that this one has.
  179.  
  180.         Thanks for using Online Archive Master!
  181.  
  182.                 --Bill
  183.  
  184.  
  185.  
  186.         DISTRIBUTION
  187.         ─────────────────────────────
  188.  
  189.         You may distribute Online Archive Master on your BBS, include it
  190.         on your Shareware disks, CD-ROMs, and so on, as long as no fee is
  191.         charged for the program itself.  Companies that sell CD-ROMs of
  192.         shareware may include the file on the CD-ROMs.   Generally anyone
  193.         can distribute this thing any way they wish, as long as no fee
  194.         is charged for the program itself.
  195.  
  196.         Only ORIGINAL copies of the archive may be distributed!  If any
  197.         modifications are made to the archive, it will FAIL the PkZIP
  198.         authenticity verification (-AV).   Modified versions of the archive
  199.         MAY NOT BE DISTRIBUTED.  Period.
  200.  
  201.         When you unzip AM_60.ZIP, you should see a -AV flag beside each and
  202.         every file that is unzipped.   You should also see this message
  203.         when all files have been unarchived:
  204.  
  205.                  Authentic files verified!    #VLC187
  206.                  William J. Dykstra
  207.  
  208.         If you do not see this message, then the archive has been tampered
  209.         with or corrupted, and you should obtain an original copy from the
  210.         author or some other reliable source.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.         Oh, by the way... I HATE reading documentation, but I REALLY
  219.         hate writing the stuff.  I'm also not that great a technical
  220.         writer, so I hope I've kept things as brief and as clear as
  221.         possible.  If you have trouble figuring things out, please
  222.         let me know, and I'll try to get the problem solved.
  223.  
  224.  
  225.  
  226.  
  227. INSTALLING Online Archive Master
  228. ────────────────────────────────
  229.     Online Archive Master (also referred to as AM) should be installed into a
  230.     separate directory.  A temporary working directory is also required.  The
  231.     temporary directory is used for storing unarchived files temporarily.
  232.  
  233.     General Installation Steps:
  234.  
  235.     (1) Create a directory into which you will place the AM files.
  236.     (2) Copy (or unarchive) the AM files into the directory you just created.
  237.     (3) Create AM-CONF.DAT, the configuration file. (See below for details)
  238.     (4) Setup the proper menu option to allow users to use the door.
  239.     (5) Using RACONFIG, define the EXTERNAL ARCHIVE VIEWER with the following
  240.         command line:    *C /C ARCMAST.BAT *N /F:@ *M
  241.         or if you only have one node:   *C /C ARCMAST.BAT /P:D:\RA /F:@ *M
  242.         This assumes you use ARCMAST.BAT as your batch file (see sample below).
  243.     (6) Create ARCMAST.BAT (or whatever name you want to use).
  244.  
  245.         Sample ARCMAST.BAT file (for multinode):
  246.                 @ECHO OFF
  247.                 CD\RA\AM
  248.                 AM_60.EXE /P:D:\RA\LINE%1 %2
  249.                 CD\RA
  250.  
  251.         Sample ARCMAST.BAT file (for ONE node systems):
  252.                 @ECHO OFF
  253.                 CD\RA\AM
  254.                 AM_60.EXE %1 %2
  255.                 CD\RA
  256.  
  257.         You must be sure to run Archive Master from the CURRENT
  258.         DIRECTORY.  Be sure that your batch file changes into the
  259.         Archive Master directory before running the program.
  260.  
  261.         Parameters Supported:
  262.  
  263.         /P:  path to EXITINFO.BBS and DORINFO1.DEF
  264.              
  265.              This allows you to specify where EXITINFO.BBS and DORINFO1.DEF
  266.              are found.  This makes it very easy to use the program with
  267.              multinode systems.
  268.  
  269.              You *MUST* indicate where the proper EXITINFO.BBS file is.
  270.  
  271.  
  272.         /C:  Configuration filename
  273.              
  274.              This allows you to use a different configuration filename (and
  275.              path) if you need/want to.  By default AM-CONF.DAT is used, in
  276.              the current directory.
  277.  
  278.              
  279.         /F:  Full path and filename of file to view
  280.  
  281.              This option is used to immediately view a file when running AM.
  282.              This is used by the External Archive Viewer option in RA.  The
  283.              menu of choices (change area, view archive, etc) will NOT be
  284.              shown when this option is used. Instead, the program will
  285.              immediately view the archive specified on the command line.
  286.  
  287.  
  288. examples:  AM_60.EXE /P:D:\RA\ /F:D:\RA\FILE\NEW\AM_60_G1.ZIP
  289.               - EXITINFO.BBS and DORINFO1.DEF stored in D:\RA\
  290.               - Immediately view the file D:\RA\FILE\NEW\AM_60_G1.ZIP
  291.  
  292.            AM_60.EXE /P:C:\RA\
  293.               - EXITINFO.BBS and DORINFO1.DEF stored in C:\RA\
  294.               - Program runs and displays menu, not in immediate view mode.
  295.  
  296.            AM_60.EXE /P:C:\RA\  /C:CONFIG.DAT
  297.               - EXITINFO.BBS and DORINFO1.DEF stored in C:\RA\
  298.               - Program runs and displays menu, not in immediate view mode.
  299.               - Use the file CONFIG.DAT from the current directory as the
  300.                 configuration file, rather than using AM-CONF.DAT.
  301.  
  302.            AM_60.EXE /P:C:\RA\  /C:C:\RA\LINE2\CONFIG.DAT /N:2
  303.               - EXITINFO.BBS and DORINFO1.DEF stored in C:\RA\
  304.               - Program runs and displays menu, not in immediate view mode.
  305.               - Use the file CONFIG.DAT from the D:\RA\LINE2 directory as the
  306.                 configuration file, rather than using AM-CONF.DAT.
  307.               - If a user extracts a file, AM_002.ZIP will be created rather
  308.                 than EXTRACT.ZIP, because we specified NODE 2 (/N:2).
  309.  
  310.  
  311.     (7) You may optionally add an entry to your filebase for EXTRACT.ZIP.
  312.         This file is created when a user extracts a file or files.  If you
  313.         do not create an entry in the specified area, then one will be
  314.         created by Online Archive Master.  Once the entry is created you
  315.         may want to change flag settings, etc, if you want the file to be
  316.         tagged as free, unlisted, etc.
  317.  
  318.     (8) Try it and hope it works!
  319.  
  320.  
  321.  
  322.     To Disable the EXTRACT Option:
  323.     ─────────────────────────────
  324.  
  325.     Set line 3 of the configuration file (the Extract area number) to
  326.     ZERO (0).  This will disable the extract feature.  When this feature
  327.     is disabled, the (E)xtract option and the (C)ontents of EXTRACT.ZIP
  328.     option will NOT be displayed.
  329.  
  330.     NOTE: If you disable the extract option, you should probably modify the
  331.     help file (AM_60.HLP) and remove all references to the extract option,
  332.     so as to not confuse your users.
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.     The AM-CONF.DAT Configuration file:
  341.  
  342.     I store all my RA files in D:\RA\.
  343.     I created D:\RA\AM for the Archive Master files.
  344.  
  345.     This configuration file has 6 lines.
  346.  
  347.  
  348.     *** NOTE IF YOU ARE UPGRADING *** REMOVE the first three lines of your
  349.     configuration file!  The BBS name, Sysop name, and registration code
  350.     fields are no longer used!
  351.  
  352.  
  353.       Line 1 is the path to and filename of the log file to be used.
  354.       Line 2 is the path to your RA system files. (CONFIG.RA, FILES.RA)
  355.       Line 3 is the AREA NUMBER of the area where extracted files will be
  356.              placed.  This area must be defined in RemoteAccess.
  357.              *** TO DISABLE THE EXTRACT OPTION, SET THIS VALUE TO ZERO ***
  358.       Line 4 is for optional extra command line switches for PKzip.  These
  359.              are used when a user extracts a file, and PKzip builds the
  360.              extract file.  For example, to add a comment to the ZIP file,
  361.              this line in the config file might be:  -Z < D:\RA\COMMENT.TXT
  362.              where COMMENT.TXT would contain your ZIP comment.
  363.  
  364.              Leave a blank line if you don't want to use any extra switches.
  365.  
  366.       Line 5 is the version of PKunzip you are using.  If you use PKunzip
  367.              version 1.10, then the line should be 110.  If you use version
  368.              1.93 or HIGHER the line should be 193.
  369.       Line 6 is the version of ARJ you are using.  This should be 210 if you
  370.              use ARJ 2.10, and it should be 230 if you use ARJ 2.30.
  371.  
  372.  
  373.     Sample configuration file:
  374.  
  375.       D:\RA\AM.LOG                 <- Log filename
  376.       D:\RA\                       <- path to RA system files
  377.       2                            <- file area where EXTRACT.ZIP is stored
  378.       -Z < D:\RA\COMMENT.TXT       <- Extra PKZip switches
  379.       193                          <- PKunzip version (110 or 193+)
  380.       230                          <- ARJ version (210 or 230)
  381.  
  382.     Once you have correctly modified this file, save it (as an ASCII file).
  383.     If you do not have a registration code, leave it set to zeros.  Any
  384.     incorrect value will simply be ignored.
  385.  
  386.     To run the program, run AM_60.EXE with either one or two parameters.
  387.     NOTE: If you pass a filename on the command line (the second parameter)
  388.     then Online Archive Master will skip the opening credits and the main
  389.     menu, and will immediately show the contents of the specified file (if
  390.     available).  This is useful for using Online Archive Master as your
  391.     external archive viewer (RACONFIG).
  392.  
  393.     Usage:  AM_60.EXE /P:PathToExitInfo /F:FileToView /C:ConfigFileName
  394.             (See explanation of parameters above)
  395.  
  396.     Set AM up as a TYPE 7 program in your RACONFIG menu selection.
  397.     I RECOMMEND THAT YOU USE THE SWAPPING FEATURE (*M).  The program MAY appear
  398.     to work without swapping, but ARJ requires a lot of memory, and it might
  399.     not view ARJ files properly if you do not use swapping.  On my system,
  400.     sometimes the ARJ files simply would not display.  I found that there
  401.     was not enough memory for ARJ to unarchive the files.  Using the *M
  402.     feature fixed this problem.
  403.  
  404.     The following programs MUST be available to the program at all times.
  405.     Be sure these programs can be found in a directory that is in your
  406.     PATH statement:
  407.  
  408.          PKZIP.EXE    (any version)      (for ZIPing extract file)
  409.          PKUNZIP.EXE  (ver 1.10 or 1.93) (for UNpacking ZIP files)
  410.          ARJ.EXE      (ver 2.10 or 2.30) (for UNpacking ARJ files)
  411.          PKUNPAK.EXE  (ver 3.61)         (for UNpacking PAK files)
  412.          PKXARC.EXE   (ver 3.4)          (for UNpacking ARC files)
  413.          LHA.EXE      (ver 2.11)         (for unpacking LZH and LHA files)
  414.          SQZ.EXE      (ver 1.08.3)       (for unpacking SQZ files)
  415.  
  416.     If the program cannot find these files, then it will NOT work.
  417.     If you don't have ANY .LZH or .LHA files, you can do without
  418.     the LHA.EXE program.  If you don't have ANY .ARJ files, you don't
  419.     need ARJ.EXE.  If you don't have ANY .ARC files, you don't need
  420.     PKXARC.EXE.  If you don't have ANY .PAK files, you don't need
  421.     PKUNPAK.EXE.  If you don't have ANY .ZIP files (ya right!) then
  422.     you won't need PKUNZIP.EXE.
  423.  
  424.     If the program crashes when you try to view an archive, odds are it could
  425.     not find the required UNarchiver in the path, so it was unable to
  426.     unarchive the required file!
  427.  
  428.     UPDATE: PKUNZIP v2.04g.  If you are using PkUNZIP 2.04g, please set the
  429.     configuration file for version 1.93.  This will work.  If you set Online
  430.     Archive Master for version 1.10, it will probably not work with 2.04g.
  431.  
  432.  
  433.     **IMPORTANT NOTE**
  434.  
  435.     When a user extracts files, the file(s) they extract will be stored in
  436.     EXTRACT.ZIP.  This ZIP file will be placed in the file area that you
  437.     specified in the configuration file.  MAKE SURE THIS IS NOT A CD-ROM
  438.     AREA!  Online Archive Master must be able to write to this file area.
  439.  
  440.  
  441.  
  442. SUGGESTIONS:
  443. ───────────
  444.  
  445.     The program will NOT delete the extract file!  (obviously, as the user
  446.     will want to be able to download it!)  You should delete after the user
  447.     logs off, or it will be left there and may confuse other users when
  448.     they log on and use the program. (they will get a chance to delete it,
  449.     though).
  450.  
  451.     My batch file has something like this:
  452.  
  453.  REM after_RA is run after the user logs off the BBS
  454.  :AFTER_RA
  455.  IF EXIST D:\RA\FILE\REQUEST\EXTRACT.ZIP GOTO KILLIT
  456.  GOTO NOKILL
  457.  :KILLIT
  458.  RAFILE KILL EXTRACT.ZIP 2       (assuming area 2 is where EXTRACT.ZIP is)
  459.  :NOKILL
  460.     .
  461.     .
  462.     .
  463.  etc..
  464.  
  465.  
  466. ──────────────────────────────────────────────────────────────────────────────
  467.  
  468.  
  469. Registration:
  470. ────────────
  471.     Registration of this program is no longer required.  The program has
  472.     always been free (and always will be) but I used to require registration.
  473.     I would love to hear from you - postcards would be GREAT, but ordinary
  474.     mail or e-mail are fine too!
  475.  
  476.  
  477.     NOTICE TO COMMERCIAL SYSTEMS:
  478.     This program is also freeware for commercial systems, however, if you
  479.     use this program on a commercial system you MUST inform the author that
  480.     you are doing this.   The name and "function" of the business would be
  481.     appreciated.
  482.  
  483.  
  484. Thank you for using Online Archive Master!
  485.  
  486. Bill Dykstra
  487.  
  488.  
  489.         Online Archive Master 6.0 is compiled with Borland Pascal 7.0.
  490.  
  491.  
  492.  
  493.                                Support BBS:
  494.  
  495.                             The BillBoard BBS
  496.                              (905) 898-2443
  497.                         Newmarket, Ontario  Canada
  498.  
  499.                             Fidonet 1:250/932
  500.  
  501.                     Internet: bill.dykstra@canrem.com
  502.  
  503.  
  504.   ────────────────────────────────────────────────────────────────────────────
  505.  
  506.   ▀█▀▀▀▄  ▄▀▀▀▀▀▀
  507.    █ █ █  █ █▀▀▀ Dykstra
  508.    █ █ █  ▀▄▄▄▄   Software
  509.    █ ▀ █     ▄ █
  510.   ▀▀▀▀▀  ▀▀▀▀▀ █  (C) Copyright 1993, 1994 William J. Dykstra
  511.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  512.  
  513.   ────────────────────────────────────────────────────────────────────────────
  514.  
  515.