home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / MKNET115.ZIP / MKNET.DOC < prev    next >
Text File  |  1994-11-25  |  16KB  |  361 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.  This is the main
  148.                       (default) tagline, used when the conference config
  149.                       tagline number is set to zero.
  150.  
  151.           Compression Type - Pick the compression type to be used on the
  152.                       *.REP packets that you generate.  The compression
  153.                       type used on the *.QWK packets you receive is
  154.                       automatically detected and the correct unpacker
  155.                       will be called.
  156.  
  157.           GateWay - Normally set this to NO.  It is used to allow
  158.                       conferences to be Gated between QWK format networks
  159.                       and Fido-Technology networks, by creating the correct
  160.                       message format and EchoMail.Bbs entries.  MAKE SURE
  161.                       THAT YOU HAVE THE PERMISSION OF THE NETWORK
  162.                       ADMINISTRATORS BEFORE GATING ANY CONFERENCES!
  163.  
  164.           Ignore Priv In - YES will cause MKNet to ignore private
  165.                       messages when importing mail
  166.  
  167.           Ignore Priv Out - YES will cause MKNet to ignore private
  168.                       messages when exporting mail
  169.  
  170.           Aggressive Locking - YES will cause MKNet to keep a message
  171.                       base locked while one entire conference is
  172.                       tossed.  This can speed up importing, but may
  173.                       delay message saving on other nodes in multi-node
  174.                       systems
  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 leave the tag# set to
  194.                       zero the main tagline will be used. If you choose
  195.                       a number between 1 and 20, one of the alternate
  196.                       taglines from the alternate tagline config screen
  197.                       will be used. If you are running one of the directly
  198.                       supported BBS types, just press {Enter} on the
  199.                       MsgAreaId field and MKNetCfg will bring up a picklist
  200.                       of the areas on your BBS.  When you select one, it
  201.                       will fill in the MsgAreaId automatically for you.
  202.                       If you are running another BBS type, or need to
  203.                       choose message areas in addition to the ones from
  204.                       your BBS, you may also manually type in a MsgAreaId.
  205.  
  206.                       The format of the MsgAreaId is as follows:
  207.  
  208.                       Hudson: 'H', followed by a 3 digit area number,
  209.                          followed by the message base path.
  210.                          H042C:\QUICK\MSGBASE
  211.  
  212.                       Squish: 'S', followed by the message base path and
  213.                          name
  214.                          SC:\MAX\MSGS\GENERAL
  215.  
  216.                       Fido (*.Msg) : 'F', followed by the directory name
  217.                          FC:\FD\MAIL
  218.  
  219.                       Ezycom: 'E', followed by a 4 digit area number,
  220.                          followed by the msg base path
  221.                          E0050C:\Ezy\MsgBase
  222.  
  223.                       JAM: 'J', followed by the message base path and
  224.                          name.
  225.                          JC:\RA\MSGS\ADMIN
  226.  
  227.                       After you edit a conference setting, MKNetCfg will ask
  228.                       if you want to update the last-exported number.
  229.                       Normally you should answer YES, which will cause the
  230.                       last exported to be set to the highest message in that
  231.                       message base.
  232.  
  233.  
  234.  
  235.                            MKNet - QWK Network Interface
  236.                          Copyright by 1991, 1993 by Mark May
  237.  
  238.                          RENUMBERING THE MESSAGE BASES
  239.  
  240.                                *** IMPORTANT ***
  241.  
  242.          The 1.1x version of MKNet changes the way MKNet keeps track of
  243.          the last message imported/exported for each area.  It no
  244.          longer keeps the information in the lastread values of a fake
  245.          user on the BBS.  This means that the last imported/exported
  246.          values are *not* updated by the BBS when you renumber now,
  247.          but instead now requires that MKReset be run when you
  248.          renumber the message base.
  249.  
  250.          The normal procedure would be to run MKNet (to extract any
  251.          mail waiting to be exported), renumber the message base, and
  252.          then run MKReset (to get the last exported pointers back in
  253.          sync with the renumbered message base).  If you do not do
  254.          this, you risk losing outgoing mail that was waiting to be
  255.          exported.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                            MKNet - QWK Network Interface
  262.                          (C) Copyright by 1991 by Mark May
  263.  
  264.  
  265.           MKNet v1.15            REGISTRATION
  266.  
  267.           A registration fee is not required for these programs.
  268.           I initially wrote this interface program to allow my
  269.           system to interface with P/Net (a small but interesting
  270.           Programmers echo network - that faded away).
  271.  
  272.           I would appreciate it if you would fill in the form below
  273.           and return it to me with any questions, comments, or
  274.           suggestions, this will help in gauging the interest in this
  275.           program as well as determining future features needed.
  276.  
  277.  
  278.           Registration Information:                  MKNet v1.15
  279.  
  280.  
  281.           Name:         ____________________________________________
  282.  
  283.           Address:      ____________________________________________
  284.  
  285.                         ____________________________________________
  286.  
  287.           City, ST Zip  ____________________________________________
  288.  
  289.  
  290.           Bbs Name:     ____________________________________________
  291.  
  292.           Bbs Type/Version: ________________________________________
  293.  
  294.           Bbs Phone Number  (     )        -
  295.  
  296.           Any suggestions or comments ______________________________
  297.  
  298.           __________________________________________________________
  299.  
  300.           __________________________________________________________
  301.  
  302.  
  303.           Registrations should be mailed to:
  304.  
  305.           Mark May
  306.           Mythical Kingdom Software
  307.           P.O. Box 24808
  308.           Huber Heights, OH 45424
  309.  
  310.  
  311.           You may leave questions or get the latest version by
  312.           calling:
  313.  
  314.           Mythical Kingdom Tech Bbs
  315.  
  316.           Phone (513) 237-7737 28800 baud HST/v32/v34
  317.           FidoNet            1:110/290
  318.  
  319.           You may also read me as: maym@dmapub.dma.org
  320.  
  321.  
  322.  
  323.  
  324.                            MKNet - QWK Network Interface
  325.                          Copyright by 1991, 1993 by Mark May
  326.  
  327.  
  328.           Other Mythical Kingdom Software Bbs utilities include:
  329.  
  330.           MKRead - a nice, easy to setup and use online message
  331.             reader for sysops to use.  It is full-featured with
  332.             taglines (including modifiers), ansi message
  333.             viewing, and more.
  334.  
  335.           MKToday - a configurable today's callers screen
  336.             generator.  With this your Today's callers screen won't
  337.             have to look like everyone elses. (RA/Qbbs/Sbbs).  Also
  338.             generates yesterday's callers and summary history screens.
  339.  
  340.           MKXrs - an XRS message/reply tosser that improves
  341.             security over the normal method of using an echomail
  342.             tosser and provides the sysop with several options.
  343.             Messages are quickly tossed while the caller is still
  344.             online.
  345.  
  346.           MKUti - a set of UTI drivers for Quickbbs/Superbbs/MK
  347.             to allow PC-Relay/Postlink (an echo network interface used
  348.             by RIME as well as other networks).
  349.  
  350.           MXUTI, MOUTI, MRUTI - similar UTI drivers for Maximus, Opus,
  351.             and Remote Access
  352.  
  353.           MKNet - a QWK mail network interface for QuickBbs or
  354.             Remote Access (preforms the function that Qnet or Rnet
  355.             perform for PCB for RA, so that RA Bbs's can participate
  356.             in QWK networks).
  357.  
  358.           MKQwk - a fast QWK mail door for Remote Access.  It supports
  359.             both multinode and net-status (for QWK networks).  It is
  360.             very flexible and easy to set-up.
  361.