home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / 1edit276.zip / 1EDIT.DOC next >
Text File  |  1992-07-12  |  41KB  |  1,321 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                   +----------------------------------------+
  14.                   |  +----------------------------------+  |
  15.                   |  |         -*-  1-Edit  -*-         |  |
  16.                   |  +----------------------------------+  |
  17.                   +----------------------------------------+
  18.  
  19.  
  20.                                 Version: 2.75
  21.  
  22.                                      For
  23.  
  24.                                 QuickBBS v2.75
  25.  
  26.  
  27.                                       by
  28.  
  29.  
  30.                                   Bob Ransom
  31.  
  32.  
  33.  
  34.  
  35.                               Copyright (c) 1991
  36.                              All Rights Reserved
  37.  
  38.  
  39.  
  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.                |              TABLE OF CONTENTS              |
  75.                +---------------------------------------------+
  76.  
  77.  
  78.           What Is 1-Edit .....................................  2
  79.           Shareware & Warranty Info ..........................  3
  80.           FOSSILS, ANSI.SYS, and Other Requirements ..........  4
  81.                LOCAL.DEF File ................................  5
  82.                Locked COM Ports ..............................  6
  83.                Directories ...................................  6
  84.           Command Line Syntax ................................  7
  85.                Colors ........................................  7
  86.                Drop to DOS Security Level ....................  7
  87.                Directory Commands ............................  7
  88.           Getting Started ....................................  8
  89.                Setting Up 1-Edit Within QuickBBS .............  8
  90.           The Menu Editor .................................... 10
  91.           The User Editor .................................... 11
  92.                Mass Updates .................................. 11
  93.                Security "Jumping" (-J parameter) ............. 11
  94.                Editing Your Own User Record .................. 12
  95.           Drop To DOS ........................................ 13
  96.                Local Drop .................................... 13
  97.                Remote Drop ................................... 13
  98.                DOSSHELL.BAT .................................. 14
  99.           Multi-Node Setup ................................... 15
  100.                The -N Parameter .............................. 15
  101.                The -U Parameter .............................. 16
  102.           Registering 1-Edit ................................. 17
  103.           Final Notes ........................................ 19
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           1-Edit Documentation                             Page 1
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                +---------------------------------------------+
  140.                |                WHAT IS 1-EDIT?              |
  141.                +---------------------------------------------+
  142.  
  143.  
  144.           1-Edit is a combined User Editor and Menu Editor for
  145.           QuickBBS v2.75 systems designed to work reliably from
  146.           remote.  Features include:
  147.  
  148.                    - Built-in FOSSIL routines for easy to operate
  149.                    remote performance.
  150.  
  151.                    - Full carrier-detection which returns to
  152.                    QuickBBS when carrier is dropped.
  153.  
  154.                    - Automatic high-speed performance with locked
  155.                    ports at up to 38,400 baud.
  156.  
  157.                    - Ability to work in multi-node setups.
  158.  
  159.                    - Status line showing user name, baud and modem
  160.                    settings, and time remaining (registered versions
  161.                    only.)
  162.  
  163.                    - User definable colors.
  164.  
  165.                    - Full editing capabilities of nearly all fields
  166.                    in the USERS.BBS file.
  167.  
  168.                    - Full menu editing capabilities including
  169.                    adding, deleting, renaming, and copying menus,
  170.                    plus direct editing of each line of the menu
  171.                    record.
  172.  
  173.                    - Reasonably small file size: the program is only
  174.                    around 100K and runs in about 120K.  This allows
  175.                    1-Edit to run easily from Type 7 shells.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           1-Edit Documentation                             Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                +---------------------------------------------+
  206.                |      1-EDIT: SHAREWARE & WARRANTY INFO      |
  207.                +---------------------------------------------+
  208.  
  209.  
  210.  
  211.           Here comes the dull stuff...
  212.  
  213.  
  214.           SHAREWARE INFO
  215.           --------------
  216.  
  217.           This program is released to the public as shareware.  This
  218.           means try the program and if you like it and continue to
  219.           use it, you must register it within a reasonable amount of
  220.           time.  This program is not freeware nor public domain
  221.           software; rather it is copyrighted material with all
  222.           rights reserved.  You are granted only a limited license
  223.           to test this software to see if it meets your needs.
  224.  
  225.           You may copy 1-Edit and transfer it to others provided you
  226.           follow these brief rules:
  227.  
  228.           1- You may not change the program, its documentation, any
  229.           ancillary programs or files included in the archive, or
  230.           the archive itself, in any way without express written
  231.           consent from me, the author.
  232.  
  233.           2- You may not sell the program to others.  This program
  234.           may be distributed on pay systems, but not on a "fee per
  235.           download" basis.
  236.  
  237.           3- You may not distribute this product with any other
  238.           products without express written consent from me.
  239.  
  240.           Registration of 1-Edit is a cheap 10 bucks and covers you
  241.           for all future releases of the program.  More information
  242.           on registration is included later in this document.
  243.  
  244.  
  245.           WARRANTY
  246.           --------
  247.  
  248.           No warranty of any kind, covering either hardware or
  249.           software damage, is expressed nor implied.  If you choose
  250.           to use this program, you do so at your own risk.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           1-Edit Documentation                             Page 3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                +---------------------------------------------+
  272.                |  FOSSILS, ANSI.SYS, and OTHER REQUIREMENTS  |
  273.                +---------------------------------------------+
  274.  
  275.  
  276.  
  277.           There are a few things you should know before attempting
  278.           to boot 1-Edit for the first time:
  279.  
  280.  
  281.           Software Version
  282.           ----------------
  283.  
  284.           This version, 2.75, of 1-Edit is designed to work with
  285.           QuickBBS v2.75.  If you are, for some reason, still
  286.           running an older version of QuickBBS (2.64-2.66), please
  287.           use 1-Edit v1.01.
  288.  
  289.  
  290.           FOSSIL Driver
  291.           -------------
  292.  
  293.           1-Edit requires that a FOSSIL driver be installed and
  294.           active at all times.  This shouldn't prove to be much of a
  295.           hindrance since 1-Edit was designed for remote use -- and
  296.           QuickBBS also requires the FOSSIL be installed and active.
  297.           If you are editing strictly from the local console, you'll
  298.           probably find the new Menuedit and Useredit programs
  299.           (included in the QBBS275U archive) to be faster and
  300.           prettier to work with.  1-Edit has been tested under
  301.           several versions of both the X00 and BNU drivers; either
  302.           should work fine.  However, if you are using either as a
  303.           TSR (rather than as a standard "DEVICE="), you must make
  304.           sure that the FOSSIL isn't being removed from memory when
  305.           you shell or exit your BBS or mailer.
  306.  
  307.  
  308.           ANSI Graphics
  309.           -------------
  310.  
  311.           1-Edit requires all users of the program to have the
  312.           ANSI.SYS driver installed -- both on the BBS side and on
  313.           the remote side.  This shouldn't be much of a problem as I
  314.           figure 99.98% of all sysops do.  If you're unfamiliar with
  315.           ANSI.SYS and its installation, please refer to your DOS
  316.           manual.  ANSI.SYS is included with all versions of DOS.
  317.  
  318.           I've received a few messages from sysops who would prefer
  319.           that the program *not* use ANSI graphics as they do their
  320.           work from non-ANSI machines (like VT-220 terms on a VAX).
  321.           Someday I hope to take care of this problem, making ANSI
  322.           an option rather than a requirement.  I'm using ANSI not
  323.           so much for color as for cursor positioning and movement,
  324.           and I haven't quite figured a way around the use of ANSI.
  325.  
  326.  
  327.           1-Edit Documentation                             Page 4
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.           DORINFO1.DEF and LOCAL.DEF
  338.           --------------------------
  339.  
  340.           1-Edit requires a DORINFO1.DEF file to be present when
  341.           starting.  First, some background on this file, then info
  342.           on how to get around the necessity of having it available
  343.           to 1-Edit when using the program locally.
  344.  
  345.           Anytime QuickBBS calls a child program (a door) via a Type
  346.           7 or Type 15 exit, it creates two files: a DORINFO1.DEF
  347.           file and an EXITINFO.BBS.  Both contain information about
  348.           the user online at the time the door is started --
  349.           information like baud rate, com port, time remaining,
  350.           security level.  When you return to QuickBBS from the
  351.           shell, both of these files are deleted automatically --
  352.           which is why you can never find them on your disk after
  353.           running a door.
  354.  
  355.           1-Edit uses only the DORINFO1.DEF file to get information
  356.           about the user.  Because the file is required, and because
  357.           one won't always be available (such as when running 1-Edit
  358.           outside of QuickBBS), I've made the program search for a
  359.           second file called LOCAL.DEF.  LOCAL.DEF is nothing but a
  360.           copy of a DORINFO1.DEF which should stay in your QuickBBS
  361.           system directory (usually C:\QBBS\).  Just put it there
  362.           and leave it there, and 1-Edit will always know where to
  363.           find it when it's needed.
  364.  
  365.           A copy of a LOCAL.DEF file is included in the 1-Edit
  366.           archive.  You'll want to edit it to reflect your name and
  367.           system name.  Here's what one looks like with my comments
  368.           in braces { }:
  369.  
  370.           ---------------------------------------------------------
  371.           THE CREATIVE CONNECTION-SOUTHFIELD, MI-(313)559-9039
  372.           BOB                    {Sysop first name}
  373.           RANSOM                 {Sysop last name}
  374.           COM0                   {Don't edit this! COM0 = Local}
  375.           0 Baud,N,8,1           {No need to edit this}
  376.           0                      {This does nothing; just a zero}
  377.           BOB                    {User's first name}
  378.           RANSOM                 {User's last name}
  379.           SOUTHFIELD, MI         {No need to edit; not used}
  380.           1                      {Graphics mode; no need to edit]
  381.           32000                  {Security level}
  382.           235                    {Time remaining}
  383.           ---------------------------------------------------------
  384.  
  385.           Feel free to edit the LOCAL.DEF file to suit yourself.
  386.           However, the COM port setting MUST remain as COM0 to
  387.           indicate a local logon.  Changing the security level, time
  388.           remaining, etc., is up to you.  After editing, place the
  389.           file into your QuickBBS system directory and leave it
  390.           there.
  391.  
  392.  
  393.           1-Edit Documentation                             Page 5
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.           Locked COM Ports
  404.           ----------------
  405.  
  406.           Locked ports are supported automatically by 1-Edit.  No
  407.           need to use DORSPEED, SETSPEED, etc.  1-Edit has been
  408.           successfully tested at up to 38,400 baud.
  409.  
  410.  
  411.           Directories
  412.           -----------
  413.  
  414.           1-Edit may be run from whatever directory you choose
  415.           provided you have the environment QUICK set (i.e.
  416.           "SET QUICK=C:\QBBS\".  See your DOS manual for more
  417.           details on setting and using environment variables.)  If
  418.           you DON'T set the QUICK variable, you MUST run 1-Edit from
  419.           your main QuickBBS directory.
  420.  
  421.           When first started, 1-Edit looks for the above mentioned
  422.           environment variable.  If found, 1-Edit then looks there
  423.           for your configuration files.  If not found, 1-Edit
  424.           assumes that the config files are in the current working
  425.           directory.  QUICKCFG.DAT is then read to check the
  426.           location of your menu directory and USERS.BBS file.
  427.           Onscreen messages will tell you what's going on, which
  428.           path the program is choosing, etc.
  429.  
  430.  
  431.           Okay, so now you've unarchived the program and put it
  432.           somewhere on your harddrive, paying attention to the QUICK
  433.           variable (if set, 1-Edit can go anywhere; if not, 1-Edit
  434.           must be in your main QuickBBS directory).  You've also put
  435.           the LOCAL.DEF file into your main QuickBBS directory
  436.           (regardless of what QUICK is set to, LOCAL.DEF belongs in
  437.           the main directory.)  Now you're almost ready to get
  438.           started.
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.           1-Edit Documentation                             Page 6
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.                +---------------------------------------------+
  470.                |             COMMAND LINE SYNTAX             |
  471.                +---------------------------------------------+
  472.  
  473.  
  474.           1-Edit allows you to customize it somewhat via the command
  475.           line.  All of the following command line parameters are
  476.           optional (and case is unimportant):
  477.  
  478.           -Nxxxxxx   Tells 1-Edit to look in path xxxxxx for the
  479.                      DORINFO1.DEF, LOCAL.DEF, and QUICKCFG.DAT
  480.                      files.  Example: "-Nc:\qbbs\line1"  A trailing
  481.                      backslash is optional.
  482.  
  483.           -Uxxxxxx   Tells 1-Edit to look in path xxxxxx for the
  484.                      USERS.BBS file.  Example: "-Uc:\qbbs\users"
  485.                      A trailing backslash is optional.
  486.  
  487.           -Fxx       Sets foreground color to xx.  xx must be 0-7.
  488.                      Default color is cyan (#3).  Example: -F6
  489.  
  490.           -Hxx       Sets the highlight color to xx.  xx must be
  491.                      0-15.  Default highlight color is bright yellow
  492.                      (#14).  Example: -H12
  493.  
  494.           -Sxxxxx    Sets the minimum security level for accessing
  495.                      the Drop To DOS feature to xxxxx.  xxxxx must
  496.                      be 0-64000.  Default is 32000.  (More on this
  497.                      feature later.)  Example: -S100
  498.  
  499.           -J         Turns on security "jumping."  More on this
  500.                      later.
  501.  
  502.           ?          Brings up a short help screen outlining these
  503.                      command line parameters.
  504.  
  505.           None of these parameters are required; use any, all, or
  506.           none of them as you choose.  Several of these are
  507.           discussed in more detail later, so don't worry if you
  508.           don't yet understand their uses.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.           1-Edit Documentation                             Page 7
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.                +---------------------------------------------+
  536.                |                GETTING STARTED              |
  537.                +---------------------------------------------+
  538.  
  539.  
  540.           With that boring stuff out of the way, we'll get on to the
  541.           meat of the program.  I won't bother taking you through
  542.           each and every option of both editors -- most everything
  543.           is self-explanatory so I'll just touch on some things and
  544.           highlight the few oddities.  Any sysop that has gotten
  545.           QuickBBS up and running shouldn't have any problems.
  546.  
  547.  
  548.           Setting Up 1-Edit Within QuickBBS
  549.           ---------------------------------
  550.  
  551.           1-Edit works both as a Type 7 or a Type 15 door.  However,
  552.           there's no need that I can see to ever run it as a Type
  553.           15.  Even under very tight memory constraints, the Type 7
  554.           (used with QuickBBS's *M data line parameter) should work
  555.           fine.  By the way, the *M parameter causes QuickBBS to
  556.           swap itself to EMS or disk during the Type 7 shell,
  557.           leaving you with nearly all of your available DOS to run
  558.           1-Edit.
  559.  
  560.           Here's a sample of a Type 7 setup as it would look from
  561.           within the new Menuedit:
  562.  
  563.           ------(this screen has been edited to fit the page)----
  564.           ┌─────────────────────────────────────────────────────────
  565.           │                             Editing Entry #: 20
  566.           │         1         2         3         4         5
  567.           │123456789012345678901234567890123456789012345678901234567
  568.           │<^1^> ............ 1-Edit····························
  569.           │
  570.           │Optional Data:
  571.           │1edit.exe *M·································
  572.           │
  573.           │Menu Type....>7··
  574.           │Security.....>31000
  575.           │Key..........>1
  576.           │ForeGround...>3·
  577.           │BackGround...>0·
  578.           │A Flags......>--------
  579.           │B Flags......>--------
  580.           │C Flags......>--------
  581.           │D Flags......>--------
  582.           │
  583.           │                       [F1] to Finish and Save Changes
  584.           │                    [ESC] To Abort Changes To This Entry
  585.           │    [HOME]-Beginning of Line, [END]-End of Line, [INS]-T
  586.           │               [F2]-Center Display Line, [F10]-Menu Type
  587.           └────────String To Appear On Menu, ^String^ Makes String
  588.           ---------------------------------------------------------
  589.  
  590.  
  591.           1-Edit Documentation                             Page 8
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.           I think that gives you the basic idea of what it looks
  602.           like.  If you choose to use some of 1-Edit's command line
  603.           options, the above data line might read:
  604.  
  605.           Optional Data:
  606.           1edit.exe -Nc:\qbbs\line*N -Uc:\qbbs\users\ -F7 -H15 *M
  607.  
  608.           Note that the above uses both the QuickBBS *N and *M
  609.           parameters: *M to swap QuickBBS to EMS or disk; *N causes
  610.           QuickBBS to put the current node number in place of the
  611.           *N.  See your QuickBBS docs for more info on these and
  612.           other usable Type 7 parameters.
  613.  
  614.  
  615.           Actual Startup
  616.           --------------
  617.  
  618.           When you first crank up 1-Edit, it will check to see that
  619.           a FOSSIL is present.  If not, the program aborts.  From
  620.           there it begins its search for QUICKCFG.DAT and
  621.           DORINFO1.DEF, using LOCAL.DEF if necessary.  Some values
  622.           are initialized and you're told (on the local screen only)
  623.           where it's taking the files from.  Then an opening screen
  624.           pops up.  If the program is unregistered, the program will
  625.           ring the bell a few times, then pause for 4 seconds to
  626.           <ahem> encourage registration.  After the pause you'll be
  627.           prompted to "Press [ENTER] to continue:".  Press Enter and
  628.           you'll get the main menu.
  629.  
  630.           From the main menu you may choose to edit the user files,
  631.           menu files, or drop to DOS.  At this point, registered
  632.           versions of 1-Edit will show a status line on the local
  633.           console detailing who's online, baud and modem settings,
  634.           and time remaining.  Unregistered versions show only the
  635.           line "Unregistered Evaluation Copy".
  636.  
  637.           A quick side note:  Throughout most of the program,
  638.           pressing [ENTER] or entering a question mark ("?") will
  639.           redraw the screen.  This is really only useful in times of
  640.           high line noise but it's nice to have available when you
  641.           need it.
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.           1-Edit Documentation                             Page 9
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                +---------------------------------------------+
  668.                |                THE MENU EDITOR              |
  669.                +---------------------------------------------+
  670.  
  671.  
  672.           Those of you familiar with Adam Hudson's original Menuedit
  673.           program will feel right at home here.  When you first
  674.           choose the menu editor from the main menu, you'll be
  675.           presented with a list of the menus in your QuickBBS menu
  676.           directory.  After displaying all of the menus you'll have
  677.           the option of editing/adding a menu, renaming a menu,
  678.           copying a menu, deleting a menu, or relisting the files.
  679.  
  680.           There's no need to explain most of these functions.  One
  681.           thing you might like to know is that any rename, delete,
  682.           or copy operation can be stopped by pressing [ENTER] on a
  683.           blank input field.
  684.  
  685.           Choose the <E> option and you'll be prompted for the menu
  686.           name.  If the menu isn't found, you'll be asked if you
  687.           wish to create it.  If the menu exists, or if you do want
  688.           to create it, you'll be dropped into the actual menu
  689.           editor.  From here you can do a variety of things, all
  690.           very similar to the old Menuedit.
  691.  
  692.           Rather than beat a dead horse trying to detail each and
  693.           every function of this editor, you should just play with
  694.           the thing for a while.  Copy an existing menu to another
  695.           menu file called TEST or FRED or something.  Then hack
  696.           away on the copied menu.  You'll get the hang of it in no
  697.           time.
  698.  
  699.           Oh, something you should know: When editing a field in
  700.           either editor (menu or user), as soon as you punch [ENTER]
  701.           the new value, if it's not blank, is written to disk.  If
  702.           it *is* blank, nothing is written and you exit the
  703.           procedure.  The immediate write to disk is done so that,
  704.           should carrier drop unexpectedly, all of your changes are
  705.           already stored.
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.           1-Edit Documentation                             Page 10
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                +---------------------------------------------+
  734.                |                THE USER EDITOR              |
  735.                +---------------------------------------------+
  736.  
  737.  
  738.           Most all of this section should be pretty easy to figure
  739.           out.  Press the plus (+) key to move the next user, or the
  740.           minus (-) key to move to the previous user.  When moving
  741.           from user to user, if you hit the beginning or end of the
  742.           USERS.BBS file, the program will "wrap around" to the next
  743.           user.  Example: You come to the last user in the file, say
  744.           it's user #100, then press the plus key (+) one more time.
  745.           The program will "wrap around" back to user #0 (the first
  746.           user in the file).
  747.  
  748.           Pick and choose any fields you want to edit, press the
  749.           bracketed key <>, and you can edit away.  Should you start
  750.           to edit a field, then decide against it, just press
  751.           [ENTER] over a blank edit field and that field will remain
  752.           unchanged.
  753.  
  754.           At the bottom of the screen you'll see a small window with
  755.           choices to add a user, delete a user, find a user, etc.
  756.           <Q>uit takes you back to the main menu.  <O>ther clears
  757.           this small window and replaces it with a second window of
  758.           other editing options.  To return to the first set of
  759.           options, press <O> again.
  760.  
  761.  
  762.           Mass Updates
  763.           ------------
  764.  
  765.           With 1-Edit, you have the ability to do two types of mass
  766.           updating (changes made to every user in the file).  You
  767.           can do mass updates of a flag.  For example, you could
  768.           turn every user's B1 flag ON.
  769.  
  770.           You may also mass update everyone's "High Message Read"
  771.           number.  This is something you won't need often, if ever,
  772.           but it's handy to have.  The usual reason for changing
  773.           everyone's High Message Read is after blowing up your
  774.           message base through some botched operation, leaving you
  775.           with no choice but to delete all the message files and
  776.           start over again.
  777.  
  778.  
  779.           Security "Jumping" (aka "the -J parameter")
  780.           -------------------------------------------
  781.  
  782.           By default, any user that has access to 1-Edit can edit
  783.           *any* user record.  (See below about editing your own
  784.           record.)  For some sysops, those with remote cosysops,
  785.           this can sometimes cause a problem.  You may wish to allow
  786.           a user to edit *some* user records, but not all.  That's
  787.  
  788.  
  789.           1-Edit Documentation                             Page 11
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.           what the "-J" does.  Add it to your 1-Edit command line
  800.           and the program will conveniently skip any record in the
  801.           USERS.BBS where the security level is greater than the
  802.           user's own security level.  For example, say your remote
  803.           sysop has a security level of 100.  With the "-J" on the
  804.           command line, 1-Edit won't let him/her even see, much less
  805.           edit, records where the security level is 101 or greater.
  806.  
  807.  
  808.           Editing Your Own User Record
  809.           ----------------------------
  810.  
  811.           To put it simply, you can't do it.  I hear about this
  812.           "bug" all the time.  People tell me how they went in and
  813.           changed several fields in their own record, only to exit
  814.           1-Edit and QuickBBS and find that the changes mysteriously
  815.           disappeared.  The reason is pretty simple and goes all the
  816.           way back to the very first versions of QuickBBS.
  817.  
  818.           Here's what happens:  When a user logs onto QuickBBS, his
  819.           or her user record is read into memory.  Any changes that
  820.           QuickBBS would make to that record are held in memory (but
  821.           not written to disk) until the user logs off.  At logoff,
  822.           the user's record is completely rewritten by QuickBBS with
  823.           the new data.  If, during the user's online session, the
  824.           user changes his/her own record, those changes are written
  825.           to disk by 1-Edit -- but those changes are completely
  826.           overwritten again by QuickBBS at logoff.
  827.  
  828.           The simplest way around this is to logon using another
  829.           name (maybe create a user account called "Test User" or
  830.           somesuch), edit your "real" user record, then log off.  Or
  831.           wait to make changes to your record until you can do so by
  832.           running a user editor directly from DOS.
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.           1-Edit Documentation                             Page 12
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                +---------------------------------------------+
  866.                |              DROP TO DOS FEATURE            |
  867.                +---------------------------------------------+
  868.  
  869.  
  870.           Please read this section carefully!
  871.  
  872.           Dropping to DOS through 1-Edit can be handy at times but
  873.           can also lock your computer up if you don't pay attention
  874.           to what you're doing.
  875.  
  876.           Before attempting to use this feature, double check that
  877.           the DOS environment variable COMSPEC is set properly.  To
  878.           check this, type SET at a DOS prompt.  Your environment
  879.           will be displayed for you.  You should see "COMSPEC=" and
  880.           the drive/path to your COMMAND.COM file.  If this *isn't*
  881.           set properly, please consult your DOS manual.
  882.  
  883.           When displaying the main menu, 1-Edit checks the user's
  884.           security level (as set in DORINFO1.DEF) against the
  885.           security level set on the command line (or the default
  886.           value, 32000).  If the user's level equals or exceeds that
  887.           level, the Drop to DOS function appears on the main menu.
  888.           If the user's level is *less* than the specified level,
  889.           the option doesn't appear and won't function.  This allows
  890.           you to have cosysops helping you edit your user and menu
  891.           records without actually allowing them to enter DOS.
  892.  
  893.           Drop to DOS works two different ways, depending on whether
  894.           you're using the program locally or remotely.
  895.  
  896.  
  897.           Local Drop to DOS
  898.           -----------------
  899.  
  900.           When in local mode, the Drop to DOS is just a very simple
  901.           shell.  You hit "D" and you get the familiar flashing
  902.           cursor.  (What actually happens is a second copy of
  903.           COMMAND.COM is loaded.)  You may run whatever you need to
  904.           run from here.  When you're ready to return to 1-Edit,
  905.           just type EXIT and press [ENTER].
  906.  
  907.  
  908.           Remote Drop to DOS
  909.           ------------------
  910.  
  911.           Things get a little more complicated when dropping to DOS
  912.           remotely.  First, when you do drop to DOS, 1-Edit goes on
  913.           hold.  It no longer monitors carrier, it doesn't feed
  914.           screen displays to the modem or read incoming data from
  915.           the modem, nor does the user inactivity timeout function
  916.           work.  This is exactly the same as when you shell out from
  917.           QuickBBS via a Type 7 or 15 menu option -- all BBS
  918.           functions stop cold.  Whatever you run here *must* be able
  919.  
  920.  
  921.           1-Edit Documentation                             Page 13
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.           to send info through the modem, read incoming data from
  932.           the modem, and check carrier.  QuickBBS won't do it for
  933.           you after executing a Type 7 or 15 menu option, and 1-Edit
  934.           won't do it for you when you <D>rop to DOS.
  935.  
  936.           When you do execute the Drop to DOS remotely, you'll be
  937.           prompted for a filename to execute.  Leave this field
  938.           blank and you'll be returned to 1-Edit.  If you do execute
  939.           a program or batch file, you MUST INCLUDE THE FILE
  940.           EXTENSION WITH THE FILENAME (i.e. ".EXE", ".COM", ".BAT").
  941.           You may also include as many command line parameters as
  942.           will fit into the field.  The parameters will be passed on
  943.           to the child program.  When you exit the child program,
  944.           you'll be returned to 1-Edit automatically.
  945.  
  946.           A sample batch file called DOSSHELL.BAT is included in the
  947.           1-Edit archive for you to look over.  It details how you
  948.           can set up a true "drop to DOS" from 1-Edit using CTTY.COM
  949.           or Gateway.  THIS IS NOT MEANT TO BE A READY-TO-RUN BATCH
  950.           FILE!  Use it only as a guide.  If you do decide to try it
  951.           out, be sure to pass your baud rate to DOSSHELL.BAT on the
  952.           command line as:  DOSSHELL.BAT 2400  (or whatever baud
  953.           rate you're using.)  You should read and test this batch
  954.           file carefully before relying on it!!!  I can't stress
  955.           that enough.  Also, you should add to it some sort of
  956.           carrier detect TSR, like WATCHCD, before using it.
  957.           WATCHCD (and the related BOOT.COM) are available in all
  958.           versions of the X00 FOSSIL driver.
  959.  
  960.           Better yet, get a copy of DOORWAY, a great program that
  961.           lets you run nearly anything as a door with complete
  962.           carrier detection.  It's shareware and registration is
  963.           pretty cheap.
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.           1-Edit Documentation                             Page 14
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.                +---------------------------------------------+
  998.                |      USING 1-Edit ON MULTI-NODE SETUPS      |
  999.                +---------------------------------------------+
  1000.  
  1001.  
  1002.           Typically when running a multi-node QuickBBS set up, you
  1003.           will have your directories set similar to this:
  1004.  
  1005.           C:\QBBS\        =  Main System Directory.  Your QUICK
  1006.                              environment variable points here.
  1007.  
  1008.           C:\QBBS\NODEx\  =  Separate directories for each node that
  1009.                              you run, where "x" equals the node
  1010.                              number.
  1011.  
  1012.           Your actual directory names may be different though many
  1013.           people seem to follow this example as outlined in the
  1014.           QuickBBS docs.
  1015.  
  1016.           Under single node setups, your config files (QUICKCFG.DAT
  1017.           et al) live in the System directory.  This is also where
  1018.           QuickBBS puts the DORINFO1.DEF file when executing a Type
  1019.           7 or Type 15 menu option.  Under multi-node setups, the
  1020.           config files live in each line directory, and the
  1021.           DORINFO1.DEF is placed in the proper line directory, too.
  1022.           Under these situations, you'll need the following
  1023.           parameters to help 1-Edit figure out what is going on and
  1024.           where to look for files:
  1025.  
  1026.           The -N Parameter
  1027.           ----------------
  1028.  
  1029.           When 1-Edit detects the -N parameter on the command line,
  1030.           it will search the directory specified after the -N for
  1031.           both the DORINFO1.DEF file and the QUICKCFG.DAT file.  If
  1032.           the files are found, they will be used.  If either file is
  1033.           not found in the specified directory, 1-Edit will fall
  1034.           back and attempt to locate the files in the main System
  1035.           directory.
  1036.  
  1037.           In the case of the QUICKCFG.DAT file being missing from
  1038.           both the specified -N parameter directory *and* from the
  1039.           System directory (pretty much impossible if your system
  1040.           actually  works), the program will abort.
  1041.  
  1042.           If the DORINFO1.DEF file isn't found in the -N specified
  1043.           directory nor in the System directory, 1-Edit will search
  1044.           the System directory for the LOCAL.DEF file.  There's no
  1045.           need to put a copy of LOCAL.DEF into each line directory;
  1046.           one copy in the System directory is all that's needed.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.           1-Edit Documentation                             Page 15
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.           Here's an example of the -N parameter in use:
  1064.  
  1065.           1EDIT.EXE -Nc:\qbbs\node1
  1066.  
  1067.                   - or -
  1068.  
  1069.           1EDIT.EXE -Nc:\qbbs\node*N
  1070.  
  1071.           A trailing backslash is optional.  Note the "*N" in the
  1072.           second example.  This utilizes a feature of QuickBBS
  1073.           (mentioned earlier) where QuickBBS will substitute the
  1074.           node number for the "*N" when executing a Type 7 or Type
  1075.           15 shell.
  1076.  
  1077.  
  1078.           The -U Parameter
  1079.           ----------------
  1080.  
  1081.           This tells 1-Edit to get the USERS.BBS from the directory
  1082.           specified after the -U.  Example:
  1083.  
  1084.           1EDIT.EXE -Uc:\qbbs\users\
  1085.  
  1086.           As before, a trailing backslash is optional.
  1087.  
  1088.           This is probably not going to be the most used parameter
  1089.           as most folks maintain only a single user file.  But just
  1090.           in case, it's here...
  1091.  
  1092.           One thing to note about this parameter's use:  If 1-Edit
  1093.           can't find the USERS.BBS file in the specified directory,
  1094.           the program won't search elsewhere for it.  It will simply
  1095.           abort with an error code.
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.           1-Edit Documentation                             Page 16
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.                +---------------------------------------------+
  1130.                |             REGISTERING 1-EDIT              |
  1131.                +---------------------------------------------+
  1132.  
  1133.  
  1134.           Keys
  1135.           ----
  1136.  
  1137.           1-Edit uses a "keyed" registration system similar to that
  1138.           used by QuickBBS.  The information contained in your
  1139.           QUICKCFG.DAT file under Sysop Name and BBS Name are used
  1140.           to create your key.  Unregistered versions of the program
  1141.           (programs running without the key) ring the bell and have
  1142.           a 4 second pause built into the beginning of the program.
  1143.           Also, the status line is disabled.  Registered versions of
  1144.           the program kill the beeping and 4 second pause and enable
  1145.           the status line.  Registered versions also show the sysop
  1146.           name and system name on the title screen when 1-Edit is
  1147.           started.  These are the ONLY differences between
  1148.           registered and unregistered.  There are no built-in
  1149.           self-destruct mechanisms or anything like that.
  1150.  
  1151.  
  1152.           When you register 1-Edit, you will receive a small key
  1153.           file that will disable the ringing and pause, and enable
  1154.           the status line.  If you're a member of Fidonet, your key
  1155.           file will be delivered by netmail file attach.  If you're
  1156.           not in Fidonet, your key will be delivered on disk by
  1157.           regular mail.  I've found Fidonet delivery to be faster,
  1158.           cheaper, and easier, regardless of where you are in the
  1159.           world, so I attempt to use that method whenever possible.
  1160.  
  1161.  
  1162.           Installing Keys
  1163.           ---------------
  1164.  
  1165.           When you receive your keyfile, it may come to you named
  1166.           something like LASTNAME.KEY (where LASTNAME is your
  1167.           lastname).  If so, please rename it to 1EDIT.KEY, and
  1168.           place it into your main QuickBBS System directory.  Be
  1169.           very careful with the filename of this key:  It must be
  1170.           called 1EDIT.KEY (and NOT 1-EDIT.KEY).
  1171.  
  1172.           Leave this key in place for as long as you use 1-Edit.  It
  1173.           will be good for all future versions of the program.  Or,
  1174.           if for some reason I change the key encryption in a future
  1175.           version, I'll send you a new key before releasing the new
  1176.           version.
  1177.  
  1178.           F.Y.I.:  There's no difference between the keys for the
  1179.           QuickBBS version of this program and the RemoteAccess
  1180.           version (1-Edit-RA) except the filename.  If you are
  1181.           switching to QuickBBS from RA and have a valid key for
  1182.           1-Edit-RA, just rename the key to 1EDIT.KEY.
  1183.  
  1184.  
  1185.           1-Edit Documentation                             Page 17
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.           Registering
  1196.           -----------
  1197.  
  1198.           A form is included in the program archive.  Please
  1199.           complete the form and mail it along with your check or
  1200.           money order for $10.00 (U.S. funds only) to the address on
  1201.           the form.  Your key will be sent to you within a few days
  1202.           of receipt.
  1203.  
  1204.           Please be VERY careful when completing the registration
  1205.           form that your Sysop Name and BBS Name are EXACTLY as they
  1206.           appear in your QuickBBS configuration.
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.           1-Edit Documentation                             Page 18
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.                +---------------------------------------------+
  1262.                |                    THE END                  |
  1263.                +---------------------------------------------+
  1264.  
  1265.  
  1266.           Okay, I guess that covers it.  Hopefully this file is
  1267.           complete enough that you can figure out how to use the
  1268.           program.  Should you encounter a problem of some sort or
  1269.           an unfound bug, please be sure to let me know.
  1270.           Suggestions for enhancements are always welcome, to.
  1271.  
  1272.           You can contact me via the QuickBBS Support echo, the
  1273.           QuickPRO echo, by netmail, or by regular mail.
  1274.  
  1275.           The current version of this program will always be
  1276.           available for file request or first call download.  File
  1277.           request the magic name: 1EDIT
  1278.  
  1279.           -Bob Ransom
  1280.            27840 Lathrup Blvd.
  1281.            Lathrup Village, Michigan  48076
  1282.            U.S.A.
  1283.  
  1284.            The Creative Connection BBS
  1285.            24 hours / 7 days
  1286.            300-1200-2400 baud / 8-N-1
  1287.            (313) 559-9039
  1288.            Fidonet 1:120/96
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.           1-Edit Documentation                             Page 19
  1318.  
  1319.  
  1320.  
  1321.