home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / nsav_v11.lha / nsav.doc < prev    next >
Text File  |  1993-06-27  |  14KB  |  332 lines
  1. *     *   *****  ***** *   * |                      
  2. **    *  *       *   * *   * |  By                 (v1.1)              |
  3. * *   *  *       *   * *   * |      / 
  4. *  *  *   ****   ***** *   * |     < rispy    /
  5. *   * *       *  *   *  * *  |      \        < oftware
  6. *    **       *  *   *  * *  |                >
  7. *     *  *****   *   *   *   |               /  
  8. Network  SysOp AutoValidation|  CS ID: DLG03
  9.  
  10. Introduction
  11. ============
  12.  
  13.   As most of you out there in DLG land probably realize by now, is
  14. that CS used to run a WWIV BBS.  One of the neat things that one of
  15. the well-known mod writers* wrote up was something called sysop
  16. autovalidation.  In general, when a visiting sysop logged in, they
  17. would get validated immediately, or at least their level changed in
  18. such a way that they would have access to the sysop files.  As WWIV
  19. grew in strength, so did the ability to reliably autovalidate
  20. people--through their network node number.  CrispySoft now presents
  21. our DLG interpretation of such a modifcation.  While there is still a
  22. lot we want to do with it, NSAV does provide the basics that such a
  23. program should possess.
  24.  
  25.   In our version, a user is presented with a menu where they can select
  26. their status from options you have configured, including Non-SysOp,
  27. SysOp/Non-Network, SysOp/Networked.  If the user chose Non-SysOp, the
  28. program exits.  If the user chose SysOp/Non-Network, the user is asked
  29. a few questions about their BBS.  If the user chose SysOp/Networked,
  30. the user is asked the network node number and the phone number for
  31. validation.  If the user passes those tests, a piece of netmail is
  32. generated and sent along its merry way.  The BBS information entered
  33. (or pulled from the nodelist) is entered into a plain text file for you
  34. to do whatever with.  
  35.  
  36.   After that, a check is made on the user's name against the
  37. NSAV:DLGOwners.LST. If it is and the user confirms, the user's status
  38. is upgraded again, but this time with the DLG template that you
  39. specify in the configuration program.  If the user says that the
  40. number found by NSAV isn't his or her number, the user is asked their
  41. DLG serial number. However, a note is then sent to TelePro Technologies
  42. for a confirmation.  While this all sounds rather complicated, the
  43. process provides an easy way for you to automagically take care of
  44. users that you'd like to give some automagic privileges to.
  45.  
  46. *- Mod is an abbreviation of modification. Since WWIV source code was
  47.    available after one registered, you could easily change the code to
  48.    do whatever you wanted.  As can be predicted, scores of people
  49.    released their changes for public consumption.  Thus, a whole new
  50.    social class among WWIV sysops was born.  Even then, those who
  51.    wrote excellent mods were called 'Mod Gods' to differentiate them
  52.    from authors who wrote average or mediocre mods.  Further reading
  53.    can be obtained from any WWIV sysop, more than likely.
  54.  
  55. Requirements
  56. ============
  57.  
  58.    * dlg.library
  59.    * DLG:SendMsg
  60.    * an assignment of NSAV: where the NSAV files are kept. 
  61.    * TrapList and traplist.library for Fidonet-type networks
  62.    * wwivnet.library for WWIVnet-type networks
  63.  
  64. Usage
  65. =====
  66.  
  67. NetSysAutoVal 
  68. -------------     
  69.      This program is the user-end of the NSAV system.  It *must* be
  70. run underneath DLG (that is why it doesn't take any parameters).  It
  71. will autodetermine the port, user status, etc.  It is ok to run
  72. multiple copies of the program.  This program is not pure, so don't make
  73. it resident (I may fix this in the future if you really want me to). 
  74. I would recommend putting it in your main menu.  You can set it up
  75. any way you want, just be sure to mark it as having to run as an
  76. overlay and that CLI Mode is off.  [NSAV takes care of messages that
  77. may be pending itself].  Or, you could put it somewhere in your
  78. login procedure, after a level check or somesuch, as one of the beta 
  79. testers did.
  80.  
  81. NSAV-Config
  82. -----------
  83.      This is where you set up the options that makes NSAV work its
  84. magic.  Set it up as a menu option in your sysop menu.  Be sure to
  85. mark it as CLI mode off and overlaying.  Let us go through the options
  86. one-by-one.
  87. ----------------------------------------------------------------------
  88. Network Sysop Automatic Validation
  89. ----------------------------------------
  90.  
  91. [1]            Fidonet [FIDO] 1:11/400
  92.  
  93. ----------------------------------------
  94. [A] Add a Network
  95. [C] Main Configuration
  96. [D] Delete a Network
  97. [E] Edit a Network
  98. [S] Save Your Work
  99. [M] Previous Menu
  100. ----------------------------------------
  101.  
  102. [UNREGISTERED] [NSAV] => 
  103. ----------------------------------------------------------------------
  104. This is the first screen you'll see.  This menuset contains the functions
  105. you need to edit the general information that the user is presented
  106. with.  From here you can...
  107.  
  108. A]dd    - Add a network to the list
  109. D]elete - Delete a network from the list
  110. E]dit   - Edit a network on the list
  111. S]ave   - Save your network settings
  112. C]onfig - Configure the main program's features
  113. M]ain   - Quit the program, go back to the previous menu
  114.  
  115. Choosing Edit takes you to the following menu...
  116. ----------------------------------------------------------------------
  117. Edit a Network: Fidonet
  118. ----------------------------------------
  119. [N] Network Name: Fidonet
  120. [K] Template    : Validated
  121. [T] Network Type: FIDO
  122.     Network Node: 1:11/400
  123.     Zone Ranges : 1 through 6
  124. [M] Previous Menu
  125. ----------------------------------------
  126.  
  127. [Edit a Net] => 
  128. ----------------------------------------------------------------------
  129. From here, we can change the settings of a network.  These individual
  130. settings are:
  131.  
  132.     - Name of the network
  133.     - DLG Pro template to apply if successful
  134.     - Network Type
  135.  
  136. When you change the network type, you will be prompted for information
  137. particular to that network.  For Fidonet-type networks, you will get
  138. asked your 3-dimensional address and what zones this particular network
  139. covers.  For WWIVnet-type networks, you will get asked the network node
  140. number and which network it is in WWIVnetConfig.
  141.  
  142. ----------------------------------------------------------------------
  143. ----------------------------------------
  144. [L] Log Name              : LOGS:NSAV.LOG
  145. [S] SysOp name            : SysOp
  146. [N] NetMail name          : SysOp
  147. [B] BBS List name         : DLGConfig:Text/VisitingSysops.DLG
  148. [F] Fidonet.index Location: NODELIST:
  149. [T] DLG Pro Template      : VALIDATED
  150. [A] Ask about DLG Pro     : No
  151. [M] Previous Menu
  152. ----------------------------------------
  153.  
  154. [Config NSAV] => 
  155. ----------------------------------------------------------------------
  156. Choosing C]onfig from the main menu brings you this screen.  From here
  157. is where you decide on a few minor details that make the program a bit
  158. nicer for you and the user to use.  We have...
  159.  
  160. Log Name          - Where NSAV puts its log
  161. SysOp Name        - Your *REAL* name used for the NSAV.keyfile
  162. NetMail Name      - Whatever name you want on netmail
  163. BBS List          - Where to put NSAV's BBS list
  164. Fidonet Index     - Where TrapList looks for its files
  165. DLG Pro Template  - Which DLG Pro template to apply to owners
  166. Ask about DLG Pro - Should NSAV even ask about DLG status?
  167.  
  168. Pretty straight forward, for the most part.  These options are
  169. automatically saved when you exit this screen by typing quit.
  170.  
  171. What Are All Of These Files?
  172. ============================
  173.  
  174.   Included with your archive are sample files that you are free to
  175. edit at will.  These control various messages spit out by NSAV. 
  176. Here's a list of all the possible files that you can use.  Note that
  177. you do not *have* to have any of them.
  178.  
  179.   AboutFidonets.DLG   -- This file is printed right before the user
  180.                          enters a Fidonet-type address.
  181.  
  182.   AboutWWIVnets.DLG   -- This file is printed right before the user
  183.                          enters a WWIVnet-type address.
  184.  
  185.   BadNode.DLG         -- The node that was entered couldn't be found!
  186.  
  187.   BadPhone.DLG        -- This message is printed if the phone numbers
  188.                          do not match.
  189.  
  190.   BadZone.DLG         -- The user entered in a zone that does not
  191.                          belong with that network.... your chance to
  192.                          yell at him/her!
  193.  
  194.   CheckDLG.DLG        -- This file will get sent to Tom Conroy 
  195.                          1:134/2003 to validate someone's DLG Pro
  196.                          registration number.  The number will appear 
  197.                          IN THE TITLE of the message... so plan 
  198.                          accordingly.
  199.  
  200.   CheckValidation.DLG -- This file will be sent to the sysop of the
  201.                          node where the user THINKS s/he is from. 
  202.                          Just a precautionary measure.  [Sent via
  203.                          SendMsg]
  204.   
  205.   ConfirmDLG.DLG      -- This file will get sent to Tom Conroy 
  206.                          1:134/2003 if a user's name is found in
  207.                          the DLGOwners.LST. 
  208.  
  209.   DLGOwners.LST       -- The current list of registered DLG owners.
  210.  
  211.   GoodNode.DLG        -- We found the node!
  212.  
  213.   GoodPhone.DLG       -- This message is printed if the phone numbers
  214.                          DO match.
  215.  
  216.   ManualAdd2BBS.DLG   -- This message is printed if the user chose 
  217.                          SysOp, no network.  
  218.  
  219.   NotASysop.DLG       -- Printed out if the user chose '0' not a 
  220.                          network sysop.
  221.  
  222.   NSAV-Intro.DLG      -- Printed out before the program asks for their
  223.                          network.
  224.  
  225.   PhoneNum.DLG        -- This is the message that is printed right
  226.                          before the user is about to enter his/her
  227.                          phone number.
  228.  
  229.   TellAboutCheck.DLG  -- This message will get printed to the user 
  230.                          before the message to TpT is sent off to check
  231.                          a *user-entered* DLG serial number.
  232.  
  233.   TellAboutConfirm.DLG-- This message will get printed to the user
  234.                          before the note to TpT is sent off to confirm
  235.                          a NSAV-found DLG serial number.
  236.  
  237. One of our standard conventions around here is that files that end in
  238. .DLG are files that contain switches that DLG Pro will translate for
  239. us.  For example, using the %name in CheckValidation.DLG will allow
  240. you to ask the sysop about the user who just logged in on a PERSONAL
  241. level.  We hope you don't mind if we carry that tradition on to this
  242. program.
  243.  
  244.  
  245. Help!
  246. =====
  247.  
  248.   First, the standard disclaimer:
  249.  
  250.   Crispy Software, or any of its subcomponents, make absolutely no
  251. guarantees as to this program's abilities.  All risk involved with
  252. NSAV rests solely on the user of the NSAV program.
  253.  
  254.   That aside, if you do have any problems, suggestions, flames, cash,
  255. nubile young women, etc... we would like to hear about them
  256. (especially the last two..).  You can contact us at the following
  257. locations:
  258.  
  259.   Fidonet : Support@1:11/400.0        [this will soon change...again...]
  260.   AmigaNet: Support@40:206/12.0
  261.   Internet: support@crispy.carb.il.us
  262.   WWIVlink: 2@26853                   [this will soon change...again...]
  263.   
  264. If the previous electronic addresses don't cut it, try snail mail to
  265. here:
  266.  
  267.              Crispy Software
  268.              c/o Allen Wittenauer
  269.              403 West Freeman, Apt 15
  270.              Carbondale, IL  62901
  271.  
  272.                    -or-
  273.  
  274. You could always call the system.  No guarantees on whether or not you
  275. actually survive the shock when you see what we did to DLG...
  276. [especially if we finish up our "Run MS-DOS BBS's As A Door" program...
  277. hehe..]
  278.  
  279.               M E N T A L
  280.               V O R T E X
  281.             01-618-529-3486
  282.  
  283.               3/12/2400 
  284.    [someday soon, a real modem will appear here.
  285.     Of course, if you really, really would like
  286.     to donate one, we wouldn't refuse it... <wink>]
  287.  
  288. Distribution
  289. ============
  290.  
  291.   Even though NSAV is Copyright (C) 1993, Crispy Software, this
  292. program can still be freely distributed so long as it is not done
  293. through ADS or except as noted below.  SAN and Fred Fish distribution
  294. more than welcome.  Companies that distribute PD/shareware via disk or
  295. anyone we forgot: call, write, contact us for further instructions.  
  296.  
  297.   New versions can be picked up via FREQ of NSAV -or- send mail to
  298. fileserver@crispy.carb.il.us, with the keyword HELP to learn how to
  299. get files from Mental Vortex without hassle of a phone call.  BMS
  300. service is also available, assuming Allen set it up correctly.
  301.  
  302.   This program is being released as shareware.  The current
  303. registration fee is $10.00 US.  Unlike most authors, we refuse to set
  304. a time limit as to when you should pay.  Instead, take as long as you
  305. want.  When you feel it has made your life easier, then just drop a
  306. check or whatever in the mail.  We'll send you a keyfile that will
  307. proclaim to the world that you do support the shareware efforts of
  308. those sick individuals who actually think they can make a buck or two
  309. off of sysops, probably one of the poorest of social classes on the
  310. face of the earth. ;) Make checks payable to Allen Wittenauer. 
  311. Keyfiles can be put on hold for you at 1:11/400.0, can be sent
  312. uuencoded to you via Internet, or by establishing an account
  313. on MtV (if you pre-pay, your keyfile will be generated and uploaded to
  314. you online, on your first call via the magic of NSAVMakeReg).
  315.  
  316. Dedications
  317. ===========
  318.  
  319. Mike MacNessa &          Thanks for talking me into DLG guys! - ec
  320. John Waters               
  321.  
  322. Mike MacNessa &          Thanks for talking Allen into DLG--we're sick
  323. John Waters              of working on the WWIVSERV doc's! - ts & rtt
  324.  
  325. Users of MtV             For putting up with the slow system during 
  326.                          development.  At least you aren't rebuilding
  327.                          your accounts everyday anymore! :)
  328.  
  329. Aaron Wald               For reminding why I quit calling a certain
  330.                          CNET board that used to be in the B'ville
  331.                          area--attitude. - ec
  332.