home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 147.img / NETMAL46.ZIP / NETDOR46.ZIP / NETDOOR.DOC < prev    next >
Text File  |  1990-01-30  |  23KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. NetDoor
  10. Version 4.6
  11. HUB Door System for NetMail
  12.  
  13.  
  14. by Mark J. Findlay
  15. Home Dba BBS   (206) 789-9302  (WASEA)
  16.  
  17. Copyright (c) 1989
  18. All Rights Reserved
  19.  
  20.  
  21.  
  22.  
  23. Disclaimer.
  24.  
  25. The author makes no warranties expressed or implied as to the
  26. quality or performance of this program. The author will not
  27. be held liable for any direct, indirect, incidental, or
  28. consequential damages resulting from the use of this
  29. program.  Your use of the program constitutes your agreement
  30. to this disclaimer and your release of the author from any
  31. form of liability or litigation.
  32.  
  33.  
  34.  
  35. We are continuing our full support of the NetMail system and are
  36. constantly working to improve our product to suit the needs of the
  37. users. Many of the upgrades to NetMail since its original release
  38. are due to user's comments and suggestions for improvement. We also
  39. provide FREE 24 hour support to ALL Home Dba Software users regardless
  40. of their registration status via our support board (Home Dba BBS) as
  41. well as the HOMEDBA conference carried by systems throughout the
  42. United States.
  43.  
  44.  
  45.  
  46. Table of Contents.
  47.  
  48. NETDOOR.ZIP Contents ...............................  1.0
  49.  
  50.      Files Included with NETDOOR.ZIP ...............  1.1
  51.      Files Created By NetDoor ......................  1.2
  52.      Multi-Node Processing and NetDoor .............  1.3
  53.  
  54. Setup ..............................................  2.0
  55.  
  56.      HUB Responsibility : Assigning Conf Names .....  2.1
  57.      Directories ...................................  2.2
  58.      Updating DOORS.DAT ............................  2.3
  59.      Adjusting the NETDOOR batch file ..............  2.4
  60.      Other Required Programs .......................  2.5
  61.      Before Running NetDoor ........................  2.6
  62.  
  63. Running NetDoor ....................................  3.0
  64.  
  65.      When a NODE calls .............................  3.1
  66.      Security : BBS.NET ............................  3.2
  67.      PCBoard Caller Log ............................  3.3
  68.      When a NODE Changes Configuration .............  3.4
  69.      Deleting a NODE from the Network ..............  3.5
  70.      Unattended Logging of NetDoor Operation .......  3.6
  71.      PCBoard Events ................................  3.7
  72.  
  73. How to Get Additional Help .........................  4.0
  74.  
  75. Help in Finding/Joining a NetMail Network ..........  5.0
  76.  
  77. Other Programs From Home Dba Software ..............  6.0
  78.  
  79. Acknowledgements ...................................  7.0
  80.  
  81.  
  82. Page 1
  83.  
  84. 1.0  NETDOOR.ZIP Contents.
  85.  
  86. 1.1  Files Included with NETDOOR.ZIP.
  87.  
  88. The following files should be contained in your NETDOOR.ZIP
  89. file:
  90.  
  91.           NETDOOR.EXE    - NetDoor executable file.
  92.  
  93.           NETDOOR.CNF    - NetDoor config file.
  94.  
  95.           NETDOOR.DOC    - This document.
  96.  
  97.               NETDOOR    - NetDoor batch file.
  98.  
  99.  
  100. If your NETDOOR.ZIP file is missing any of these files,
  101. please contact Home Dba BBS at (206) 789-9302 (WASEA). You may always
  102. download the most recent version of NetMail from the support
  103. conference there.
  104.  
  105.  
  106.  
  107. 1.2  Files Created by NetDoor.
  108.  
  109. NetDoor will create new files not included with the original NetMail/NetDoor
  110. package, in order to help in the processing of calling nodes.
  111.  
  112. <BBSCODE>.HST   : NetDoor will create this file and maintain it for each
  113.                   calling node. <BBSCODE> represents the 1 - 8 character
  114.                   unique identifier for the calling node. This file
  115.                   contains a history of the calling node's last successful
  116.                   mail transfer, in the form of last message numbers
  117.                   processed for each conference carried by the calling node
  118.                   at the time of the last successful call. With this
  119.                   information, NetDoor can prompt calling nodes as to
  120.                   whether they wish to re-receive their previously
  121.                   received mail packet. You should not alter this file or
  122.                   attempt to move this file from its directory.
  123.  
  124. NETWORK.LST     : This file contains the network-wide nodelist which NetDoor
  125.                   automatically maintains each time a calling node enters
  126.                   NetDoor. Notice the 5th parameter on the NetDoor command
  127.                   line within the NETDOOR batch file. That parameter
  128.                   specifies the location of your NODE'S NetMail directory.
  129.                   (That being the directory where you have defined the
  130.                   node portion of your hub/node operations). That is the
  131.                   directory in which NetDoor will process the NETWORK.LST
  132.                   file.
  133.  
  134.                   IT IS VITAL THAT YOU PROPERLY IDENTIFY YOUR NODE NETMAIL
  135.                   DIRECTORY AND THAT YOU NEVER MOVE NETWORK.LST FROM THIS
  136.                   DIRECTORY!!
  137.  
  138.                   When you perform the node aspect of your hub/node operation,
  139.                   the export function will include the existing NETWORK.LST
  140.                   file in your outgoing mail packet, to be processed by
  141.                   the NetDoor on the hub system that you send your mail to.
  142.  
  143.                   When a node calls a hub, NetDoor updates NETWORK.LST not
  144.                   only with the calling node's information, but also with
  145.                   any information contained in the NETWORK.LST file sent
  146.                   along by the calling node. In this way, NetDoor maintains
  147.                   a constantly updated network-wide nodelist file for use
  148.                   in displaying via the NETSTAT.EXE program (available to
  149.                   registered users only).
  150.  
  151.  
  152.  
  153. 1.3  Multi Node processing and NetDoor.
  154.  
  155. You may make this door available to as many nodes simultaneously
  156. as you wish. This door can be run concurrently by any number
  157. of callers. Remember that you must create a work directory for
  158. each of your PCBoard nodes. Each work directory will have a name
  159. equal to the work directory specified in your NetMail GLOBAL
  160. configuration, with an added number corresponding to the node
  161. number of each PCBoard node. For example:
  162.  
  163.  If your WORK DIRECTORY = C:\NETMAIL\WORK
  164.  
  165.  and you are operating 3 nodes, you will need to create 3
  166.  NetDoor work directories:
  167.  
  168.                   C:\NETMAIL\WORK1
  169.                   C:\NETMAIL\WORK2
  170.                   C:\NETMAIL\WORK3
  171.  
  172.  NetDoor will use the work directory corresponding to the node
  173.  number the caller is currently on. If a NetMail node calls
  174.  on your PCBoard node 2, then C:\NETMAIL\WORK2 would be the
  175.  work directory NetDoor uses for that call.
  176.  
  177. NOTE:  IT IS ABSOLUTELY VITAL THAT YOU CREATE A SEPARATE WORK
  178.        DIRECTORY FOR EACH PCBOARD NODE YOU OPERATE!
  179.  
  180.  
  181.  
  182. 2.0    Setup.
  183.  
  184. 2.1    HUB Responsibility : Assigning Conference Names.
  185.  
  186.     As stated in the NetMail documentation, you, as the HUB
  187. sysop must assign a unique conference name for each
  188. conference that will be networked through your HUB. This
  189. applies to ALL conferences networked through you regardless
  190. of whether or not you intend to actually carry the
  191. conferences on your BBS!  Never alter or reuse these names
  192. once networking begins unless deleting the conference from
  193. your network or your nodes will not recieve their mail from
  194. that conference and you will not receive theirs.
  195.  
  196.  
  197. 2.2    Directories.
  198.  
  199.     The first step in setting up NetDoor is creating the
  200. directory in which NetDoor will reside. For the sake of
  201. order, the author recommends the creation of a separate
  202. subdirectory to house NetDoor:
  203.  
  204.                   Example:    C:\Netdoor\
  205.  
  206. Next, copy the files NETDOOR.EXE and NETDOOR.CNF into
  207. this directory or subdirectory. Place the NETDOOR file
  208. in your main PCBoard directory.
  209.  
  210. See section 1.3 above to properly set up your NetDoor work
  211. directories.
  212.  
  213.  
  214. 2.3    Updating DOORS.DAT
  215.  
  216. You will need to update your PCBoard DOORS.DAT file with the
  217. appropriate entry. If you have never configured a door before
  218. you should re-read the PCBoard documentation on the subject
  219. to completely familiarize yourself with the entire process,
  220. but as an aid in Setup configuration we will brief you on the
  221. details.  Using PCBSETUP, enter the screen containing the
  222. DOORS.DAT file specification and press F2 to edit the
  223. DOORS.DAT file. Add an entry for NetDoor by adding the name
  224. of the NetDoor batch file:  NETDOOR. Next, assign a security
  225. level to which the user (NODE system Sysop) will need in
  226. order to enter the door from PCBoard.
  227.  
  228. NOTE: NetDoor is not designed to be a Door security system. Please
  229.       specify an adequate security level to insure that only
  230.       the NODE system sysops are granted access to the door.
  231.  
  232.  
  233.  
  234.  
  235. 2.4    Adjusting the NETDOOR batch file.
  236.  
  237. NetDoor comes with a pre-written NETDOOR batch file which you
  238. are to place in your PCBoard executable directory. (Do not
  239. add the extention of ".BAT" to the NETDOOR file, PCBoard will
  240. take care of this when the door is entered). You may need to
  241. update the NETDOOR file depending on your configuration.
  242. Update this file accordingly based on the following example:
  243.  
  244. NETDOOR file statement     comment
  245. ----------------------     ----------------------------------------
  246. echo off                   Do not echo to screen.
  247.  
  248. cd \Netdoor                Change directory to the directory housing
  249.                            Netdoor.
  250.  
  251. Netdoor netdoor.cnf c:\pcb c:\hubmail c:\utils c:\nodemail
  252.  
  253.                            The above line illustrates the startup
  254.                            command for NetDoor.
  255.  
  256.                            Netdoor     = Startup Netdoor.exe
  257.  
  258.                            Netdoor.cnf = Config file for NetDoor
  259.  
  260.                            c:\pcb      = This is where your PCBOARD.DAT,
  261.                                          PCBOARD.SYS reside. NetDoor will
  262.                                          scan these node specific files
  263.                                          when first entered by the calling
  264.                                          node.
  265.  
  266.                            c:\hubmail  = HUB's Main NETMAIL directory.
  267.  
  268.                            c:\utils    = PATH of your PKZIP.EXE file.
  269.  
  270.                                          NetDoor was re-written to execute
  271.                                          PKZIP WITHOUT loading a copy of
  272.                                          COMMAND.COM in order to save
  273.                                          approximately 24K of memory at
  274.                                          compression time. This 4th parameter
  275.                                          tells NetDoor the directory that
  276.                                          PKZIP.EXE resides in.
  277.  
  278.                            c:\nodemail = NODE's Main NetMail Directory.
  279.  
  280. cd \pcb                    return to the main PCBoard directory.
  281.  
  282. board                      restart PCBoard.
  283.  
  284.  
  285. You must enter the parameters in EXACTLY the order presented
  286. above.  NetDoor uses the HUB's NetMail directory specified to load
  287. both the HUB GLOBAL.NET file and BBS.NET files and the NODE's
  288. NetMail directory to maintain the network-wide nodelist.
  289.  
  290. SPECIAL NOTE:  Please be certain you make the proper distinction
  291.                between the HUB`s NetMail directory and the NODE's
  292.                NetMail directory. If you are operating SOLELY as
  293.                a HUB (In other words, you are the National Hub
  294.                and you make NO calls to any other system to
  295.                transfer mail), then specify the directory where
  296.                NETDOOR.EXE resides as your 5th parameter.
  297.  
  298.  
  299.  
  300. Please note that with release 2.0 of NetMail, the HUB system
  301. no longer performs manual IMPORT or EXPORT. These functions
  302. are now written into the NetDoor and are performed automatically
  303. each time a node calls.
  304.  
  305.  
  306.  
  307. 2.5    Other Required Programs.
  308.  
  309. HUB systems MUST have PKZIP, PKUNZIP and DSZ in one of the
  310. directories included in the DOS PATH specification. NetMail
  311. and NetDoor use PKZIP and PKUNZIP at various points and NetDoor
  312. calls DSZ to receive and transmit mail packets.
  313.  
  314. YOU MUST HAVE A REGISTERED VERSION OF DSZ IN ORDER FOR THE DOOR
  315. TO FUNCTION PROPERLY!
  316.  
  317.  
  318. NOTE: Please make an effort to coordinate similar versions of
  319.       DSZ between the HUB and NODE systems. This has been
  320.       found to be a problem when DSZ versions were too far
  321.       apart between some HUB and NODE systems.
  322.  
  323.  
  324. 2.6    Before Running NetDoor.
  325.  
  326. Prior to running NetDoor for the first time, you must insure
  327. that you have completed the HUB configuration process through
  328. NETMAIL and that all GLOBAL.NET and CONF.NET information
  329. (created by the global and conference configuration process)
  330. is complete. This includes the creation and verification of
  331. directories and the assignment of a unique conference names
  332. to every conference that will be processed through your HUB
  333. regardless of whether you intend on carrying the conference
  334. or not.
  335.  
  336.  
  337.  
  338. 3.0    Running NetDoor.
  339.  
  340. You are now ready to receive NODE callers. As an initial test
  341. of your NetDoor configuration, you should attempt entering
  342. the door locally from PCBoard. If your configuration is
  343. correct, you will enter the door, and, because there are at
  344. present no local functions available, be returned to PCBoard.
  345.  
  346. If this happens as described, you are ready to receive
  347. calling NODES.
  348.  
  349.  
  350.  
  351.  
  352. 3.1    When a NODE calls.
  353.  
  354. NetDoor provides several prompts to the NODE caller, either
  355. helping to direct operations or simply notifying the NODE of
  356. the current activity. All messages are echoed to the local
  357. HUB screen as well.
  358.  
  359.  
  360.  
  361. 3.2    Security : BBS.NET
  362.  
  363. NetDoor provides security through the use of the NetDoor
  364. Verification of Callers option from the NetMail Configuration
  365. Menu. (Global Information). If the HUB sysop specifies "Y" in
  366. the "Verify NetDoor Callers" option of the Global Configuration,
  367. NetDoor will, after determining the identity of a NODE calling
  368. for the first time, verify that NODEs authority by scanning
  369. BBS.NET in the main NetMail executable directory. BBS.NET is
  370. created when the HUB system is first configured through NetMail.
  371. If the security option is on and NetDoor does not find the
  372. NODE's BBS-Code in BBS.NET, the calling NODE will be notified
  373. and will not be permitted to carry on the mail transfer process
  374. within NetDoor and will be returned to PCBoard. Appropriate
  375. entries will also be made in the PCBoard Caller Log.
  376.  
  377. On the other hand, the HUB system could conceiveably be
  378. configured to allow ANY AND ALL new NODE callers immediate
  379. access to the NetMail system by specifiying "N" in the
  380. "Verify NetDoor Callers" entry. When this occurs, NetDoor
  381. scans BBS.NET for the NODE entry, but if not found, automatically
  382. adds the new NODE's configuration information to BBS.NET for
  383. subsequent use. If the HUB sysop maintains a bulletin listing all
  384. conferences in the network and their conference number, and
  385. specifies a security allowing ANYONE into the NetDoor through
  386. PCBSetup, AND specifies "N" in the "Verify NetDoor Callers"
  387. field, AND configures the NETDOOR batch file for automatic
  388. non-attended HUB operation (See Sample Batch File), the HUB system
  389. could actually operate a network allowing new NODES to enter
  390. and participate in the network, without ever having made
  391. contact with the new NODE or ever needing to!
  392.  
  393. While this scenario is not necessarily an ideal or suggested
  394. one, it does illustrate NetMail's power and gives you some
  395. idea for the flexibility and options you have as a HUB sysop.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402. 3.3    PCBoard Caller Log.
  403.  
  404. NetDoor reports to you on the activity of the calling NODE,
  405. not only on screen while the caller is online, but also to
  406. the PCBoard caller log for your review at a later time.
  407. Included in each entry in the caller log is:
  408.  
  409. Time and Date of entry to NetDoor
  410. Calling BBS identity
  411. File transfer completions
  412. Various Error Messages
  413. Time and Date of NetDoor termination.
  414.  
  415.  
  416.  
  417. 3.4    When a NODE changes configuration.
  418.  
  419. When the NODE system calls and transfers its mail, BBS.NET is
  420. automatically updated by NetDoor with the current NODE
  421. configuration. (Which conferences the NODE is networking).
  422. This allows the NODE system to freely change the conferences
  423. it carries at any time and be insured of receiving only the
  424. conferences it is currently carrying. At no time does the HUB
  425. sysop need to make any alterations to NetDoor.
  426.  
  427.  
  428.  
  429.  
  430. 3.5    Deleting a NODE from the Network.
  431.  
  432. When a NODE system is no longer part of the network run by
  433. the HUB, the HUB sysop must delete the NODE information
  434. record from the BBS.NET information file to stop any further
  435. holding or creation of that NODE's mail.
  436.  
  437. This is accomplished by executing the ALT-D function from
  438. the BBS Maintenance function from within the NetMail
  439. Configuration program. After entering the BBS Maintenance
  440. screen, page through the available entries until you
  441. come to the bbs you wish to delete. Press ALT-D and confirm.
  442. A backup of the BBS.NET file will be maintained by NetMail
  443. each time you perform a DELETE of a NODE.
  444.  
  445.  
  446.  
  447.  
  448. 3.8   Unattended Logging of NetDoor Operations.
  449.  
  450.     Incorporated into NetMail are many ProKit routines. This means that
  451.     as a HUB, you may log all NetDoor screen display activity to a collection
  452.     file for later review. This can be useful if you wish to review to
  453.     message activity of a node over a period of time, or wish to review the
  454.     NetDoor activity which occurred while you were away from the terminal.
  455.     Everything that is normally displayed by NetDoor will be written to the
  456.     collection file in the NetDoor directory. The collection filename will
  457.     be DEBUG1.OUT. In order to turn this function on, you must set the
  458.     ENVIRONMENT variable "PRODEBUG" on by using the following command either
  459.     from the DOS prompt or in your autoexec.bat:
  460.  
  461.                            SET PRODEBUG=ON
  462.  
  463.     Keep in mind that with prodebug set to on, ALL programs written with
  464.     ProKit routines will begin the detailed logging process. This could have
  465.     a profound effect on your disk space, as well as the overall performance
  466.     of your system, which is now writing to disk, nearly everthing that
  467.     scrolls across the user's screen.
  468.  
  469.  
  470.     WITH PRODEBUG SET TO ON, ALL PROGRAMS WRITTEN WITH PROKIT ROUTINES WILL
  471.     BEGIN THE DETAILED LOGGING PROCESS. THIS COULD HAVE A PROFOUND EFFECT
  472.     ON YOUR DISK SPACE, AS WELL AS OVERALL SYSTEM PERFORMANCE.
  473.  
  474.     In order to counter the effects of the disk utilization of the various
  475.     ProKit program logging, you should periodically enter the subdirectories
  476.     that the programs using ProKit reside, and delete the DEBUG1.OUT files
  477.     that are created.
  478.  
  479.     By far the greatest impact will be seen by the ProDoor program. All
  480.     screens displayed to the user by ProDoor will also be logged to disk!
  481.     Therefore, a user browsing 100K of messages during a session would
  482.     also result in an additional 100K being added to your log file. Multiply
  483.     this by several callers and you can easily see the impact this
  484.     environment variable can have.
  485.  
  486.     In order to remove the PRODEBUG=ON variable, you must either remove the
  487.     SET PRODEBUG=ON command from your autoexec.bat and reboot your system,
  488.     or, you may turn the variable off from the DOS command line:
  489.  
  490.  
  491.                            SET PRODEBUG=
  492.  
  493.  
  494.     Keep in mind that just turning the prodebug variable off from the DOS
  495.     command line will be ineffective if you still have the PRODEBUG=ON
  496.     command in your autoexec.bat file. The next time you booted your
  497.     system, the prodebug variable would be reset to ON and you would
  498.     again be logging all ProKit program activity.
  499.  
  500.  
  501. 3.9   PCBoard Events.
  502.  
  503. If a calling Node attempts to enter the NetDoor within 15 minutes of
  504. a scheduled PCBoard event, NetDoor will first check to see if the
  505. event can "slide" (that is, if the upcoming event has been defined as
  506. being able to wait until the caller logs off before starting) and if
  507. so, will let the calling Node proceed with the mail transfer. if an
  508. event is scheduled and the slide indicator has been set to "N" and
  509. the caller is within 15 mintutes of the upcoming event, the caller
  510. will be informed of this by NetDoor and will be returned to PCBoard.
  511.  
  512.  
  513.  
  514.  
  515. 4.0    How to Get Additional Help.
  516.  
  517.  
  518. If at any time you happen to run into problems you cannot
  519. solve or need additional information on any of NetMail's
  520. functions or simply wish to learn more about NetMail or any
  521. other Home Dba Software program, you may call our Support
  522. Board - HOME DBA BBS at (206) 789-9302 (WASEA).
  523.  
  524.  
  525. PLEASE MAKE ALL INQUIRIES IN THE SUPPORT CONFERENCE!
  526.  
  527.  
  528. When calling with problems, please upload as many
  529. NetMail files related to the problem as possible;
  530. (CONF.NET, BBS.NET etc), as well as CONFIG.SYS and
  531. AUTOEXEC.BAT
  532.  
  533.  
  534.  
  535.  
  536. 5.0    Help in Finding/Joining a NetMail Network.
  537.  
  538. The support conference on Home Dba will maintain a bulletin
  539. listing all known bulletin boards networking with NetMail. You
  540. may browse and/or download this list and contact the BBS most
  541. conveniently located, for more information in joining that BBS's
  542. network.  If you are already a member of a NetMail network, you
  543. may fill out the support conference questionnaire and your BBS
  544. will be added to the Nationwide NetMail Users List.
  545.  
  546.  
  547.  
  548.  
  549. 6.0    Other Programs Available from Home Dba Software.
  550.  
  551.  
  552.  
  553.  NetMail - This is the counterpart to NetDoor. This program
  554.            provides both HUB and node with everthing required for
  555.            complete setup and configuration into a NetMail
  556.            Network.
  557.  
  558.  TuDoor  - This DOOR allows users to view ansi/ascii tutorials
  559.            forward and backwards.  It was put together to get
  560.            information to users who never seemed to get around
  561.            to reading bulletins...  know any users like
  562.            that?...
  563.  
  564.  AnsiView - Interactive Ansi Viewing Door that allows
  565.            users to view ansi screen creations interactively
  566.            without having to download them first.  Comes with
  567.            a starter set of ansi screens....
  568.  
  569.  WallyBil - Calculates and maintains shared expenses among
  570.            groups of people like roommates in college etc.
  571.            Maintains individual entries, allows update of
  572.            entries, calculates each person's debt to the other
  573.            etc.
  574.  
  575.  Assorted tutorials for TuDoor Door.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587. 7.0    Acknowledgements.
  588.  
  589. Special thanks and program dedication to Yani, whose patience
  590. and encouragement are outdone only by her Indian cooking!
  591.  
  592. I also wish to thank all those who have helped to make NetMail the
  593. program it is today, through their many comments and suggestions
  594. for improvement.
  595.