home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / lwuser10.zip / LWUSER.DOC < prev    next >
Text File  |  1993-06-28  |  18KB  |  458 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.       ║      ║       ╔══╗  ╔╗   ║ ╔════╗   ║    ║  ╔══╗  ╔════╗ ╔═════
  24.       ║      ║      ╔╝  ╚╗ ║║   ║ ║    ║   ║    ║ ╔╝  ╚╗ ║    ║ ║
  25.       ║      ║      ║    ║ ║╚╗  ║ ║    ║   ║    ║ ║    ║ ║    ║ ║
  26.       ║      ║      ╠════╣ ║ ╚╗ ║ ║    ║   ║ ╔╗ ║ ╠════╣ ╠═╦══╝ ╠═══
  27.       ║      ║      ║    ║ ║  ╚╗║ ║    ║   ║╔╝╚╗║ ║    ║ ║ ╚╗   ║
  28.       ╚═════ ╚═════ ║    ║ ║   ╚╝ ╚════╝   ╚╝  ╚╝ ║    ║ ║  ╚═╗ ╚═════
  29.  
  30.                                    Presents
  31.  
  32.              ║    ║    ║      ║  ║ ╔═══ ╔═══ ╔═══╗
  33.              ║    ║ ╔╗ ║ ───  ║  ║ ║    ║    ║   ║
  34.              ║    ║╔╝╚╗║      ║  ║ ╚══╗ ╠══  ╠═╦═╝    VERSION 1.0
  35.              ╚═══ ╚╝  ╚╝      ╚══╝ ═══╝ ╚═══ ║ ╚═╗
  36.  
  37.  
  38.                     Copyright 1992,1993 by Bob DaCastello
  39.  
  40.  
  41.              The BEST REMOTE USER EDITOR for Remote Access 2.x !!
  42.                  ^^^^
  43.  
  44.  
  45.                                ╔══════════════╗
  46.                                ║ INTRODUCTION ║
  47.                                ╚══════════════╝
  48.  
  49.    Ok, since the release of RemoteAccess 2.00g1 everyone has been crying
  50.    for a remote user editor, so.........HERE IT IS!  Llanoware also offers
  51.    a REMOTE MENU EDITOR!! Check the end of these docs under Distribution
  52.    and Beta Sites.
  53.  
  54.    ALL ITEMS MARKED WITH A {+} ARE FEATURES/OPTIONS ENABLED BY REGISTERING.
  55.    PLEASE SUPPORT YOUR SHAREWARE AUTHORS AND REGISTER THEIR WAREZ!!
  56.  
  57.  
  58.                                  ╔══════════╗
  59.                                  ║ FEATURES ║
  60.                                  ╚══════════╝
  61.  
  62.  * Allows you to edit ANY/ALL aspect of a user's profile by remote, even
  63.    to change their password.
  64.  
  65.  * Allows you to add or delete users by Remote (deletion is by marking
  66.    the user for deletion ... the account must be deleted by RAUSER, and
  67.    you HAVE read the RA User Manual, RIGHT? <grin>
  68.  
  69.  * When Inserting a new user, most defaults are taken from your RA New User
  70.    configuration in RACONFIG > SYSTEM > NEW USERS
  71.  
  72.  * Extremely powerful search system to find specific users, string
  73.    search by name or handle.
  74.  
  75.  * {+} String search by security level, birthday, address, phone number,
  76.    or comment field.
  77.  
  78.  * Supports an unlimited number of nodes via a small CTL file to be
  79.    kept with the EXE file, or multiple configurations by placing CTL
  80.    files in the node directories.
  81.  
  82.  * Supports locked communications ports
  83.  
  84.  * Completely Multi-Node aware, successfully tested under DOS 3.3, DOS 5.0,
  85.    DOS 6.0, Lantastic, Novell, DesqView/QEMM on machines ranging from
  86.    XT's to 486's.
  87.  
  88.  * {+} IN ADDITION to the user's "Comment" field, LWUSER allows you to keep
  89.    an "LWCOMMENT", an unlimited size comment for each user (unlimited number
  90.    of 80 character lines) accessible through LWUser.
  91.  
  92.  * Ability to force USA style phone numbers and inserts the ( ) around
  93.    the area code and separates the prefix and suffix with a "-"
  94.    automatically when adding or editing a phone number. ie: (805)264-0443
  95.  
  96.  * Only requires about 140k so swapping usually isn't necessary.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                                       1
  106.  
  107.  
  108.                                ╔═════════════╗
  109.                                ║ LEGAL STUFF ║
  110.                                ╚═════════════╝
  111.  
  112.   As with any new utility, especially one that alters user bases or message
  113.   bases, you should ALWAYS MAKE A BACK UP of your files before playing with
  114.   the new utility.
  115.  
  116.   WARRANTY:
  117.   Yea right! There's ain't none. You download it at your own risk,
  118.   you install it at your own risk, and you use it at your own risk ...
  119.   simple enough? In the event the use of this program, at any time, causes
  120.   damage, corruption, or loss of data, what you'll get from me is a big
  121.   "Didn't you do a backup first?". In the event the use of this program, at
  122.   any time, causes a hardware failure, hard drive crash, or otherwise causes
  123.   your system to explode into 5,000 pieces, the scope of my guarantee to you
  124.   is that you may keep whatever pieces you can find ... and if you ask me
  125.   real nice, I'll tell you where you can go to buy superglue.
  126.  
  127.   In legal mumbo jumbo, the bottom line is: The author shall not be
  128.   responsible for direct, indirect, incidental, or consequential damages
  129.   resulting from any bug, defect, error, or failure to perform.
  130.  
  131.  
  132.  
  133.                                ╔══════════════╗
  134.                                ║ REQUIREMENTS ║
  135.                                ╚══════════════╝
  136.  
  137.  * RemoteAccess 2.00 of course!  LWUSER will NOT work on versions of
  138.    RA prior to RA 2.00g1.
  139.  
  140.  * Any IBM Compatible with DOS 3.1 or better should work just fine. Color
  141.    monitor preferred but not required.
  142.  
  143.  * Fossil driver such as BNU or X00 is also highly recommended (Since RA
  144.    requires a fossil driver, this SHOULD be taken care of, RIGHT?!)
  145.  
  146.  * An ANSI driver MUST be installed in the calling system for proper
  147.    operation of the door by remote.
  148.  
  149.  
  150.  The Distribution Archive:
  151.  
  152.    LWUSER.EXE   - Main program
  153.    LWUSER.DOC   - Your readin' it!
  154.    LWUSER.CTL   - Sample Control file ... Edit as needed
  155.    LW_REG.FRM   - Registration form for ALL LlanoWare Doors
  156.    FILE_ID.DIZ  - Well, you need to know what the file is, right?
  157.    LWUWHATS.NEW - Release/Changes history
  158.  
  159.  
  160. {+} FROM THE FIRST TIME you run LWUSER registered, two small files will
  161.     be created in the Userbase directory. These are LWUSER.DAT (The
  162.     LWComments) and LWUSER.IDX (The LWComment Index Files). Don't worry
  163.     about them, they mind their own business, they are housebroken, and
  164.     they don't make any noises late at night. Don't delete them unless you
  165.     want to delete ALL LWComments you have entered.
  166.  
  167.  
  168.                                       2
  169.  
  170.  
  171.                                ╔══════════════╗
  172.                                ║ INSTALLATION ║
  173.                                ╚══════════════╝
  174.    Upgrading from v0.9: Copy ALL the new files over the old ones and redit 
  175.    the CTL file.
  176.  
  177.    Installation is fairly easy and straight-forward. The following steps and
  178.    examples should have you up and running in a very short period of time.
  179.    It is assumed that you are familiar with setting up DOORS on your system;
  180.  
  181.          1) Edit the LWUSER.CTL file to reflect your name, your BBS name,
  182.             your registration numbers (if registered) ... for more
  183.             information regarding the CTL file, see the instructions
  184.             contained inside of the sample CTL file.
  185.          2) Place a copy of LWUSER.EXE wherever you wish. For multiple
  186.             configurations, place a copy of the .CTL file in each node
  187.             directory, otherwise it is best to reside in the same
  188.             directory with LWUSER.EXE.
  189.  
  190.    Install LWUSER as a type 7 exit with an optional data line of:
  191.  
  192.    C:\PATH\LWUSER.EXE
  193.  
  194.    Insert the correct pathname to find LWUSER. Memory swapping with the *M
  195.    should not be needed unless you are running RA in an environment that
  196.    has less than 460k available. No other optional data is required.
  197.  
  198.  
  199.                                 ╔═══════════╗
  200.                                 ║ OPERATION ║
  201.                                 ╚═══════════╝
  202.  
  203.   LWUSER REQUIRES THAT THERE IS AN ANSI DRIVER PRESENT IN THE REMOTE SYSTEM
  204.   ALTHOUGH ONE IS NOT REQUIRED ON THE HOST (BBS) SYSTEM FOR THE DOOR TO RUN.
  205.  
  206.    LWUSER may also be run locally with one of two command line parameters:
  207.  
  208.    /L - prompts you for a name to "login" to the door with
  209.    /S - quick sysop login ... takes sysop name out of the CTL file
  210.  
  211.    USING THE DOOR:
  212.    After the initial screen, your user list will appear on the screen with
  213.    a string of commands available at the bottom of the screen. Here is a
  214.    quick rundown of those commands:
  215.  
  216.    N)ext        - Takes you to the next screen of users down the list
  217.    P)revious    - Takes you to the previous screen of users up the list
  218.    F)irst       - Takes you to the top screen of users starting with record 0
  219.    L)ast        - Takes you to the lowest screen of users ending with the last
  220.                   user in the user-base.
  221.    I)nsertNew   - Insert a new user in the user base. This will assign the
  222.                   next available user number available at the bottom of your
  223.                   list. If you change your mind, the blank profile will not
  224.                   let you exit without at least something entered in the Name
  225.                   field ... you don't have to save the changes.
  226.    G)oto        - Prompts you for a user to jump to on the list (not edit)
  227.    E)ditUser    - Prompts you for the number of a user profile to edit
  228.  
  229.  
  230.                                       3
  231.  
  232.  
  233.  
  234.    S)earch      - Brings up the sub-command line for searching the user base
  235.  
  236.    A NOTE ON SEARCHING: Searching is an extremely powerful and useful
  237.    feature of LWUSER provided it is used properly.
  238.  
  239.    Here is a quick rundown of the S)earch sub-commands:
  240.  
  241.       N)ame     - Enter full name or a search string. LWUSER will display a
  242.                   running count of how many users in the userbase it has
  243.                   checked and will display all users who had a match in the
  244.                   Name Field to your search string.
  245.  
  246.       H)andle   - Same as Name above but searches the Handle field
  247.  
  248.   {+}A)ddress   - Searches all 3 lines of the address field for the specified
  249.                   text or numeric search string
  250.  
  251.   {+}S)ecurity  - Searches the Security Level field for users matching
  252.                   the specified security level. This spec will not accept
  253.                   a search string....only a valid security level.
  254.  
  255.   {+}P)hone     - Searches both Data and Voice phone number fields for the
  256.                   specified numeric string, similar to the birthdate search.
  257.  
  258.   {+}C)omment   - Searches the RA Comment field for the specified text
  259.                   or numeric string
  260.  
  261.   {+}B)irthdate - Enter a full date or any numeric search string. Runs
  262.                   the search the same as name and handle searches.
  263.                   For instance, if you choose to search with a string
  264.                   of 67, it would show you users with: 05-15-67 as well
  265.                   as users with 05-16-78.                   ^^
  266.                                      ^ ^
  267.  
  268.    Whenever searching for specific user(s), the prompt accepts search
  269.    strings, NOT wildcards. If you are searching the name field for
  270.    all users named Mark...you would just put "Mark" (without the quotes)
  271.    in the string search, not "Mark*.*" or "Mark?" The same goes for ALL
  272.    fields that accept strings to match. Do not enter punctuation in the
  273.    search strings unless, for instance, you are searching the address
  274.    fields for commas. You get the idea. I'm sure most of you know the
  275.    difference between Search Strings and Wildcards, but this was for
  276.    those than don't <grin>.
  277.  
  278.    Once you are in a specific users profile, the prompts should take you
  279.    through everything you need. It is beyond the scope of this document
  280.    to explain how to edit your user profiles. Please refer to your RA
  281.    SysOp Manual.
  282.  
  283.    IMPORTANT: When you are in a specific user's profile to make changes,
  284.    make sure to pay attention that ALL alphabetical commands have an UPPER
  285.    CASE command and a LOWER CASE command ... Case DOES matter, so pay
  286.    attention when you want to change the field identified with "A" that you
  287.    don't hit "a" or you may end up changing a field you didn't want to.
  288.  
  289.    LWUSER WILL ALWAYS ASK YOU IF YOU WANT TO SAVE THE CHANGES YOU MADE WHEN
  290.    YOU FINISH EDITING A USER. NO CHANGES ARE SAVED MADE UNLESS YOU PRESS "Y".
  291.  
  292.  
  293.                                       4
  294.  
  295.  
  296.  
  297.                                ╔══════════════╗
  298.                                ║ LOCKED PORTS ║
  299.                                ╚══════════════╝
  300.  
  301.    LWUSER should not require any special attention for locked ports,
  302.    however if you run into a problem such as getting nothing but junk
  303.    characters when you load the door, you can un-comment the LOCKED
  304.    variable in the CTL file(s) and change the number to your locked rate,
  305.    or you can add a /B to the optional data field of the menu entry like
  306.    this:
  307.  
  308.    C:\PATH\LWUSER.EXE /B38400 or whatever your locked speed is.
  309.    (DON'T PUT A *B ... The /B is to identify locked rate, not current baud)
  310.  
  311.    If you run multi-node and have different ports locked at different
  312.    speeds, you will need to maintain separate .CTL files in the node
  313.    directories reflecting the locked speed of each node's port. LWUser
  314.    checks the current directory first for the CTL file.
  315.  
  316.  
  317.                                ╔══════════════╗
  318.                                ║ REGISTRATION ║
  319.                                ╚══════════════╝
  320.  
  321.    BENEFITS: First and foremost, knowing that you have supported the author
  322.    so he can continue his work!  Besides that, the nagging "Unregistered"
  323.    message goes away and enables registered features such as LWCOMMENT
  324.    and all items in this document marked with a {+}.
  325.  
  326.    HOW: For a $10.00 donation sent to the address below, you will be given
  327.    a registration number personalized just for you! If you have a valid
  328.    FIDONET address, the registration number will be sent to you directly.
  329.    Otherwise, the registration number will be sent to you via snailmail
  330.    (US Postal service). All registrations will be sent out within
  331.    3 days of receipt. See LW_REG.FRM for more info.
  332.  
  333.                 Make checks payable to and send donations to:
  334.  
  335.                                 Bob DaCastello
  336.                                 P.O. Box 53
  337.                                 Llano, CA  93544-0053
  338.  
  339.          Your comments/suggestions are welcomed and encouraged!!!!
  340.  
  341.   If you have ANY problems, remarks, suggestions, PLEASE contact me via
  342.   netmail ASAP at 1:102/1313, or log into my BBS at (805)264-0443.
  343.                    (fidonet)
  344.  
  345.                                ╔══════════════╗
  346.                                ║ DISTRIBUTION ║
  347.                                ╚══════════════╝
  348.  
  349.   You may make this file available for downloading from your BBS or you may
  350.   upload it to any BBS of your choice, provided that you do not make any
  351.   changes to the contents of the archive. The archive and its individual
  352.   contents may not be distributed used by any service that charges any
  353.   money whatsoever, without the written permission of the author.
  354.  
  355.  
  356.                                       5
  357.  
  358.  
  359.  
  360.                              ╔══════════════════╗
  361.                              ║ ACKNOWLEDGEMENTS ║
  362.                              ╚══════════════════╝
  363.   Big Thanks to:
  364.  
  365.   Mark Mistretta for beta testing and all his input into making LWUSER
  366.   what it is, and for writing these docs! (I hate doc-writing)
  367.  
  368.   Pam Smith of Window in Time BBS for her assistance.
  369.  
  370.   Thanks to Mike Janke (author of RACE user editor) for his TP assistance!
  371.  
  372.   Scott Baker for writing DoorDriver 5.0!
  373.  
  374.   Andrew Milner and all the great RA support Teams for a great BBS program!!
  375.  
  376.   All of the sysops who reported bugs and operational problems in the
  377.   previous releases, thereby helping me make this GREAT release!
  378.  
  379.  
  380.                            ╔════════════════════╗
  381.                            ║ DISTRIBUTION SITES ║
  382.                            ╚════════════════════╝
  383.  
  384.                            Author's BBS - Llano, CA
  385.                            Bob DaCastello (That's Me!)
  386.                            805-264-0443 (14.4k HST)
  387.                            FIDONET: 1:102/1313
  388.  
  389.                            Off Roaders BBS - Palmdale, CA
  390.                            Mark Mistretta
  391.                            805-272-9792 (16.8k Dual Standard)
  392.                            805-272-9793 (14.4 HST)
  393.                            805-272-9795 (14.4 v.32bis)
  394.                            805-273-9796 (9600 v.32)
  395.                            FIDONET: 1:102/1314
  396.                                     1:102/1315
  397.  
  398.                            Window In Time - Phoeniz, AZ
  399.                            Pam Smith
  400.                            602-253-1946 (9600 v.32)
  401.                            602-253-7069 (2400)
  402.                            602-253-7169 (2400)
  403.                            FIDONET: 1:114/203
  404.  
  405.                            Tumbleweed BBS - Lancaster, CA
  406.                            Bruce & Cheryl Bergstrom
  407.                            805-946-3332 (16.8k Dual Standard)
  408.                            FIDONET: 1:102/1308
  409.  
  410.     The latest versions of LWUSER and LWMENU should always be available
  411.     for download from one of the above systems.
  412.  
  413.         Freq Magic Name LWMENU - for the Remote Menu Editor
  414.         Freq Magic Name LWUSER - for the Remote User Editor
  415.         Freq Magic Name LWEDIT - for both of em!
  416.  
  417.                                       6
  418.  
  419.  
  420.  
  421.     They are also being sent out through various distribution networks
  422.     and should be available at The TruckStop BBS, Pacific Coast Micro,
  423.     RA-USA and many other RA Support Sites.
  424.  
  425.  
  426.                              ╔══════════════════╗
  427.                              ║ TROUBLE SHOOTING ║
  428.                              ╚══════════════════╝
  429.  
  430.     I have tried to encorporate as much error checking as possible into
  431.     this version, most errors should show you what/where the problem may be.
  432.  
  433.     Error 102 or 100 usually indicates a file/directory is not found.  Most
  434.     of these should be caught by LWUSER.
  435.  
  436.     If you are using locked com ports and are experiencing garbage at the
  437.     remote end, the first thing should be to insure that your fossil driver
  438.     is locked at the same speed as RA.
  439.     Sample X00.SYS command line:
  440.     DEVICE=c:\X00.SYS E 1 b,0,38400
  441.                             ^note that a "0" here indicates com 1
  442.  
  443.     LWUSER looks in the current directory FIRST for the needed CONFIG.RA
  444.     and LWUSER.CTL files it needs, if not found it then looks where the
  445.     LWUSER.EXE file is kept for the LWUSER.CTL file and checks the RA
  446.     environment as defined in your autoexec.bat with SET RA=c:\ra for
  447.     the CONFIG.RA file.
  448.  
  449.  
  450.     If you expierence any problems, PLEASE contact me ASAP, I am always
  451.     glad to help and will respond ASAP!
  452.  
  453.  
  454.  
  455.  
  456.                                       7
  457.  
  458.