home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / TRINET71.ZIP / TRINET.DOC < prev    next >
Text File  |  1994-11-09  |  12KB  |  309 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   TriNet 7.1
  8.      A QWK Networking Program for the TriBBS (R) Bulletin Board System
  9.                      Copyright (c) 1991-1994 By TriSoft
  10.  
  11.  
  12.      TriNet  is a QWK networking program that allows your TriBBS board
  13.      to  participate  in  one  of  the  many  QWK-based mail networks.
  14.      Essentially,  you  download QWK packets from your host's QWK mail
  15.      door.    You  then import these messages into your TriBBS message
  16.      base  using  TriNet.   In return, you export messages out of your
  17.      TriBBS message base by having TriNet create a REP file.  You then
  18.      upload  these  messages  to  the net through your host's QWK mail
  19.      door.
  20.  
  21.  
  22.      THE TRINET DIRECTORY
  23.      ---------------------
  24.  
  25.      The  first  step  during  the  TriNet  installation process is to
  26.      create  a directory for the networking program and copy the files
  27.      TRINET.EXE and RESET.EXE into the newly created directory.
  28.  
  29.  
  30.      THE CONFIGURATION FILE
  31.      ----------------------
  32.  
  33.      Next,  you  must  create  a  configuration  file  in  your TriNet
  34.      directory.    The  configuration  file is the key to successfully
  35.      operating  TriNet.  You must create a configuration file for each
  36.      network  host  you  do  transfers  with.  Let's suppose your host
  37.      produces  QWK  packets with the QWK mail door id of LOBSTER.  You
  38.      would  have  to  name  your  configuration file LOBSTER.CFG.  The
  39.      following is a sample configuration file:
  40.  
  41.      tribbs=c:\tribbs
  42.      hsysop=Mark Goodwin
  43.      htag=Test Network: The Lobster Buoy * 207-941-0805
  44.      lsysop=Denise Goodwin
  45.      ltag=Test Network: The Lobster Buoy (Test Board) * 207-555-5555
  46.      hsysop1=Mark Goodwin
  47.      htag1=TTN: The Lobster Buoy * 207-941-0805
  48.      lsysop1=Denise Goodwin
  49.      ltag1=TTN: The Lobster Buoy (Test Board) * 207-555-5555
  50.      bulletin=c:\tribbs\display\bullet1.bbs
  51.      noappend
  52.      conf=5,7
  53.      conf=4,13,1
  54.  
  55.      You  should  note  that  the  order  of  the  configuration  file
  56.      statements isn't significant.  The following explanations provide
  57.      more  detail  about  each  of  the  TriNet  configuration  file's
  58.      statements:
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      TRIBBS=directory
  65.  
  66.      This  is a required configuration file statement and simply tells
  67.      TriNet where your main TriBBS directory is located.
  68.  
  69.  
  70.      HSYSOP[n]=host sysop's name
  71.  
  72.      This  is a required configuration file statement and simply tells
  73.      TriNet  the  host  sysop's  name.  This statement is necessary so
  74.      TriNet  can  translate  any incoming messages from "Sysop" to the
  75.      host sysop's name.  An optional network number from 0 to 9 can be
  76.      specified  by  "n".   You should note that HSYSOP and HSYSOP0 are
  77.      synonymous.
  78.  
  79.  
  80.      HTAG[n]=host tag line 
  81.  
  82.      This  is a required configuration file statement and simply tells
  83.      TriNet  the  host's  tag  line.   Whenever TriNet doesn't find an
  84.      origin tag line in an incoming message, it will insert a tag line
  85.      using  the host's tag line.  An optional network number from 0 to
  86.      9  can  be specified by "n".  You should note that HTAG and HTAG0
  87.      are synonymous.
  88.  
  89.  
  90.      LSYSOP[n]=local sysop's name
  91.  
  92.      This  is a required configuration file statement and simply tells
  93.      TriNet  the name of the local sysop's name.  In other words, your
  94.      name.    This  option  is  necessary  so TriNet can translate any
  95.      outgoing messages from "Sysop" to your name.  An optional network
  96.      number from 0 to 9 can be specified by "n".  You should note that
  97.      LSYSOP and LSYSOP0 are synonymous.
  98.  
  99.  
  100.      LTAG[n]=local tag line
  101.  
  102.      This  is a required configuration file statement and simply tells
  103.      TriNet the tag line for your board.  Whenever TriNet doesn't find
  104.      an  origin  tag line in an outgoing message, it will insert a tag
  105.      line  using  your  board's  tag line.  An optional network number
  106.      from  0  to 9 can be specified by "n".  You should note that LTAG
  107.      and LTAG0 are synonymous.
  108.  
  109.  
  110.      BULLETIN=filename
  111.  
  112.      This  is  an  optional  configuration  file  statement.  If it is
  113.      specified  in  the  configuration  file,  TriNet  will  create  a
  114.      monochrome bulletin each time it imports messages.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.      NOAPPEND
  121.  
  122.      This  is  an  optional  configuration  file statement.  Normally,
  123.      TriNet  will  append any new outgoing messages to an existing REP
  124.      packet.    The  NOAPPEND  option  instructs  TriNet  to delete an
  125.      existing REP packet before processing any new outgoing messages.
  126.  
  127.  
  128.      LOGFILE=log file's complete pathname
  129.  
  130.      This  is  an  optional  configuration  file  statement.  If it is
  131.      specified in the configuration file, TriNet will log all activity
  132.      to the specified log file each time it is run.
  133.  
  134.  
  135.      STRIPNULLS
  136.  
  137.      This  is an optional configuration file statement.  Some QWK mail
  138.      doors (most notably Qmail) incorrectly puts null characters (00H)
  139.      into   message  blocks.    Unfortunately,  others  (most  notably
  140.      MarkMail)  put garbage message blocks into QWK packets and can be
  141.      corrected  for  by ignoring blocks that have null characters.  So
  142.      to  provide for greater compatibility with QMail, you may want to
  143.      specify  STRIPNULLS  in  your  configuration  file if your hub is
  144.      using  QMail.  This will instruct TriNet to simply strip away any
  145.      null characters it encounters in a message block.
  146.  
  147.  
  148.      ARCHIVER=archive type
  149.  
  150.      This  is  an  optional configuration file statement.  By default,
  151.      TriNet  uses  PKZIP and PKUNZIP to compress and decompress files.
  152.      However, the ARCHIVER statement can be used to specify one of the
  153.      following archivers:
  154.  
  155.           ============================================================
  156.           Archive Type        EXEs Needed
  157.           ------------------------------------------------------------
  158.           ZIP                 PKZIP.EXE and PKUNZIP.EXE
  159.           LHA                 LHA.EXE
  160.           ARJ                 ARJ.EXE
  161.           ARC                 PAK.EXE
  162.           PAK                 PAK.EXE
  163.           ============================================================
  164.  
  165.  
  166.      CONF=local conference,host conference[,network]
  167.  
  168.      You   must  specify  at  least  one  CONF  statement  per  TriNet
  169.      configuration  file.  This statement tells TriNet what conference
  170.      numbers  are being used on both your board and your host's board.
  171.      When  you  participate  in  a QWK network, it is more than likely
  172.      that  the  conference  numbers on your board will differ from the
  173.      conference  numbers  on your host's board.  Accordingly, you must
  174.  
  175.  
  176.  
  177.  
  178.  
  179.      i n c l u de  a  CONF  statement  for  each  conference  you  are
  180.      participating in.  Let's suppose you are carrying a C programming
  181.      conference  on  your  board  as  conference  number  3,  but  the
  182.      conference  is  number  11 in your host's QWK packets.  You would
  183.      have  to include a statement like CONF=3,11 in your configuration
  184.      file for TriNet to properly handle the conference.
  185.  
  186.      You may also specify a network number (0 to 9) to the conference.
  187.      If you do not specify a network number, TriNet assumes network 0.
  188.      Let's  suppose  in  the  above example, that you get two networks
  189.      from  the  same host and that the above conference is for network
  190.      1.    Accordingly,  you would use a statement like CONF=3,11,1 to
  191.      specify the proper conference and network numbers.
  192.  
  193.  
  194.      IMPORTING MESSAGES WITH TRINET
  195.      ------------------------------
  196.  
  197.      Messages  can  be imported with TriNet by using the following DOS
  198.      command line:
  199.  
  200.      TRINET IMPORT host
  201.  
  202.      Where  "host"  is the host's QWK mail door id.  If your host's id
  203.      was  LOBSTER  you  could  import your messages with the following
  204.      statement:
  205.  
  206.      TRINET IMPORT LOBSTER
  207.  
  208.      NOTE:  All QWK packets must be in the TriNet directory for TriNet
  209.      to properly process them.
  210.  
  211.  
  212.      EXPORTING MESSAGES WITH TRINET
  213.      ------------------------------
  214.  
  215.      Messages  can  be exported with TriNet by using the following DOS
  216.      command line:
  217.  
  218.      TRINET EXPORT host
  219.  
  220.      Where  "host"  is the host's QWK mail door id.  If your host's id
  221.      is  LOBSTER,  you  could  export your messages with the following
  222.      statement:
  223.  
  224.      TRINET EXPORT LOBSTER
  225.  
  226.      NOTE: TriNet will place the REP packet in the TriNet directory.
  227.  
  228.  
  229.      HIGH MESSAGE POINTERS
  230.      ---------------------
  231.  
  232.      To  be  able  to keep track of what messages have or haven't been
  233.  
  234.  
  235.  
  236.  
  237.  
  238.      exported  from your message base, TriNet maintains a file of high
  239.      message  pointers.   This file has a filename of host.HGH.  Where
  240.      "host"  is  your  host's  QWK  mail  door  id.   Normally, TriNet
  241.      maintains this high message pointer file automatically.  However,
  242.      there are times when you may need to manually intervene.
  243.  
  244.      For  example, you may reconfigure your message conferences.  This
  245.      is  no  big deal; but if the changes you make move your networked
  246.      conferences  around,  the  high  message  pointer  file  will  be
  247.      incorrect.    The  solution  to  preventing  such a problem is to
  248.      export  all networked messages before changing your configuration
  249.      and  then  running RESET.EXE after you change your configuration.
  250.      RESET is run with the following command line:
  251.  
  252.      RESET host
  253.  
  254.      Where  "host"  is  your  host's QWK mail door id.  By taking this
  255.      action,  all  unexported  messages  will be exported and all high
  256.      message pointers will be correct.
  257.  
  258.      A similar situation may occur if you renumber one or more of your
  259.      networked  conferences  with TRIPACK.  (Remember, you should only
  260.      renumber  your  message base conferences if they are in danger of
  261.      rolling  over  999,999.)   Simply export any messages, run RESET,
  262.      and then run TRIPACK.
  263.  
  264.  
  265.      TWITTING OUT PROBLEM PEOPLE
  266.      ---------------------------
  267.  
  268.      Unfortunately, we all run into undesirable characters who like to
  269.      cause  trouble on networks.  TriNet allows you to setup a special
  270.      ASCII  text file called host.TWT (where "host" is host's QWK mail
  271.      id)  in  order to twit people out.  Once a person's name has been
  272.      placed  in  the twit file, any messages that are addressed either
  273.      from  or to a user will be not be imported or exported by TriNet.
  274.      People  can  be  twitted  out  of  all  networks or just selected
  275.      networks.
  276.  
  277.      As  stated above, the twit file is an ASCII text file.  Each line
  278.      in the twit file uses the following format:
  279.  
  280.      UsersName[,NetworkNumber,NetworkNumber,...]
  281.  
  282.      Where:
  283.  
  284.      UsersName           is the name of the user to be twitted.
  285.  
  286.      NetworkNumber       is  a  network that the user is to be twitted
  287.                          o u t   of.    If  not  network  numbers  are
  288.                          specified,  TriNet  will twit the user out of
  289.                          all networks.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.      The following is a sample twit file:
  296.  
  297.      Joe Hacker
  298.      Dr. Doom,0,2
  299.  
  300.      The  above twit file would twit out Joe Hacker globally and would
  301.      twit out Dr. Doom from conferences 0 and 2.
  302.  
  303.  
  304.      SUPPORT
  305.      -------
  306.  
  307.      If  you  have  any  problems installing and using TriNet, you can
  308.      obtain  support by calling either The Lobster Buoy, 207-941-0805,
  309.      or any other TriBBS support board.