home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMTRBBS / DSDROP30.ZIP / DSDROP.DOC < prev    next >
Encoding:
Text File  |  1993-10-04  |  17.2 KB  |  386 lines

  1.                        ═╦══╗ ╝ ╔══╗ ╔═══ ╔═══ ╦══╗ ╦══╗
  2.                         ║  ║   ╠══╣ ║ ╔╗ ║ ╔╗ ╠═   ╠═╦╝
  3.                        ═╩══╝   ╩  ╩ ╚══╝ ╚══╝ ╩══╝ ╩ ╩═
  4.                            ╔══╗ ╦  ╦ ╔══╗ ╔══╗ ╦ ╔═
  5.                            ╚══╗ ╠══╣ ║  ║ ║    ╠═╩╗
  6.                            ╚══╝ ╩  ╩ ╚══╝ ╚══╝ ╩  ╩
  7.  
  8.                      It's not Shareware.  It's SHOCKWARE!
  9.  
  10.                               DSDrop Version 3.0
  11.                      D'Agger Shock Drop Carrier Notifier
  12.              Copyright 1993 by D'Agger Shock, All Rights Reserved
  13.                               September 24, 1993
  14.  
  15. ==============================================================================
  16.  
  17.                                   SHOCKWARE
  18.                                   ~~~~~~~~~
  19.     This program is distributed on the Shockware basis. It is NOT crippled
  20.     in any way. If you like it, and you use it, I ask that you please
  21.     register. REGISTER.TXT is included with this archive. By registering,
  22.     you will keep updates and other quality software coming!
  23.  
  24.                                    WARRANTY
  25.                                    ~~~~~~~~
  26.     This program is distributed without warranty. D'Agger Shock will not be
  27.     liable in any way for any damages caused from the use of this program.
  28.     There is no guarantee that this program will work on your system. A
  29.     friend of mine put it best when he said:
  30.  
  31.     "Hey, it works on my system!"
  32.  
  33.                                     TriBBS
  34.                                     ~~~~~~
  35.     This program is desiged for use with the TriBBS Bulletin Board System
  36.     only!
  37.  
  38.     TriBBS is a registered trademark of Mark D. Goodwin.
  39.  
  40. ==============================================================================
  41.  
  42.                      WHAT THIS PROGRAM IS SUPPOSED TO DO
  43.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44.     DSDrop checks if the last caller dropped carrier or not. If carrier loss
  45.     occurred, DSDrop will send a logon notice to the caller, and if so desired
  46.     a notification screen to the sysop, and a log file. The notification
  47.     screen and log file contain all of the callers information.
  48.  
  49. ==============================================================================
  50.  
  51.                                MULTI-NODE SETUP
  52.                                ~~~~~~~~~~~~~~~~
  53.     Throughout this document there are examples for multi-node systems. If
  54.     you are running a multi-node system, please take the time to follow the
  55.     examples. If you are running only a single node setup, just use the node
  56.     1 examples. SHARE.EXE must be loaded for multi-node systems!!! To do
  57.     this, put the following line in you Config.Sys:
  58.  
  59.     INSTALL=C:\DOS\SHARE.EXE
  60. ==============================================================================
  61.  
  62.     The next thing you have to do, is make a configuration file. A sample
  63.     configuration file is included in this archive. This file can be any
  64.     name. When you run DSDrop, run the name of the configuration file as
  65.     DSDrop's first parameter.
  66.  
  67.  
  68. Example: DSDROP DSDROP1.CFG     <- For node 1.
  69.          DSDROP DSDROP2.CFG     <- For node 2.
  70.  
  71. Sample configuration file for Node 1:
  72.  
  73. C:\TRIBBS                         <- Path to node 1's directory.
  74. C:\TRIBBS                         <- Path to THIS node's directory.
  75. C:\TRIBBS\TRITOOLS\DSDROP.ANS     <- Path and name of color ANSI screen.
  76. C:\TRIBBS\TRITOOLS\DSDROP.BBS     <- Path and name of Mono screen.
  77. C:\TRIBBS\TRITOOLS\DSDROP.RIP     <- Path and name of RIP screen.
  78. BRIGHT GREEN                      <- Heading Color
  79. BRIGHT WHITE                      <- Text Color.
  80. SYSOP=1                           <- Sysop's user number.
  81. SYSOPSCREEN=YES                   <- Send notification screen to Sysop?
  82. RIP=YES                           <- Using RIP?
  83. DAT=YES                           <- Use a data file?
  84. LOG=YES                           <- Log all carrier losses?
  85. C:\TRIBBS\DSDROP.DAT              <- Path and name of data file.
  86. C:\TRIBBS\DSDROP.LOG              <- Path and name of log file.
  87.  
  88.  
  89. Sample configuration file for Node 2:
  90.  
  91. C:\TRIBBS                         <- Path to node 1's directory.
  92. C:\TRIBBS2                        <- Path to THIS node's directory.
  93. C:\TRIBBS\TRITOOLS\DSDROP.ANS     <- Path and name of color ANSI screen.
  94. C:\TRIBBS\TRITOOLS\DSDROP.BBS     <- Path and name of Mono screen.
  95. C:\TRIBBS\TRITOOLS\DSDROP.RIP     <- Path and name of RIP screen.
  96. BRIGHT GREEN                      <- Heading Color
  97. BRIGHT WHITE                      <- Text Color.
  98. SYSOP=1                           <- Sysop's user number.
  99. SYSOPSCREEN=YES                   <- Send notification screen to Sysop?
  100. RIP=YES                           <- Using RIP?
  101. DAT=YES                           <- Use a data file?
  102. LOG=YES                           <- Log all carrier losses?
  103. C:\TRIBBS\DSDROP.DAT              <- Path and name of data file.
  104. C:\TRIBBS\DSDROP.LOG              <- Path and name of log file.
  105. LOCKOUT=100                       <- Lock user out at ## of carrier drops.
  106.  
  107. NOTE: All lines in the configuration file MUST be present wether you are using
  108.       a feature or not!
  109.  
  110.  
  111.     MAIN PATH: This is the path to the main TriBBS directory.
  112.  
  113.     THIS PATH: This is the path to the node that DSDrop is running in.
  114.  
  115.     ANSI SCREEN: This is the name of the Color ANSI that will be sent to the
  116.     caller. If it's in the same directory, just the name is needed. Otherwise
  117.     the full path must be specified. A samples has been included.
  118.  
  119.     MONO SCREEN: This is the name of the Non-color screen that will be sent to
  120.     the caller. If it's in the same directory, just the name is needed.
  121.     Otherwise, the full path must be specified. A sample has been included.
  122.  
  123.     RIP SCREEN: This is the name of the RIPScrip screen that will be sent to
  124.     the caller only if the RIP= line is set to YES. If it's in the same
  125.     directory, just the name is needed. Otherwise, the full path must be
  126.     specified. A sample has been included.
  127.  
  128.  
  129.     HEADING COLOR: This is the color for the Headings that DSDrop will send
  130.     to the Sysop Notification Screen.
  131.  
  132.     TEXT COLOR: This is the color of the Callers information that is sent to
  133.     the Sysop Notification Screen.
  134.  
  135.     SYSOP= LINE: This is the Sysop's user number. A user number is a number
  136.     that TriBBS gives each caller. You can check to see what your user number
  137.     is from the "Edit Users" option from TriBBS's Waiting for Caller screen.
  138.     (Normally, this number is 1, because the Sysop is usually the first
  139.     person to logon.)
  140.  
  141.     SYSOPSCREEN= LINE: Do you want a notification screen sent to the Sysop?
  142.     There are two options. SYSOPSCREEN=YES which will send a notification
  143.     screen, and SYSOPSCREEN=NO which will not. There must be no space to the
  144.     left or to the right of the equal sign.
  145.  
  146.     RIP= LINE: Does you BBS support RIP graphics? There are two options.
  147.     RIP=YES which will look for the screen specified in line 5, and send it to
  148.     the caller, and RIP=NO which will not look for the screen or send it to
  149.     the caller. If you are using TriBBS 4.x set this to NO.
  150.  
  151.     DAT= LINE: Do you want to use the Data file features? The data file
  152.     contains important information about each caller that drops carrier. The
  153.     features include a drop carrier counter, lockout flag, call waiting flag.
  154.     There are two options. DAT=YES which will enable the above features for
  155.     use with DropEdit and send the data to the file specified in line 13, and
  156.     DAT=NO which disables both the above features and DropEdit.
  157.  
  158.     LOG= LINE: Do you want a log of all carrier drops? There are two options.
  159.     LOG=YES which will log all carrier drop to the file specified in line 14,
  160.     and LOG=NO which will disable the log.
  161.  
  162.     NOTE: You may want to set this to C:\TRIBBS\MWORK\CALLERS.LOG for ease of
  163.           use.
  164.  
  165.     DATA PATH: This is the path and name to the dat file. If line 11 is set to
  166.     DAT=NO, then this line will have no effect, but it MUST be present!
  167.  
  168.     LOG FILE PATH: This is the path and name to the log file. IF line 12 is
  169.     set to LOG=NO, then this line will have no effect, but it MUST be present!
  170.     
  171.     LOCKOUT= LINE: This is the number of times a person can drop carrier
  172.     before they become locked out. All lock outs are handled by DropEdit. If
  173.     you do not want the lock out feature then you do not have to use it, but
  174.     this line MUST be present!
  175.  
  176. Example Sysop Notification Screen:
  177.  
  178.  Heading LIne                   Sysop's Name
  179.   |                            __|__________
  180.   |                           {             }
  181. This is a note from DSDrop to Dean D'Agostino.
  182. The following user has dropped carrier.
  183.    __                                   __
  184. H |  User Name.......: Dean D'Agostino    |
  185. E |  User Alias......: Speedtorch         |
  186. A |  User Number.....: 1                  | T
  187. D |  User Password...: Register           | E
  188. I |  Security Level..: 100                | X
  189. N |  City, State.....: Valrico, Fl        | T
  190. G |  Phone Number....: 813-555-5555       |
  191.   |  Date Dropped....: 10-04-1993         | L
  192. L |  Time Dropped....: 12:50:08 pm        | I
  193. I |  Node Dropped....: 1                  | N
  194. N |  Carriers Dropped: 3                  | E
  195. E |  Call Waiting....: Yes                |
  196.   |__Locked Out......: No               __|
  197.  
  198.                     
  199.                                     COLORS
  200.                                     ~~~~~~
  201. NOTE: The following colors are for the color ANSI screens ONLY! All colors
  202.       can be used for the heading lines OR the text lines.
  203.  
  204.                        Bright Colors       Dark Colors
  205.                        ~~~~~~~~~~~~~       ~~~~~~~~~~~
  206.                        BRIGHT RED          RED
  207.                        BRIGHT GREEN        GREEN
  208.                        YELLOW              BROWN
  209.                        BRIGHT BLUE         BLUE
  210.                        MAGENTA             PURPLE
  211.                        BRIGHT CYAN         CYAN
  212.                        BRIGHT WHITE        BRIGHT GREY
  213.                        BRIGHT GREY         GREY
  214.  
  215. ==============================================================================
  216.  
  217.     In order for DSDrop to get the all of the information, you will need a
  218.     LOGON.BAT. If you already have one, good. If not, here is an example of
  219.     what yours can look like:
  220.  
  221.  
  222. Example LOGON.BAT for node 1:
  223.  
  224. @ECHO OFF
  225. BOARD
  226.  
  227. Example LOGON.BAT for node 2:
  228.  
  229. @ECHO OFF
  230. NODE2
  231.  
  232.     TriBBS will create ALL door data files needed before it leaves memory.
  233.     Then, "BOARD" will go right back into TriBBS, leaving the door data files.
  234.  
  235.     The next thing to do to get DSDrop up and running is put it in your
  236.     BETWEEN.BAT. This example assumes that you have used a separate directory
  237.     for DSDROP.
  238.  
  239.  
  240. Example BETWEEN.BAT for node 1:
  241.  
  242. @ECHO OFF
  243. CD\TRIBBS\TRITOOLS
  244. DSDROP DSDROP1.CFG
  245. CD\TRIBBS
  246. IF EXIST C:\TRIBBS\TRIBBS.SYS DEL C:\TRIBBS\TRIBBS.SYS
  247.  
  248. Example BETWEEN.BAT for node 2:
  249.  
  250. @ECHO OFF
  251. CD\TRIBBS\TRITOOLS
  252. DSDROP DSDROP2.CFG
  253. CD\TRIBBS2
  254. IF EXIST C:\TRIBBS2\TRIBBS.SYS DEL C:\TRIBBS2\TRIBBS.SYS
  255.  
  256.  
  257. IMPORTANT: Notice the "If Exist" statement in the above lines. This MUST be
  258. the VERY LAST line of your Between.Bat!
  259.  
  260. NOTE: DSDROP.EXE and the configuration file MUST be in the same directory, or
  261.       you will have to specify the full path name!
  262.  
  263.                 DOES YOUR MODEM DETECT CARRIER LOSS CORRECTLY?
  264.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  265.     In order for DSDrop to work, your modem must correctly detect carrier
  266.     loss. Here is an excerpt from the "Freejack's Tips" section of the
  267.     Tampa Bay TriBBS Newsletter explaining what to do.
  268.  
  269.     "If you have experienced problems where a caller has logged off and your
  270.     BBS sometimes does not recycle, or a caller drops carrier and the BBS just
  271.     sits there, most likely this is the problem of your settings in your NRAM
  272.     of your modem.... TriBBS monitors the DCD (Data Carrier Detect signal) of
  273.     the users modem. The problem lies in most factory settings on modems
  274.     where they are set up for basically calling out, and not for receiving.
  275.     Therefore, the modem is set with the &C or &C0, which forces the DCD
  276.     signal active (ON) continuously. This factory setting gives TriBBS
  277.     problems, because it forces TriBBS to monitor the DCD at the high setting
  278.     and may fool it into thinking someone is still on line, where in fact
  279.     they may have dropped or lost carrier... To check to see if this setting
  280.     is in your active NRAM profile of your modem, type this command in your
  281.     favorite communication program that you use to normally call out.
  282.  
  283.     AT&V   <--This command allows you to view your NRAM settings.
  284.  
  285.     If you see the command (&C or &C0) in one of the lines in the active
  286.     profile of your NRAM settings, then you will need to change this...the
  287.     following is how you would do this:
  288.  
  289.     ATZ   (Enter Return)  <--This is to get your modems attention.
  290.     OK     <--Don't type this, this is what your modem should return.
  291.     AT&C1 (Enter Return)  <--This will place the new command in your NRAM.
  292.     OK     <--Don't type this, this is what your modem should return.
  293.     AT&W  (Enter Return)  <--This will write the new setting to the NRAM.
  294.  
  295.     These commands should work for most modems on the market today. These are
  296.     standard commands used by most of the modem manufactures. However, if you
  297.     do have a problem, feel free to drop me a message on my BBS and I will be
  298.     happy to help you out..."
  299.  
  300.                              HOW TO RESET DSDROP
  301.                              ~~~~~~~~~~~~~~~~~~~
  302.     If there comes a time that you want or need to reset DSDrop's drop carrier
  303.     counter, all you have to do is del the .DAT file. To reset just one
  304.     caller, use DropEdit.
  305.  
  306.                               SPEEDING UP DSDROP
  307.                               ~~~~~~~~~~~~~~~~~~
  308.     The longer your CALLERS.LOG file is, the longer it will take DSDrop to
  309.     detect if the last caller dropped carrier or not. To speed things up a
  310.     little, you can use a program that trims the CALLERS.LOG down to size.
  311.     Perhaps one of the best is DSChop. It lets you choose your file size by
  312.     the number of callers OR by the number of lines in CALLERS.LOG.
  313.  
  314.                                    HISTORY
  315.                                    ~~~~~~~
  316.     3.0
  317.     ~~~
  318.     DSDrop 3.0 was TOTALLY rewritten! It is now much faster than 2.1. The
  319.     Drop Carrier counter is back and this time, it works! Now supports a RIP
  320.     screen! Added a switch to the notification screen and the log feature as
  321.     a request by the Sysop of The Dogger, Billybob Jenkins.
  322.     
  323.     2.1
  324.     ~~~
  325.     Got rid of the Drop Carrier Counter. Was having too many damn problems
  326.     with it. Everything else is still the same. The Drop Carrier Counter
  327.     MAY be back in future versions. I don't know yet.
  328.  
  329.     2.0
  330.     ~~~
  331.     Added multi-node support! The Sysop Notification Screen now tells which
  332.     node the caller dropped carrier on.
  333.  
  334.     1.0
  335.     ~~~
  336.     Wanted a better drop carrier detector that would not only send the caller
  337.     a logon note, but also the Sysop. I didn't like having to check the
  338.     CALLERS.LOG everyday to see if anybody dropped carrier.
  339.  
  340.                               VIRUS INFORMATION
  341.                               ~~~~~~~~~~~~~~~~~
  342.     No program or virus checker is perfect so D'Agger Shock is now using
  343.     McAffee Associates' VALIDATE.COM to check the executable files for
  344.     your protection against viruses.
  345.  
  346.     The validation data for DSDROP.EXE, Version 3.0 is:
  347.  
  348.               File Name:  DSDROP.EXE
  349.                    Size:  54,882
  350.                    Date:  10-4-1993
  351.     File Authentication:
  352.          Check Method 1:  339D
  353.          Check Method 2:  1DD6
  354.  
  355.                                     THANKS
  356.                                     ~~~~~~
  357.               Thanks go out to these TriBBS Sysops of Tampa Bay
  358.  
  359.                                 Dennis Clevenger     <- The beta tester
  360.     An adult's Paradise! ->    The EROGENOUS Zone       from Hell!
  361.     Files, Games, Messages.      (xxx) xxx-xxxx
  362.  
  363.                                    Gary Price        <- "Freejack's Tips"
  364.     Games, Files, and    ->     Freejack's Place
  365.     Messages. Adult Access.      (205) 739-7121
  366.  
  367.  
  368.                                     Mike Lott        <- Editor of the
  369.     Games, Files, and    ->     Night City South        Tampa Bay TriBBS
  370.     Messages. Adult Access.      (813) 949-5751         Newsletter
  371.  
  372.                             WHERE I CAN BE REACHED
  373.                             ~~~~~~~~~~~~~~~~~~~~~~
  374.                               WHERE TO REGISTER
  375.                               ~~~~~~~~~~~~~~~~~  
  376.     To get in touch with me, I can be reached at one of the following places. 
  377.     My name is Dean D'Agostino. Just leave me a message. I can now be reached
  378.     on WME in BBS Utilities and TriBBS Support. Just in case you lost
  379.     REGISTER.TXT, the registration fee for DSDrop is $5.00. Please make Check
  380.     or Money Order out to Dean D'Agostino, and mail to D'Agger Shock.
  381.                                                  
  382.     Priadore             The Blazing Phoenix BBS     D'Agger Shock
  383.     (813) 854-4961       (813) xxx-xxxx              P.O. Box 1368
  384.     24 Hrs.              Coming Soon                 Valrico, Fl 33549
  385.  
  386.