home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / MTNV21.ARJ / MTONEXT.DOC < prev    next >
Text File  |  1993-12-29  |  11KB  |  262 lines
  1.  
  2.  
  3.                        Message To Next Caller Door v2.1
  4.                     (c) 1993  by Datagen Software Designs
  5.                      written & programmed by John Dailey
  6.  
  7.                             WARRANTY and DISCLAIMER
  8.                             ───────────────────────
  9.  
  10.           This  software  is  provided  AS IS without any expressed or
  11.           implied warranties whatsoever. No warranty of fitness for  a
  12.           particular  purpose  is offered. The author of this software
  13.           cannot be held responsible for DIRECT, INDIRECT  INCIDENTAL,
  14.           CONSEQUENTIAL,  or  ANY OTHER damages due to your ability or
  15.           inability to use this software, even if the author has  been
  16.           advised of the possibility of such damages. The user assumes
  17.                 full responsibility for the use of this software.
  18.  
  19. Files Included In This Package:
  20. ───────────────────────────────
  21.  
  22.           MTONEXT.DOC ─── Message To Next Caller v2.1 Documentation
  23.           MTONEXT.HIS ─── Message To Next Caller v2.1 History File
  24.           MTONEXT.EXE ─── Message To Next Caller v2.1 Executable File
  25.           MTONEXT.DAT ─── Sample Message File
  26.           MTONEXT.MOD ─── .MOD File For WWIV 4.20+
  27.  
  28.  
  29. Files Created By This Program:
  30. ──────────────────────────────
  31.  
  32.           MTONEXT.CFG ─── Configuration File
  33.           MTONEXT.ANS ─── ANSI Display File [Optional]
  34.           MTONEXT.ASC ─── ASCII Display File [Optional]
  35.           MTONEXT.DAT ─── Record Of Message
  36.           MTONEXT.OLD ─── Previous Record [Optional]
  37.  
  38. What Is It?:
  39. ────────────
  40.  
  41.      This program is great fun!  With it, your users can leave a message to
  42. the next caller of your BBS.  It is written to be run as an on-line door (or
  43. as a logoff event with the enclosed MOD), and is simple to set up.  All you
  44. need to do is add it to your CHAINs menu, run the setup program [optional],
  45. and it's ready to go!
  46.  
  47. Installation:
  48. ─────────────
  49.  
  50.      The Message To Next Caller Door needs only one command line parameter. 
  51. This parameter is simply the directory and filename of the CHAIN.TXT file
  52. that WWIV writes to your disk.  For example:
  53.  
  54.      MTONEXT %1 (WWIV replaces the %1 with the needed information)
  55.      MTONEXT C:\WWIV\CHAIN.TXT
  56.  
  57.      Besides the command line parameter listed above, there is another one
  58. that is for the sysop's use only.  That is the "/S" command-line parameter. 
  59. This loads the setup menu for Message To Next Caller instead of running the
  60. program itself.  This feature uses no communications routines, and is covered
  61. later on in this document.
  62.  
  63.      First, if possible you should place the executable file in your main
  64. WWIV directory, but you may put it in it's own subdirectory provided you call
  65. the program with a batch file.  An example of this batch file would be as
  66. follows:
  67.  
  68.           @ECHO OFF
  69.           CD \WWIV\MTONEXT
  70.           MTONEXT %1
  71.           CD ..
  72.  
  73.      Now, simply create an entry in your BBS CHAINs area for the program with
  74. specifications as shown below.
  75.  
  76.      Filename       : <The name of your batch file or the command line> %1
  77.      ANSI           : Required
  78.      DOS Interrupts : NOT USED!
  79.      Shrink         : Optional
  80.  
  81.      If you wish the message from the previous caller to be shown at logon
  82. time, then you need to add one line to your logon batch file that will TYPE
  83. the files to the screen.  To do this, simply add:
  84.  
  85.      TYPE + <subdirectory where the files are placed> + MTONEXT.ANS (or
  86.      MTONEXT.ASC)
  87.  
  88.      where ever you wish in your LOGON.BAT file.  For example:
  89.  
  90.      TYPE C:\WWIV\GFILES\MTONEXT.ANS
  91.  
  92.      Note that the MTONEXT.ANS file is an ANSI display file, and the
  93. MTONEXT.ASC file is a WWIV color-coded file for both ANSI and non-ANSI. 
  94.  
  95.      Upon entering the door, the current message will be displayed, and it
  96. will ask if the user wishes to leave a new message.  If not, then it returns
  97. to the BBS, but otherwise, it will ask the user to input a message of 5 lines
  98. or less, allowing WWIV's <CNTRL><P> color commands.  After confirmation that
  99. everything is correct, the program will create files according to what is in
  100. the configuration file, and return to the BBS.
  101.  
  102. The Setup Menu:
  103. ───────────────
  104.  
  105.      To load the setup program, simply type "MTONEXT /S" at the DOS prompt. 
  106. A simple menu will appear:
  107.  
  108.                 1]  Allow Anonymous [YES/NO]
  109.                 2]  Allow Handles [YES/NO]
  110.                 3]  Make ANSI [YES/NO]
  111.                 4]  Make ASCII [YES/NO]
  112.                 5]  Create .OLD File [YES/NO]
  113.                 6]  User Signing With Sysop's Name [DROP/EXIT/OK]
  114.                 7]  Directory For Display Files [C:\WWIV\GFILES\]
  115.                 8]  Attention Statement [- NONE -]
  116.                 9]  Change Display Colors
  117.                 S]  Save Changes
  118.                 Q]  Quit To DOS
  119.  
  120.         - Allow Anonymous [YES/NO]
  121.           This option allows the sysop to control whether or not users can
  122.           post Messages anonymously.
  123.  
  124.         - Allow Handles [YES/NO]
  125.           This option allows the sysop to control whether or not users
  126.           can put in different Handles as there's.
  127.  
  128.         - Make ANSI [YES/NO]
  129.           This will tell the program whether or not to make an ANSI
  130.           display file.
  131.  
  132.         - Make ASCII [YES/NO]
  133.           This tells the program whether or not to create a WWIV
  134.           Color-coded ASCII file for non-ANSI users.
  135.  
  136.         - Create .OLD File [YES/NO]
  137.           Let's the sysop decide if he/she would like a backup of the
  138.           message .DAT.  This simply means that each time a user changes
  139.           the message, the old message file (MTONEXT.DAT) will be
  140.           renamed to MTONEXT.OLD.
  141.  
  142.         - User Signing With Sysop's Name [DROP/EXIT/OK]
  143.           This new option keeps users from signing with the sysop's
  144.           name.  It will either drop carrier on anyone who enters the
  145.           sysop's name as their handle, exit to the BBS, or do nothing.
  146.           If this option is not on (OK), the users may enter the sysop's
  147.           handle as their own.  Be warned!
  148.  
  149.         - Directory For Display Files [C:\WWIV\GFILES\]
  150.           This option simply tells MTONEXT where to place your display
  151.           files(s).
  152.  
  153.         - Attention Statement [- NONE -]
  154.           This choice let's you enter a one-liner that will appear on
  155.           the top of the display file.  Basically an attention-getter.
  156.  
  157.         - Change Display Colors
  158.           The long awaited option to change the colors of the ANSI
  159.           display file, and the colors while inside the door.  Please
  160.           note that this option does not change the MTONEXT.ASC
  161.           settings, but only the MTONEXT.ANS file's.  Choosing this will
  162.           bring you to another menu.
  163.  
  164.         - Save Changes
  165.           Saves any changes made to the setup program.
  166.  
  167.         - Quit To DOS
  168.           Quits the Setup program and exits to DOS.  If changes have
  169.           been made to the setup, and have not been saved, the program
  170.           will ask you whether or not you wish to save those changes.
  171.  
  172.      Simply press the letter or number of your choice, and if required, enter
  173. the requested information.
  174.  
  175.      That is all there is to it!  The door will now function properly if set
  176. up correctly.
  177.  
  178. The Sysop Info Bar:
  179. ───────────────────
  180.  
  181.      The sysop information bar at the bottom of the screen gives a wide
  182. variety of information about what is currently going on inside the door. 
  183.  
  184.      First, is the current users name that is using the door, followed by
  185. their number.  Next, the com port is displayed followed by the baud rate.  If
  186. the user is local, "LOCAL" will be displayed.  Finally, inside greater than
  187. (>) and less than (<) symbols, the real handle and number of the user that
  188. posted the message displayed is shown.
  189.  
  190. Extended Usage:
  191. ───────────────
  192.  
  193.      For those of you who would like to modify your WWIV source code, I have
  194. included a .MOD file that you may insert into your WWIV source at the logoff
  195. routine.
  196.  
  197.      Simply follow the instructions that are included with the .MOD file and
  198. you are all set.  This routine will simply load Message To Next Caller if the
  199. user has ANSI capabilities at logoff.  Please feel free to modify this MOD in
  200. any way you like, but Datagen Software Designs is not responsible for any
  201. problems thereof.
  202.  
  203.      This .MOD was included for a few reasons.  The first being that having
  204. to go into the on-line games area to leave a message to the next caller was
  205. more like an autopost program (which there are plenty of).  The second being
  206. that it was suggested by a few sysops to have a .MOD such as this.  Hope it
  207. was worth-while!
  208.  
  209. Registration:
  210. ─────────────
  211.  
  212.      No registration fee is required for this program, but you may make
  213. small donations to Datagen Software Designs to further our cause, and help
  214. in the production of more quality software.  You may distribute this program
  215. freely as long as all files are kept together in archived form and not
  216. modified in anyway.
  217.  
  218. Datagen Software Designs Support BBS Information:
  219. ─────────────────────────────────────────────────
  220.  
  221.      For information on becoming a respectable Datagen Software Designs
  222. support Bulletin Board System, simply mail the below address, with the
  223. following information:  (Note - you must include all information.)
  224.  
  225.           BBS Name,
  226.           BBS Phone Number,
  227.           BBS Type and Version,
  228.           BBS Net/Node (if applicable)
  229.           Disk Size (5 1/4" or 3 1/2")
  230.           Sysop Name,
  231.           Sysop Real Name,
  232.           Sysop Address,
  233.           Sysop Age,
  234.           How Long Your BBS Has Been Up,
  235.           And finally, your reason for wanting to become a support BBS.
  236.  
  237.      Sysop's requesting to become a support board will be notified as soon as
  238. possible on their request, and if accepted, will be eligible to receive
  239. Datagen's Support BBS Newsletter, technical support on all Datagen products,
  240. and MUCH more!  Send requests to:
  241.  
  242.           Support BBS Information
  243.           Datagen Software Designs
  244.           1732 Wind Drift Rd.
  245.           Orlando, FL  32809
  246.  
  247. Authors Notes And Credits:
  248. ──────────────────────────
  249.  
  250.      Questions, comments, complaints, or to receive a complete listing and
  251. description of all Datagen products, mail John Dailey at the below address,
  252. through Compuserve at 73124, 2612, through Internet at 73124.2612@cis.com,
  253. through Prodigy at ID# MKHH05B, or through WWIVNet at 23@4709 (Enigma).
  254.  
  255.      Thank you for your support!
  256.  
  257.           Message To Next Caller v2.1
  258.           c/o John Dailey
  259.           1732 Wind Drift Rd.
  260.           Orlando, FL  32809
  261.  
  262.