home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / CONV_15.ZIP / CONV!.DOC next >
Text File  |  1993-12-31  |  12KB  |  319 lines
  1.  
  2.  
  3.                        ============================
  4.                                 Convince!
  5.                        ============================
  6.                       COPYRIGHT 1992,94 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                  UltraBBS, Telegard, TriBBS, Remote Access.
  11.  
  12.                        VERSION 1.50     01/01/94
  13.  
  14.                                    By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                                  2 NODES
  28.                         1200/2400/9600/19200/38400
  29.                                24 Hours/Day
  30.  
  31. LATEST VERSION:
  32. ===============
  33.  
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36. LEGALITIES:
  37. ===========
  38.  
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  45.  
  46. DISTRIBUTION:
  47. =============
  48.  
  49. You may make this file available for downloading from your BBS or you may
  50. upload it to any BBS of your choice, provided that you do not make any
  51. changes to the contents of the archive (ZIP file). The archive and its
  52. individual contents may not be used by any service that charges any money
  53. whatsoever, without the written permission of the author.
  54.  
  55. PROGRAM DESCRIPTION:
  56. ====================
  57.  
  58. Convince! is a simple door program that you run before the real door or
  59. after the real door. Convince! tracks the number of times a user enters
  60. a door and after every 5 or 10 plays, presents him with a message saying
  61. "User Name you have played this door xx times. Please help contribute
  62. to register this door."
  63.  
  64. You can configure Convince to show this everytime (keeping tallies of
  65. all the plays), every 5 plays, or every 10 plays.
  66.  
  67. Via the CONV!.SPE file you can include "special users" that will not get
  68. the message.
  69.  
  70. You may also bypass users of specified security levels by adding the
  71. security level to the SECURE.DAT file. Just append the file to add
  72. security levels like this:
  73.  
  74. 100
  75. 120
  76. 1000
  77.  
  78. NOTE:
  79. =====
  80.  
  81. When you register, you will receive a CONV!.KEY file to unlock the
  82. full version of this door.
  83.  
  84. Convince! will only track up to 5 users until the door is registered.
  85.  
  86. FEATURES:
  87. =========
  88.            --- Desqview Aware.
  89.            --- COM0-15 support and non-standard IRQ's.
  90.            --- Colorful ANSI screens.
  91.            --- Chat function.
  92.            --- NO BRUN module needed for play.
  93.            --- BETA tested on five different boards.
  94.            --- Will return to BBS on dropped carrier.
  95.            --- Will TIMEOUT a player after 5 minutes of no activity.
  96.            --- Support BBS available.
  97.  
  98.  
  99. INSTALLATION:
  100. ============
  101.  
  102. Example configuration file for PCBOARD.SYS
  103. ------------------------------------------
  104.  
  105. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  106. T&J Software        <=-  (Change this to your BBS name)
  107. Tom                 <=-  (The Sysop's first name)
  108. Wildoner            <=-  (The Sysop's last name)
  109.  
  110. Example configuration file for USERS.SYS
  111. ----------------------------------------
  112.  
  113. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  114. T&J Software        <=-  (Change this to your BBS name)
  115. Tom                 <=-  (The Sysop's first name)
  116. Wildoner            <=-  (The Sysop's last name)
  117.  
  118. Example configuration file for DOOR.SYS
  119. ---------------------------------------
  120.  
  121. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  122. T&J Software        <=-  (Change this to your BBS name)
  123. Tom                 <=-  (The Sysop's first name)
  124. Wildoner            <=-  (The Sysop's last name)
  125.  
  126. Example configuration file for USERINFO.DAT
  127. -------------------------------------------
  128.  
  129. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  130. T&J Software        <=-  (Change this to your BBS name)
  131. Tom                 <=-  (The Sysop's first name)
  132. Wildoner            <=-  (The Sysop's last name)
  133. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  134.  
  135. Example configuration file for CALLINFO.BBS
  136. -------------------------------------------
  137.  
  138. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  139. T&J Software        <=-  (Change this to your BBS name)
  140. Tom                 <=-  (The Sysop's first name)
  141. Wildoner            <=-  (The Sysop's last name)
  142.  
  143. Example configuration file for DORINFOx.DEF
  144. -------------------------------------------
  145.  
  146. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  147.                           where 'x' is the BBS Node number.
  148. T&J Software        <=-  (Change this to your BBS name)
  149. Tom                 <=-  (The Sysop's first name)
  150. Wildoner            <=-  (The Sysop's last name)
  151.  
  152. Example configuration file for SFDOORS.DAT
  153. ------------------------------------------
  154.  
  155. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  156. T&J Software        <=-  (Change this to your BBS name)
  157. Tom                 <=-  (The Sysop's first name)
  158. Wildoner            <=-  (The Sysop's last name)
  159.  
  160. Example configuration file for GTUSER.BBS
  161. -----------------------------------------
  162.  
  163. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  164. T&J Software        <=-  (Change this to your BBS name)
  165. Tom                 <=-  (The Sysop's first name)
  166. Wildoner            <=-  (The Sysop's last name)
  167. 1                   <=-  (COM port number - defaults to 1)
  168. 1                   <=-  (Node number - defaults to 1)
  169.  
  170. Example Batch File
  171. ==================
  172.  
  173. A sample batch file is included and is similer to the following:
  174.    ECHO OFF
  175.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  176.    CONV! CONV!.CFG        <=- Execute the door program and pass the
  177.                                 configuration filename to the program.
  178.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  179.    BOARD                    <=- Restart BBS.
  180.  
  181. This Door is multi-node  compatible so you may run more than 1 node from
  182. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  183. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  184. variables, (q.v.)
  185.  
  186. Environment Variables
  187. =====================
  188.  
  189. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  190. variables. Non-PCBoard systems may also use these variables by including
  191. the following in either your BBS batch or AUTOEXEC.BAT
  192.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  193.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  194. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  195. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  196. .CFG file for multi-node operation!
  197.  
  198. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  199. command line.  For example:
  200.  
  201.      CONV! CONV!.CFG /5
  202. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  203.      CONV! CONV!.CFG /%IRQ%
  204.  
  205. This tells the program to use IRQ 5 instead of the standard IRQ.
  206.  
  207.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  208.  systems. Seems Novell also uses the / character so something went screwy
  209.  somewhere. So I added the * (asterisk) which may be used instead of the /
  210.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  211.  and are interchangeable.
  212.  
  213.  
  214. When specifying the location of the system file on line 1 of the doors .CFG
  215. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  216. and %wcnodeid%. Some examples:
  217.  PCBoard: 
  218.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  219.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  220.  
  221.  Wildcat!:
  222.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  223.  
  224. Non-PCBoard systems may use the PCB environment variables by setting them
  225. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  226.  SET PCBDRIVE=C:
  227.  SET PCBDIR=\BBSDIR
  228.  SET PCBNODE=1
  229.  
  230. Fossil Driver Support
  231. ---------------------
  232. Convince! supports the use of Fossil drivers.  To tell your Door to use the
  233. Fossil driver instead of the standard COM ports, just put /FD on the command
  234. line when running the door. For example:
  235.      MYDOOR MYDOOR.CFG /FD
  236. indicates that a Fossil driver is present and should be used. If no Fossil
  237. driver is detected, Convince! will print a message to that effect and exit
  238. the door gracefully.
  239.  
  240. Sysop Keys
  241. ==========
  242.  
  243. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  244.          written to DOOR.SYS and USERS.SYS
  245. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  246.          and/or written to DOOR.SYS and USERS.SYS
  247. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  248. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  249.          and/or written to DOOR.SYS and USERS.SYS
  250. F8    -  Returns the caller involuntarily to the BBS.
  251. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  252.          and/or written to DOOR.SYS and USERS.SYS
  253. F10   -  Activates SysOp CHAT mode within the DOOR.
  254. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  255. UP    -  Give the caller extra time while in the DOOR.  
  256. DN    -  Subtract time from the caller while in the DOOR. 
  257. HOME  -  HELP key for Status Line options.
  258. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  259. ALT-X -  PCBoard will exit after current caller logs off. Value is
  260.          passed to PCBoard. Not available on non-PCBoard systems.
  261.  
  262.  
  263. Next, you may add names to the CONV!.SPE file. Names listed in this
  264. file will not get any messages on door usage. This file must always
  265. be present -- so always keep at a minimum one name in it. Just add
  266. one name per line.
  267.  
  268. Finally, edit the CONV!.SYS file. Enter one of three numbers....
  269.  
  270. 0  = Show door usage to the player everytime.
  271. 5  = Show door usage to the player every 5 times he enters the door.
  272. 10 = Show door usage to the player every 10 times he enters the door.
  273.  
  274.  
  275. To run in LOCAL mode simply type CONV! LOCAL
  276.  
  277.  
  278. RESETTING:
  279. =========
  280. Simply delete the file CONV!.USR.
  281.  
  282. UPPGRADING:
  283. ==========
  284. Simply replace the main .EXE file and delete the CONV!.USR file!
  285.  
  286.  
  287. FUTURE VERSIONS:
  288. ================
  289.  
  290. --->> Let me know what you would like to see added!!
  291.  
  292.  
  293. VERSION HISTORY:
  294. ===============
  295. Version 1.00 ......... First release. 05-15-92
  296. Version 1.10 ......... Updated to new door routines. 10-12-1992
  297. Version 1.20 ......... Updated  routines, added support for fossil
  298.                        drivers. 11-27-1992
  299. Version 1.30 ......... Added support for COM0-15, made a change in
  300.                        how names are read in, some BBS packages add
  301.                        a space to the end of the users name.
  302. Version 1.40 ......... Added better support for WC! IM and PCB/M
  303.                        versions, now will support mono and color
  304.                        users, better error handling routines.
  305.                        08-11-1993
  306. Version 1.50 ......... Upgraded to DoorFrameX v3.1 routines. Changed
  307.                        the format of the user record file. Added
  308.                        security level bypassing by entering the
  309.                        security level in the SECURE.DAT file.
  310.                        01-01-94
  311.  
  312. REGISTERING:
  313. ============
  314. That's all there is to it! If you have any problems or questions
  315. please feel free to call the T&J BBS at (717)325-9481 and join the
  316. T&J Software Conference.
  317.  
  318. See the enclosed registration form for ordering!  (REGISTER.TXT)
  319.