home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / OFFLINE / TRNET601.ZIP / TRINET.DOC < prev    next >
Text File  |  1993-07-06  |  9KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  TriNet 6.0
  8.        A QWK Networking Program for the TriBBS Bulletin Board System
  9.                  Copyright (c) 1991-1993 By Mark D. Goodwin
  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.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      TRIBBS=directory
  74.  
  75.      This is a required configuration file statement and  simply tells
  76.      TriNet where your main TriBBS directory is located.
  77.  
  78.  
  79.      HSYSOP[n]=host sysop's name
  80.  
  81.      This is  a required configuration file statement and simply tells
  82.      TriNet the  host sysop's  name.  This  statement is  necessary so
  83.      TriNet can translate  any incoming messages  from "Sysop" to  the
  84.      host sysop's name.  An optional network number from 0 to 9 can be
  85.      specified by "n".   You should note that  HSYSOP and HSYSOP0  are
  86.      synonymous.
  87.  
  88.  
  89.      HTAG[n]=host tag line 
  90.  
  91.      This is a required configuration  file statement and simply tells
  92.      TriNet  the host's  tag line.   Whenever  TriNet doesn't  find an
  93.      origin tag line in an incoming message, it will insert a tag line
  94.      using the host's tag line.  An optional network number from  0 to
  95.      9 can be specified by "n".   You should note that HTAG and  HTAG0
  96.      are synonymous.
  97.  
  98.  
  99.      LSYSOP[n]=local sysop's name
  100.  
  101.      This is a required configuration file  statement and simply tells
  102.      TriNet the name  of the local sysop's name.  In other words, your
  103.      name.   This  option is  necessary  so TriNet  can translate  any
  104.      outgoing messages from "Sysop" to your name.  An optional network
  105.      number from 0 to 9 can be specified by "n".  You should note that
  106.      LSYSOP and LSYSOP0 are synonymous.
  107.  
  108.  
  109.      LTAG[n]=local tag line
  110.  
  111.      This is a required configuration file statement and  simply tells
  112.      TriNet the tag line for your board.  Whenever TriNet doesn't find
  113.      an origin tag line  in an outgoing message, it will  insert a tag
  114.      line using  your board's  tag line.   An optional  network number
  115.      from 0  to 9 can be specified by "n".   You should note that LTAG
  116.      and LTAG0 are synonymous.
  117.  
  118.  
  119.      BULLETIN=filename
  120.  
  121.      This  is an  optional configuration  file  statement.   If it  is
  122.      specified  in  the  configuration  file,  TriNet  will  create  a
  123.      monochrome bulletin each time it imports messages.
  124.  
  125.  
  126.      NOAPPEND
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      This  is an  optional configuration  file  statement.   Normally,
  140.      TriNet will append  any new outgoing messages to  an existing REP
  141.      packet.   The  NOAPPEND  option  instructs TriNet  to  delete  an
  142.      existing REP packet before processing any new outgoing messages.
  143.  
  144.  
  145.      STRIPNULLS
  146.  
  147.      This is an optional configuration  file statement.  Some QWK mail
  148.      doors (most notably Qmail) incorrectly puts null characters (00H)
  149.      into  message  blocks.    Unfortunately,  others  (most   notably
  150.      MarkMail) put garbage message blocks  into QWK packets and can be
  151.      corrected for by  ignoring blocks that have null  characters.  So
  152.      to provide for greater compatibility  with QMail, you may want to
  153.      specify  STRIPNULLS in  your configuration  file if  your hub  is
  154.      using QMail.  This will instruct TriNet to simply strip  away any
  155.      null characters it encounters in a message block.
  156.  
  157.  
  158.      CONF=local conference,host conference[,network]
  159.  
  160.      You   must  specify  at  least  one  CONF  statement  per  TriNet
  161.      configuration  file.  This statement tells TriNet what conference
  162.      numbers are being used  on both your board and your host's board.
  163.      When you  participate in a  QWK network,  it is more  than likely
  164.      that the  conference numbers on  your board will differ  from the
  165.      conference numbers on your  host's board.  Accordingly, you  must
  166.      include   a  CONF   statement  for   each   conference  you   are
  167.      participating in.  Let's suppose you are carrying a C programming
  168.      conference  on  your  board  as  conference  number  3,  but  the
  169.      conference is number  11 in your host's  QWK packets.  You  would
  170.      have to include  a statement like CONF=3,11 in your configuration
  171.      file for TriNet to properly handle the conference.
  172.  
  173.      You may also specify a network number (0 to 9) to the conference.
  174.      If you do not specify a network number, TriNet assumes network 0.
  175.      Let's suppose  in the  above example, that  you get  two networks
  176.      from the  same host and that the  above conference is for network
  177.      1.   Accordingly, you would  use a statement like  CONF=3,11,1 to
  178.      specify the proper conference and network numbers.
  179.  
  180.  
  181.      IMPORTING MESSAGES WITH TRINET
  182.      ------------------------------
  183.  
  184.      Messages can be  imported with TriNet by using  the following DOS
  185.      command line:
  186.  
  187.      TRINET IMPORT host
  188.  
  189.      Where "host" is the  host's QWK mail door id.   If your host's id
  190.      was  LOBSTER you could  import your  messages with  the following
  191.      statement:
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      TRINET IMPORT LOBSTER
  206.  
  207.      NOTE: All QWK packets must be  in the TriNet directory for TriNet
  208.      to properly process them.
  209.  
  210.  
  211.      EXPORTING MESSAGES WITH TRINET
  212.      ------------------------------
  213.  
  214.      Messages can be  exported with TriNet by using  the following DOS
  215.      command line:
  216.  
  217.      TRINET EXPORT host
  218.  
  219.      Where "host" is the host's QWK  mail door id.  If your  host's id
  220.      is  LOBSTER, you could  export your  messages with  the following
  221.      statement:
  222.  
  223.      TRINET EXPORT LOBSTER
  224.  
  225.      NOTE: TriNet will place the REP packet in the TriNet directory.
  226.  
  227.  
  228.      HIGH MESSAGE POINTERS
  229.      ---------------------
  230.  
  231.      To be able  to keep track of  what messages have or  haven't been
  232.      exported from your message base,  TriNet maintains a file of high
  233.      message pointers.  This file has  a filename of host.HGH.   Where
  234.      "host"  is  your host's  QWK  mail  door  id.   Normally,  TriNet
  235.      maintains this high message pointer file automatically.  However,
  236.      there are times when you may need to manually intervene.
  237.  
  238.      For example, you may reconfigure your message  conferences.  This
  239.      is no big deal;  but if the changes you make  move your networked
  240.      conferences  around,  the  high  message  pointer  file  will  be
  241.      incorrect.   The  solution to  preventing  such a  problem is  to
  242.      export all networked messages  before changing your configuration
  243.      and then running  RESET.EXE after you change  your configuration.
  244.      RESET is run with the following command line:
  245.  
  246.      RESET host
  247.  
  248.      Where "host" is  your host's QWK  mail door id.   By taking  this
  249.      action,  all unexported  messages will  be exported and  all high
  250.      message pointers will be correct.
  251.  
  252.      A similar situation may occur if you renumber one or more of your
  253.      networked conferences with  TRIPACK.  (Remember, you  should only
  254.      renumber your message  base conferences if they are  in danger of
  255.      rolling over  999,999.)  Simply  export any messages,  run RESET,
  256.      and then run TRIPACK.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      SUPPORT
  272.      -------
  273.  
  274.      If you  have any  problems installing and  using TriNet,  you can
  275.      obtain  support by calling either The Lobster Buoy, 207-941-0805,
  276.      or any other TriBBS support board.
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.