home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MKNET110.ARJ / MKNET.DOC next >
Encoding:
Text File  |  1993-09-09  |  15.2 KB  |  365 lines
  1.  
  2.  
  3.                            MKNet - QWK Network Interface
  4.                          Copyright by 1991, 1993 by Mark May
  5.  
  6.  
  7.                                     INTRODUCTION
  8.  
  9.           This set of programs allows MK, RA1.1x, RA2.0, QuickBbs,
  10.           and SuperBbs to work with networks that are based on the QWK
  11.           format.  It may also be manually configured to support other
  12.           BBS types that use Hudson, Squish, *.Msg, JAM, or Ezycom format
  13.           message bases. This is the "Node" program to support such a
  14.           network (similar in function to programs like RNet, QNet, or
  15.           TNet). To be a hub in a QWK based network you would also
  16.           need a QWK mail door that support net-status, such as MKQwk.
  17.  
  18.           This set should include:
  19.  
  20.           MKNet.Doc     This documentation file
  21.           MKNetCfg.Exe  Main configuration program
  22.           MKNetCfg.Ovr  Overlay file for configuration program
  23.           MKNet.Exe     The QWK net interface program
  24.           MKNet.Ovr     Overlay file for MKNet
  25.           MKReset.Exe   To Reset your Host LastRead pointers
  26.  
  27.  
  28.                                       DISCLAIMER
  29.  
  30.           This set of programs comes with NO warranty NEITHER expressed
  31.           NOR implied.  It is YOUR responsibility to see that these
  32.           programs meet your needs.  The author assumes NO LIABILITY
  33.           for any damages or results that occur from using or the
  34.           inability to use these programs.  As with all bbs utilities,
  35.           there is some risk of problems even after testing, so full
  36.           and regular backups are important!  If you do not agree with
  37.           this disclaimer, you are PROHIBITED from running these programs.
  38.           Running them confirms your AGREEMENT to these conditions.
  39.  
  40.                                        CHANGES
  41.  
  42.           v1.10 09/09/93 Major update.  MKNet has been completely
  43.                 rewritten in modular OOP code.  This will allow it
  44.                 to be much more easily be updated to support future
  45.                 changes in BBS's.  MKNet now no longer requires access
  46.                 to the user file to keep lastreads (see *IMPORTANT* note
  47.                 about *RENUMBERING* message bases).  MKNet is also now
  48.                 even faster than before!
  49.  
  50.           v1.00 05/08/91 Initial release.  While the program has been
  51.                 through testing on my Bbs, since Quick-clones are not
  52.                 currently in any QWK networks, it has not been as
  53.                 extensively tested as other MK products.
  54.  
  55.  
  56.  
  57.                            MKNet - QWK Network Interface
  58.                          Copyright by 1991, 1993 by Mark May
  59.  
  60.                                    INSTALLATION
  61.  
  62.           Copy *.EXE and *.OVR from the MKNet archive to a directory
  63.           that is on your DOS path.  Choose a directory  that MKNet will
  64.           be run from (ie the current directory when your batch file calls
  65.           MKNet).  Run MKNetCfg in this directory (see details on running
  66.           these programs below) to create your host configuration.  MKNet
  67.           and MKNetCfg expect/update the host config file in the current
  68.           directory ONLY!
  69.  
  70.           The message areas set-up to be echoed, should be set-up in
  71.           your Bbs config program as EchoMail areas.
  72.  
  73.           Contact your hub next and make sure that he has given you
  74.           "Net-Status" in the conferences that you want to echo.  To
  75.           prevent conferences pirating by non-network members, MKNet
  76.           will refuse to import messages from conferences that you
  77.           do not show Net-Status.
  78.  
  79.  
  80.  
  81.  
  82.                            MKNet - QWK Network Interface
  83.                          Copyright by 1991, 1993 by Mark May
  84.  
  85.                                  MKNet OPERATION
  86.  
  87.           Operation of MKNet is simple.  In your batch file change to
  88.           the drive and directory containing your HostName.Cfg and
  89.           execute MKNet.  The actions that MKNet takes is based on the
  90.           combination of HostId.Qwk and HostId.Rep files that it
  91.           finds.  If it finds only and existing HostId.Rep file it
  92.           will scan the message base for additonal messages to be
  93.           added to the existing REP file.  If it finds a HostId.QWK
  94.           file (which would occur if you successfully connected with
  95.           your hub), It will delete the HostId.Rep file (which
  96.           presumably has now been sent to your hub since you have a
  97.           QWK file from him) and imports the QWK file into your
  98.           message base before deleting it.  These actions mean that
  99.           operation is fully automatic with MKNet taking the proper
  100.           action to delete or create files as appropriate.
  101.  
  102.           After running MKNet, you will need to execute either a comm
  103.           program with a script or automated comm program (like RoboComm)
  104.           to handle transferring your REP & QWK files to and from your
  105.           host.  Your host will likely be able to help you in setting up
  106.           this part of the operation.  It is also possible to do this
  107.           step manually if you prefer it that way.
  108.  
  109.           After the transfers are finished, you will want to run MKNet
  110.           again to import the messages that you have received.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                            MKNet - QWK Network Interface
  117.                          Copyright by 1991, 1993 by Mark May
  118.  
  119.                                 MKNet CONFIGURATION
  120.  
  121.           In the directory that MKNet will be run from (not the directory
  122.           that MKNet is located in necessarily), run MKNetCfg to create
  123.           an HostName.Cfg file with the info MKNet needs in order to
  124.           operate.  Just type:
  125.  
  126.           MKNET HostName
  127.  
  128.           In QWK Path:  Path where your comm program places your inbound
  129.                       *.QWK packets that you have downloaded from your
  130.                       hub/host.
  131.  
  132.           Out REP Path:  Path where your comm program expects to find
  133.                       your outbound *.REP packets to be uploaded to
  134.                       your hub/host.
  135.  
  136.           Work Path:  A directory that can be used by MKNet to store
  137.                       temporary files while processing the *.QWK and
  138.                       *.REP packets. (MKNet will create a temporary
  139.                       directory underneath te work path you supply to
  140.                       help ensure that no file name conflicts occur).
  141.  
  142.  
  143.  
  144.  
  145.  
  146.                            MKNet - QWK Network Interface
  147.                          Copyright by 1991, 1993 by Mark May
  148.  
  149.                               HOST/HUB CONFIGURATION
  150.  
  151.           Host Sysop - The name of your Hubs sysop.  Messages from
  152.                       some Bbs software will come thru with messages
  153.                       from/to him listed as Sysop.  This field is used
  154.                       to change that to the correct name.
  155.  
  156.           Host Tag Line - Most mail coming into your system will already
  157.                       have a tagline from your hub, but when it is
  158.                       missing, the tagline you enter here will be added
  159.                       to the message.  Note that some offline reader
  160.                       taglines look like normal taglines and may prevent
  161.                       this tagline from being added.
  162.  
  163.           Compression Type - Pick the compression type to be used on the
  164.                       *.REP packets that you generate.  The compression
  165.                       type used on the *.QWK packets you receive is
  166.                       automatically detected and the correct unpacker
  167.                       will be called.
  168.  
  169.           GateWay - Normally set this to NO.  It is used to allow
  170.                       conferences to be Gated between QWK format networks
  171.                       and Fido-Technology networks, by creating the correct
  172.                       message format and EchoMail.Bbs entries.  MAKE SURE
  173.                       THAT YOU HAVE THE PERMISSION OF THE NETWORK
  174.                       ADMINISTRATORS BEFORE GATING ANY CONFERENCES!
  175.  
  176.  
  177.  
  178.  
  179.                            MKNet - QWK Network Interface
  180.                          Copyright by 1991, 1993 by Mark May
  181.  
  182.                             SETTING UP CONFERENCES
  183.  
  184.           Conferences - Pick the conferences (initially marked available)
  185.                       that you want to configure.  For each one you pick
  186.                       you will be able to enter a QWK area number (the
  187.                       message area number used for the conference by your
  188.                       host), a "lastread" number (to indicate the last
  189.                       message imported/exported so that future exported
  190.                       mail will start at the right place), and a
  191.                       "MsgAreaId". By setting the Qwk area number to a
  192.                       negative one, you make mark an area as unused/
  193.                       available again. If you are running one of the directly
  194.                       supported BBS types, just press {Enter} on the
  195.                       MsgAreaId field and MKNetCfg will bring up a picklist
  196.                       of the areas on your BBS.  When you select one, it
  197.                       will fill in the MsgAreaId automatically for you.
  198.                       If you are running another BBS type, or need to
  199.                       choose message areas in addition to the ones from
  200.                       your BBS, you may also manually type in a MsgAreaId.
  201.  
  202.                       The format of the MsgAreaId is as follows:
  203.  
  204.                       Hudson: 'H', followed by a 3 digit area number,
  205.                          followed by the message base path.
  206.  
  207.                          H042C:\QUICK\MSGBASE
  208.  
  209.                       Squish: 'S', followed by the message base path and
  210.                          name
  211.  
  212.                          SC:\MAX\MSGS\GENERAL
  213.  
  214.                       Fido (*.Msg) : 'F', followed by the directory name
  215.  
  216.                          FC:\FD\MAIL
  217.  
  218.                       Ezycom: 'E', followed by a 4 digit area number,
  219.                          followed by the msg base path
  220.  
  221.                          E0050C:\Ezy\MsgBase
  222.  
  223.                       JAM: 'J', followed by the message base path and
  224.                          name.
  225.  
  226.                          JC:\RA\MSGS\ADMIN
  227.  
  228.                       After you edit a conference setting, MKNetCfg will ask
  229.                       if you want to update the last-exported number.
  230.                       Normally you should answer YES, which will cause the
  231.                       last exported to be set to the highest message in that
  232.                       message base.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                            MKNet - QWK Network Interface
  239.                          Copyright by 1991, 1993 by Mark May
  240.  
  241.                          RENUMBERING THE MESSAGE BASES
  242.  
  243.                                *** IMPORTANT ***
  244.  
  245.          This version of MKNet changes the way MKNet keeps track of
  246.          the last message imported/exported for each area.  It no
  247.          longer keeps the information in the lastread values of a fake
  248.          user on the BBS.  This means that the last imported/exported
  249.          values are *not* updated by the BBS when you renumber now,
  250.          but instead now requires that MKReset be run when you
  251.          renumber the message base.
  252.  
  253.          The normal procedure would be to run MKNet (to extract any
  254.          mail waiting to be exported), renumber the message base, and
  255.          then run MKReset (to get the last exported pointers back in
  256.          sync with the renumbered message base).  If you do not do
  257.          this, you risk losing outgoing mail that was waiting to be
  258.          exported.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                            MKNet - QWK Network Interface
  265.                          (C) Copyright by 1991 by Mark May
  266.  
  267.  
  268.           MKNet v1.10            REGISTRATION
  269.  
  270.           A registration fee is not required for these programs.
  271.           I initially wrote this interface program to allow my
  272.           system to interface with P/Net (a small but interesting
  273.           Programmers echo network - that faded away).
  274.  
  275.           I would appreciate it if you would fill in the form below
  276.           and return it to me with any questions, comments, or
  277.           suggestions, this will help in gauging the interest in this
  278.           program as well as determining future features needed.
  279.  
  280.  
  281.           Registration Information:                  MKNet v1.10
  282.  
  283.  
  284.           Name:         ____________________________________________
  285.  
  286.           Address:      ____________________________________________
  287.  
  288.                         ____________________________________________
  289.  
  290.           City, ST Zip  ____________________________________________
  291.  
  292.  
  293.           Bbs Name:     ____________________________________________
  294.  
  295.           Bbs Type/Version: ________________________________________
  296.  
  297.           Bbs Phone Number  (     )        -
  298.  
  299.           Any suggestions or comments ______________________________
  300.  
  301.           __________________________________________________________
  302.  
  303.           __________________________________________________________
  304.  
  305.  
  306.           Registrations should be mailed to:
  307.  
  308.           Mark May
  309.           Mythical Kingdom Software
  310.           P.O. Box 24808
  311.           Huber Heights, OH 45424
  312.  
  313.  
  314.           You may leave questions or get the latest version by
  315.           calling:
  316.  
  317.           Mythical Kingdom Tech Bbs
  318.  
  319.           Phone (513) 237-7737 9600 baud HST/V32
  320.           FidoNet            1:110/290
  321.           RIME (RelayNet)    ->MYTHKING
  322.  
  323.           You may also read me as: maym@dmapub.dma.org
  324.  
  325.  
  326.  
  327.  
  328.                            MKNet - QWK Network Interface
  329.                          Copyright by 1991, 1993 by Mark May
  330.  
  331.  
  332.           Other Mythical Kingdom Software Bbs utilities include:
  333.  
  334.           MKRead - a nice, easy to setup and use online message
  335.             reader for sysops to use.  It is full-featured with
  336.             taglines (including modifiers), ansi message
  337.             viewing, and more.
  338.  
  339.           MKToday - a configurable today's callers screen
  340.             generator.  With this your Today's callers screen won't
  341.             have to look like everyone elses. (RA/Qbbs/Sbbs).  Also
  342.             generates yesterday's callers and summary history screens.
  343.  
  344.           MKXrs - an XRS message/reply tosser that improves
  345.             security over the normal method of using an echomail
  346.             tosser and provides the sysop with several options.
  347.             Messages are quickly tossed while the caller is still
  348.             online.
  349.  
  350.           MKUti - a set of UTI drivers for Quickbbs/Superbbs/MK
  351.             to allow PC-Relay/Postlink (an echo network interface used
  352.             by RIME as well as other networks).
  353.  
  354.           MXUTI, MOUTI, MRUTI - similar UTI drivers for Maximus, Opus,
  355.             and Remote Access
  356.  
  357.           MKNet - a QWK mail network interface for QuickBbs or
  358.             Remote Access (preforms the function that Qnet or Rnet
  359.             perform for PCB for RA, so that RA Bbs's can participate
  360.             in QWK networks).
  361.  
  362.           MKQwk - a fast QWK mail door for Remote Access.  It supports
  363.             both multinode and net-status (for QWK networks).  It is
  364.             very flexible and easy to set-up.
  365.