home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / RA / RAMAN100.ZIP / RAMAN.DOC < prev    next >
Encoding:
Text File  |  1992-01-02  |  42.2 KB  |  1,171 lines

  1.  
  2.  
  3.  
  4.              
  5.              
  6.              
  7.              
  8.              
  9.              
  10.              
  11.              
  12.              
  13.              
  14.              
  15.              
  16.              
  17.              
  18.              
  19.              
  20.  
  21.  
  22.         ┌─────────┐┌──────────┬┌────────────┐┌──────────┬───────┬───┐
  23.         │  ┌───┐  ││  ┌───┐   ││  ┌─┐  ┌─┐  ││  ┌───┐   │       │   │
  24.         │  │   │  ││  │   │   ││  │ │  │ │  ││  │   │   │   │   │   │
  25.         │  └───┘  └┤  └───┘   ││  │ │  │ │  └┤  └───┘   │   │   │   │
  26.         │  ┌────┐  │  ┌────┐  ││  │ │  │ │   │  ┌────┐  │   │   │   │
  27.         │  │    │  │  │    │  ││  │ │  │ │   │  │    │  │   │       │
  28.         └──┘    └──┴──┘    └──┴┴──┘ └──┘ └───┴──┘    └──┴───┴───────┘
  29.  
  30.  
  31.  
  32.              
  33.  
  34.  
  35.  
  36.  
  37.              
  38.              
  39.              
  40.              
  41.              
  42.              
  43.              
  44.  
  45.              
  46.              
  47.              
  48.              
  49.  
  50.              
  51.              
  52.              
  53.              
  54.                         RAMAN - RemoteAccess Manager v1.00
  55.              Copyright (C) 1991 By David Hickey, All rights reserved
  56.              
  57.  
  58.  
  59.  
  60.              
  61.                                 TABLE OF CONTENTS
  62.              
  63.              Features                                     1
  64.              License                                      1
  65.              Registration                                 2
  66.              System Requirements                          2
  67.              Installation                                 3
  68.              Setup                                        4
  69.              Feature Descriptions
  70.                   Toggles Menu                            4
  71.                   Archivers                               9
  72.                   Logfiles                               10
  73.                   Allfiles                               11
  74.                   Misc                                   12
  75.              Multi-Node Operation                        14
  76.              Running RAMAN                               15
  77.              Credits                                     17
  78.              Bug Reports                                 17
  79.              Beta Testers                                18
  80.              Other Stuff                                 18
  81.              Registering RAMAN                           19
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.         RAMAN Remote Access Manager    January 2, 1992              1
  89.  
  90.  
  91.  
  92.                                     FEATURES
  93.  
  94.              * Alphabetizes FILES.BBS
  95.              * Updates download counters
  96.              * Adds download counters to file descriptions without them
  97.              * Truncates file descriptions
  98.              * Add file headers to FILES.BBS
  99.              * Cleans up the location field in your user file
  100.              * Creates up to 5 allfiles listings
  101.              * Archives up to 5 logfiles by date
  102.              * Scans files for viruses
  103.              * Re-archive an unlimited number of directories
  104.              * Back up your user files
  105.              * Generate a report of message base usage 
  106.              * Pick random screens/menus
  107.              
  108.              
  109.                                      LICENSE
  110.              
  111.              The term "RAMAN" refers to the files contained in the
  112.         files contained in the RemoteAccess distribution archive released 
  113.         by David Hickey.  The following must be read, understood, and 
  114.         agreed upon BEFORE you use RAMAN:
  115.              
  116.              * RAMAN is Shareware.  It is not FreeWare or Public Domain.
  117.              
  118.              * This program and the accompanying documentation are 
  119.         copyrighted material by David Hickey.
  120.              
  121.              * This program is provided AS IS!  I have taken a great deal 
  122.         of precautions insuring RAMAN will work as this documentation 
  123.         states, but there is always the unknown.  I provide NO warranty 
  124.         whatsoever.
  125.  
  126.              * The author, David Hickey, is not liable to you or anyone 
  127.         for, but not limited to, any direct, indirect, incidental, or 
  128.         consequential damages, including, but not limited to, any lost 
  129.         profits, damaged hardware or software, or loss of money resulting 
  130.         from the inability or abilitiy of this program to perform as
  131.         stated.  By using this program, you agree to these terms and
  132.         release the author from any liablility or litigation whatsoever.
  133.  
  134.              * I am in no way obligated to provide future versions of
  135.         or support for RAMAN.
  136.  
  137.              * You are hereby granted a limited license to use RAMAN up 
  138.         to 14 days before registering.  After 14 days you are required to 
  139.         register this program as described at the end of this 
  140.         documentation.  You may use and distribute this program provided 
  141.         it is not modified, reverse engineered, or in any way altered.
  142.  
  143.                                        1
  144.  
  145.  
  146.         RAMAN Remote Access Manager    January 2, 1992              2
  147.  
  148.  
  149.              
  150.              
  151.                                   REGISTRATION
  152.  
  153.  
  154.              As stated in the license agreement, you are required to 
  155.         register RAMAN if you use it past the 14 day trial period.  RAMAN 
  156.     is not crippled in any way, however, if you have not registered 
  157.     RAMAN will pause for 10 seconds each time it executes.  This pause
  158.     will be eliminated once you receive your keyfile.  It will also stamp
  159.     a nice UNREGISTERED message on things like the Allfiles listings, 
  160.     File Headers, etc until you have registered.  The end of this 
  161.     document contains registration information.  If you like this program
  162.     then please register.  
  163.                                                                 
  164.  
  165.                                   REQUIREMENTS
  166.              
  167.              
  168.              To date, this program has been tested with the following hardware 
  169.         configurations:
  170.              
  171.              1) Packard Bell 80286 with 1Mb RAM under MS-DOS v4.01
  172.              2) 80386 SX Clone with 2Mb RAM under MS-DOS v4.01
  173.              3) 80286 with 1Mb RAM under MS-DOS v3.3
  174.              4) IBM XT clones with 640k RAM under MS-DOS 5.0 and 3.3
  175.              5) 80386 with 8Mb RAM under MS-DOS v5.0
  176.  
  177.              Memory requirements is around 295k.  If RAMAN has to call an
  178.         external program such as ARJ, it will attempt to swap itself out
  179.         of memory and into either EMS or to a swap file.  If the swap 
  180.         should fail, RAMAN will recover and execute the external program
  181.         while still in memory.  It is highly unlikely a swap would ever
  182.         fail, but if it does and it has to call ARJ, it would need around
  183.         450k to execute ARJ.  The swapper used was written by Kim
  184.         Kokkonen of TurboPower Software.
  185.              
  186.              A copy of RemoteAccess v1.00 or later is required.  This 
  187.         program is RemoteAccess specific and uses CONFIG.RA, FILES.RA, 
  188.         MESSAGES.RA, and your RemoteAccess logfile.  For some of the 
  189.         functions, you will need to have a copy of PKZIP.EXE and 
  190.         PKUNZIP.EXE by Pkware, LHA.EXE by Yoshi, ARJ.EXE by Robert K. 
  191.         Jung, and SCAN.EXE by McAfee. 
  192.              
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                        2
  200.  
  201.  
  202.         RAMAN Remote Access Manager    January 2, 1992              3
  203.  
  204.  
  205.  
  206.  
  207.              RAMAN makes repeated calls to access the disk drive, and
  208.         works extremely well while running under a disk caching system.
  209.         This is not a requirement, but in experimentation on my system
  210.         RAMAN has run MUCH faster under the 256k cache I use.
  211.  
  212.  
  213.                                   INSTALLATION
  214.  
  215.  
  216.              You MUST have the COMSPEC environment variable set to point
  217.         to where Command.Com is located.  To do this, put the following
  218.         line in either your AUTOEXEC.BAT file or your BBS batch file:
  219.  
  220.              SET COMSPEC=C:\DOS\COMMAND.COM
  221.  
  222.              Edit this line to point to where your copy of Command.Com is
  223.         located. Next, copy all the files in the distribution archive into
  224.         any directory you want.  RAMAN does not need to be placed in your
  225.         RemoteAccess system directory, but it does need to have all it's
  226.         files in the same place.
  227.  
  228.  
  229.  
  230.                                       SETUP
  231.  
  232.  
  233.              A setup program called RAMANCFG.EXE is provided for the
  234.         configuration.  The configuration file is NOT an ASCII file.
  235.  
  236.              Switches for RAMANCFG.EXE:
  237.  
  238.                M  - Force RAMANCFG into monochrome mode
  239.                C  - Force RAMANCFG into color mode
  240.                T  - Sends the contents of RAMAN.SYS to a text file called
  241.                     RAMANCFG.TXT
  242.                P  - Sends the contents of RAMAN.SYS to the printer
  243.  
  244.              Switches are NOT case sensistive and must be preceded by a 
  245.         '/' or a '-'. RAMANCFG will automatically detect the monitor type
  246.         you have and default to that.  Specifying the M or C switch will
  247.         override what RAMANCFG has detected.
  248.  
  249.              There are some things that require a trailing backslash, and 
  250.         some that do not.  RAMANCFG automatically removes/adds a trailing 
  251.         backslash to whatever needs it.  You don't have to worry about 
  252.         that.
  253.  
  254.  
  255.  
  256.  
  257.                                        3
  258.  
  259.  
  260.         RAMAN Remote Access Manager    January 2, 1992              4
  261.  
  262.  
  263.  
  264.              There are several functions that deal with your FILES.RA
  265.         file, and one that uses MESSAGES.RA.  For an area in FILES.RA to 
  266.         be considered unused, the field where you enter the path for that 
  267.         area MUST be blank.  Otherwise RAMAN will consider it "fair 
  268.         game."  With MESSAGES.RA, an area is considered unused by RAMAN 
  269.         if it's Name field is blank.  Again, if there is anything in that 
  270.         field, it is considered "fair game."
  271.  
  272.  
  273.                               FEATURE DESCRIPTIONS
  274.  
  275.              Following is a description of each of the features available:
  276.              
  277.              
  278.                                   Toggles Menu
  279.                                   ------------
  280.              
  281.         ALPHABETIZE FILES.BBS - Does just what you think.  With this 
  282.         option enabled each entry in each of the FILES.BBS files in 
  283.         FILES.RA will be alphabetized from A-Z.  This procedure will 
  284.         strip any file headers and descriptions that take up more than 
  285.         one line in FILES.BBS.  If you are using a program other than 
  286.         RAMAN to add headers in your FILES.BBS files, you will have to 
  287.         run that program after RAMAN is done.  RAMAN adds file headers 
  288.         AFTER this procedure, so there is nothing to worry about if you 
  289.         use RAMAN to add headers. This is the only function that will
  290.         strip multi-line descriptions or file headers.
  291.              
  292.              
  293.         UPDATE DOWNLOAD COUNTERS - This function will read your 
  294.         RemoteAccess logfile and pick out the files that have been 
  295.         downloaded.  RAMAN will then update the download counter for each 
  296.         file that was downloaded.  Please note that RAMAN creates a file 
  297.         called RAMAN.PLC during this process.  This file is used by RAMAN 
  298.         to keep track of which files it has already counted and whether 
  299.         or not the logfile it is reading is new or old.  In other words, 
  300.         RAMAN will know whether or not you have deleted your logfile and 
  301.         started over again and will not count the same files twice.  If 
  302.         you have not defined a download counter in RAMANCFG (the next 
  303.         function), or if a file that has been downloaded does not have a 
  304.         counter, RAMAN will leave it alone instead of screwing up your 
  305.         descriptions with meaningless numbers.
  306.  
  307.  
  308.         ADD DOWNLOAD COUNTERS - Will add a download counter type of your 
  309.         choice in each of the description fields in the FILES.BBS files.  
  310.         The counter is only added to files that do not have a counter 
  311.         yet.  This procedure will not affect file headers or multi-line 
  312.         descriptions.
  313.  
  314.                                    4
  315.  
  316.  
  317.         RAMAN Remote Access Manager    January 2, 1992              5
  318.              
  319.  
  320.  
  321.         TRUNCATE DESCRIPTIONS IN FILES.BBS - Even though a file 
  322.         description fits on only one line in the FILES.BBS file, it may 
  323.         take up two when it is displayed to a user.  This function will 
  324.         cut the file descriptions down in FILES.BBS so that the user is 
  325.         only shown one line.  If you have multi-line descriptions, each 
  326.         line of that description will be cut down so that it only will 
  327.         display on one line when RemoteAccess displays it to the user.
  328.              
  329.         CLEAN UP USERS LOCATION FIELD - This makes the location field of 
  330.         each user's location field look better.  For example:
  331.              
  332.              BaLTImoRE, md  -----> Baltimore, Md
  333.              NOrth SOUthgAte aVENUE -----> North Southgate Avenue
  334.              LonDON, ENGLAND -----> London, England
  335.             
  336.         ARCHIVE LOGFILE(S) -  This function will archive and delete up to 
  337.         five logfiles (or any other file for that matter) that you define 
  338.         (described later).
  339.              
  340.              
  341.         CREATE ALLFILES LISTING(S) -  This function will create up to 
  342.         five ASCII allfiles listings that you define (described later).  
  343.         After creating these listings, RAMAN will archive them in the 
  344.         same directory.  Net result is an archived and text version of 
  345.         the allfiles listing.
  346.              
  347.              
  348.         SCAN FILES FOR VIRUSES -  This function calls SCAN.EXE by McAfee 
  349.         to scan files for viruses.  There are three ways this function 
  350.         can work.  The first way assumes you have one directory that all 
  351.         uploads go into.  When RAMAN is run, only this directory will be 
  352.         checked out.  The second way is if you have uploads going into 
  353.         several different directories.  If this is the case, then RAMAN 
  354.         can scan your RA logfile to find out where uploaded files have 
  355.         gone into and scan the files.  The third way is to create an 
  356.         ASCII file called SCANDIR.CTL that contains the names of any 
  357.         directories you want files in checked for viruses.  The format of 
  358.         this file is:
  359.              
  360.              <directory>
  361.              <directory>
  362.              ...
  363.              
  364.              Example:
  365.              
  366.              c:\files\misc
  367.              c:\files\pascal
  368.              c:\files\sdsra\
  369.  
  370.  
  371.                                    5
  372.  
  373.  
  374.         RAMAN Remote Access Manager    January 2, 1992              6
  375.              
  376.  
  377.  
  378.              The names of the directories do not have to have a trailing 
  379.         backslash, and the number of directories you may specify is 
  380.         unlimited. If SCANDIR.CTL is present, then RAMAN will use that.  
  381.         If you want RAMAN to only scan files in your upload directory, 
  382.         then in the MISC section of RAMANCFG (described later) you have 
  383.         to set the "UPLOADS GO INTO A SINGLE DIRECTORY" to "Y", and then 
  384.         enter the directory name in the space named "FULL PATH TO UPLOAD 
  385.         DIRECTORY"  If you want RAMAN to use your RA logfile to find the 
  386.         path and filename for uploads, set "UPLOADS GO INTO A SINGLE 
  387.         DIRECTORY" to "N".  RAMAN will also create and maintain a file 
  388.         called RAMAN.SCN.  This file contains the path and filename of 
  389.         all files RAMAN has already scanned so it will not scan them 
  390.         again.  After each run, RAMAN checks this file against reality to 
  391.         make sure that the files logged in RAMAN.SCN are still present on 
  392.         disk.  If they are not, their record is removed.  This feature 
  393.         both saves time so RAMAN does not have to scan files more than 
  394.         once and also makes this function ideal to run after a user logs 
  395.         off to check files he/she may have uploaded.
  396.              
  397.         PICK RANDOM MENUS/SCREENS - This function allows you to specify, 
  398.         in a file called MENSCR.CTL, the names of files you want to 
  399.         switch around.  This could be useful if you want a different 
  400.         WELCOME.A?? or LOGO.A?? screen to be displayed each time someone 
  401.         logs on.  The best way to explain this file is to show an example 
  402.         of the control file:
  403.  
  404.  
  405.             -c:\ra\txtfiles\welcome1.ans    <---- Full path/filename to                                    
  406.                                                    Target file
  407.              c:\hold\welcome1.an1         \   Up to 50 files that are 
  408.              c:\hold\welcome1.an2           \ possible source files to be
  409.              c:\hold\welcome1.an3            >randomly copied to the 
  410.              c:\hold\welcome1.an4           / Target path and filename 
  411.              c:\hold\welcome1.an5         /   specified above.
  412.              -c:\ra\txtfiles\welcome1.asc
  413.              c:\hold\welcome1.as1
  414.              c:\hold\welcome1.as2
  415.              -
  416.              
  417.              Note the '-' at the end.  This tells RAMAN that there are no 
  418.         more entries after that '-'  DO NOT FORGET TO ADD THIS!  The '-' 
  419.         in front of the filename tells RAMAN that this is the target 
  420.         filename, and the files listed after that are source files.  You 
  421.         may specify up to 50 source files for each target file.  The 
  422.         number of target files is unlimited, but a '-' MUST appear at the 
  423.         end of the file, and a '-' MUST appear before each target file.
  424.  
  425.  
  426.  
  427.  
  428.                                    6
  429.  
  430.  
  431.         RAMAN Remote Access Manager    January 2, 1992              7
  432.  
  433.  
  434.              
  435.         CREATE REPORT OF MESSAGE BASE ACTIVITY - This option scans your 
  436.         RA logfile to generate an ANSI and ASCII file (defined later) 
  437.         showing the number of times someone has posted a message and the 
  438.         number of times someone has read a message in each sepearate 
  439.         message area.  In unregistered mode, RA does not log message 
  440.         Reads to it's logfile.  Therefore, if your copy of RA is not 
  441.         registered, then you will see nothing but zeros for the Reads of 
  442.     each area.  If RAMAN finds a line saying the user read in Combined
  443.     Mode, RAMAN will look at that users combined information record in
  444.     USERSXI.BBS and update each area listed.  Because offline mail 
  445.     doors are in wide use, RAMAN also makes provisions for recording 
  446.     their activity as well.  At the end of the report, RAMAN will tell
  447.     you how many messages have been downloaded through the offline door
  448.     and how many have been uploaded through the offline door.  Currently,
  449.     RAMAN recognizes the log formats of: RAMail, XRS, Silver Express, and
  450.     MkQwk.  Future versions will support more readers as I become
  451.     aware of their existance.  RAMAN keeps a file called RAMAN.MSG.
  452.     This file contains information about the RA logfile that RAMAN 
  453.     uses to make sure it doesn't count things more than once and 
  454.     also to determine if the RA logfile it's working on is a new one
  455.     or an old one.  You can display these files via a Type 5, 39, 40,
  456.     45, or 46 menu display.  This is a good addition to your bulletin
  457.     or message menu.
  458.  
  459.         REARCHIVE FILES - This function re-archives all files in a given 
  460.         directory into an archive format of your choice (ZIP, LZH, ARJ).  
  461.         RAMAN first looks for a file called REARCDIR.CTL.  If this file 
  462.         is found, RAMAN will archive the files in the directories listed 
  463.         in it.  Otherwise RAMAN will re-archive the files in each 
  464.         directory listed in FILES.RA.  The format of REARCDIR.CTL is the 
  465.         same as for SCANDIR.CTL:
  466.              
  467.              <directory>
  468.              <directory>
  469.              ...
  470.              
  471.              Example:
  472.              
  473.              c:\files\uploads
  474.              c:\files\sdsra
  475.              c:\files\bbssoft
  476.              c:\files\pascal
  477.              
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                   7
  487.  
  488.  
  489.         RAMAN Remote Access Manager    January 2, 1992              8
  490.  
  491.  
  492.  
  493.              There is no limit to the number of directories you may list, 
  494.         and the RAMAN does not require them to have a trailing backslash.  
  495.         You pick which archiver you want used from the ARCHIVERS menu 
  496.         described in the next section.
  497.              
  498.              
  499.              BACK UP USER FILES - This function will make an archive, in 
  500.         the format of your choice (ZIP, LZH, ARJ) of your USERS*.BBS 
  501.         files.  The filename of the archive that will be made is the 
  502.         letters UF plus the date, plus the archive method (.ZIP, .LZH,
  503.         or .ARJ).  This file will be put into the directory you specifiy
  504.         in RAMANCFG under the Misc section which is descbribed later.
  505.         NOTE: If you use this function, it would be very wise to have the 
  506.         backup path pointing to a floppy drive.  Backups on a hard drive 
  507.         are not going to do you much good if your hard drive crashed!
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.                                     8
  544.  
  545.  
  546.         RAMAN Remote Access Manager    January 2, 1992              9
  547.  
  548.  
  549.  
  550.                                     Archivers
  551.                                     ---------
  552.              
  553.              PATH AND FILENAME TO PKZIP.EXE - Enter the full path and 
  554.         filename to where PKZIP.EXE is located.  Example: 
  555.         C:\UTILITY\PKZIP.EXE. This is used to compress files with the 
  556.              
  557.              
  558.              PATH AND FILENAME TO PKUNZIP.EXE - Enter the full path and 
  559.         filename to where PKUNZIP.EXE is located.  Example: 
  560.         C:\UTILITY\PKUNZIP.EXE. This is used to decompress files with the 
  561.              
  562.              
  563.              PATH AND FILENAME TO LHA.EXE - Enter the full path and 
  564.         filename to where LHA.EXE is located.  Example: 
  565.         C:\UTILITY\LHA.EXE. This is used to compress and decompress files 
  566.         with the .LZH extension.
  567.              
  568.              
  569.              PATH AND FILENAME TO ARJ.EXE - Enter the full path and 
  570.         filename to where ARJ.EXE is located.  Example: 
  571.         C:\UTILITY\ARJ.EXE. This is used to compress and decompress files 
  572.         with the .ARJ extension.
  573.              
  574.              
  575.              FORMAT TO REARCHIVE IN - Here is where you pick the format 
  576.         RAMAN will re-archive files into.  Choices supported are ZIP, LZH, 
  577.         and ARJ.
  578.              
  579.  
  580.              When defining the path and filename for each of the
  581.         archivers, RAMAN will check that directory and make sure the file 
  582.         exists.  If it does not exist, RAMAN will prompt you for the 
  583.         correct path and filename.  During program execution, RAMAN will 
  584.         double check to make sure these files are still in place.  If 
  585.         they are not, RAMAN checks your path statement and attempts to 
  586.         locate each program that way.  If it can find them, it will write 
  587.         that information into RAMAN.SYS.  If it can not find them, then 
  588.         you're up a creek!  This check does not take long, and it will 
  589.         help insure against potential problems if for example you 
  590.         reorganize your drive and forget to make the necessary changes in 
  591.         RAMANCFG.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                       9
  601.  
  602.  
  603.         RAMAN Remote Access Manager    January 2, 1992              10
  604.  
  605.  
  606.              
  607.                                     Logfiles
  608.                                     --------
  609.              
  610.              This is the section where you define up to five logfiles you 
  611.         want RAMAN to archive and delete.
  612.              
  613.              FIRST LOGFILE TO ARCHIVE - Press the [Enter] key and you 
  614.         will be asked for information about the logfile:
  615.              
  616.                PATH AND FILENAME TO LOGFILE - Enter the full path and 
  617.         filename to the the logfile you want archived.  Example: 
  618.         C:\RA\RA.LOG
  619.              
  620.                PATH TO PUT ARCHIVED LOGFILE - Enter the path where you 
  621.         want RAMAN to put the archive after it is finished.  Example: 
  622.         C:\RA\RALOGS\ If you do not put a trailing backslash on the path, 
  623.         RAMAN will append one automatically.
  624.              
  625.                FIRST 2 LETTERS FOR ARCHIVE NAME - Enter the first two 
  626.         letters you want for the archive name.  Example: RA
  627.              
  628.              
  629.                The name of the archive will be a combination of the first 
  630.         two letters you define plus the date.  For example: If you 
  631.         defined the first two letters as "RA" and the date is December 1, 
  632.         1991 and you want the ZIP archiver to be used, the filename will 
  633.         be: RA120191.ZIP.
  634.              
  635.              FORMAT TO ARCHIVE LOGFILES - Select the method you want the 
  636.         logfiles to be archived in (ZIP, LZH, ARJ).
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                Some people may not have five logfiles to archive, so
  643.         there is no point in filling in the remaining spaces with dummy
  644.         files.  If you don't have five logfiles, then enter the menu for
  645.         the ones you are not planning to use. Go to each question (Path
  646.         to logfile, Path to put the logs, first two letters), press
  647.         [Enter] once, then press it a second time.  This will display a
  648.         'Not used' message in the first two and a '--' in the third. This
  649.         tells RAMAN there is nothing there and therefore disables the
  650.         spaces for the remaining logfiles.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                    10
  658.  
  659.  
  660.         RAMAN Remote Access Manager    January 2, 1992              11
  661.  
  662.  
  663.              
  664.                                     Allfiles
  665.                                     --------
  666.              
  667.              This section is almost identical to the way the Logfiles are 
  668.         handled.
  669.              
  670.              FIRST ALLFILES LISTING - Press the [Enter] key and you will 
  671.         be asked for information for the allfiles listing:
  672.              
  673.                PATH AND FILENAME FOR LISTING - Enter the full path and 
  674.         filename for this allfiles listing.  Example: 
  675.         C:\FILES\MISC\ALLFILES.LST
  676.              
  677.                SECURITY LEVEL FOR THIS LIST - Enter the minimum security 
  678.         level a file area must have to be included in this listing.  
  679.         Example: 10 In this example, all file areas with a security level 
  680.         of 10 or below as, defined in FILES.RA, will be included in the 
  681.         allfiles listing.
  682.              
  683.                As with the logfiles, you may not need five allfiles 
  684.         listings.  The procedure for disabling the remaining allfiles is 
  685.         the same as for logfiles. Go to each listing you do not want to 
  686.         use.  At the questions (path and filename for the listing, 
  687.         security level for listing) press [Enter] once then press it 
  688.         again.  This will display 'Not used' for the path and a 0 for the 
  689.         security level.  This tells RAMAN to disregard this listing.
  690.              
  691.              FORMAT TO ARCHIVE ALLFILES - Choose whether you want the 
  692.         allfiles listings to be archived in the ZIP, LZH, or ARJ format.
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.                                    11
  715.  
  716.  
  717.         RAMAN Remote Access Manager    January 2, 1992              12
  718.  
  719.  
  720.  
  721.                                       Misc
  722.                                       ----
  723.              
  724.              This section contains miscellaneous information that is 
  725.         required for certain functions.
  726.              
  727.              REMOTEACCESS SYSTEM PATH - Enter the path to where your *.RA 
  728.         files are kept. Example: C:\RA
  729.              
  730.              REMOTEACCESS LOGFILE - Enter the path and filename to your 
  731.         RemoteAccess logfile.  Example: C:\RA\RA.LOG
  732.              
  733.              DOWNLOAD COUNTER TYPE - Enter the type of download counter 
  734.         you want RAMAN to add to descriptions in FILES.BBS.  If you do 
  735.         not intend to use RAMAN to add download counters, but do want 
  736.         RAMAN to update ones you already have, enter the style that is 
  737.         currently in use.  Example: [00]
  738.              
  739.              FULL PATH TO UPLOAD DIRECTORY - If you want RAMAN to only 
  740.         scan uploaded files for viruses and if your uploads go into a 
  741.         single directory, enter the path to that directory here.  
  742.         Example: C:\FILES\UPLOADS\  (RAMAN appends a '\' if you do not 
  743.         put one there).
  744.              
  745.              FULL PATH/FILENAME TO SCAN.EXE - Enter the full path and 
  746.         filename to where SCAN.EXE is located.  This is the program RAMAN 
  747.         uses to scan files for viruses.  RAMAN will check to make sure 
  748.         that the directory/filename you have entered actually exist.  
  749.         Example: C:\UTILITY\SCAN.EXE
  750.              
  751.              FIRST AREA NOT TO ADD COUNTERS - You may specify up to five 
  752.         directories that you do not want RAMAN to add download counters 
  753.         to.  If you have directories you do not want counters added to, 
  754.         enter its directory number (from FILES.RA) here.  If you do not 
  755.         have 5 directories you want left alone, put a 0 as the area 
  756.         number for each one you will not use.  For example, if you put a 
  757.         zero in all five spots, RAMAN will add download counters to every 
  758.         directory (this is assuming you have this option turned on in the 
  759.         first place!)
  760.              
  761.              UPLOADS GO IN A SINGLE DIRECTORY - This is used in 
  762.         conjunction with the function to scan files for viruses.  If all 
  763.         your uploads go into one directory, set this option to 'Y'.  If 
  764.         your uploads can go into several different directories, set this 
  765.         to 'N'  A 'N' will make RAMAN scan your RemoteAccess logfile to 
  766.         see where uploaded files have gone.  For more information, see 
  767.         the section under 'Toggles' that describes the function to scan 
  768.         for viruses.
  769.              
  770.  
  771.                                       12
  772.  
  773.  
  774.         RAMAN Remote Access Manager    January 2, 1992              13
  775.  
  776.  
  777.              
  778.              PATH/FILENAME FOR ASCII REPORT - If you have enabled the 
  779.         function to create a report of your message base usage, enter the 
  780.         full path and filename for the ASCII version of the report.  
  781.         Example: C:\RA\TXTFILES\MSGUSAGE.ASC
  782.              
  783.  
  784.              PATH/FILENAME FOR ANSI REPORT - Same as the above, but for 
  785.         the ANSI version of the report.  Example: 
  786.         C:\RA\TXTFILES\MSGUSAGE.ANS
  787.              
  788.              PATH FOR USER FILE BACKUP - Enter the directory where you 
  789.         want RAMAN to place the archive containing the backed-up user 
  790.         files. Example: C:\RA\BACKUPS\  (A '\' will be appended if you 
  791.         forget to add it). As previously mentioned, this is a Registered 
  792.         Only feature.
  793.  
  794.              FORMAT TO ARCHIVE USER FILES - Select the format you would 
  795.         like the backed up user files to be archived in: ZIP, LZH, or ARJ.
  796.  
  797.  
  798.  
  799.              
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.                                     13
  829.  
  830.  
  831.         RAMAN Remote Access Manager    January 2, 1992              14
  832.  
  833.  
  834.                               Multi-Node Operation
  835.                               --------------------
  836.  
  837.              I don't currently run a multi-node board, and I know no one
  838.         in the area who does.  However, I am not completely ignorant of the
  839.         way RemoteAccess works, so I'll give this a shot.  If you run with
  840.         all of RA's .RA files in a single directory (C:\RA for example) and
  841.         the RA logfile is in that directory only, then set RAMAN up the same
  842.         way I have already described.  This *should* work.  If each of your
  843.         nodes has it's own .RA files, or if you want RAMAN to work with each
  844.         node individually, then you will need to have one copy of RAMAN with
  845.         all of it's files for each node.  Make sure that you set the path
  846.         to your system directory to where the .RA files are stored for that
  847.         node.  If you run multi-node, then you have probably had experience
  848.         with setting things up for your configuration, and RAMAN should be
  849.         no exception.  You probably know more than I do about this area of
  850.         RA operation.  I cannot guarantee that what I have suggested is
  851.         going to work, but to my way of thinking, it *should* do the trick.
  852.  
  853.              If you run multi-node and get RAMAN working great on your 
  854.         system, I'd appreciate it if you could netmail me and let me know 
  855.         how you did it so I can see if I can make it any easier with the
  856.         next version of RAMAN. 
  857.  
  858.  
  859.  
  860.              
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                      14
  886.  
  887.  
  888.         RAMAN Remote Access Manager    January 2, 1992              15
  889.  
  890.              
  891.  
  892.                                   Running RAMAN
  893.                                   -------------
  894.              Running RAMAN can be done in one of two ways.  First, you 
  895.         can run it with no command line parameters by typing in RAMAN and 
  896.         hitting [Enter].  RAMAN will read the configuration file and do 
  897.         what you have told it to do there if you run it like this.  This 
  898.         method is ideal for running RAMAN in your nightly maintenance, 
  899.         which is what RAMAN was orginally designed for.  And alternate 
  900.         method is to run RAMAN with command line parameters to make it 
  901.         perform only a few functions.  This is ideal for running RAMAN 
  902.         after a user hangs up to have it check for viruses in any files 
  903.         that may have been uploaded, update the message base report, etc.
  904.               
  905.              The following parameters are valid:
  906.              
  907.              H         - Displays a help screen
  908.              ?         - Displays a help screen
  909.              CLEAN     - Clean up the location field of the user file
  910.              TRUNC     - Truncates descriptions in FILES.BBS so they will 
  911.                          fit on one line when displayed on the screen
  912.              MANGORP   - Manages orphaned files/descriptions in FILES.BBS
  913.              ADDHEAD   - Adds file headers to FILES.BBS
  914.              ABC       - Alphabetize all FILES.BBS
  915.              ADDCOUNT  - Add download counters to all FILES.BBS
  916.              UPDCOUNT  - Update download counters
  917.              ALLFILE   - Creates allfiles listing(s)
  918.              SCAN      - Scans files for viruses
  919.              ARCLOG    - Archives and deletes your logfile(s)
  920.              REARC     - Re-archive files
  921.              SWITCH    - Switches defined menus/textfiles
  922.              MSGACT    - Generates a report of message base usage
  923.          BACKUP    - Backs up your user files  
  924.  
  925.              A '-' or a '/' must precede each parameter, except for the 
  926.         'H' or '?' which do not require a '-' or '/' in front of them.  
  927.         Parameters are NOT case sensitive.
  928.              
  929.              Example:
  930.              
  931.              RAMAN -Scan /allfile
  932.              
  933.              Note that RAMAN uses information from its configuration file 
  934.         such as path information even if it is being run with parameters.
  935.              
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.                                     15
  943.  
  944.  
  945.         RAMAN Remote Access Manager    January 2, 1992              16
  946.  
  947.  
  948.  
  949.              Example of partial batch file:
  950.              
  951.              :NIGHTLY
  952.              Echo Nightly maintenance is performed here
  953.              RAMAN
  954.              :AFTER_USER
  955.              Echo Performed after each user logs off
  956.              RAMAN -Scan -Msgact -Switch -Addhead -Updcount
  957.  
  958.              If RAMAN can not read the overlays contained in RAMAN.EXE, 
  959.         it will return an errorlevel of 1.  This would mean either the
  960.         EXE is corrupted or it may contain a virus of some type.
  961.  
  962.              If you run RAMAN without parameters, the order things are
  963.         performed is as follows: Clean User Location, Alphabetize the
  964.         Files.Bbs, Add download counters, Update download counters, 
  965.         Truncate descriptions, Add headers to Files.Bbs, Create the
  966.         allfiles listings, Switch menus/textfiles, Generate message 
  967.         base report, Scan for viruses, Re-archive files, Archive the
  968.         logfiles, and Backup the user files.
  969.  
  970.              
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.                                      16
  1000.  
  1001.  
  1002.         RAMAN Remote Access Manager    January 2, 1992              17
  1003.  
  1004.  
  1005.              
  1006.                                      Credits
  1007.                                      -------
  1008.              
  1009.              All product names mentioned in this document other than 
  1010.         RAMAN are copyrighted (C) material, Trademarks (tm), or 
  1011.         Registered Trademarks (R) of their respective holders:
  1012.              
  1013.              Arj.Exe, ARJ       Robert K. Jung
  1014.              IBM                International Business Machines Corporation
  1015.              Lha.Exe, LZH       H. Yoshizak
  1016.              MS-DOS             MicroSoft Corporation
  1017.              Pkzip.Exe, ZIP     Pkware, Inc.
  1018.              Pkunzip.Exe, ZIP   Pkware, Inc.
  1019.              RemoteAccess, RA   Andrew Milner and Continental Software, Inc.
  1020.              Scan.Exe           McAfee Associates
  1021.              Turbo Pascal       Borland International, Inc.
  1022.              
  1023.              
  1024.                                    Bug Reports
  1025.                                    -----------
  1026.              
  1027.              Any and all bug reports should be sent to me via netmail at 
  1028.         1:261/1108.  If you do not have access to netmail, write them 
  1029.         legibly on paper and mail them to me, or you can call my board at 
  1030.         1-410-263-1633 and leave a message.  When reporting a bug please 
  1031.         include the following:
  1032.              
  1033.              Your computer type
  1034.              Amount of RAM you are running RAMAN under
  1035.              What you have tried, and a complete description of the 
  1036.         problem you are having along with any runtime error and offset 
  1037.         memory address it gives you.
  1038.              
  1039.              Please, do not send a bug report until you have gone over 
  1040.         your configuration very carefully and made certain you have 
  1041.         things set up properly.  80% of all so called "bugs" can be 
  1042.         traced back to someone not reading the docs or some kind of silly 
  1043.         mistake in the configuration (you know the ones, the ones that 
  1044.         make you want to hit your head against a brick wall after you 
  1045.         find out what the problem was...).
  1046.              
  1047.              If you can not understand something in the docs or need 
  1048.         help, you can either netmail me, call my board, or ask me to call 
  1049.         you voice and I will help you out and get it running.  I am also 
  1050.         available through the RA_SUPPORT echo and the RA_UTIL echo.  Both 
  1051.         are on the FidoNet backbone.  I would ask you to please write to 
  1052.         me in RA_UTIL as that echo is more suited to this purpose than 
  1053.         RA_SUPPORT is.  I DO answer my mail!
  1054.  
  1055.  
  1056.                                    17
  1057.  
  1058.  
  1059.         RAMAN Remote Access Manager    January 2, 1992              18
  1060.  
  1061.  
  1062.  
  1063.                             Beta testers/Thanks to...
  1064.                             -------------------------
  1065.              
  1066.              This is in recognition to those who voluntarily offered to 
  1067.         test RAMAN while it was still in Beta stages.  These people 
  1068.         risked their entire system in testing unproven designs:
  1069.              
  1070.              Steve Watson, The Lymph Node!                 
  1071.              Joe Williams, B.A. Express        - 1:261/1099
  1072.              Jim Henthorn, The Fire Station    - 1:261/1044
  1073.              Sid Balcom, The Catalytic Star    - 1:109/343
  1074.              Bruce Shetrone, The Dollar Saver  - 1:261/1128
  1075.              
  1076.                                      
  1077.              Thanks guys, I couldn't have done it without you!
  1078.              
  1079.  
  1080.                           
  1081.                                    Other stuff
  1082.                                    -----------
  1083.              
  1084.              The latest version of RAMAN will always be requestable from 
  1085.         my system, The North Star, at 1:261/1108 and from each of the 
  1086.         Beta sites listed above. Magic name is RAMAN for the latest 
  1087.         version.  
  1088.              
  1089.              
  1090.              I know that a lot of people have been burned by Shareware 
  1091.         authors.  I can only say that I will not take your money and run 
  1092.         like some seem to do. Beyond that, you will just have to trust 
  1093.         me.  Should circumstances occur and I cannot continue RAMAN 
  1094.         development, I will probably release the source code to 
  1095.         registered users or make arrangements with someone else to take
  1096.         over RAMAN development.  This is NOT a promise.  I plan to be 
  1097.         around for a while, but you never know what could happen.
  1098.  
  1099.              
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.                                       18
  1114.  
  1115.  
  1116.         RAMAN Remote Access Manager    January 2, 1992              19
  1117.  
  1118.  
  1119.  
  1120.                                 Registering RAMAN
  1121.                                 -----------------
  1122.  
  1123.                When registering, please fill out REGISTER.FRM and
  1124.         mail it along with your registration fee to:
  1125.  
  1126.                                      David Hickey
  1127.                                      304 North Glen Avenue
  1128.                                      Annapolis, Md 21401
  1129.                                      United States Of America
  1130.  
  1131.              The registration fee is $10.  Please send only U.S. funds, 
  1132.         no foreign personal checks unless it is drawn on a U.S. bank, and
  1133.         no credit cards.  It just costs too much to process them.
  1134.  
  1135.              When I receive your money I will generate a key file for
  1136.         you.  If you have a FidoNet address, I will CRASHmail it to you.  
  1137.         If you do not have a FidoNet address, I will call your BBS and 
  1138.         upload your key file to you in a private upload.  Once you 
  1139.         receive your key, place it in the directory with RAMAN's other 
  1140.         files.  Be sure it is named RAMAN.KEY.
  1141.  
  1142.              If you do not have a FidoNet address, be sure to create
  1143.         an account for me under the name of David Hickey and put the
  1144.     password on the place provided on the registration form contained
  1145.     in the file REGISTER.FRM which is in the RAMAN distribution archive.
  1146.                             
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.                                       19
  1170.         EOF
  1171.