home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / NWSMAN12.ZIP / NWSMAN.DOC < prev    next >
Encoding:
Text File  |  1993-07-14  |  18.4 KB  |  507 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                               NEWS MANAGER
  11.  
  12.                               version  1.0
  13.  
  14.                                    by
  15.  
  16.                               Mike Weaver
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                CONTENTS
  27.                                ========
  28.                                                                              
  29.                               Overview
  30.                               Copyright
  31.                               Warranty
  32.                               Distribution
  33.                               Registration
  34.                               List of files in archive
  35.                               Configuration Files
  36.                               Environment Variables
  37.                               Batch File
  38.                               Sysop Keys
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                  OVERVIEW
  50.                                  --------
  51.  
  52. News Manager is a utility for PCBoard 14.x, although it has not been tested
  53. on any other systems it should work fine with any system that can produce
  54. a DOOR.SYS, PCBOARD.SYS, USERINFO.DAT, DORINFOx.DEF, CALLINFO.BBS and a
  55. few others.
  56.  
  57. News Manager allows the SysOp or a person picked by the SysOp to maintain
  58. multiple text files on the BBS from a remote location.  You can add to or
  59. delete NEWS, SECURITY files, or any other text file that you list in the
  60. config file.  The first release of News Manager has no bells or whistles.
  61. It was written to solve a need I had on my BBS, so if you like the program
  62. and have any ideas for improvement let me know.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                Copyright
  72.                                ---------
  73.  
  74. NEWS MANAGER, Copyright (c) 1992 by Mike Weaver, is being distributed as
  75. Shareware.  Under this concept you may use the  SHAREWARE (unregistered)
  76. version for a  reasonable period of  time for evaluation after which you
  77. must either register your copy or discontinue  usage.
  78.  
  79.  
  80.  
  81.                          DISCLAIMER - WARRANTY
  82.                          ~~~~~~~~~~~~~~~~~~~~~
  83. This product is provided as is without warranty of any kind.  The entire
  84. risk as to the results and performance of the program is assumed by you.
  85. Futhermore, the  author does not warrant, guarantee, or  make any  other
  86. representations regarding the use of,  or the  results of the use of the
  87. program,  and you rely on the  program and  results  solely at  your own
  88. risk.  The author  cannot and will not accept  responsibility for system
  89. damage, loss of profit or any other special, consequential or incidental 
  90. damages  resulting  from  the use of or inability to  use this  product.
  91.  
  92.  
  93.  
  94.                              Distribution
  95.                              ------------
  96.  
  97. This program is being distributed via the SHAREWARE concept and as such,
  98. may be copied freely with the following restrictions:
  99.  
  100.         * The program must be supplied in it's original unmodified
  101.           form, including documentation.
  102.  
  103.         * This program may not be distributed as part of any commercial
  104.           application or service without the express, written consent
  105.           of the author.
  106.  
  107.         * Vendors of Shareware/Public Domain software may not
  108.           distribute this program without the express, written
  109.           consent of the author.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                              Registration
  118.                              ------------
  119.  
  120. This door represents  many hours of  programming and the author deserves
  121. just compensation for his time, efforts and expertise.  If you find this
  122. program to be of some  value and you  continue to use it on your system,
  123. you must return the order form provided along with the registration fee.
  124. Registration entitles you to free upgrades via modem from The NITE-LITE.
  125. Payments should be  made in the  form of a check or money order.
  126.  
  127.                 The NITE-LITE bbs: (615) 458-9099 v.32bis
  128.  
  129. NOTE: After I recieve your registration fee,  your registration number
  130.       will be posted in a private message on The NITE-LITE.
  131.  
  132.         I have not crippled this program in any way, so you can use it
  133.         forever if you like.  However be forewarned that unless you
  134.         register I may not be apt to answer questions as freely.  I
  135.         too however realize the cost of running a BBS so I ask only a
  136.         mere $10 if you like and use the program.  If you do not like
  137.         the program and have an idea that would make it more likeable
  138.         by all means let me know and I will try to implement it.
  139.  
  140.                       List of Files in archive:
  141.                       -------------------------
  142.           Sample.cfg                             Nwsman.doc
  143.           Nwsman.exe                             Nwsman.
  144.           File_id.diz        NiteLite.txt        History.doc
  145.  
  146. SAMPLE.CFG    This is the door configuration file.  The one included in
  147.               this archive is a sample and will have to be edited to fit
  148.               your system.
  149. NWSMAN.DOC    Three guesses and the first 2 don't count. <Grin>
  150. NWSMAN.EXE    The executable door program itself.  This door is a stand
  151.               alone program that requires no other files such as DoorPatch
  152.               or Brun. I wrote this door using DoorFrame 3.8
  153. NWSMAN.       This is a sample batch file to run the door on PCBoard
  154.               systems.  You may have to edit it depending on where you
  155.               store the door files etc.
  156. FILE_ID.DIZ   This file contains program descriptions for boards that
  157.               implement automatic file description insertion with a
  158.               program such as PCBDescribe(tm).
  159. NITELITE.TXT  This is a small ad for my BBS.
  160. HISTORY.DOC   A list of corrections or bug fixes or changes in NEWS MANAGER
  161.  
  162.  
  163.  
  164. Example configuration file for|PCBOARD.SYS|
  165. ------------------------------------------
  166.  
  167. C:\PCB\PCBOARD.SYS    <=-  (Full pathname of your PCBOARD.SYS file)
  168. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  169. Mike                  <=-  (The Sysop's first name)
  170. Weaver                <=-  (The Sysop's last name)
  171. 662345922             <=-  (Your registration #)  Use this one till you get one
  172. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  173. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  174. User Defined 1        <=-  (Title text for user defined file to maintain)
  175. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  176. User Defined 2        <=-  (Title text for user defined file to maintain)
  177. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186. Example configuration file for|USERS.SYS|
  187. ------------------------------------------
  188.  
  189. C:\PCB\USERS.SYS      <=-  (Full pathname of your USERS.SYS file)
  190. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  191. Mike                  <=-  (The Sysop's first name)
  192. Weaver                <=-  (The Sysop's last name)
  193. 662345922             <=-  (Your registration #)  Use this one till you get one
  194. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  195. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  196. User Defined 1        <=-  (Title text for user defined file to maintain)
  197. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  198. User Defined 2        <=-  (Title text for user defined file to maintain)
  199. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209. Example configuration file for|DOOR.SYS|
  210. ---------------------------------------
  211.  
  212. C:\BBS\DOOR.SYS       <=-  (Full pathname of your DOOR.SYS file)
  213. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  214. Mike                  <=-  (The Sysop's first name)
  215. Weaver                <=-  (The Sysop's last name)
  216. 662345922             <=-  (Your registration #)  Use this one till you get one
  217. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  218. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  219. User Defined 1        <=-  (Title text for user defined file to maintain)
  220. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  221. User Defined 2        <=-  (Title text for user defined file to maintain)
  222. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Example configuration file for|USERINFO.DAT|
  233. -------------------------------------------
  234.  
  235. C:\BBS\USERINFO.DAT   <=-  (Full pathname of your USERINFO.DAT file)
  236. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  237. Mike                  <=-  (The Sysop's first name)
  238. Weaver                <=-  (The Sysop's last name)
  239. 662345922             <=-  (Your registration #)  Use this one till you get one
  240. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  241. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  242. User Defined 1        <=-  (Title text for user defined file to maintain)
  243. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  244. User Defined 2        <=-  (Title text for user defined file to maintain)
  245. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  246.  
  247. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255. Example configuration file for|CALLINFO.BBS|
  256. -------------------------------------------
  257.  
  258. C:\BBS\CALLINFO.BBS   <=-  (Full pathname of your CALLINFO.BBS file)
  259. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  260. Mike                  <=-  (The Sysop's first name)
  261. Weaver                <=-  (The Sysop's last name)
  262. 662345922             <=-  (Your registration #)  Use this one till you get one
  263. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  264. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  265. User Defined 1        <=-  (Title text for user defined file to maintain)
  266. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  267. User Defined 2        <=-  (Title text for user defined file to maintain)
  268. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278. Example configuration file for|DORINFOx.DEF|
  279. -------------------------------------------
  280.  
  281. C:\BBS\DORINFOx.DEF   <=-  (Full pathname of your DORINFOx.DEF file)
  282.                       <=-  (Change this to your BBS name)
  283. The NITE-LITE bbs     <=-  (The Sysop's first name)
  284. Mike                  <=-  (The Sysop's last name)
  285. Weaver                <=-  (Your registration #)  Use this one till you get one
  286. 662345922             <=-  (Location of your file directory menu)
  287. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  288. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  289. User Defined 1        <=-  (Title text for user defined file to maintain)
  290. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  291. User Defined 2        <=-  (Title text for user defined file to maintain)
  292. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301. Example configuration file for|SFDOORS.DAT|
  302. ------------------------------------------
  303.  
  304. C:\BBS\SFDOORS.DAT    <=-  (Full pathname of your SFDOORS.DAT file)
  305. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  306. Mike                  <=-  (The Sysop's first name)
  307. Weaver                <=-  (The Sysop's last name)
  308. 662345922             <=-  (Your registration #)  Use this one till you get one
  309. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  310. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  311. User Defined 1        <=-  (Title text for user defined file to maintain)
  312. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  313. User Defined 2        <=-  (Title text for user defined file to maintain)
  314. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324. Example configuration file for|CHAIN.TXT|
  325. ----------------------------------------
  326.  
  327. C:\BBS\CHAIN.TXT      <=-  (Full pathname of your CHAIN.TXT file)
  328. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  329. Mike                  <=-  (The Sysop's first name)
  330. Weaver                <=-  (The Sysop's last name)
  331. 662345922             <=-  (Your registration #)  Use this one till you get one
  332. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  333. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  334. User Defined 1        <=-  (Title text for user defined file to maintain)
  335. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  336. User Defined 2        <=-  (Title text for user defined file to maintain)
  337. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347. Example configuration file for|TRIBBS.SYS|
  348. ----------------------------------------
  349.  
  350. C:\BBS\TRIBBS.SYS     <=-  (Full pathname of your TRIBBS.SYS file)
  351. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  352. Mike                  <=-  (The Sysop's first name)
  353. Weaver                <=-  (The Sysop's last name)
  354. 662345922             <=-  (Your registration #)  Use this one till you get one
  355. c:\pcb\gen\news       <=-  (Location and filename of main board news file)
  356. c:\pcb\gen\20         <=-  (Location and filename of security specific file)
  357. User Defined 1        <=-  (Title text for user defined file to maintain)
  358. c:\pcb\gen\news10     <=-  (Location and filename of 1st defineable file)
  359. User Defined 2        <=-  (Title text for user defined file to maintain)
  360. c:\pcb\gen\news13     <=-  (Location and filename of 2nd defineable file)
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370. Line 1 ->  Is the location of your BBS info file. The program requires
  371.            the complete path and filename. I recommend using USERS.SYS
  372.            for PCBoard use.
  373. Line 2 ->  The name of your BBS goes here.
  374. Line 3 ->  The SysOp's first name.
  375. Line 4 ->  The SysOp's last name.
  376. Line 5 ->  This is where you put your serial number once you register the
  377.            program.  Until then use any 9 digit number you like but don't
  378.            leave this line out or the door will crash!
  379. Line 6 ->  This is the location of your main board news file.  The example
  380.            above is from my system, use whatever you use in PCBSetup.
  381. Line 7 ->  This is the location of the Security specific file you wish to
  382.            maintain.
  383. Line 8 ->  This line is for the header text for the first user defineable
  384.            file you want to maintain.  Example:  Conference 10 News
  385. Line 9 ->  This is the location of the file you chose in the previous
  386.            line.
  387. Line 10->  This line is for the header text for the 2nd user defineable
  388.            file you want to maintain.  Example:  Conference 13 News
  389. Line 11->  This is the location of the file you chose in the previous
  390.            line.
  391.  
  392.  
  393.                          Environment Variables
  394.                          ---------------------
  395.  
  396. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  397. variables. Non-PCBoard systems may also use these variables by including
  398. the following in either your BBS batch or AUTOEXEC.BAT
  399.  
  400.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  401.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  402.  
  403. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  404. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  405. .CNF file for multi-node operation!
  406.  
  407. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  408. command line.  For example:
  409.  
  410.      NWSMAN NWSMAN.CNF /5
  411.  
  412. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  413.  
  414.      NWSMAN NWSMAN.CNF /%IRQ%
  415.  
  416. This tells the program to use IRQ 5 instead of the standard IRQ.
  417.  
  418.  
  419. !!!! I have only run and tested this door with PCBoard 14.5a and I cannot !!!!
  420. !!!! attest to its ability to run on any other systems. Consider yourself !!!!
  421. !!!! warned in advance.                                                   !!!!
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.                           Example Batch File
  440.                          -------------------
  441.  
  442. A sample batch file is included and is similer to the following:
  443.  
  444.    ECHO OFF
  445.    CD\DOORS\NWSMAN          <=- Switch to the door's Directory.
  446.    NWSMAN NWSMAN.CNF        <=- Execute the door program and pass the
  447.                                 configuration filename to the program.
  448.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  449.    BOARD                    <=- Restart BBS.
  450.  
  451. This Door is multi-node  compatible so you may run more than 1 node from
  452. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  453. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  454. variables, (q.v.)
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                               Sysop Keys
  463.                               ----------
  464. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  465.          written to DOOR.SYS and USERS.SYS
  466. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  467.          and/or written to DOOR.SYS and USERS.SYS
  468. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  469. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  470.          and/or written to DOOR.SYS and USERS.SYS
  471. F8    -  Returns the caller involuntarily to the BBS.
  472. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  473.          and/or written to DOOR.SYS and USERS.SYS
  474. F10   -  Activates SysOp CHAT mode within the DOOR.
  475. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  476. UP    -  Give the caller extra time while in the DOOR.  
  477. DN    -  Subtract time from the caller while in the DOOR. 
  478. HOME  -  HELP key for Status Line options.
  479. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  480. ALT-X -  PCBoard will exit after current caller logs off. Value is
  481.          passed to PCBoard. Not available on non-PCBoard systems.
  482.  
  483.  
  484.  
  485. One last thing I am terrible at writing so if these docs seem hard to read
  486. or use it is probably because they are. <GRIN>
  487.  
  488.  
  489.                                CREDITS
  490.                                -------
  491.  
  492.         I want to thank Ted Freeman for his great program DoorFrame,
  493.         as well as for his never ending help as I tried to build
  494.         without the proper tools. <G>
  495.  
  496.  
  497.                      OK I'm finished, send the millions to:
  498.  
  499.                                 Mike Weaver
  500.                                 % The NITE-LITE bbs
  501.                                 Rt. 1 Box 231b
  502.                                 159 Moatsewell Rd.
  503.                                 Philadelphia, Tn.
  504.                                                37846
  505.  
  506.  
  507.