home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / ATW17.ZIP / TJMAG.DOC < prev    next >
Text File  |  1996-07-27  |  13KB  |  330 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │  Across The Wire Magazine  │
  5.                       │============================│
  6.                       │COPYRIGHT 1996 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, and Remote Access.
  11.  
  12.  
  13.                     VERSION 1.20 BETA 2     01/25/96
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 6:00 & 8:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                            The T&J Software BBS
  27.                         NODE 1: (717)325-9481 28.8k
  28.                         NODE 2: (717)325-4369 28.8k
  29.                         NODE 3: (717)325-2054 28.8k
  30.                                24 Hours/Day
  31.  
  32.                  INTERNET:  tjsoft@postoffice.ptd.net
  33.                      FIDO:  1:268/400
  34.                       FTP:  ftp.europa.com /outgoing/DOORS/tj-software
  35.                       FTP:  ftp.thekeep.com /TJ-Software
  36.  
  37.                      FREQ: ATW for the full door
  38.                      FREQ: ATWDATA for the monthly articles
  39.                            only. You will need to FREQ ATW
  40.                            if you don't have it setup!
  41.  
  42. NOTE:
  43. ~~~~~
  44. This is a special beta version of the ATW reader door! This version
  45. incorporates reading of back issues online and the ability of downloading
  46. articles directly from the door.
  47.  
  48. Starting with this issue, you must be running v1.20+ of the door reader
  49. to read articles. Please FREQ TJATW from 1:268/400 for a complete listing
  50. of ATW files available including updated back issues that will work with
  51. the door!
  52.  
  53. LATEST VERSION:
  54. ^^^^^^^^^^^^^^^
  55. Please call the T&J BBS for the latest version of this program.
  56.  
  57. LEGALITIES:
  58. ^^^^^^^^^^^
  59. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  60. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  61. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  62. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  63. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  64. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  65.  
  66. DISTRIBUTION:
  67. ^^^^^^^^^^^^^
  68. Please feel free to distribute this door.
  69.  
  70. PROGRAM DESCRIPTION:
  71. ^^^^^^^^^^^^^^^^^^^^
  72. Free monthly online magazine for any BBS that wishes to carry it!
  73.  
  74. DOWNLOADING ARTICLES:
  75. ~~~~~~~~~~~~~~~~~~~~~
  76. To download articles from the door, a NODEx.CFG file must be created
  77. for each remote node (the 'x' represents the node number). Here's an
  78. example of the NODEx.CFG file:
  79.  
  80. The only line required is listed below. This specifies to use DSZ with a
  81. particular base address and IRQ for that base address.
  82.  
  83. DSZ 3F8,4
  84.  
  85. Command Line:
  86.         You may use DSZ or GSZ, simply replace the item on the
  87.         command line.
  88.  
  89.         2F8,3 represents the BASE and IRQ for COM2. You need to change
  90.         this depending upon your hardware configuration. You will nee
  91.         a NODE<nodenumber>.CFG file for each node.
  92.  
  93.         COM1      3F8,4 ─┐ Standard
  94.         COM2      2F8,3 ─┘
  95.         COM3      3E8,<IRQ> ─┐Put correct IRQ number
  96.         COM4      2E8,<IRQ> ─┘instead of <IRQ>
  97.  
  98.         You should read the DSZ/GSZ documentation and the
  99.         X00.SYS DOCs for further details.  You should also have
  100.         DSZ.COM or GSZ.COM located in a directory that is in
  101.         your path.  Users will be given a choice of ZMODEM,
  102.         XMODEM, or YMODEM. I wholeheartedly recommend that you
  103.         register DSZ or GSZ from Chuck Forsberg if you intend
  104.         to use it.
  105.  
  106. If you cannot find the most recent version of DSZ, please call our BBS
  107. and check the Communications File Area for a file called DSZ*.ZIP.
  108.  
  109. If you don't want to allow downloading of articles, or have no support
  110. on your BBS package for downloading, create a file in the ATW directory
  111. called NODL.DAT. It doesn't matter what this file conatins, only that
  112. it is present in the directory - this will disable downloading of
  113. articles.
  114.  
  115. TEXT COLOR:
  116. ^^^^^^^^^^^
  117. Simply edit the file COLOR.DAT, lines 1 and 2. Here's the file:
  118.  
  119. 14
  120. 3
  121.  
  122. Line 1: Foreground Color
  123. Line 2: Background Color
  124.  
  125. Foreground:   15 = Bright White     Background: 7 = Default White
  126.               14 = Bright Yellow                6 = Light Yellow
  127.               13 = Bright Purple                5 = Light Purple
  128.               12 = Bright Red                   4 = Light Red
  129.               11 = Bright Cyan                  3 = Light Cyan
  130.               10 = Bright Green                 2 = Light Green
  131.                9 = Bright Blue                  1 = Light Blue
  132.                8 = Dark Grey
  133.                7 = Default White
  134.                6 = Light Yellow
  135.                5 = Light Purple
  136.                4 = Light Red
  137.                3 = Light Cyan
  138.                2 = Light Green
  139.                1 = Light Blue
  140.  
  141. CONFIGURATION: (The TJMAG.CFG file)
  142. ^^^^^^^^^^^^^^
  143. Run --->  TJMAG UTILITY   to easily setup your TJMAG.CFG file!
  144.  
  145.  
  146. Example configuration file for PCBOARD.SYS
  147. ------------------------------------------
  148. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  149. T&J Software        <=-  (Change this to your BBS name)
  150. Tom                 <=-  (The Sysop's first name)
  151. Wildoner            <=-  (The Sysop's last name)
  152.  
  153. Example configuration file for USERS.SYS
  154. ----------------------------------------
  155. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS 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 DOOR.SYS
  161. ---------------------------------------
  162. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  163. T&J Software        <=-  (Change this to your BBS name)
  164. Tom                 <=-  (The Sysop's first name)
  165. Wildoner            <=-  (The Sysop's last name)
  166.  
  167. Example configuration file for USERINFO.DAT
  168. -------------------------------------------
  169. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  170. T&J Software        <=-  (Change this to your BBS name)
  171. Tom                 <=-  (The Sysop's first name)
  172. Wildoner            <=-  (The Sysop's last name)
  173. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  174.  
  175. Example configuration file for CALLINFO.BBS
  176. -------------------------------------------
  177. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  178. T&J Software        <=-  (Change this to your BBS name)
  179. Tom                 <=-  (The Sysop's first name)
  180. Wildoner            <=-  (The Sysop's last name)
  181.  
  182. Example configuration file for DORINFOx.DEF
  183. -------------------------------------------
  184. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  185.                           where 'x' is the BBS Node number.
  186. T&J Software        <=-  (Change this to your BBS name)
  187. Tom                 <=-  (The Sysop's first name)
  188. Wildoner            <=-  (The Sysop's last name)
  189.  
  190. Example Batch File
  191. ^^^^^^^^^^^^^^^^^^
  192. A sample batch file is included and is similer to the following:
  193.    ECHO OFF
  194.    CD\DOORS\TJMAG           <=- Switch to the door's Directory.
  195.    TJMAG TJMAG.CFG          <=- Execute the door program and pass the
  196.                                 configuration filename to the program.
  197.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  198.    BOARD                    <=- Restart BBS.
  199.  
  200.  
  201. This Door is multi-node  compatible so you may run more than 1 node from
  202. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  203. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  204. variables, (q.v.)
  205.  
  206. Normally, when running multinode, just setup different TJMAG.CFG files
  207. for each node:   TJMAG1.CFG   TJMAG2.CFG  etc....
  208.  
  209.  
  210. Environment Variables
  211. ^^^^^^^^^^^^^^^^^^^^^
  212. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  213. variables. Non-PCBoard systems may also use these variables by including
  214. the following in either your BBS batch or AUTOEXEC.BAT
  215.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  216.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  217. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  218. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  219. .CFG file for multi-node operation!
  220.  
  221. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  222. command line.  For example:
  223.  
  224.      TJMAG TJMAG.CFG /5
  225. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  226.      TJMAG TJMAG.CFG /%IRQ%
  227.  
  228. This tells the program to use IRQ 5 instead of the standard IRQ.
  229.  
  230.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  231.  systems. Seems Novell also uses the / character so something went screwy
  232.  somewhere. So I added the * (asterisk) which may be used instead of the /
  233.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  234.  and are interchangeable.
  235.  
  236. When specifying the location of the system file on line 1 of the doors .CFG
  237. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  238. and %wcnodeid%. Some examples:
  239.  PCBoard: 
  240.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  241.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  242.  
  243.  Wildcat!:
  244.    USERINFO.DAT in C:\WILDCAT\WCWORK\NODE1
  245.  
  246.                    C:\WILDCAT\WCWORK\NODE%wcnodeid%\USERINFO.DAT
  247.  
  248.  
  249.    DOOR.SYS in C:\WILDCAT\WCWORK\NODE1
  250.  
  251.                    C:\WILDCAT\WCWORK\NODE%wcnodeid%\DOOR.SYS
  252.  
  253. Non-PCBoard systems may use the PCB environment variables by setting them
  254. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  255.  SET PCBDRIVE=C:
  256.  SET PCBDIR=\BBSDIR
  257.  SET PCBNODE=1
  258.  
  259. Fossil Driver Support
  260. ^^^^^^^^^^^^^^^^^^^^^
  261. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  262. Fossil driver instead of the standard COM ports, just put /FD on the command
  263. line when running the door. For example:
  264.      MYDOOR MYDOOR.CFG /FD
  265. indicates that a Fossil driver is present and should be used. If no Fossil
  266. driver is detected, DoorFrame will print a message to that effect and exit
  267. the door gracefully.
  268.  
  269. Sysop Keys
  270. ^^^^^^^^^^
  271. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  272.          written to DOOR.SYS and USERS.SYS
  273. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  274.          and/or written to DOOR.SYS and USERS.SYS
  275. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  276. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  277.          and/or written to DOOR.SYS and USERS.SYS
  278. F8    -  Returns the caller involuntarily to the BBS.
  279. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  280.          and/or written to DOOR.SYS and USERS.SYS
  281. F10   -  Activates SysOp CHAT mode within the DOOR.
  282. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  283. UP    -  Give the caller extra time while in the DOOR.  
  284. DN    -  Subtract time from the caller while in the DOOR. 
  285. HOME  -  HELP key for Status Line options.
  286. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  287. ALT-X -  PCBoard will exit after current caller logs off. Value is
  288.          passed to PCBoard. Not available on non-PCBoard systems.
  289.  
  290. PROBLEMS:
  291. ^^^^^^^^^
  292. See the TJHELP.TXT file!
  293. Please feel free to contact me if you have any problems at all.
  294.  
  295. MAINTENANCE:
  296. ^^^^^^^^^^^^
  297. No nightly maintenance required.
  298.  
  299. RUNNING LOCALLY:
  300. ^^^^^^^^^^^^^^^^
  301. To run in LOCAL mode simply type TJMAG LOCAL
  302.  
  303. FUTURE VERSIONS:
  304. ^^^^^^^^^^^^^^^^
  305. Let me know what you would like to see added!!
  306.  
  307. VERSION HISTORY:
  308. ^^^^^^^^^^^^^^^^
  309. Version 1.00 ......... First release. 03/23/95
  310. Version 1.01 ......... Fixed screen bug on the last page of articles.
  311.                        04/23/95
  312. Version 1.20B1 ....... Beta1 of the door reader includes support for
  313.                        downloading articles and reading of back issues
  314.                        while in the door. 12/26/95
  315. Version 1.20B2 ....... Beta2 - slight modifications to the above
  316.                        routines. Added support for a second ANSI hello
  317.                        screen in case we need to make a special announce-
  318.                        ment. Added several logging features to the .LOG
  319.                        file. 01/25/96
  320.  
  321. REGISTERING:
  322. ^^^^^^^^^^^^
  323. ATW is FREE!!
  324.  
  325. That's all there is to it! If you have any problems or questions
  326. please feel free to call the T&J Software BBS at (717)325-9481.
  327.  
  328. See the enclosed registration form for ordering other doors!
  329. (REGISTER.TXT)
  330.