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