home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / ANN37.ZIP / ANN.DOC < prev    next >
Text File  |  1993-12-29  |  10KB  |  235 lines
  1.  
  2.  
  3.                           The Annoncement Door!
  4.                               Version 3.70
  5.  
  6.                       COPYRIGHT 1991,94 T&J Software
  7.  
  8.                                 01/01/94
  9.  
  10.         One of the T&J Software Collection of multi-BBS door programs.
  11.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  12.               UltraBBS, Telegard, TriBBS, and Remote Access.
  13.  
  14.                                   by
  15.  
  16.                               T&J Software
  17.                              (717)325-9481
  18.                                  24H/7D
  19.                        Hayes Optima 14.4 (2 lines)
  20.  
  21.                            397 West Broadway
  22.                           Jim Thorpe, PA 18229
  23.                           (717)325-9480 VOICE
  24.                      6:00 to 9:00 p.m. Eastern Time
  25.  
  26.  
  27. LATEST VERSION:
  28. Please call the T&J BBS for the latest version of this program.
  29.  
  30. LEGALITIES:
  31. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  32. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  33. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  34. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  35. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  36. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  37.  
  38. DISTRIBUTION:
  39. You may make this file available for downloading from your BBS or you may
  40. upload it to any BBS of your choice, provided that you do not make any
  41. changes to the contents of the archive (ZIP file). The archive and its
  42. individual contents may not be used by any service that charges any money
  43. whatsoever, without the written permission of the author.
  44.  
  45. PROGRAM DESCRIPTION:
  46. My users contribute to registering door programs. I made this simple
  47. door as a way for all users to see who payed to have each door
  48. registered. There is no fee for this door.
  49.  
  50. You can also use it as a COMMENT FROM THE SYSOP about the door that
  51. the person is entering.
  52.  
  53. To try the door locally simply run ANN LOCAL.
  54.  
  55.  
  56. NOTE: When making your ANNOUNCE.ANS and your ANNOUNCE.ASC screens using
  57.       your drawing package, try leaving the top three lines and bottom
  58.       three lines blank. Also, when saving your screen be sure not to
  59.       include a clear screen command. Save the screen with a "home cursor".
  60.       If you are using TheDraw greater than version 3.3 use a "block save"
  61.       to save your screen.
  62.  
  63. A new item has been added in v3.7+. If you make a file called
  64. DELAY.DAT and put a number in it such as 10, Announce will delay the
  65. screen for that many seconds instead of putting up the ENTER prompt.
  66.  
  67. CONFIGURATION: (ANN.CFG)
  68. =============
  69.  
  70. Example configuration file for PCBOARD.SYS
  71. ------------------------------------------
  72.  
  73. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  74. T&J Software        <=-  (Change this to your BBS name)
  75. Tom                 <=-  (The Sysop's first name)
  76. Wildoner            <=-  (The Sysop's last name)
  77.  
  78. Example configuration file for USERS.SYS
  79. ----------------------------------------
  80.  
  81. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  82. T&J Software        <=-  (Change this to your BBS name)
  83. Tom                 <=-  (The Sysop's first name)
  84. Wildoner            <=-  (The Sysop's last name)
  85.  
  86. Example configuration file for DOOR.SYS
  87. ---------------------------------------
  88.  
  89. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  90. T&J Software        <=-  (Change this to your BBS name)
  91. Tom                 <=-  (The Sysop's first name)
  92. Wildoner            <=-  (The Sysop's last name)
  93.  
  94. Example configuration file for USERINFO.DAT
  95. -------------------------------------------
  96.  
  97. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  98. T&J Software        <=-  (Change this to your BBS name)
  99. Tom                 <=-  (The Sysop's first name)
  100. Wildoner            <=-  (The Sysop's last name)
  101. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  102.  
  103. Example configuration file for CALLINFO.BBS
  104. -------------------------------------------
  105.  
  106. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110.  
  111. Example configuration file for DORINFOx.DEF
  112. -------------------------------------------
  113.  
  114. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  115.                           where 'x' is the BBS Node number.
  116. T&J Software        <=-  (Change this to your BBS name)
  117. Tom                 <=-  (The Sysop's first name)
  118. Wildoner            <=-  (The Sysop's last name)
  119.  
  120. Example configuration file for SFDOORS.DAT
  121. ------------------------------------------
  122.  
  123. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  124. T&J Software        <=-  (Change this to your BBS name)
  125. Tom                 <=-  (The Sysop's first name)
  126. Wildoner            <=-  (The Sysop's last name)
  127.  
  128. Example configuration file for GTUSER.BBS
  129. -----------------------------------------
  130.  
  131. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  132. T&J Software        <=-  (Change this to your BBS name)
  133. Tom                 <=-  (The Sysop's first name)
  134. Wildoner            <=-  (The Sysop's last name)
  135. 1                   <=-  (COM port number - defaults to 1)
  136. 1                   <=-  (Node number - defaults to 1)
  137.  
  138. Example Batch File
  139. ==================
  140.  
  141. A sample batch file is included and is similer to the following:
  142.    ECHO OFF
  143.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  144.    ANN ANN.CFG              <=- Execute Announce!
  145.    LEMON33 LEMON.CFG        <=- Execute the door program and pass the
  146.                                 configuration filename to the program.
  147.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  148.    BOARD                    <=- Restart BBS.
  149.  
  150. This Door is multi-node  compatible so you may run more than 1 node from
  151. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  152. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  153. variables, (q.v.)
  154.  
  155. Environment Variables
  156. =====================
  157.  
  158. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  159. variables. Non-PCBoard systems may also use these variables by including
  160. the following in either your BBS batch or AUTOEXEC.BAT
  161.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  162.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  163. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  164. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  165. .CFG file for multi-node operation!
  166.  
  167. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  168. command line.  For example:
  169.  
  170.      ANN ANN.CFG /5
  171. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  172.      ANN ANN.CFG /%IRQ%
  173.  
  174. This tells the program to use IRQ 5 instead of the standard IRQ.
  175.  
  176.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  177.  systems. Seems Novell also uses the / character so something went screwy
  178.  somewhere. So I added the * (asterisk) which may be used instead of the /
  179.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  180.  and are interchangeable.
  181.  
  182. When specifying the location of the system file on line 1 of the doors .CFG
  183. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  184. and %wcnodeid%. Some examples:
  185.  PCBoard: 
  186.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  187.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  188.  
  189.  Wildcat!:
  190.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  191.  
  192. Non-PCBoard systems may use the PCB environment variables by setting them
  193. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  194.  SET PCBDRIVE=C:
  195.  SET PCBDIR=\BBSDIR
  196.  SET PCBNODE=1
  197.  
  198. Fossil Driver Support
  199. ---------------------
  200. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  201. Fossil driver instead of the standard COM ports, just put /FD on the command
  202. line when running the door. For example:
  203.      MYDOOR MYDOOR.CFG /FD
  204. indicates that a Fossil driver is present and should be used. If no Fossil
  205. driver is detected, DoorFrame will print a message to that effect and exit
  206. the door gracefully.
  207.  
  208.  
  209. Sysop Keys
  210. ==========
  211.  
  212. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  213.          written to DOOR.SYS and USERS.SYS
  214. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  215.          and/or written to DOOR.SYS and USERS.SYS
  216. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  217. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  218.          and/or written to DOOR.SYS and USERS.SYS
  219. F8    -  Returns the caller involuntarily to the BBS.
  220. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  221.          and/or written to DOOR.SYS and USERS.SYS
  222. F10   -  Activates SysOp CHAT mode within the DOOR.
  223. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  224. UP    -  Give the caller extra time while in the DOOR.  
  225. DN    -  Subtract time from the caller while in the DOOR. 
  226. HOME  -  HELP key for Status Line options.
  227. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  228. ALT-X -  PCBoard will exit after current caller logs off. Value is
  229.          passed to PCBoard. Not available on non-PCBoard systems.
  230.  
  231. If you have any problems/suggestions please feel free to contact The
  232. T&J BBS.
  233.  
  234. See the REGISTER.TXT file for other programs from T&J Software!
  235.