home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / mount10.zip / MOUNTIE.DOC < prev    next >
Text File  |  1993-06-26  |  20KB  |  462 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                           The Mountie!  v1.00
  17.  
  18.                         Mount & Dismount CD-ROMs
  19.  
  20.                                   For
  21.  
  22.                           RemoteAccess v2.00G
  23.  
  24.  
  25.              Software and documentation written by Clyde Sisler
  26.                        Copyright (C) 1993 Clyde Sisler
  27.                             All rights reserved
  28.  
  29.  
  30.  
  31.  
  32.  
  33.             New Sysop Proverb:   He who faileth to backeth up files
  34.                                  of exceedingly great value shalt
  35.                                  shedeth a voluminous amount of 
  36.                                  large tears before joining the
  37.                                  omniscient Sysop in the sky. 
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                          ***** Table of Contents *****
  53.  
  54.  
  55.      1  Warranty & Disclaimer . . . . . . . . . . . . . . . . . . . . 1
  56.      2  Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 1
  57.      3  Package Contents. . . . . . . . . . . . . . . . . . . . . . . 2    
  58.      4  Installation  . . . . . . . . . . . . . . . . . . . . . . . . 3
  59.      5  Operations. . . . . . . . . . . . . . . . . . . . . . . . . . 3
  60.      6  Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  61.  
  62.  
  63.  
  64.  
  65.  1  Warranties and Disclaimers:
  66.  
  67.     Ha, Ha, Ha!  You kiddin' me or what?  You get no warranties, written,
  68.     implied, or otherwise except that this software will take up some of
  69.     your disk space.  Instead, you get a bunch of the following disclaimers:
  70.  
  71.     "The Mountie!" is released into the Public Domain and may only be used
  72.     in agreement with the conditions set out in this document.  Subsequent
  73.     use of this package constitutes that agreement and releases the author
  74.     (Clyde W. Sisler) from any and all forms of future liability or
  75.     litigation.  Under no condition shall the author be liable for any
  76.     damages or costs of any kind which result from your use or inability to
  77.     use "The Mountie!"
  78.  
  79.     "The Mountie!" refers to all executables and documentation and other
  80.     files released for distribution by the author in the original compressed
  81.     archive.
  82.  
  83.     "The Mountie!" is copyrighted material by the author and as such, all
  84.     rights are reserved and protected under U.S. copyright laws.
  85.  
  86.     Care has been taken to write and test a program that does (and doesn't
  87.     do) what the documentation states.    "The Mountie!", however,  is
  88.     provided as is, without warranty or guarantee of any kind, either
  89.     expressed or implied!  It works for me and it *SHOULD* work for you.
  90.  
  91.     The author will not be obligated to provide future maintenance nor
  92.     enhancement releases nor ongoing support for "The Mountie!". The author
  93.     further reserves the right not to release future Public Domain versions
  94.     but may provide shareware or commercial versions of this product instead.
  95.  
  96.     "The Mountie!" may be distributed freely provided no money or any other
  97.     compensation is asked for or accepted under any condition.
  98.  
  99.     With all that crap out of the way, let's get to it!
  100.  
  101.  
  102.  
  103.  2  Introduction:
  104.  
  105.     Before you do anything else with The Mountie!, please backup the
  106.     FGROUPS.RA and FILES.RA files in your [drive]:\RA directory.  Both
  107.     of these files are modified when you mount and dismount disks using
  108.     The Mountie!.
  109.         
  110.     The Mountie! allows you to logically mount/dismount CD-ROMs, network
  111.     drives, local hard drives or removable disks within RemoteAccess v2.00G.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                   - 1 -
  119.  
  120.  
  121.  
  122.     File Areas associated with a physical disk are grouped together using
  123.     RA's File Groups and RACONFIG.EXE.  You then select which of your 
  124.     File Groups are disks in The Mountie!  Each disk definition contains
  125.     Online & Offline Security Codes & Flags.
  126.  
  127.     When a disk is mounted, you're asked for the Drive on which it is to
  128.     be mounted and the Device Number.  This information can change each
  129.     time the disk is mounted, allowing you to easily move a disk from drive
  130.     to drive.  The File Group record is updated with it's online security
  131.     code & flags.  Each File Area associated with the disk is then updated
  132.     placing the drive letter as the first character of the path.  The
  133.     device number and (optionally) online security code & flags are also
  134.     changed.
  135.  
  136.     When a disk is dismounted, the File Group record is updated with it's
  137.     offline security code & flags restricting user access to the disk as
  138.     you see fit.  "(Offline)" is also placed near the end of the File Group
  139.     Name.  Each File Area is then (optionally) updated with offline security
  140.     code & flags, further restricting access as your plan dictates.  "**" is
  141.     (optionally) placed near the end of the File Area Name.  This provides a
  142.     simple means for identification of offline areas when you still want the
  143.     areas visible to the user.  "(Offline)" and "**" are removed from the 
  144.     names when the disk is mounted again.
  145.  
  146.     Changing the Group and Area Names provides a means of notifiying users
  147.     of the unavailabilty of the disk and areas but still allowing them access
  148.     to the listings.  You'd probably want to change the download security
  149.     code and/or flags to prevent access and give some thought to upload
  150.     security as well.  The "**" in the File Area name is particularily 
  151.     useful if the area appears in File Groups other than those indicating
  152.     a disk, such as catagories.
  153.  
  154.     Note: It's assumed that all File Areas on a disk will have the same 
  155.           security codes and flags and they will be the same as the File
  156.           Group.  Before using The Mountie! you should sit down and determine
  157.           what you're access restrictions will be and if The Mountie! is
  158.           suitable for your needs.  A future release of The Mountie! may
  159.           allow you to import Security codes & flags from FILES.RA and 
  160.           modify them for online/offline use in the Mountie!
  161.  
  162.  
  163.  3  Package Contents:
  164.  
  165.        BOOHOO.TXT             A sad story
  166.        FILE_ID.DIZ            Description of this package
  167.        MOUNTIE.DOC            This Document
  168.        MOUNTIE.EXE            The Mountie! executable
  169.        FA.EXE                 File Area report utility
  170.        FG.EXE                 File Group report utility
  171.        FGFA.EXE               File Group/File Area report Utility     
  172.        MF.EXE                 List files with flags turned on in FDB
  173.  
  174.  
  175.                                   - 2 -
  176.  
  177.  
  178.  
  179.  4  Installation:
  180.  
  181.     If you're reading this, it's already installed.  Hopefully you have 
  182.     RemoteAccess v2.00G installed on the same machine and have the 
  183.     RA environment variable set in your AUTOEXEC.BAT file.  
  184.  
  185.     Example:  SET RA=[drive]:\RA
  186.  
  187.  
  188.  5  Operation:
  189.  
  190.     Just run the durn thing and you're presented with the Main Menu.
  191.  
  192.     Press <ALT> to activate the menu or <ESC> to quit the program
  193.  
  194.  
  195.     Groups:   This section allows you to Select Groups, drop to DOS or 
  196.               quit the program.
  197.  
  198.               Select Groups: displays all of the File Groups you've
  199.                              defined in FGROUPS.RA.  You're presented
  200.                              with the File Group's name, it's Group 
  201.                              number and the Drive letter, if currently
  202.                              mounted.  A check mark appears on the extreme
  203.                              left if it's been selected as a disk.  Pressing
  204.                              the space bar toggles the check mark on and off
  205.                              thereby selecting or de-selecting the File Group
  206.                              as a disk.
  207.  
  208.                              Use the mouse, PGUP/PGDN and arrow keys to
  209.                              move back and forth between the File Groups.
  210.  
  211.                              Press <ENTER> when all disks have been
  212.                              selected.  DISKS.DAT will be written.  This
  213.                              configuration file contains the disks you've
  214.                              selected, their attributes and if they're
  215.                              mounted or dismounted.     
  216.                              
  217.               DOS Shell:     Quick way to Drop to DOS to perform some 
  218.                              function without leaving the program.  Note
  219.                              that The Mountie! does not swap itself out
  220.                              of memory so you'll have that amount of
  221.                              overhead when you're at the DOS prompt using
  222.                              this function.
  223.  
  224.               Exit:          Quit the program
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                                   - 3 -
  232.  
  233.  
  234.  
  235.     Disks:    This section allows you to mount or dismount disks and change
  236.               their online and offline attributes.
  237.  
  238.               After selecting any of the following functions, you're presented
  239.               with a list of File Groups previously selected as disks.  The
  240.               disk's name, Group number and the drive letter, if it's currently
  241.               mounted, are displayed.
  242.  
  243.               Use the mouse, PGUP/PGDN and arrow keys to position the cursor
  244.               and press <ENTER> to select the desired disk.
  245.  
  246.               Mount A Disk:  Use this function to place a disk online.  Once
  247.                              the disk has been selected, your're presented
  248.                              with a request for a Drive letter and Device
  249.                              number on which the disk is to be mounted.
  250.  
  251.                              Note: To keep things relatively simple and 
  252.                              provide added flexability, no check is made
  253.                              to see if the disk is already mounted nor if
  254.                              another disk is already mounted on the drive.
  255.  
  256.                              You're also presented with 3 Yes/No switches
  257.                              which tell The Mountie! if the File Areas'
  258.                              Name, Security code and/or Security flags
  259.                              should be updated.  Use the space bar or 
  260.                              left/right arrows to change the default 
  261.                              setting.
  262.  
  263.                              Note: These settings are saved and used as
  264.                              default settings when/if you decide to
  265.                              dismount the disk.
  266.                        
  267.                  FGROUPS.RA is updated with the Group's online 
  268.                              attributes (see Online Attributes below) and
  269.                              positions 21-30 of the File Group's name are
  270.                              spaced out (see Dismount A Disk below).
  271.                                                 
  272.                              FILES.RA is then updated.  Each File Area in 
  273.                              which the disk's Group Number appears as a 
  274.                              Group or Alternate Group is updated with the
  275.                              Device number and the Drive letter is inserted
  276.                              into the first position of the path.
  277.  
  278.                              If Yes was selected for Name, positions 29-30
  279.                              of the File Area's name are spaced out (see
  280.                              Dismount A Disk below).
  281.  
  282.                              If Yes was selected for Security, each File
  283.                              Area's Download, List and Upload Security
  284.                              codes will be updated with those defined in
  285.                              the File Group's Online Attributes.
  286.  
  287.  
  288.                                   - 4 -
  289.  
  290.  
  291.                              If Yes was selected for Flags, each File
  292.                              Area's Download, List and Upload Security
  293.                              Flags will be updated with those defined in
  294.                              the File Group Online Attributes.
  295.  
  296.  
  297.               Dismount A Disk:
  298.                              Use this function to place a disk offline.  
  299.  
  300.                              Note: To keep things relatively simple and 
  301.                              provide added flexability, no check is made
  302.                              to see if the disk is already dismounted.
  303.                              This allows you to change the offline
  304.                              attributes and dismount it again. 
  305.  
  306.                              You're also presented with 3 Yes/No switches
  307.                              which tell The Mountie! if the File Areas'
  308.                              Name, Security code and/or Security flags
  309.                              should be updated.  Use the space bar or 
  310.                              left/right arrows to change the default 
  311.                              setting.
  312.  
  313.                              Note: These settings are saved and used as
  314.                              default settings when you decide to mount
  315.                              the disk again.
  316.                        
  317.                  FGROUPS.RA is updated with the Group's offline 
  318.                              attributes (see Offline Attributes below) and
  319.                              "(Offline)" is placed in positions 21-30 of
  320.                              the File Group's name.  Group Names are
  321.                              restricted to 20 characters so " (Online)" can
  322.                              be added to the end of the name and still fit
  323.                              within RA type 50 displays.
  324.  
  325.                              FILES.RA is then updated if any of the Yes/No 
  326.                              options were selected.  Each File Area in 
  327.                              which the disk's Group Number appears as a 
  328.                              Group or Alternate Group is updated as 
  329.                              indicated by the Yes/No switches.
  330.  
  331.                              If Yes was selected for Name, "**" is placed
  332.                              in positions 29-30 of the File Area's name.
  333.                              File Area Names are restricted to 27 characters
  334.                              so " **" can be added to the end of the name
  335.                              and still fit within RA type 50 displays.
  336.  
  337.                              If Yes was selected for Security, each File
  338.                              Area's Download, List and Upload Security
  339.                              codes will be updated with those defined in
  340.                              the File Group's Offline Attributes.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.                                   - 5 -
  348.  
  349.  
  350.  
  351.                              If Yes was selected for Flags, each File
  352.                              Area's Download, List and Upload Security
  353.                              Flags will be updated with those defined in
  354.                              the File Group Offline Attributes.
  355.  
  356.  
  357.               Online Attributes:
  358.                              Use this function to change the online 
  359.                              attributes of a disk.
  360.  
  361.                              When a File Group is first selected as a 
  362.                              disk to be mounted and dismounted (Select
  363.                              Groups), the File Group's Security and 
  364.                              Security Flags in FGROUPS.RA are used to
  365.                              intialize the Online and Offline Attributes
  366.                              for both the File Group and File Areas.  These
  367.                              are stored in DISKS.DAT and used to update the
  368.                              File Group and (optionally) File Areas only
  369.                              when actually mounting or dismounting a disk.  
  370.   
  371.                              The Online Attributes should probably remain the
  372.                              same as those defined in RACONFIG as the File
  373.                              Group and all of it's File Areas will be changed
  374.                              to the attributes in DISKS.DAT when the disk is
  375.                              mounted.
  376.  
  377.                              Online Attributes are really the means to 
  378.                              restore Security Codes and Flags to their 
  379.                              original values when mounting the disk after
  380.                              it's been dismounted.  
  381.  
  382.                              If you change the File Group or File Area 
  383.                              Security Code or Flags in RACONFIG, you probably
  384.                              should change them here too.  
  385.  
  386.                              Any value in the flags fields other than '-'
  387.                              or ' ' means the flag is turned on.  Use of the
  388.                              'O' flags is not supported.   
  389.  
  390.               Offline Attributes:
  391.                              Use this function to change the offline 
  392.                              attributes of a disk.
  393.                    
  394.                              See Online Attributes above for a brief 
  395.                              introduction to Online/Offline Attributes.
  396.  
  397.                  Combined with the changes made to the File
  398.                              Group and File Area names when dismounting
  399.                              a disk, the Offline Attributes give you a 
  400.                              lot of flexibility in how you want to handle
  401.                              offline disks.
  402.  
  403.  
  404.                                   - 6 -
  405.  
  406.  
  407.                              You can have one or both appear on your type
  408.                              50 menus with their names altered to indicate
  409.                              they're not available.
  410.  
  411.                              You can also use File Group and/or File Area
  412.                              Security and/or Flags in any combination to 
  413.                              restrict or permit access to the list, upload
  414.                              and download functions.
  415.  
  416.  
  417.  6  Utilities
  418.  
  419.     FA.EXE     File Area report utility - useful for keeping track of which
  420.                directories are on which drives
  421.  
  422.     FG.EXE     File Group report utility - useful for reference when assigning
  423.                File Areas to File Groups
  424.                    
  425.     FGFA.EXE   File Group/File Area report Utility - Useful for keeping track
  426.                of which FIle Areas are in which File Groups  
  427.               
  428.     MF.EXE     List files with flags turned on in FDB - useful for displaying
  429.                files with flags turned on the Files Database, espeically after
  430.                loading a new CDROM.  These flags are:
  431.  
  432.                      1) Deleted
  433.                      2) Unlisted
  434.                      3) Free
  435.                      4) Not Downloadable
  436.                      5) Locked
  437.                      6) Missing/Offline
  438.                      7) No Time Restrictions
  439.  
  440.     The above utilities all use stdout for the output.  This means if
  441.     you just run the program, all data will, by default, display on the
  442.     monitor.  You may also redirect the output to a printer or to a disk 
  443.     file.  For instance:
  444.  
  445.         FA.EXE > filearea.lst will cause the output of the File Area Report
  446.                               program to be written to a disk file named
  447.                               filearea.lst in the current directory.
  448.  
  449.         FG.EXE > prn (or lpt1, etc) will cause the output of the File Group
  450.                               Report program to be sent directly to the
  451.                               printer. 
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                   - 7 -
  462.