home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MRUTI201.ZIP / MRUTI.DOC < prev    next >
Encoding:
Text File  |  1993-08-25  |  8.6 KB  |  261 lines
  1.  
  2.                             UTI drivers for RA Bbs
  3.                      Copyright (C) 1992, 1993 by Mark May
  4.  
  5.  
  6.                                  INTRODUCTION
  7.  
  8.           This set of programs allows RA to work with with programs
  9.           that require a Universal Text Interface (UTI), (currently
  10.           PC Relay). It implements version 2.1 of the UTI specifications,
  11.           but does not handle LastRead pointers as would be needed with
  12.           the MegaMail door.
  13.  
  14.  
  15.           This set should include:
  16.  
  17.  
  18.           MRUTI.DOC     This documentation file
  19.           UTIVER.EXE    UTI version program (2.1)
  20.           UTILIST.EXE   Conference (message area) lister
  21.           UTIHIGH.EXE   High message number finder
  22.           UTIIMPRT.EXE  Imports messages into the bbs from UTI format
  23.           UTIEXPRT.EXE  Exports messages out of the bbs to UTI format
  24.           FTS.TXT       Example "gateway" file
  25.  
  26.  
  27.                                   DISCLAIMER
  28.  
  29.           This set of programs comes with NO warranty NEITHER expressed
  30.           NOR implied.  It is YOUR responsibility to see that these
  31.           programs meet your needs.  The author assumes NO LIABILITY
  32.           for any damages or results that occur from using or the
  33.           inability to use these programs.  As with all bbs utilities,
  34.           there is some risk of problems even after testing, so full
  35.           and regular backups are important!  If you do not agree with
  36.           this disclaimer, you are PROHIBITED from running these programs.
  37.           Running them confirms your AGREEMENT to these conditions.
  38.  
  39.  
  40.                                     CHANGES
  41.  
  42.           08/25/93 V2.01 Updated to handle JAM message areas
  43.  
  44.           03/14/93 V2.00 Update to support RA 2.00 gamma
  45.  
  46.  
  47.  
  48.  
  49.                            UTI drivers for RA v2.0
  50.                      Copyright (C) 1992, 1993 by Mark May
  51.  
  52.  
  53.                               SET-UP FOR PC-RELAY
  54.  
  55.  
  56.           The UTI drivers themselves (the Uti*.Exe files) can
  57.           reside in any directory that is on your path.  See the
  58.           documentation that came with PC-Relay for more information
  59.           on setting up PC-Relay itself.  The only other requirement
  60.           is that you set an environment variable for your Bbs so that
  61.           the UTI drivers can find the config files.
  62.  
  63.           EXAMPLE:   SET RA=C:\RA
  64.  
  65.  
  66.                                MULTINODE SET-UP
  67.  
  68.           The UTI drivers are multinode aware, supporting file locking
  69.           and sharing (note that SHARE should be used in multinode
  70.           set-ups).  Normally when importing the UTI driver will lock
  71.           the message base, import a message and then unlock it.  If
  72.           the environment variable UTILOCK is found, the UTI driver
  73.           will lock the message base, import all of the messages in
  74.           that conference, then unlock the message base.  This will
  75.           imrprove performance, but does cause a delay if someone
  76.           attempts to write to that message area while importing is
  77.           taking place.  Running in locked mode is the RECOMMENDED
  78.           setting.
  79.  
  80.           EXAMPLE:   SET UTILOCK=M  {will run in locked mode}
  81.           EXAMPLE:   SET UTILOCK=   {will run in unlocked mode}
  82.  
  83.  
  84.  
  85.                             CONFERENCE IDENTIFIERS
  86.  
  87.           Conference Identifiers used are the message base type
  88.           followed by area number and the path/filename.
  89.  
  90.           The message base name is used for both the name (shortened to
  91.           15 characters) and the description (full size).
  92.  
  93.           EXAMPLE:   H042C:\MK\MSG would be area 42 in a Hudson
  94.                      (Quick/RA/Etc) message base in the C:\MK\Msg
  95.                      directory
  96.  
  97.           Jam areas use an identifer of J followed by the path/filename
  98.           of the JAM message area.
  99.  
  100.           EXAMPLE:  JF:\RA2\MSG\ADMIN would be a JAM area called ADMIN
  101.                     in the F:\RA2\MSG directory.
  102.  
  103.  
  104.  
  105.  
  106.                             UTI drivers for RA v2.0
  107.                      Copyright (C) 1992, 1993 by Mark May
  108.  
  109.  
  110.  
  111.                               NETWORK (PC-RELAY)
  112.  
  113.           PC-Relay (in its Config.Exe program) must be set for level 2 UTI
  114.           drivers as the interface to the Bbs.
  115.  
  116.  
  117.                       GATING TO FIDO-TECHNOLOGY-NETWORKS
  118.  
  119.           To gate to Fido Technology networks you need to create one
  120.           text file and also set an environment variable UTIGATE to
  121.           point to the text file.  There are currently two keywords
  122.           for the text file ADDR for your Fido-Technology address and
  123.           ORIGIN for your origin text.
  124.  
  125.           Example
  126.  
  127.           Set UTIGATE=C:\MK\FTS.TXT
  128.  
  129.           In the FTS.TXT file
  130.  
  131.           ;Can add comment lines starting with ';'
  132.           Addr     1:110/290
  133.           Origin   Mythical Kingdom Tech Bbs 513-237-7737 v32/HST
  134.  
  135.  
  136.  
  137.  
  138.                             UTI drivers for RA v2.0
  139.                      Copyright (C) 1992, 1993 by Mark May
  140.  
  141.  
  142.                                    FUNCTIONS
  143.  
  144.              Although the UTI level 2 specifications are Proprietary
  145.              (see Kip Compton - author of Pc-Relay & MegaMail for more
  146.              infomation).  I will give a brief overview of the command
  147.              line and function of the programs included in the UTI driver
  148.              set.  The information given here is the most that I can give
  149.              out without violating the Proprietary nature of the Level 2
  150.              UTI specifications.  To use the UTI drivers with either
  151.              PC-Relay or MegaMail, you will not usually need to know
  152.              any of the following.  It is informational only to help
  153.              if you do have problems.
  154.  
  155.  
  156.  
  157.  
  158.              UTIVER.EXE    UTI version program (2.1) writes the UTI
  159.              version supported to an ascii text file
  160.  
  161.                              UTIVER Path\Filename.Ext
  162.  
  163.  
  164.  
  165.              UTILIST.EXE   Conference (message area) lister will make
  166.              a list of all message areas and board numbers for all
  167.              areas that are defined in your config.bbs or messages.ra
  168.              file
  169.                              UTILIST Path\Filename.Ext
  170.  
  171.  
  172.  
  173.  
  174.              UTIHIGH.EXE   High message number finder.  Make a list
  175.              of the highest message number in the bbs for the specified
  176.              conference (message board) area
  177.  
  178.                      UTIHIGH Conference Path\Filename.Ext
  179.  
  180.  
  181.  
  182.                             UTI drivers for RA v2.0
  183.                      Copyright (C) 1992, 1993 by Mark May
  184.  
  185.  
  186.  
  187.  
  188.              UTIIMPRT.EXE  Imports messages into the bbs from a UTI format
  189.              text file.
  190.  
  191.              UTIIMPRT Conference Path\Filename [Difference.Txt] [/NETWORK]
  192.  
  193.  
  194.  
  195.              UTIEXPRT.EXE  Exports messages out of the bbs to a UTI format
  196.              text file starting after the specified starting message number.
  197.  
  198.              UTIEXPRT Conference Start# Path\Filename [/NETWORK]
  199.  
  200.  
  201.  
  202.  
  203.                             UTI drivers for RA v2.0
  204.                      Copyright (C) 1992, 1993 by Mark May
  205.  
  206.  
  207.           MRUti v2.01            REGISTRATION
  208.  
  209.           If you would fill in the form below and return it to me
  210.           so that I can keep track of who has found this interface
  211.           useful.
  212.  
  213.  
  214.           Registration Information:                  MRUti v2.01
  215.  
  216.  
  217.           Name:         ____________________________________________
  218.  
  219.           Address:      ____________________________________________
  220.  
  221.                         ____________________________________________
  222.  
  223.           City, ST Zip  ____________________________________________
  224.  
  225.  
  226.           Bbs Name:     ____________________________________________
  227.  
  228.           Bbs Type Version (MK, Quick, RA, Super) __________________
  229.  
  230.           Bbs Phone Number  (     )        -
  231.  
  232.           Any suggestions or comments ______________________________
  233.  
  234.           __________________________________________________________
  235.  
  236.           __________________________________________________________
  237.  
  238.  
  239.           Registrations should be mailed to:
  240.  
  241.           Mark May
  242.           Mythical Kingdom Software
  243.           P.O. Box 24808
  244.           Huber Heights, OH 45424
  245.  
  246.  
  247.                                     SUPPORT
  248.  
  249.           You may leave questions or get the latest version by
  250.           calling:
  251.  
  252.           Mythical Kingdom Tech Bbs
  253.  
  254.           Phone (513) 237-7737 9600 baud HST/V32
  255.           FidoNet            1:110/290
  256.           RIME (RelayNet)    ->MYTHKING
  257.  
  258.           If you netmail a question you will need to poll
  259.           (in a couple of days normally) to get your answer.
  260.  
  261.