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