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