home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DC1_5.ZIP / DC1_5.EXE / DC.DOC < prev    next >
Encoding:
Text File  |  1996-06-10  |  9.0 KB  |  348 lines
  1.  
  2.                       Dropped Carrier for RemoteAccess
  3.  
  4.                          Copyright 1995 Colin Birch
  5.  
  6.                        The Dog House BBS 01443 400327
  7.  
  8.                        24 Hours - 2400 to 28800 VFast
  9.  
  10.                             Fidonet 2:442/618
  11.  
  12.  
  13. What is DC.EXE?
  14. ~~~~~~~~~~~~~~~
  15.  
  16.  DC.EXE creates .ANS/ASC files listing the BBS users who have dropped carrier
  17.  It creates 3 types of file.
  18.  
  19.  DC.ANS/ASC
  20.  The first lists each individual dropped carrier and the time the carrier was
  21.  dropped. So if a person dropped carrier 3 times in one day that person would
  22.  be listed 3 times.
  23.  
  24.  DC1.ANS/ASC
  25.  The second lists the number of times each caller has dropped carrier. So if
  26.  the user dropped carrier 3 times (s)he would be listed once with the number
  27.  of dropped carriers next to the entry
  28.  
  29.  DROPTOT.ANS/ASC
  30.  The third is similar to the second but lists the number of dropped carriers
  31.  over a user definable period. You may for example want to show how many
  32.  times a user has dropped carrier over the last month.
  33.  
  34.  
  35.  Registered versions of DC.EXE also have the ability to change a sysop
  36.  definable user flag. This can then be used to show a screen to carrier
  37.  droppers.
  38.  
  39.  Registered versions also allow automatic security level changes after a
  40.  user has dropped carrier a sysop defined number of times.
  41.  
  42.  
  43.  
  44. How do I set up DC.EXE?
  45. ~~~~~~~~~~~~~~~~~~~~~~~
  46.  
  47.  First, add the following line to your AUTOEXEC.BAT file:-
  48.  
  49.  SET DC=~path to DC.EXE~
  50.  
  51.  Save your AUTOEXEC.BAT file then re-boot your computer
  52.  
  53.  Add the following line to your BBS.BAT file - Change path to suit
  54.  
  55.  Single node:-
  56.  ~~~~~~~~~~~~~
  57.  C:\RA\DC\DC.EXE
  58.  
  59.  Multi Node:-
  60.  ~~~~~~~~~~~~
  61.  C:\RA\DC\DC.EXE /N~node number~
  62.  
  63.  
  64.  You must then edit the DC.CFG file to suit. A sample DC.CFG file is included
  65.  below with explanations.
  66.  
  67.  
  68.  
  69.  
  70.  
  71. ; If you use FLM put the path and file name of your FLM log file in
  72. ; the following line then remove the leading ;
  73.  
  74. ;FLM f:\flm.log
  75.  
  76.  
  77. If you use FLM then users can log off from within FLM. To make sure these
  78. log-offs don't get included in the dropped carrier screens place the FULL
  79. path and name of your FLM log file in the line above.
  80.  
  81.  
  82. ; File name for .ANS/.ASC drop carrier screens - DO NOT ADD EXTENSION
  83. ;Default - DC.ANS/.ASC
  84.  
  85. FILENAME DC
  86.  
  87. If you don't want to use the file name DC.ANS/ASC then put the file name
  88. required in the line above.
  89.  
  90.  
  91. ; File name for .ANS/.ASC drop carrier screens - DO NOT ADD EXTENSION
  92. ;Default - DC1.ANS/.ASC
  93.  
  94. FILENAME DC1
  95.  
  96. As above only with the DC1.ANS/ASC screens
  97.  
  98.  
  99.  
  100. ; Show name of last caller ( Y/N )
  101.  
  102. LASTON Y
  103.  
  104.  
  105. This adds a line to the bottom of the screen showing the name of the last
  106. caller.
  107.  
  108.  
  109.  
  110. ; Show drop carriers for two days ? ( Y/N )
  111. ; ~N~ will just show todays carrier droppers
  112. ; ~Y~ will show yesterday + today
  113.  
  114. TWODAYS Y
  115.  
  116. This gives you the option of showing the dropped carrier for just today or
  117. for the last two days
  118. Y= last two days
  119. N= Today only
  120.  
  121.  
  122. ; List of callers you do not want to be named as carrier droppers
  123. ; You may list up to 20 names
  124. ; Remember to remove the ; from the start of the line
  125.  
  126. ; MISSNAME callers name#1
  127. ; MISSNAME callers name#2 etc.
  128. MISSNAME Colin Birch
  129.  
  130. A list of people which you DO NOT want listed as carrier droppers. These
  131. people will also NOT be listed in the last user section.
  132.  
  133.  
  134.  
  135. ; The following is for registered copies only
  136.  
  137.  
  138. ; User definable colours
  139.  
  140. ; Colour chart
  141. ;
  142. ;  0 - Black               8 - Dark Grey
  143. ;  1 - Blue                9 - Brt Blue
  144. ;  2 - Green              10 - Brt Green
  145. ;  3 - Cyan               11 - Brt Cyan
  146. ;  4 - Red                12 - Brt Red
  147. ;  5 - Magenta            13 - Brt Magenta
  148. ;  6 - Brown              14 - Yellow
  149. ;  7 - Light Grey         15 - White
  150.  
  151. BACKGROUND 0
  152. HEADERTEXT 2
  153. BBSTEXT 12
  154. DROPCAR 14
  155. SPEED 3
  156. NAME 11
  157. TIME 9
  158. UNDERLINE 14
  159. PRESS 7
  160. ENTER 14
  161.  
  162. The above should be obvious. It allows you to customise the colours to suit
  163. your BBS.
  164.  
  165.  
  166. ; Text to replace the line :- Carrier droppers on ~BBS name~ Today/Last 2 days
  167. ; use $BBS in the text where you want your BBS name to be
  168.  
  169. NEWTEXT
  170.  
  171.  
  172. You can change the text in the first line of the screens to any text. If you
  173. want to include your BBS name use the macro $BBS
  174.  
  175.  
  176. ; File name for highest carrier dropper chart - DO NOT ADD EXTENSION
  177. ; Default DROPTOT.ANS/.ASC
  178.  
  179. DROPTOT DROPTOT
  180.  
  181. If you don't want to use the file name DROPTOT.ANS/ASC then put the file name
  182. required in the line above.
  183.  
  184.  
  185. ; How long to keep a log of carrier droppers
  186. ; 0 = permanent
  187.  
  188. DAYSOLD 15
  189.  
  190. How many days old do you want to include entries in the DROPTOT.ANS/ASC
  191. screens. 
  192.  
  193.  
  194.  
  195. ; Archive type to use in RA.LOG maint section
  196. ; allowable archivers are:-
  197. ;
  198. ; ARJ ZIP LZH LHA RAR
  199. ;
  200. ; NOTE - The archive you wish to use MUST be in a DOS PATH
  201.  
  202. ARC ARJ
  203.  
  204.  
  205. The maint. section of DC.EXE will automatically remove entries in your RA.LOG
  206. file that are over one month old. This is to stop DC.EXE having to trawl
  207. through 6 months of RA.LOG just to find todays entries. Setting the ARC above
  208. defines which archiver type DC.EXE will use to backup the entries removed.
  209.  
  210.  
  211.  
  212. ; Security level drop after x carrier drops
  213. ; NUMBER ~no of carrier drops~ - ~new sec level~
  214. ; NUMBER 3 - 20 
  215. ; This would set a users security level to 20 after 3 carrier drops
  216. ; Up to 10 different levels may be used
  217.  
  218.  
  219. NUMBER 10 - 19
  220. ;NUMBER 5 - 18
  221.  
  222. This defines the number of dropped carriers before the users sec level is
  223. dropped. The first number is the number of dropped carriers, the second
  224. number is the new sec level. If you don't want this feature just place a
  225. semi-colon (;) in front of the word NUMBER
  226.  
  227.  
  228.  
  229. ; Create a log file in your LOGS directory of users whos SEC level has been
  230. ; dropped ?
  231.  
  232. NEWLOG Y
  233.  
  234. If you set this to Y a log file will be kept of all users whos sec level has
  235. been automatically altered
  236.  
  237.  
  238. ; USER flag to be set to ~X~ when a user drops carrier
  239.  
  240. SETFLAG A8
  241.  
  242. This sets a user flag to X when (s)he drops carrier. to disable place a
  243. semi colon (;) before the word SETFLAG
  244. Valid flags are A1 to 8, B1 to 8, C1 to 8 and D1 to 8
  245.  
  246.  
  247.  
  248. ; POSTCODE - This is used by your DC.KEY file
  249.  
  250. POSTCODE CF37 2AA
  251.  
  252.  
  253. If you register DC.EXE you must alter this to give YOUR postcode. this is
  254. used to validate the key file.
  255.  
  256.  
  257.  
  258.  
  259. How to run DC.EXE
  260. ~~~~~~~~~~~~~~~~~
  261.  
  262.  There are two ways to run DC.EXE. Both must be used to use all features
  263.  of DC.EXE
  264.  
  265. 1st.
  266.  
  267.  DC.EXE should be called each time a user logs off. Just add DC.EXE to your
  268.  BBS BAT file.
  269.  
  270. 2nd.
  271.  
  272.  During your daily maintainance, you should call DC.EXE/MAINT  This alters
  273.  the sec levels etc.
  274.  
  275.  
  276. Optional Switches
  277. ~~~~~~~~~~~~~~~~~
  278.  
  279. DC.EXE /N~node number~   - Multi Node setup Node 1 would be DC.EXE/N1
  280. DC.EXE /?                - Short online help screen
  281.  
  282.  
  283.  
  284. How do I register DC.EXE?
  285. ~~~~~~~~~~~~~~~~~~~~~~~~~
  286.  
  287.  Simply fill in the file REGISTER.TXT which is included in the archive along
  288.  with DC.EXE. If the file is missing please contact me at Fidonet 2:442/618
  289.  or The Dog House BBS - 01443 400327 - 24 Hours
  290.  
  291.  
  292. What do I get if I register?
  293. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  294.  
  295.  Well, first you get COLOUR in the .ANS screens instead of the boring grey
  296.  Not just colour, but USER DEFINABLE COLOURS!!!!
  297.  
  298.  Registered versions of DC.EXE also have the ability to change a sysop
  299.  definable user flag. This can then be used to show a screen to carrier
  300.  droppers.
  301.  
  302.  Registered versions also allow automatic security level changes after a
  303.  user has dropped carrier a sysop defined number of times.
  304.  
  305.  
  306. Thanks to:-
  307. ~~~~~~~~~~~
  308.  
  309.  Lez Crowther  of Big Rig BBS        - 01582 866794 - 24 hours
  310.  
  311.  and to all the people who support shareware!
  312.  
  313.  
  314. Disclaimer
  315. ~~~~~~~~~~
  316.  
  317.  Although I have tested this program thouroughly the only guarantee I make
  318.  is that DC.EXE and it's support files will take up hard disk space. I accept
  319.  no responsability of ANY loss or damage caused directly or indirectly from
  320.  using DC.EXE
  321.  
  322.  
  323. Shareware
  324. ~~~~~~~~~
  325.  
  326.  This program is SHAREWARE. If after a trial period of 10 days you continue
  327.  to use this program YOU MUST REGISTER IT. The authour retains full copyright
  328.  to the software and all it's support files.
  329.  
  330.  
  331. History
  332. ~~~~~~~
  333.  
  334.  V1.0  -  7  - May 1995 -  1st public release
  335.  V1.1  - 10  - May 1995 -  Small problem under very unusual conditions meant
  336.                            that some user flags were being changed when they
  337.                            shouldn't be
  338.  V1.2  -  2 - June 1995 -  Users whos names are in the MISSNAME section were
  339.                            still having their Sec levels reduced if they
  340.                            dropped carrier too many times.
  341.  V1.3  -  5 -  Dec 1995 -  Bluewave OLR support added. Previously, if a
  342.                            caller used the quick log-off feature of BW then
  343.                            he would be marked as a carrier dropper
  344.  V1.4  - 21 -  Feb 1996 -  DC.LOG now shows callers original sec level before
  345.                            they were dropped
  346.  V1.5  -  9 - July 1996 -  Multi-Node now catered for
  347.  
  348.