home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / FIDOGT13.ZIP / FIDOGATE.DOC < prev    next >
Text File  |  1992-07-16  |  19KB  |  618 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    FidoGate v 1.3
  20.  
  21.                    An add-on utility for Novell's Message Handling
  22.                          Service to provide exchange of mail
  23.                          with FidoNet-style NetMail messages
  24.  
  25.                               Written by Darwin Collins
  26.                             Documentation by Marc Nowell
  27.  
  28.                         Copyright 1992 CLS and Darwin Collins
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                   Table of Contents
  35.  
  36.  
  37.             Introduction .............................................3
  38.             How To Contact Us ........................................3
  39.             Licenses, Warranties and Disclaimers .....................4
  40.             Shareware - How to Register ..............................4
  41.             Overview of Functions ....................................4
  42.             Installation .............................................5
  43.             FIDOGATE.CFG Contents ....................................6
  44.             Usage ....................................................9
  45.             A Really Weird Routing Idea ..............................10
  46.             Acknowledgments ..........................................11
  47.             History ..................................................11
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.                                     Page 2 of 11
  88.  
  89.  
  90.  
  91.  
  92.  
  93.                                     Introduction
  94.  
  95.  
  96.                  Since both Darwin and I are BBS operators, we have used
  97.             NetMail for some time.  Since we feel that Novell's MHS is
  98.             gaining ground as a "switchboard" for email, we wanted a way
  99.             to gateway messages from the NetMail standard .MSG format to
  100.             the SMF-70 format that MHS 1.5 uses.  This product is the
  101.             result.
  102.  
  103.                  The layout of the this package tends to mirror the
  104.             setup of a FidoNet-style mailer/BBS.  Whereas the setup
  105.             might not be of the "question and answer" type, it is very
  106.             straightforward and simple for the average MHS
  107.             administrator.  (If you can set up MHS, then setting up
  108.             FidoGate should be a breeze!)
  109.  
  110.  
  111.  
  112.                                   How To Contact Us
  113.  
  114.  
  115.                  In order of preference/speed of us getting it and
  116.             responding:
  117.  
  118.             1.   MHS Host CLS - (214) 399-8313, - USRobotics HST - Mail
  119.                  to Marc@CLS or Darwin@CLS - available direct, CServe,
  120.                  or NHUB. (Direct is fastest!)  Due to financial
  121.                  considerations, namely connect time plus five bucks an
  122.                  hour (boo!), file attachments cannot be sent through
  123.                  CServe at this time.  Messages through CServe will be
  124.                  picked up and responded to.
  125.  
  126.             2.   BBS (The MOCHINE) - (214) 399-8414 - USRobotics Dual
  127.                  Standard - Mail to SYSOP or Marc Nowell - NetMail to
  128.                  8:930/301.
  129.  
  130.             3.   CompuServe mail 75600,2274 (Darwin) or 71067,647
  131.                  (Marc).
  132.  
  133.             4.   US Mail to CLS, 2909 Lawrence, Irving, TX  75061, USA
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.                                     Page 3 of 11
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                         Licenses, Warranties and Disclaimers
  153.  
  154.  
  155.             I.   The shareware version of FidoGate may be distributed
  156.                  via electronic mail or electronic BBSs and information
  157.                  services as long as the contents of this archive have
  158.                  not been modified.  The shareware distribution set may
  159.                  be distributed by software libraries as long as the
  160.                  compensation is less than $7.50 for the distribution
  161.                  disk.  The shareware software may be included with
  162.                  other packages or publications only with the permission
  163.                  of CLS, which will usually be granted.
  164.  
  165.             II.  The registered version of FidoGate may not be
  166.                  redistributed, and the normal rules of commercial
  167.                  copyrighted software apply.
  168.  
  169.             III. NO WARRANTY.  ANY USE BY YOU OF THE SOFTWARE IS AT YOUR
  170.                  OWN RISK.  THE SOFTWARE IS PROVIDED FOR USE AS IS
  171.                  WITHOUT WARRANTY OF ANY KIND.  CLS, MARC NOWELL, AND
  172.                  DARWIN COLLINS DISCLAIM ALL WARRANTIES OF ANY KIND,
  173.                  EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT
  174.                  LIMITATION, IMPLIED WARRANTIES OF MERCHANTABILITY AND
  175.                  FITNESS FOR A PARTICULAR PURPOSE.
  176.  
  177.             IV.  In other words, FidoGate is guaranteed to do nothing
  178.                  more than occupy your hard disk.  If it breaks in two,
  179.                  you own both pieces!
  180.  
  181.  
  182.  
  183.                              Shareware - How to Register
  184.  
  185.  
  186.                  FidoGate is shareware.  You are free to use it on a
  187.             trial basis for 30 days.  If you find it useful and want to
  188.             continue using it, you are required to register a copy.  The
  189.             cost is $49.95 in US funds plus sales tax, if you are in
  190.             Texas, USA.
  191.  
  192.                  Please see the REGISTER.FRM file in this archive for
  193.             more information.
  194.  
  195.  
  196.  
  197.                                 Overview of Functions
  198.  
  199.  
  200.             FidoGate presently provides the following functions:
  201.  
  202.  
  203.  
  204.  
  205.                                     Page 4 of 11
  206.  
  207.  
  208.  
  209.  
  210.  
  211.             -    Operates as a MHS gateway.  MHS v 1.5 or later is
  212.                  required and is not included in this package.
  213.  
  214.             -    Allows NetMail users to send messages directly to an
  215.                  MHS host with routing and file attachments.
  216.  
  217.             -    Allows users of a MHS-enabled email system to send
  218.                  messages to a FidoNet-compatible NetMail system with
  219.                  file attachments.
  220.  
  221.             -    The gateway is not only run by MHS, but a copy of it
  222.                  may also be run by your front-end mailer via its batch
  223.                  file(s).
  224.  
  225.  
  226.  
  227.                                     Installation
  228.  
  229.  
  230.             1.   Read the entire set of instructions before you start!
  231.  
  232.             2.   Backup your existing MHS installation, as you should do
  233.                  before making *any* changes.
  234.  
  235.             3.   Make sure the MHS router is *not* running, or some of
  236.                  the following instructions will fail.
  237.  
  238.             4.   Change to the \MHS\EXE subdirectory.
  239.  
  240.             5.   Issue the following command, replacing the [MHS admin
  241.                  pwd] with the password of your MHS administrative user.
  242.                  If there is no password, use the -S alone:
  243.  
  244.                  MHSUSER -X31 -HFIDOGATE -T4 -S[MHS admin pwd] -EFIDOGATE
  245.                  -C70 -V
  246.  
  247.                  This will create MHS directory structure for the
  248.                  gateway and define it to the MHS server.  The above
  249.                  command line (and the following one!) is included in
  250.                  STEP_56.BAT for those who had rather not type it all
  251.                  in....
  252.  
  253.             6.   Issue the following command, replacing the [MHS admin
  254.                  pwd] with the password of your MHS administrative user.
  255.                  If there is no password, use the -S alone:
  256.  
  257.                  MHSUSER -X41 -UFIDOGATE -EFIDOGATE -RFIDOGATE -S[MHS
  258.                  admin pwd] -V
  259.  
  260.                  This command will create a user route for a user named
  261.                  FIDOGATE and will direct it to the FidoGate gateway.
  262.  
  263.  
  264.                                     Page 5 of 11
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.             7.   Change to the \MHS\MAIL\GATES\FIDOGATE\PUBLIC
  272.                  subdirectory.
  273.  
  274.                  If this subdirectory doesn't exist, something went
  275.                  wrong with step 5!
  276.  
  277.             8.   Copy all of the files from the FidoGate distribution
  278.                  set into this directory.
  279.  
  280.             9.   Issue the following command:
  281.  
  282.                  COPY FIDOGATE.EXE OUTPOST.EXE
  283.  
  284.                  This will create the actual gateway program.
  285.  
  286.             10.  Edit the FIDOGATE.CFG file to suit your tastes.  The
  287.                  entries are described in comments in the file itself.
  288.                  You will need to put your administrator's name and some
  289.                  passwords in here.  Also, you will define the name of
  290.                  various text files that FidoGate will use.  You may
  291.                  keep the default file names and edit the sample text
  292.                  files included, if you like.  The individual items in
  293.                  FIDOGATE.CFG and the text files are discussed in the
  294.                  next sections.
  295.  
  296.             11.  If you want the gateway to be executed by your BBS or
  297.                  mailer's batch file(s), copy the FIDOGATE.EXE and
  298.                  FIDOGATE.CFG files to the appropriate directory on your
  299.                  BBS system.  If the drive letters differ from your MHS
  300.                  system, edit the FIDOGATE.CFG file to reflect this.
  301.  
  302.             12.  Re-start the MHS router.
  303.  
  304.             13.  You're done!
  305.  
  306.  
  307.  
  308.                                 FIDOGATE.CFG Contents
  309.  
  310.  
  311.             Note:     All lines beginning with a semicolon are comments
  312.                       and are ignored by FidoGate.  All other lines
  313.                       should contain valid FidoGate commands.
  314.  
  315.                       Do give a valid path and filename for all
  316.                       commands.
  317.  
  318.                       Do not comment out any commands.
  319.  
  320.  
  321.  
  322.  
  323.                                     Page 6 of 11
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                       Do liberally edit any and all of the text files
  330.                       "pointed" to by FIDOGATE.CFG!  The included
  331.                       examples are examples *only*, feel free to
  332.                       experiment!  Namely, change all the references to
  333.                       USER@HOST to the name of your administrative user!
  334.  
  335.  
  336.             FIDOGATEADDRESS
  337.  
  338.                  The UserName and HostName of the Gateway.  For example,
  339.                  FIDOGATE@CLS
  340.  
  341.             ADMINADDRESS
  342.  
  343.                  Address of the human administrator for the gateway.
  344.                  Notices from the gateway will be sent to this address.
  345.  
  346.             PRIMARY_FTN_ORIGIN
  347.  
  348.                  Origin line for NetMail messages (Also used for the
  349.                  import tagline).  Origin line is truncated at 65
  350.                  characters.
  351.  
  352.             PRIMARY_FTN_ADDRESS
  353.  
  354.                  Zone:Net/Node.Point@Domain
  355.  
  356.                  The address that your node is in.  The full address is
  357.                  required.
  358.  
  359.             AKA_FTN_ADDRESS
  360.  
  361.                  Zone:Net/Node.Point@Domain
  362.  
  363.                  AKA addresses that your node also uses. (up to 10 are
  364.                  accepted).  The full address is required.
  365.  
  366.             AKA_FTN_ORIGIN
  367.  
  368.                  Origin line for NetMail messages (Also used for the
  369.                  import tagline).  Origin line is truncated at 65
  370.                  characters.  One of these should immediately follow
  371.                  each AKA_FTN_ADDRESS, if any are used.
  372.  
  373.             DOMAIN
  374.  
  375.                  FullName, Abbreviation, and NodeListName
  376.  
  377.                  Descriptions of the Domains to be supported. (Up to 10
  378.                  are accepted.)  FullName is the full name of the domain
  379.                  name, for example: FIDONET.ORG, RBBSNET.ORG,
  380.  
  381.  
  382.                                     Page 7 of 11
  383.  
  384.  
  385.  
  386.  
  387.  
  388.                  ALTERNET.FTN, EGGNET.FTN.  Abbreviation (8 character
  389.                  max.) -- Abbreviated or command-use name of the domain.
  390.                  For example, FIDONET, RBBSNET.  NodeList (8 character
  391.                  max.) -- the name of the nodelist that contains
  392.                  addresses for this domain.  For example, NODELIST,
  393.                  RBBSLIST.
  394.  
  395.             NODELIST_DIRECTORY
  396.  
  397.                  Drive:\Path of NODELIST.IDX & NODELIST.DAT (Binkley
  398.                  version 6 nodelist) or Drive:\Path of NODEX.NDX &
  399.                  NODEX.DAT (version 7 nodelist).  This file lists all
  400.                  the sytem operator's names and their Net/Node numbers.
  401.  
  402.             MAILER_OUTBOUND
  403.  
  404.                  Drive:\Path of the mailer's outbound area
  405.  
  406.                  Program will create the .FLO (file attach) files in
  407.                  this sub-directory).  If NONE is specified, the program
  408.                  will not create files and will mark attributes only in
  409.                  #.Msg.
  410.  
  411.             MAILER_INBOUND
  412.  
  413.                  Drive:\Path of the mailer's inbound area
  414.  
  415.                  Where your BBS/mailer would drop incoming NetMail file
  416.                  attachments.  This is where FidoGate will attempt to
  417.                  pick them up.
  418.  
  419.             TEMP_DIRECTORY
  420.  
  421.                  Drive:\PathName to use for busy flag / temporary files
  422.  
  423.             NETMAIL_DIRECTORY
  424.  
  425.                  Drive:\PathName that all NetMail messages are stored in
  426.  
  427.             DEFAULT_PACKER
  428.  
  429.                  Utility that you use to package messages into .MO?
  430.                  files for transmission.  Options are: ARC, ARJ, LHARC,
  431.                  PKARC, PKPAK, PKZIP, or NONE.  NONE will create only
  432.                  .PKT files, and not any .MO? files
  433.  
  434.             MHSDIRECTORY
  435.  
  436.                  Drive:\Path that is similar to the purpose of the MV
  437.                  variable.  This allows you to designate a different
  438.  
  439.  
  440.  
  441.                                     Page 8 of 11
  442.  
  443.  
  444.  
  445.  
  446.  
  447.                  host to handle outbound mail.  Server Name paths are
  448.                  not allowed, a valid drive letter must be specified.
  449.  
  450.             ACTIVITYFILE
  451.  
  452.                  Drive:\Path\FileName that all activity should be logged
  453.                  to.  If NONE is specified, no activity file will be
  454.                  kept.
  455.  
  456.             SUMMARYFILE
  457.  
  458.                  Drive:\Path\FileName that will contain summary data on
  459.                  message traffic.  If NONE is specified, no summary file
  460.                  will be kept.
  461.  
  462.  
  463.  
  464.                                         Usage
  465.  
  466.  
  467.                  To send a message from a NetMail system to a MHS
  468.                  mailbox:  (all parameters in []'s are OPTIONAL!)
  469.  
  470.             1.  Address the message to FIDOGATE at the correct
  471.                 zone:net/node that has the FidoGate gateway running on
  472.                 its BBS/mailer and/or MHS host.
  473.  
  474.             2.  In the message body include the following text: TO:
  475.                 user[.application]@host [{foreign address information}]
  476.                 [(comment)] [[intended host]]
  477.  
  478.             3.  Include a file attachment if you desire.
  479.  
  480.             4.  That's it!
  481.  
  482.             For example, to send a message to _me_, address a NetMail
  483.             message to FIDOGATE at 8:930/301.  In the message body, type
  484.             the text
  485.  
  486.                  TO: MARC@CLS
  487.  
  488.             on an otherwise blank line.  That'll do it!
  489.  
  490.  
  491.                  To send a message from a MHS system to a NetMail user:
  492.                  (all parameters in []'s are OPTIONAL!)
  493.  
  494.             1.  Address the message to FIDOGATE at the correct MHS host
  495.                 that has the FidoGate gateway running on its MHS host.
  496.  
  497.             2.  In the address, include a foreign address of
  498.  
  499.  
  500.                                     Page 9 of 11
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.                 {TO: username /FTN:zone:net/node.point [/crash]}
  508.  
  509.                 Username is the addressee's BBS user name.  Zone, net,
  510.                 node, and point numbers are the address of the BBS.  The
  511.                 BBS/Mailers nodelist _will_ be checked for the existance
  512.                 of the node that you specify.  If it does not exist, a
  513.                 return message will be generated to that effect.  The
  514.                 optional /crash parameter will have the gateway generate
  515.                 a crash outbound packet inself, and the BBS's mailer
  516.                 will not have to cycle to pack the message.  Otherwise
  517.                 the mailer will need to be run.
  518.  
  519.             3.  Include a file attachment if you desire.
  520.  
  521.             4.  If you request a receipt confirmation, FidoGate will
  522.                 send you a message telling you that the message was
  523.                 successfully gated.
  524.  
  525.             5.  That's it!
  526.  
  527.             For example, to send a message to _me_, address a MHS
  528.             address to
  529.  
  530.                  FIDOGATE@yourhost {to: Marc Nowell /FTN:8:930/301}
  531.  
  532.  
  533.  
  534.             A Really Weird Routing Idea
  535.  
  536.  
  537.                  Note:  This is not a reccomendation, just an example of
  538.             what a sufficiently twisted person could do with this
  539.             product!
  540.  
  541.                  Don't like MHS's general lack of good, sophisticated
  542.             modem drivers, poor support of data compression, and utter
  543.             lack of built-in scheduling?  ELIMINATE MHS AS A TRANPSORT
  544.             MECHANISM!
  545.  
  546.                  Set up BinkleyTerm or another absolutly free mailer at
  547.             each of your company's sites and hook those expensive modems
  548.             up to THEM instead of your MHS box!  Install FidoGate on
  549.             each one, then modify your email packages addresses to point
  550.             to the FidoGate instead!  Route ALL of your intersite mail
  551.             through FidoGate!
  552.  
  553.                  Ok, it's silly, but it works!  Think about it....
  554.  
  555.  
  556.  
  557.  
  558.  
  559.                                     Page 10 of 11
  560.  
  561.  
  562.  
  563.  
  564.  
  565.                                    Acknowledgments
  566.  
  567.  
  568.             Novell and NetWare MHS are trademarks of Novell, Inc.
  569.             Action Technologies, Inc., is the original creator of MHS.
  570.  
  571.             Thanks to Ron Wheeler for "idea bouncing" sessions.
  572.  
  573.  
  574.  
  575.                                        History
  576.  
  577.  
  578.             1.02      07/12/92
  579.  
  580.                  Initial release.  The SUMMARYFILE option hasn't been
  581.             implemented yet.  The ability to gateway echomail as well as
  582.             NetMail has not been completed yet.
  583.  
  584.  
  585.             1.3       07/16/92
  586.  
  587.                  Fixed two bugs:
  588.  
  589.                     1.If you have blank lines in the MHS message,
  590.                       FidoGate stripped them when it converted it to
  591.                       NetMail.  They now come through OK
  592.  
  593.                     2.When you attached a file(s) to a MHS message, they
  594.                       were not being "cleaned up" properly after the
  595.                       gateway moved them to the NetMail side.  The files
  596.                       deleted properly.
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.                                     Page 11 of 11