home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / 1edra310.arj / 1EDIT-RA.DOC next >
Text File  |  1992-02-12  |  45KB  |  1,453 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                       +---------------------------------+
  18.                       | +-----------------------------+ |
  19.                       | |    -*-  1-EDIT-RA  -*-      | |
  20.                       | +-----------------------------+ |
  21.                       +---------------------------------+
  22.  
  23.  
  24.                                 Version: 3.10
  25.  
  26.                                      For
  27.  
  28.                               RemoteAccess v1.00
  29.  
  30.  
  31.                                       by
  32.  
  33.  
  34.                                   Bob Ransom
  35.  
  36.  
  37.  
  38.                            Copyright (c) 1990-1991
  39.                              All Rights Reserved
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                    +---------------------------------------+
  76.                    |          TABLE OF CONTENTS            |
  77.                    +---------------------------------------+
  78.  
  79.  
  80.  
  81.           What Is 1-EDIT-RA? ..............................  2
  82.           Acknowledgements ................................  3
  83.           Shareware & Warranty ............................  4
  84.           FOSSILS, ANSI.SYS & Other Requirements ..........  5
  85.               LOCAL.DEF File ..............................  6
  86.               Locked COM Ports ............................  7
  87.               Directories .................................  7
  88.           Command Line Syntax .............................  8
  89.               Colors ......................................  8
  90.               Drop To DOS Security ........................  8
  91.           Getting Started .................................  9
  92.               Setting Up 1-EDIT-RA Within RemoteAccess ....  9
  93.           The MENU Editor ................................. 12
  94.           The USER Editor ................................. 13
  95.               Mass User Updates ........................... 13
  96.               The "-J" Parameter .......................... 14
  97.               Editing Your Own User Record Remotely ....... 14
  98.           Drop To DOS ..................................... 15
  99.               Local Drop To DOS ........................... 15
  100.               Remote Drop To DOS .......................... 15
  101.           Using 1-Edit-RA On Multi-Node Setups ............ 17
  102.               The "-N" Parameter .......................... 17
  103.               The "-U" Parameter .......................... 18
  104.           Registering 1-EDIT-RA ........................... 19
  105.               Keys ........................................ 19
  106.               Installing Keys ............................. 19
  107.           Final Notes ..................................... 21
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           1-EDIT-RA v3.10                               Page 1
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                    +---------------------------------------+
  143.                    |           WHAT IS 1-EDIT-RA?          |
  144.                    +---------------------------------------+
  145.  
  146.  
  147.  
  148.           1-EDIT-RA is a combined User Editor and Menu Editor for
  149.           RemoteAccess systems designed to work reliably from
  150.           remote.  Features include:
  151.  
  152.                     - Built-in FOSSIL routines for guaranteed remote
  153.                     performance.
  154.  
  155.                     - Full carrier detection which returns to
  156.                     RemoteAccess when carrier is dropped.
  157.  
  158.                     - Automatic high speed performance with locked
  159.                     ports at up to 38,400 baud (and possibly
  160.                     higher).
  161.  
  162.                     - Ability to work in multi-node setups.
  163.  
  164.                     - Status line showing user name, baud and modem
  165.                     settings, and time remaining (registered
  166.                     versions).
  167.  
  168.                     - User-definable colors.
  169.  
  170.                     - Full editing capabilities of nearly all fields
  171.                     in the USERS.BBS file.
  172.  
  173.                     - Mass flag updating of user records.
  174.  
  175.                     - Mass "High Message Read" updating of all user
  176.                     records.
  177.  
  178.                     - Full menu editing capabilities including
  179.                     adding, deleting, renaming, and copying menus,
  180.                     plus direct editing of each line of the menu
  181.                     record.  Direct editing allows you to insert,
  182.                     delete, change, and list the lines of the edited
  183.                     menu, plus full menu simulation.
  184.  
  185.                     - Small file size: the program is only around
  186.                     79K and will run in about 96K of memory.  This
  187.                     allows 1-EDIT-RA to run easily from a Type 7
  188.                     shell.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           1-EDIT-RA v3.10                               Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                    +---------------------------------------+
  208.                    |           ACKNOWLEDGEMENTS            |
  209.                    +---------------------------------------+
  210.  
  211.  
  212.           A big "Thank You" goes to all those trusting souls who
  213.           beta tested this version of 1-Edit-RA, risking life and
  214.           limb (not to mention their BBS's) to see if this thing
  215.           actually worked.  Thanks to Mark Martin, Mehdi Attaran,
  216.           Rod Hancock, Lou Ludwig, Don Click, Jim Tanner, Rene
  217.           Reitter and Keith Greer.  These folks not only tested the
  218.           software but made many suggestions for improvement in it.
  219.  
  220.           Thanks also to John Parlin for his JPDOOR Turbo Pascal
  221.           FOSSIL and door interface.  Working with JPDOOR makes door
  222.           writing a breeze if you're working in TP.  John has now
  223.           joined forces with Rod Hancock of Motor City Software and
  224.           together they're continuing developement of JPDOOR along
  225.           with other projects.  At this writing, the latest release
  226.           version of JPDOOR is 2.71 but a new version is in beta
  227.           test.  You should be able to get JPDOOR from either John's
  228.           system (1:282/12) or Rod's (1:229/418).  This software was
  229.           developed and compiled using an older JPDOOR unit for TP
  230.           5.0.
  231.  
  232.           Special thanks also go to Mike Janke for his original help
  233.           in converting the data structures used by this program
  234.           from QuickBBS to RemoteAccess, and also for his
  235.           suggestions on making 1-Edit-RA finally multi-node
  236.           capable.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           1-EDIT-RA v3.10                               Page 3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                    +---------------------------------------+
  274.                    |     1-EDIT-RA: SHAREWARE & WARRANTY   |
  275.                    +---------------------------------------+
  276.  
  277.  
  278.  
  279.           Here comes the dull but necessary stuff:
  280.  
  281.           SHAREWARE INFO
  282.           --------------
  283.  
  284.           This program is released to the public as shareware.  This
  285.           means try it and if you like it you must register it
  286.           within a reasonable amount of time.  The program is not
  287.           freeware nor public domain; it is copyrighted material
  288.           with all rights reserved.  You are granted only a limited
  289.           license to test this software.  No changes whatsoever may
  290.           be made.
  291.  
  292.           You may copy 1-EDIT-RA and transfer it to others provided
  293.           you follow these brief rules:
  294.  
  295.           1- You may not change the program, its archive, or its
  296.           documentation in anyway without express written consent
  297.           from me, the author.
  298.  
  299.           2- You may not sell the program.  This program may be
  300.           distributed on pay systems, but not on a
  301.           "fee-per-download" basis.
  302.  
  303.           3- You may not distribute this product with other products
  304.           without express written consent from me.
  305.  
  306.           Registration of 1-EDIT-RA is a cheap $10 and covers you
  307.           for all future releases of the program.  More information
  308.           on registering is included later in this document.
  309.  
  310.  
  311.           WARRANTY
  312.           --------
  313.  
  314.           No warranty of any kind, covering either hardware or
  315.           software damage, is expressed nor implied.  Use this
  316.           program at your own risk.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.           1-EDIT-RA v3.10                               Page 4
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.               +-------------------------------------------------+
  340.               |   FOSSILS, ANSI.SYS, and OTHER REQUIREMENTS     |
  341.               +-------------------------------------------------+
  342.  
  343.  
  344.  
  345.           There are a few things you should know before attempting
  346.           to boot 1-EDIT-RA for the first time:
  347.  
  348.  
  349.           Software Version
  350.           ----------------
  351.  
  352.           This version of 1-Edit-RA, v3.10, is designed to work with
  353.           RA v1.10.  If for some odd reason you're still running an
  354.           older version of RA, please use 1-Edit-RA v2.01 or 3.00.
  355.  
  356.  
  357.           FOSSIL Driver
  358.           -------------
  359.  
  360.           1-EDIT-RA requires a FOSSIL driver to be installed and
  361.           active at all times.  This shouldn't prove to be much of a
  362.           hindrance since 1-EDIT-RA was designed for remote use.  If
  363.           you are editing strictly from the local console, RACE and
  364.           RAMenu do the same job faster and nicer, and they *don't*
  365.           require a FOSSIL.  (However, they're not meant for remote
  366.           use, either.)  1-Edit-RA has been tested with both the X00
  367.           driver and the BNU driver; both work fine.  One note to
  368.           users who use the TSR version of either X00 or BNU: Be
  369.           sure that you're not having BNU remove itself from memory
  370.           when you exit your BBS and/or mailer.
  371.  
  372.  
  373.           ANSI Graphics
  374.           -------------
  375.  
  376.           1-EDIT-RA requires all users of the program to have the
  377.           ANSI.SYS driver installed - both on the BBS and remote
  378.           caller's systems.  99.9% of sysops do have it installed so
  379.           this shouldn't be a problem.  If you're unfamiliar with
  380.           ANSI.SYS, see your DOS manual.  ANSI.SYS is included with
  381.           all versions of DOS.
  382.  
  383.           I've received a few messages from sysops who would prefer
  384.           that the program *not* use ANSI as they do their remote
  385.           work from non-ANSI machines (like VT-220 terms on a VAX).
  386.           I'll be addressing those needs in a future version (as
  387.           soon as I figure out a clean way to do all the screen
  388.           manipulations that 1-Edit-RA does without ANSI).  I'm not
  389.           using ANSI so much for color changes as I am for cursor
  390.  
  391.  
  392.  
  393.           1-EDIT-RA v3.10                               Page 5
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.           placement, etc.
  406.  
  407.  
  408.           DORINFO1.DEF & LOCAL.DEF
  409.           ------------------------
  410.  
  411.           1-EDIT-RA requires a DORINFO1.DEF file to be present when
  412.           starting.  First, some background on this file and how to
  413.           get around the necessity of having it:  When RemoteAccess
  414.           shells to another program, either through a menu Type 7
  415.           exit or a menu Type 15 exit, it creates two files in your
  416.           system directory (or LINEx directory on multi-nodes):
  417.           DORINFO1.DEF and EXITINFO.BBS.  Both contain information
  418.           for the child program to use in determining the user's
  419.           name, baud rate and modem settings, graphic settings, etc.
  420.           When you return to RemoteAccess from the shell,
  421.           RemoteAccess deletes both of these files.  That's why you
  422.           can never find them on your disk -- they're already gone.
  423.  
  424.           Because 1-EDIT-RA requires DORINFO1.DEF and because a copy
  425.           won't always be available, I've made the program search
  426.           for a second file called LOCAL.DEF.  LOCAL.DEF is nothing
  427.           but a copy of DORINFO1.DEF which should stay in your main
  428.           RA system directory (usually "C:\RA").  When run,
  429.           1-EDIT-RA will first search for the DORINFO1.DEF file.  If
  430.           it's not found, it will then try to find the LOCAL.DEF
  431.           file.  If that's not found, the program aborts.  If it
  432.           *is* found (remember, you're supposed to leave it on your
  433.           disk so it should be there), 1-EDIT-RA will copy it over
  434.           to DORINFO1.DEF.  When you quit 1-EDIT-RA, the
  435.           DORINFO1.DEF file will be deleted.
  436.  
  437.           A copy of LOCAL.DEF is included in the 1-EDIT-RA archive
  438.           which you may edit to reflect your name and system name.
  439.           Here's what it looks like with my comments in braces { }:
  440.  
  441.           -------------------------------------------------------
  442.           THE CREATIVE CONNECTION-SOUTHFIELD, MI-(313)559-9039
  443.           BOB                    {Sysop first name}
  444.           RANSOM                 {Sysop last name}
  445.           COM0                   {Don't edit this!}
  446.           0 Baud,N,8,1           {No need to edit this}
  447.           0                      {This does nothing - just a zero}
  448.           BOB                    {User first name}
  449.           RANSOM                 {User last name}
  450.           LATHRUP VILLAGE, MI    {No need to edit; not used}
  451.           1                      {Graphics.  Unused by 1-Edit-RA}
  452.           32000                  {User security level}
  453.           235                    {User time remaining}
  454.           -------------------------------------------------------
  455.  
  456.  
  457.  
  458.  
  459.           1-EDIT-RA v3.10                               Page 6
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           Feel free to edit your copy of LOCAL.DEF to reflect the
  472.           proper sysop names and user names.  The COM port setting
  473.           MUST remain as COM0 -- this indicates a local connect.
  474.           Changing the security and time remaining is up to you.
  475.           Time remaining is not counted while in local.  After
  476.           editing, place the LOCAL.DEF in your RA system directory
  477.           and leave it there.
  478.  
  479.           Locked COM Ports
  480.           ----------------
  481.  
  482.           Locked COM ports are supported automatically by 1-EDIT-RA.
  483.           There is no need to use DorSpeed, SetSpeed, etc.
  484.           1-EDIT-RA has been successfully tested at speeds up to
  485.           38,400 baud.
  486.  
  487.  
  488.           Directories
  489.           -----------
  490.  
  491.           1-Edit-RA may be run from any directory you choose.  When
  492.           first started, it searches your DOS environment for "SET
  493.           RA=", then uses that path to find the CONFIG.RA,
  494.           DORINFO1.DEF, and LOCAL.DEF files.  (Note to multi-line
  495.           sysops:  See the special section below on modifications
  496.           you can make to force 1-Edit-RA to search elsewhere for
  497.           these files.)  If you don't have the RA environment
  498.           variable set (you should already), please set it.  See
  499.           your RA docs for more info.
  500.  
  501.           Also, 1-Edit-RA expects to find your USERS.BBS in the path
  502.           defined in CONFIG.RA as "Message base directory."  Your
  503.           CONFIG.RA should already be pointing to the proper
  504.           directory.  (This may also be changed with command line
  505.           parameters.  See the "Multi-Node" section of these docs.)
  506.  
  507.  
  508.           Okay, that takes care of the requirements.  Now, you've
  509.           unZIPped the 1-EDIT-RA file and put it somewhere on your
  510.           hard drive, and put the edited LOCAL.DEF into your RA
  511.           system directory.  Now you're almost ready to get started.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.           1-EDIT-RA v3.10                               Page 7
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.                    +---------------------------------------+
  538.                    |         COMMAND LINE SYNTAX           |
  539.                    +---------------------------------------+
  540.  
  541.  
  542.  
  543.           1-EDIT-RA allows you to customize it somewhat via the
  544.           command line.  Five parameters may be included if you wish
  545.           (they're optional):
  546.  
  547.           -Nxxxxx  Tells 1-Edit-RA to look in path xxxxx for the
  548.                    DORINFO1.DEF and/or CONFIG.RA files.  See
  549.                    "Multi-Node" section for more info.  Example:
  550.                    "-Nc:\ra\line1"  A trailing backslash is
  551.                    optional.
  552.  
  553.           -Uxxxxx  Tells 1-Edit-RA to look in path xxxxx for the
  554.                    USERS.BBS file. Example: "-Uc:\ra\users"
  555.                    A trailing backslash is optional.
  556.  
  557.           -Fxx     Sets foreground color to xx.  xx must be 0-7.
  558.                    Default color is cyan (#3).
  559.  
  560.           -Hxx     Sets the highlight color to xx.  xx must be 0-15.
  561.                    Default highlight color is bright yellow (#14).
  562.  
  563.           -Sxxxxx  Sets the minimum security level for the Drop to
  564.                    DOS feature to xxxxx.  xxxxx must be 0-64000.
  565.                    Default is 32000.  More on this feature later.
  566.  
  567.           -J       User security "jumping".  More on this later.
  568.  
  569.  
  570.           ?        Brings up very short help screen describing
  571.                    command line parameters.
  572.  
  573.           None of these parameters are required; use any, all, or
  574.           none of them as you choose.  The command line may be in
  575.           upper case or lower; it doesn't matter.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.           1-EDIT-RA v3.10                               Page 8
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.                    +---------------------------------------+
  604.                    |           GETTING STARTED             |
  605.                    +---------------------------------------+
  606.  
  607.  
  608.  
  609.           With that boring stuff out of the way, we'll get on to the
  610.           meat of the program.  I'm not going to bother taking you
  611.           through each and every option in the editors -- most
  612.           commands are pretty self-explanatory, so I'll just touch
  613.           on most of it and highlight oddities, etc.  Any sysop that
  614.           has gotten a RemoteAccess system up and running shouldn't
  615.           have any problems.
  616.  
  617.  
  618.           Setting Up 1-EDIT-RA Within RemoteAccess
  619.           ----------------------------------------
  620.  
  621.           1-EDIT-RA has been tested under both a RemoteAccess Type 7
  622.           exit and a Type 15 exit; either setup will work just fine.
  623.           However, because of its small size, 1-EDIT-RA is probably
  624.           best run as a Type 7 except on systems with very tight
  625.           memory constraints (i.e. some Desqview and DoubleDOS
  626.           systems).  For Desqview/DoubleDOS users: As best as I can
  627.           tell, 1-EDIT-RA runs in about 84K of memory.
  628.  
  629.           Here's a sample of how a Type 7 setup would look from
  630.           within RAMENU:
  631.           ---------------------------------------------------------
  632.                                Edit Menu Item
  633.  
  634.                    1         2         3         4         5
  635.           1234567890123456789012345678901234567890123456789012345678
  636.           <^1^> ............  Run 1-EDIT-RA Editor
  637.  
  638.           Optional Data:
  639.           1EDIT-RA.EXE -F7 -H15 -S100
  640.  
  641.           User Display
  642.           Action            Execute sub-program (Type 7)
  643.           Optional data
  644.           Hot-Key           1
  645.           Automatic         No
  646.           Colour            Colour example
  647.           Security          32000
  648.           Flags-A           --------
  649.           Flags-B           --------
  650.           Flags-C           --------
  651.           Flags-D           --------
  652.  
  653.           ---------------------------------------------------------
  654.  
  655.  
  656.  
  657.           1-EDIT-RA v3.10                               Page 9
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.           As mentioned earlier, the -F, -H, and -S command line
  671.           parameters are completely optional; leave them off if
  672.           you're happy with the defaults.
  673.  
  674.           Here's an example of the RAMENU setup for a multi-node
  675.           system:
  676.           ---------------------------------------------------------
  677.                                Edit Menu Item
  678.  
  679.                    1         2         3         4         5
  680.           1234567890123456789012345678901234567890123456789012345678
  681.           <^1^> ............  Run 1-EDIT-RA Editor
  682.  
  683.           Optional Data:
  684.           1EDIT-RA.EXE -Nc:\ra\line*N -Uc:\ra\users -F7 -H15 -S100
  685.  
  686.           User Display
  687.           Action            Execute sub-program (Type 7)
  688.           Optional data
  689.           Hot-Key           1
  690.           Automatic         No
  691.           Colour            Colour example
  692.           Security          32000
  693.           Flags-A           --------
  694.           Flags-B           --------
  695.           Flags-C           --------
  696.           Flags-D           --------
  697.  
  698.           ---------------------------------------------------------
  699.           See the section on multi-node setups for more information
  700.           on the -N and -U parameters.
  701.  
  702.  
  703.           Actual Startup
  704.           --------------
  705.  
  706.           When you first start 1-EDIT-RA, it will check to see that
  707.           a FOSSIL is present.  If not, the program aborts.  From
  708.           there it begins its search for CONFIG.RA and DORINFO1.DEF,
  709.           using LOCAL.DEF if necessary.  Some values are
  710.           initialized, then an opening screen pops up.  If you
  711.           haven't registered your program yet, the program will ring
  712.           the bell a few times, then pause for 4 seconds to <ahem>
  713.           encourage registration.  After the pause you'll be
  714.           prompted to "Press [ENTER] to continue:".  Press enter and
  715.           you'll get the main menu.
  716.  
  717.           From the main menu you may choose to edit user files, menu
  718.           files or drop to DOS.  At this point, registered versions
  719.           of 1-EDIT-RA will show a status line on the local console
  720.  
  721.  
  722.  
  723.           1-EDIT-RA v3.10                               Page 10
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.           detailing who's online, baud and modem settings, and time
  736.           remaining.  Unregistered versions show only the line
  737.           "Unregistered Evaluation Copy."
  738.  
  739.           A side note that applies here and throughout most of the
  740.           program: Pressing [ENTER] or entering a question mark will
  741.           redraw the screen.  This is really only useful in times of
  742.           high line noise, but it's nice to have available when you
  743.           need it.
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.           1-EDIT-RA v3.10                               Page 11
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.                    +---------------------------------------+
  802.                    |           THE MENU EDITOR             |
  803.                    +---------------------------------------+
  804.  
  805.  
  806.  
  807.           Those of you familiar with Adam Hudson's original Menuedit
  808.           will feel right at home here.  When you first choose the
  809.           menu editor from the main menu, you'll be presented with a
  810.           directory of the menus in your RemoteAccess menu area.
  811.           1-EDIT-RA uses the CONFIG.RA file to determine the path to
  812.           this area.  After displaying all of the menus you'll have
  813.           the option of editing/adding a menu, renaming a menu,
  814.           copying a menu, deleting a menu, or relisting the files.
  815.  
  816.           There's no need to explain most of these functions.  One
  817.           thing you might like to know is that any rename, delete,
  818.           or copy operation can be stopped by pressing [ENTER] on a
  819.           blank input field.
  820.  
  821.           Choose the <E> option and you'll be prompted for the menu
  822.           filename to edit.  Input the name.  If the menu isn't
  823.           found, you'll be asked if you wish to create it.  After
  824.           entering the menu name, you'll be dropped onto the main
  825.           menu editor menu.  From here you can do a variety of
  826.           things, all very similar to the same functions in
  827.           Menuedit.
  828.  
  829.           Rather than beat a dead horse trying to detail each
  830.           section of this menu, you should just play with it a bit.
  831.           It's pretty easy.  Start by copying a menu, any menu, to
  832.           another menu file called, maybe, TEST or FRED or
  833.           something.  Then hack on that copied menu.  You'll get the
  834.           hang of it pretty quickly (like instantly, I hope).
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.           1-EDIT-RA v3.10                               Page 12
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.                    +---------------------------------------+
  868.                    |           THE USER EDITOR             |
  869.                    +---------------------------------------+
  870.  
  871.  
  872.  
  873.           Most all of this section should be pretty easy to figure
  874.           also.  For the most part, everything is self-explanatory.
  875.           Press the plus key (+) for the next user or the minus key
  876.           (-) for the previous user.  When moving from user to user,
  877.           if you hit the beginning or end of the USERS.BBS file, the
  878.           program will "wrap around" for the next user.  Example:
  879.           You come to the last user in the file, say user #100, then
  880.           press the plus key (+).  1-EDIT-RA will "wrap around" to
  881.           user #0.
  882.  
  883.           Pick and choose the fields you need to edit, press the
  884.           bracketed key <>, and you edit to your heart's content.
  885.           One note of interest: Should you go to edit a field and
  886.           then decide not to change anything, just press [ENTER]
  887.           over a blank field and that field will remain unchanged.
  888.  
  889.           At the bottom of the screen, you'll see a small window
  890.           with choices to add a user, delete a user, toggle NO-KILL
  891.           and other flags, etc.  <Q>uit takes you back to the main
  892.           menu.  <O>ther clears this small window and replaces it
  893.           with a different set of options that allow you to make
  894.           mass updates to flags or high message read numbers (see
  895.           below), and to edit some of the other user fields that
  896.           aren't often edited.  To return to the first set of
  897.           options, press <O> again.
  898.  
  899.  
  900.           MASS UPDATES
  901.           ------------
  902.  
  903.           From the <O>ther window, you have the ability to do mass
  904.           updates to flags and high message read numbers.  What's
  905.           this good for?  Well, a couple of things:
  906.  
  907.           Some of you use a combination auto-executed menu options
  908.           and flags to show your BBS users a news file.  After they
  909.           read the file, you set that flag to OFF.  When you create
  910.           a new news file, you must go back and turned everyone's
  911.           flag back on again.  Mass Flag Upd. allows you to do that.
  912.           You're asked for the flag you wish to set (A, B, C, or D),
  913.           the flag position to set (1-8), and whether you want it on
  914.           or off.  After entering the information, 1-EDIT-RA will go
  915.           through and reset that flag bit for each user in the
  916.           USERS.BBS.
  917.  
  918.  
  919.  
  920.  
  921.           1-EDIT-RA v3.10                               Page 13
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.           Mass updating of high message read is usually good after
  934.           you either bomb your message base, or do a slightly messed
  935.           up message renumber.  I've had a few occasions where my
  936.           message base has gotten destroyed and I've had to delete
  937.           all the files.  After doing so, all the user records still
  938.           contain the old high message read numbers, so the users
  939.           all get the "No new messages" line when they attempt to
  940.           read new messages.  Using this mass update option lets you
  941.           reset everybody's high read number back to 0 (or whatever
  942.           number you want).
  943.  
  944.  
  945.           SECURITY "JUMPING" (aka "the -J parameter)
  946.           -----------------------------------------
  947.  
  948.           By default, any user who has access to 1-Edit-RA can edit
  949.           *any* user record.  For some sysops, those with remote
  950.           cosysops, this can sometimes cause a problem.  You may
  951.           wish to allow a user to edit *some* user records, but not
  952.           all.  That's what "-J" does.  Add it to your 1-Edit-RA
  953.           command line and the program will conveniently skip any
  954.           record in the USERS.BBS where the security level is
  955.           greater than the current user's own security level.  For
  956.           example, your remote sysop has a level of 100.  With
  957.           jumping in force (-J on the command line), 1-Edit-RA won't
  958.           let him/her even see any user record where the security
  959.           level is 101 or higher.
  960.  
  961.  
  962.           EDITING YOUR OWN USER RECORD REMOTELY
  963.           -------------------------------------
  964.  
  965.           To put it simply, it can't be done.  I hear about this all
  966.           the time -- folks letting me know about a "bug" in
  967.           1-Edit-RA that causes any changes made remotely to their
  968.           own record mysteriously disappear after they log off.  The
  969.           reason is pretty simple, and it goes all the way back to
  970.           the original QuickBBS versions of several years ago.
  971.           (Remember, RA was originally a clone of Quick.)
  972.  
  973.           Anyhow, here's what happens:  When a user logs onto the
  974.           BBS, RA reads his/her user file into memory.  Any changes
  975.           that RA would make to his/her user record are stored in
  976.           memory until that person logs off.  At that point, the
  977.           user's disk record is completely overwritten with all the
  978.           new data.  If, during the online session, the user changes
  979.           his/her own record, those changes are written to disk by
  980.           1-Edit-RA -- but then completely overwritten by RA when
  981.           the user logs off.  The only ways around this are to log
  982.           on under another name and edit your real user record, or
  983.           wait until you can edit directly from DOS.
  984.  
  985.  
  986.  
  987.           1-EDIT-RA v3.10                               Page 14
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.                    +---------------------------------------+
  1000.                    |         DROP TO DOS FEATURE           |
  1001.                    +---------------------------------------+
  1002.  
  1003.  
  1004.  
  1005.           This feature can be both very useful and very dangerous,
  1006.           so PLEASE READ THIS SECTION CAREFULLY.  Before attempting
  1007.           to use the Drop to DOS feature, be sure your CONFIG.SYS
  1008.           file sets COMSPEC=<path to COMMAND.COM>.  1-EDIT-RA uses
  1009.           that DOS environment variable to tell it where to find
  1010.           COMMAND.COM.  For more info on CONFIG.SYS files and
  1011.           setting COMSPEC, see your DOS manual.  If you wish to test
  1012.           whether COMSPEC= is set or not, type SET at any DOS
  1013.           prompt.  This will cause DOS to display your environment
  1014.           settings
  1015.  
  1016.           When displaying the main menu, 1-EDIT-RA checks the users
  1017.           security level (set in DORINFO1.DEF) against the security
  1018.           level set on the command line (or the default, 32000).  If
  1019.           the user's level equals or exceeds that level, the Drop to
  1020.           DOS function appears on the main menu.  If the user's
  1021.           security level is *less* than the specified level, the
  1022.           option doesn't even show up on the menu.  This allows you
  1023.           to have co-sysops be able to edit your BBS files without
  1024.           actually cutting them loose in DOS.
  1025.  
  1026.           Drop to DOS works in two different ways, depending on if
  1027.           you're online locally or from remote:
  1028.  
  1029.  
  1030.           LOCAL DROP TO DOS
  1031.           -----------------
  1032.  
  1033.           When in local mode, the drop to DOS is just a very simple
  1034.           shell.  You hit "D" and you get the familiar flashing
  1035.           cursor.  (What actually happens is a second copy of
  1036.           COMMAND.COM is loaded.)  You may run whatever files you
  1037.           need to run from here.  When ready to return to 1-EDIT-RA,
  1038.           simply type EXIT.
  1039.  
  1040.  
  1041.           REMOTE DROP TO DOS
  1042.           ------------------
  1043.  
  1044.           Things become a bit more complicated when dropping to DOS
  1045.           remotely because 1-EDIT-RA goes on hold during the shell.
  1046.           This is similar to Type 7 and Type 15 exits out of
  1047.           RemoteAccess -- when you shell out, you loose RA's ability
  1048.           to send things through the modem, watch carrier and time
  1049.           remaining, etc.  The same happens when you shell out of
  1050.  
  1051.  
  1052.  
  1053.           1-EDIT-RA v3.10                               Page 15
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.           1-EDIT-RA -- whatever you shell to *must* take over all
  1066.           modem functions including FOSSIL interface, carrier
  1067.           detect, etc.  Because of this, a warning pops up when
  1068.           executing the shell reminding you not to go and try to
  1069.           load WordPerfect or some other program that has no modem
  1070.           routines.
  1071.  
  1072.           To make this perfectly clear, I'll repeat this in shouting
  1073.           mode: 1-Edit-RA DOES NOT AND CAN NOT MONITOR WHAT YOU DO
  1074.           WHEN SHELLED OUT.  THE CHILD PROGRAM THAT YOU RUN MUST,
  1075.           REPEAT MUST HANDLE ALL MODEM AND CARRIER ROUTINES ON IT'S
  1076.           OWN.  1-Edit-RA WILL NOT DO IT!  Okay, enough shouting.
  1077.  
  1078.           When you do execute the shell, you're prompted to enter a
  1079.           filename to execute.  Leave this field blank and 1-EDIT-RA
  1080.           will return to the main menu.  If you do execute a program
  1081.           or batch file, BE SURE TO INCLUDE THE FILE EXTENSION WITH
  1082.           THE FILENAME (i.e. ".EXE", ".COM", ".BAT").  You may also
  1083.           include as many command line parameters as you can fit
  1084.           into the field.  These parameters will be passed on to the
  1085.           child program.  When you exit the child program, you'll be
  1086.           returned automatically to 1-EDIT's main menu.
  1087.  
  1088.           A sample batch file called DOSSHELL.BAT is included in the
  1089.           archive for you to look over.  It details how you can set
  1090.           up a true drop to DOS from 1-EDIT-RA using CTTY COMx or (a
  1091.           better method using Gateway) CTTY GATEx.  THIS IS NOT
  1092.           MEANT TO BE A READY-TO-RUN BATCH FILE!  Use it only as a
  1093.           guide.  If you try this out, be sure to pass your baud
  1094.           rate to the batch file on the command line as:
  1095.           DOSSHELL.BAT 2400  (or whatever rate you're using).  This
  1096.           batch file should be looked at and tested CAREFULLY before
  1097.           relying on it!!!!  Also, I'd suggest that you make sure
  1098.           you run WATCHCD or some other carrier detection TSR before
  1099.           anything else.  WATCHCD (and the related BOOT.COM) is
  1100.           available inside the archive of any version of X00.
  1101.  
  1102.           Better yet, get a copy of DOORWAY, a wonderful program
  1103.           that lets you run almost anything through the shell with
  1104.           complete carrier detection.  It's shareware and
  1105.           registration is pretty inexpensive.
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.           1-EDIT-RA v3.10                               Page 16
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.                    +---------------------------------------+
  1132.                    | USING 1-Edit-RA ON MULTI-NODE SETUPS  |
  1133.                    +---------------------------------------+
  1134.  
  1135.  
  1136.           The first versions of 1-Edit-RA (v1.0, 1.0a, and 1.01)
  1137.           didn't work too well with multi-node RemoteAccess setups.
  1138.           Okay, let's be honest:  They didn't work at all.  With
  1139.           v2.00 that was changed.
  1140.  
  1141.           First things first: You need to do nothing at all to get
  1142.           1-Edit-RA to share files with RemoteAccess.  That is
  1143.           automatic and has been tested on both Desqview setups and
  1144.           various LAN setups.  You will, however, probably want to
  1145.           take advantage of the two command line parameters designed
  1146.           specifically for multi-node setups.
  1147.  
  1148.           But, first: When running a multi-node RA system, you will
  1149.           typically have your directories set up similar to this:
  1150.  
  1151.           C:\RA        =   Main System Directory.  RA environment
  1152.                            variable points here.
  1153.  
  1154.           C:\RA\LINEx  =   Separate directories for each node that
  1155.                            you operate, where "x" equals the line
  1156.                            number.
  1157.  
  1158.           Your actual directory names may be different though most
  1159.           people seem to follow this example (as outlined in the RA
  1160.           docs.)
  1161.  
  1162.           Under single line setups, your CONFIG.RA file lives in the
  1163.           System directory.  This is also where RA puts the
  1164.           DORINFO1.DEF file when executing a Type 7 or Type 15 menu
  1165.           option.  Under multi-node setups, the DORINFO1.DEF file is
  1166.           placed in the line directories (C:\RA\LINEx).  Also, many
  1167.           sysops have two or more different kinds of modems,
  1168.           requiring CONFIG files for each modem (for different
  1169.           initialization strings, etc.)  In these cases the sysop
  1170.           places the extra CONFIG files in the line directories so
  1171.           that RA will use the proper CONFIG setup with the proper
  1172.           modem.
  1173.  
  1174.  
  1175.           THE -N PARAMETER
  1176.           ----------------
  1177.  
  1178.           When 1-Edit-RA detects the -N parameter on the command
  1179.           line, it will search the directory specified after the -N
  1180.           for both the DORINFO1.DEF and the CONFIG.RA files.  If the
  1181.           files are found, they will be used rather than whatever
  1182.  
  1183.  
  1184.  
  1185.           1-EDIT-RA v3.10                               Page 17
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.           may be in the System directory.  If either file is not
  1198.           found in the specified directory, 1-Edit-RA will then
  1199.           search for it in the System directory.  In the case of the
  1200.           CONFIG.RA file, if it's missing from the specified line
  1201.           directory and missing from the System directory (almost
  1202.           impossible if your system actually works), 1-Edit-RA will
  1203.           abort.  In the case of the DORINFO1.DEF file, 1-Edit-RA
  1204.           will first search the specified line directory, then the
  1205.           System directory.  If the file isn't found in either
  1206.           place, 1-Edit-RA will search the System directory for the
  1207.           LOCAL.DEF file (see above).  There's no need to put a copy
  1208.           of LOCAL.DEF into each of your line directories; 1-Edit-RA
  1209.           won't find them there.  One copy of LOCAL.DEF in the
  1210.           System directory is all that's required.
  1211.  
  1212.           Here's an example of the -N command line parameter in use:
  1213.  
  1214.           1EDIT-RA.EXE -Nc:\ra\line1
  1215.  
  1216.                    -or-
  1217.  
  1218.           1EDIT-RA.EXE -Nc:\ra\line*N
  1219.  
  1220.           A trailing backslash is optional.  Note the "*N" in the
  1221.           second example.  This utilizes a feature of RA in which RA
  1222.           will substitute the current line number for the "*N" when
  1223.           executing a Type 7 or Type 15 exit.  More information on
  1224.           this and other RA exit parameters is available in your RA
  1225.           docs.
  1226.  
  1227.  
  1228.           THE -U PARAMETER
  1229.           ----------------
  1230.  
  1231.           This parameter tells 1-Edit-RA to use the USERS.BBS file
  1232.           in the directory specified after the -U.  Example:
  1233.  
  1234.           -Uc:ra\users\
  1235.  
  1236.           As before, the trailing backslash is optional.  This is
  1237.           probably not going to be the most used parameter of the
  1238.           bunch.  As far as I can tell, most folks maintain a single
  1239.           USERS.BBS file for all lines of their system.  However,
  1240.           there may be (and probably are) some sysops who maintain
  1241.           separate user bases for each of their nodes.  Maybe one
  1242.           for business and the other for the general public. Anyway,
  1243.           you have the option should you wish to use it.  One thing
  1244.           to note about this parameter: If 1-Edit-RA can't find the
  1245.           USERS.BBS in the directory you specify, it will NOT look
  1246.           anywhere else for it.  It will simply abort with an error
  1247.           code.
  1248.  
  1249.  
  1250.  
  1251.           1-EDIT-RA v3.10                               Page 18
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.                    +-----------------------------------------+
  1264.                    |          REGISTERING 1-EDIT-RA          |
  1265.                    +-----------------------------------------+
  1266.  
  1267.  
  1268.  
  1269.           KEYS
  1270.           ----
  1271.  
  1272.           1-EDIT-RA uses a "keyed" registration system.  The
  1273.           information used to create your key is your system name
  1274.           and sysop name as contained in your CONFIG.RA file.
  1275.           Unregistered versions of the program (programs running
  1276.           without the key) ring the bell and have a 4 second pause
  1277.           built in at the beginning of the program, plus the status
  1278.           line is disabled.  Registered versions will also show the
  1279.           registered system name and sysop name during the opening
  1280.           screen (i.e. "Registered to: Creative Connection  Bob
  1281.           Ransom").  These are the only differences between
  1282.           registered and unregistered copies.  1-EDIT-RA has no
  1283.           built in self-destruct mechanisms or other disgusting
  1284.           things.
  1285.  
  1286.           When you register 1-EDIT-RA, you'll receive a small key
  1287.           file that will disable the bell ringing and pause, and
  1288.           enable the status line.  If you hold a valid Fidonet node
  1289.           number, your key file will be sent to you through netmail
  1290.           file attach.  Sysops who aren't a part of Fidonet or who
  1291.           are outside of the continental U.S. and Canada will
  1292.           receive their key files on a disk through the mail.
  1293.  
  1294.  
  1295.           INSTALLING KEYS
  1296.           ---------------
  1297.  
  1298.           When you receive your key file, it will be named something
  1299.           like LASTNAME.KEY (where LASTNAME is your last name).
  1300.           Place this key file into the directory where 1-EDIT-RA
  1301.           will be running from and rename it 1EDIT-RA.KEY.  Repeat:
  1302.           It must be in the same directory as 1-Edit-RA!  Be sure to
  1303.           check your spelling here: "1-EDIT-RA.KEY" won't work; only
  1304.           "1EDIT-RA.KEY" will.
  1305.  
  1306.           Leave this key in place for as long as you use 1-EDIT-RA.
  1307.           It will be good for all future releases of the program.
  1308.           If for some reason I should need to make a change in the
  1309.           key encryption routines (which would invalidate your key),
  1310.           a new key will be sent to you immediately.  Also, there is
  1311.           no difference between a key for the QuickBBS version of
  1312.           1-Edit and the RA version, 1-Edit-RA, except for the
  1313.           filename.  The RA version looks for 1EDIT-RA.KEY while the
  1314.  
  1315.  
  1316.  
  1317.           1-EDIT-RA v3.10                               Page 19
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.           QuickBBS version looks for 1-EDIT.KEY.  Just rename the
  1330.           file.
  1331.  
  1332.  
  1333.           REGISTERING
  1334.           -----------
  1335.  
  1336.           A registration form called REGISTER.DOC is included in the
  1337.           1-EDIT-RA archive.  Please complete this form and mail it
  1338.           with your check or money order for $10 (U.S. funds) to the
  1339.           address on that form.  You key will be sent to you within
  1340.           a few days of receipt of your check.
  1341.  
  1342.  
  1343.           KEY PROBLEMS
  1344.           ------------
  1345.  
  1346.           These pop up every once in a while and they usually stem
  1347.           from the information in the key file not matching that in
  1348.           your CONFIG file.  Most often the mismatch is in the BBS
  1349.           name.  The key routines don't care about case but they do
  1350.           care about wording and spacing.  Be sure that the
  1351.           information you provide on the registration form exactly
  1352.           matches that in your CONFIG file.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.           1-EDIT-RA v3.10                               Page 20
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.                    +---------------------------------------+
  1396.                    |               THE END                 |
  1397.                    +---------------------------------------+
  1398.  
  1399.  
  1400.  
  1401.           Okay, I guess that wraps it up.  Hopefully this document
  1402.           is complete enough that you can set up and run 1-EDIT-RA
  1403.           without problems.  Should you encounter a problem of some
  1404.           kind or an unfound bug, please be sure to let me know.
  1405.           Suggestions for enhancements are always welcomed, too.
  1406.           You can contact me through the RemoteAccess Utility
  1407.           Support echo (RA_UTIL), the QuickBBS Support echo, the
  1408.           QuickPro echo, or by netmail.
  1409.  
  1410.           The current version of this program is available for file
  1411.           request from my system under the magic name of 1EDIT-RA.
  1412.           First time callers can also download the program from the
  1413.           RA/QuickBBS Files section.
  1414.  
  1415.           -Bob Ransom
  1416.            27840 Lathrup Blvd.
  1417.            Lathrup Village, MI  48076
  1418.  
  1419.            The Creative Connection BBS
  1420.            24 hours / 7 days
  1421.            300-1200-2400 Baud / 8-N-1
  1422.            313/559-9039
  1423.            1:120/96
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.           1-EDIT-RA v3.10                               Page 21
  1450.  
  1451.  
  1452.  
  1453.