home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / DATACOM / INTERNET / UPC12B2 / DOC / ADVANCED.PRN < prev    next >
Encoding:
Text File  |  1993-10-04  |  73.4 KB  |  1,282 lines
  1.  
  2.  
  3.  
  4.                                         Advanced Installation and
  5.                                         Advanced Installation and
  6.                                         Advanced Installation and
  7.           Configuration Topics
  8.           Configuration Topics
  9.           Configuration Topics
  10.  
  11.  
  12.           ______________________________________________
  13.           Advanced Installation and Configuration Topics
  14.           ______________________________________________
  15.           Advanced Installation and Configuration Topics
  16.           ______________________________________________
  17.           Advanced Installation and Configuration Topics
  18.  
  19.  
  20.  
  21.           Changing How Mail is Addressed and Delivered Locally
  22.           Changing How Mail is Addressed and Delivered Locally
  23.           Changing How Mail is Addressed and Delivered Locally
  24.  
  25.  
  26.           An Overview of RMAIL
  27.           An Overview of RMAIL
  28.           An Overview of RMAIL
  29.  
  30.           Much of the advanced configuration you can do with UUPC/extended
  31.           involves changing how RMAIL delivers mail.  Before explaining how
  32.           to change it, a short summary of the default processing for mail
  33.           sent from a local user is in order:51
  34.  
  35.             1. The user generates mail via the MAIL program.52
  36.  
  37.             2. The user presses "s" to send the mail, invoking RMAIL.
  38.  
  39.             3. RMAIL reads the headers for the newly created message, and
  40.                decides to whom the message is addressed.
  41.  
  42.             4. RMAIL invokes a subroutine called _______
  43.                                                  deliver() for each
  44.  
  45.                address.
  46.  
  47.             5. _______
  48.                deliver() determines if the address to be delivered to is
  49.  
  50.                local, remote, or handled by a gateway program.53
  51.  
  52.             6. For remote mail addresses, the mail is queued for UUCICO to
  53.                transmit at a later time.
  54.  
  55.             7. For local mail addresses, a check is made for the address in
  56.                the system alias file.  If the alias exists, it is expanded
  57.                without checking the PASSWD file.  The addresses in the
  58.                expansion are processed via a recursive call to _______
  59.                                                                deliver(),
  60.  
  61.                except
  62.                except
  63.                except that addresses read directly from the system alias
  64.                file are not checked to be system aliases again.
  65.  
  66.                               
  67.  
  68.           51See Error! Bookmark not defined.
  69.                 Error! Bookmark not defined.
  70.                 Error! Bookmark not defined. for the detailed syntax of the
  71.           RMAIL command.
  72.  
  73.           52For remote mail, the MAIL program is bypassed, with UUXQT given
  74.           the job of invoking RMAIL for mail which has arrived on the local
  75.           system via UUCICO.
  76.  
  77.           53By default, mail destined for the nodename or domain name
  78.           specified in the UUPC.RC configuration file is assumed to be
  79.           local, and all other mail is remote.  This behavior is warped by
  80.           entries in the optional HOSTPATH file, if it exists.
  81.  
  82.           10/04/93                  - 133 -
  83.  
  84.  
  85.  
  86.           UUPC/extended 
  87.                         
  88.                         1.12b Installation and 
  89.                               Installation and 
  90.                               Installation and User's Reference
  91.                                                User's Reference
  92.                                                User's Reference
  93.  
  94.  
  95.             8. If the local address is not defined as a system alias, then
  96.                it is searched for in the PASSWD file.  If the address is
  97.                not a local user id,  then the mail is bounced (delivered)
  98.                to the local postmaster.54  If the "bounce" option is set,
  99.                the mail is also returned to the sender.55
  100.  
  101.             9. If the local address is valid, then the user's home
  102.                directory is checked for a file named FORWARD
  103.                                                      FORWARD
  104.                                                      FORWARD.  If this file
  105.                exists, the file is processed for delivery instructions,
  106.                otherwise the mail is delivered to the user's system mailbox
  107.                in the UUPC/extended mail directory.
  108.  
  109.           There are a number of ways to customize this processing,
  110.           described below.
  111.  
  112.  
  113.           Using Alias Files, Forward Files, and the HOSTPATH file
  114.           Using Alias Files, Forward Files, and the HOSTPATH file
  115.           Using Alias Files, Forward Files, and the HOSTPATH file
  116.  
  117.           Aliases in electronic mail serve two purposes. First, they allow
  118.           a individual user to type a familiar nickname (fred) rather than
  119.           a long full address (FFlintstone@dino.bedrock.bc) to address
  120.           mail.  The alias file thus works like an e-mail address book.
  121.           Secondly, aliases allow groups of users (such as mailing lists)
  122.           to be addressed by standard addresses.  Under UUPC/extended,
  123.           aliases are handled by two different types of optional alias
  124.           files: the user alias file and the system alias file (ALIASES)
  125.                                                                 ALIASES)
  126.                                                                 ALIASES).
  127.           The user alias file is used only 
  128.                                       only 
  129.                                       only for mail sent by a local user
  130.           using the MAIL front end.  The system alias file is used for all
  131.           local addresses processed by the RMAIL command.
  132.  
  133.           In addition, many mail systems (including UUPC/extended) support
  134.           the concept of a user forwarding his/her own mail via an optional
  135.           FORWARD
  136.           FORWARD
  137.           FORWARD file56.  The processing performed by the FORWARD
  138.                                                            FORWARD
  139.                                                            FORWARD file
  140.           overlaps that of the system alias file.  The primary difference
  141.           between the system aliases file and an individual's forward file
  142.           is that the system aliases file is generally maintained by a
  143.           system administrator for all special addresses in a system or
  144.           network, while the FORWARD
  145.                              FORWARD
  146.                              FORWARD file is maintained by the end user for
  147.           just his own mail.
  148.  
  149.                               
  150.  
  151.           54If the user id defined as the postmaster does not exist, the
  152.           mail is bounced a second time to the postmaster with validation
  153.           disabled.  This causes the mail to be delivered to the postmaster
  154.           even if the user id doesn't exist in the PASSWD file.
  155.  
  156.           55If for some reason the postmaster is not a valid user, the mail
  157.           bounces again to the postmaster, but with the validation bypassed
  158.           to avoid an endless loop.  If validation is bypassed, the mail is
  159.           written to the local mail directory under the Postmaster's user
  160.           id.
  161.  
  162.           56In UNIX systems which use SENDMAIL, the file is normally called
  163.           .forward
  164.           .forward
  165.           .forward.
  166.                                     -134-                     10/04/93
  167.  
  168.  
  169.  
  170.                                         Advanced Installation and
  171.                                         Advanced Installation and
  172.                                         Advanced Installation and
  173.           Configuration Topics
  174.           Configuration Topics
  175.           Configuration Topics
  176.  
  177.           In addition to the files described above and detailed further
  178.           below, UUPC/extended supports aliasing and re-routing entire
  179.           systems via an optional HOSTPATH 
  180.                                   HOSTPATH 
  181.                                   HOSTPATH file. This file allows mail for
  182.           entire systems to be treated as local mail, rerouted by a non-
  183.           default path, or directed to an arbitrary program for further
  184.           processing.
  185.  
  186.  
  187.           The User Alias File
  188.           The User Alias File
  189.           The User Alias File
  190.  
  191.           MAIL uses the user alias file to translate a short nickname to
  192.           the longer full name and address needed to send mail to a remote
  193.           site.  The expanded name and address  are actually written as
  194.           part of the mail header generated by MAIL.
  195.  
  196.           The user alias file may have any name.  It is located by the
  197.           Aliases=
  198.           Aliases=
  199.           Aliases= variable in the UUPC.RC or [userid].RC file.  If this
  200.           variable is not defined in either configuration file, no user
  201.           alias file is used.57  Blank lines and lines which begin with the
  202.           pound sign (#) are ignored.  Multiple users may share a user
  203.           alias file by defining the same name on the Aliases= 
  204.                                                       Aliases= 
  205.                                                       Aliases= line in the
  206.           UUPC.RC  file or their [userid].RC file, but only one alias file
  207.           is included by MAIL.  If the Aliases= 
  208.                                        Aliases= 
  209.                                        Aliases= line appears in both the
  210.           UUPC.RC and file the  [userid].RC file, only the alias file in
  211.           the  [userid].RC file is used.  A sample user alias file,
  212.           ALIASES.TXT is included with the distribution file.
  213.  
  214.               Note:
  215.               Note:
  216.               Note: The addresses supplied in the ALIASES.TXT file are
  217.                     valid addresses.  They are provided as examples and to
  218.                     assist you in getting more information about
  219.                     UUPC/extended, communications software in general,
  220.                     USENET, and the Internet.  However, they are not for
  221.                     random testing.  Abuses such as the user who sent mail
  222.                     to all the addresses in the file as a "hello world"
  223.                     test would force discarding of the live information for
  224.                     future releases.
  225.  
  226.           User aliases are defined in one of two formats.  One is used to a
  227.           define a nickname for a single addressee, and the other defines a
  228.           list of users.  The first format, defining one addressee's real
  229.           name and associated e-mail address, is done by putting the
  230.           information on one line in the alias file with the following
  231.           syntax:
  232.  
  233.             nickname     "Fullname" <address>
  234.  
  235.           Where nickname is the name you wish to use for the person when
  236.           sending mail to them, "Fullname" is the full name of the person,
  237.           and <address> is the electronic mail address for the person.  The
  238.           three fields must be separated by spaces or tabs.  Nicknames are
  239.                               
  240.  
  241.           57This should not be confused with the SYSTEM aliases file, which
  242.           has a fixed name as described on page 137.
  243.  
  244.           10/04/93                  - 135 -
  245.  
  246.  
  247.  
  248.           UUPC/extended 
  249.                         
  250.                         1.12b Installation and 
  251.                               Installation and 
  252.                               Installation and User's Reference
  253.                                                User's Reference
  254.                                                User's Reference
  255.  
  256.  
  257.           not case sensitive, addresses are case sensitive for some older
  258.           mailers, and the full name is not case sensitive but its owner
  259.           may be.  Thus, for our friend Fred, the alias would be:
  260.  
  261.             fred         "Fredrick Flintstone"
  262.             <FFlintstone@dino.bedrock.bc>
  263.  
  264.           When sending mail, the command:
  265.  
  266.             mail fred
  267.  
  268.           Will produce an addressee line with "Fredrick Flintstone"
  269.           <FFlintstone@dino.bedrock.bc>.
  270.  
  271.           You can also define lists of addresses by defining a nickname
  272.           with one or more nicknames for the addressee, such as:
  273.  
  274.             groupname    nickname1 nickname2 nickname3 ...
  275.  
  276.           You must not
  277.                    not
  278.                    not put multiple full names/address pairs on one line,
  279.           as the results will be unpredictable.58  You can specify groups59
  280.           within other groups. As an example, to define all of Fred's
  281.           family and send to them as group, the aliases could look like:
  282.  
  283.             WRONG:
  284.             WRONG:
  285.             WRONG:
  286.  
  287.             parents "Fred" <FFlintstone@dino.bedrock.bc>  "Wilma"
  288.             <WFlintstone@dino.bedrock.bc>
  289.  
  290.             RIGHT:
  291.             RIGHT:
  292.             RIGHT:
  293.  
  294.             fred         "Fredrick Flintstone"
  295.             <FFlintstone@dino.bedrock.bc>
  296.             wilma   "Wilma Flintstone" <WFlintstone@dino.bedrock.bc>
  297.             pebbles "Pebbles Flintstone" <Pebbles@dino.bedrock.bc>
  298.  
  299.             family  pebbles parents
  300.             parents fred wilma
  301.             flintstones  family
  302.  
  303.           Note that the alias for flintstones
  304.                                   flintstones
  305.                                   flintstones is totally optional, it
  306.           merely allows you have an additional choice to send mail to the
  307.           users defined by the family
  308.                                family
  309.                                family alias. This allows sending to the
  310.           entire first family of Bedrock by typing either:
  311.  
  312.                               
  313.  
  314.           58and will also be unpleasant.  Note that such undefined behavior
  315.           can be changed by the Wonderworks at will.
  316.  
  317.           59You cannot directly or indirectly include a group within
  318.           itself.  If you violate this rule MAIL will cheerfully
  319.           recursively expand the alias until it runs out of memory or disk
  320.           space, leaving you cursing.
  321.  
  322.                                     -136-                     10/04/93
  323.  
  324.  
  325.  
  326.                                         Advanced Installation and
  327.                                         Advanced Installation and
  328.                                         Advanced Installation and
  329.           Configuration Topics
  330.           Configuration Topics
  331.           Configuration Topics
  332.  
  333.             mail flintstones
  334.  
  335.           OR
  336.  
  337.             mail family
  338.  
  339.  
  340.           Implicit User Alias Processing, (or, What Your Polar Bear Never
  341.           Implicit User Alias Processing, (or, What Your Polar Bear Never
  342.           Implicit User Alias Processing, (or, What Your Polar Bear Never
  343.           Told You about Aliases)
  344.           Told You about Aliases)
  345.           Told You about Aliases)
  346.  
  347.           If MAIL cannot find a nickname for an address, it scans the alias
  348.           table seeking a match on the user id and host of the addressee.
  349.           The entries from both the user alias file and the PASSWD
  350.                                                             PASSWD
  351.                                                             PASSWD file are
  352.           scanned, in that order.  If a match is found, then the associated
  353.           information for the address and user name is used just as if the
  354.           nickname was entered.  This behavior insures that a "standard"
  355.           address is used for replies to mail.
  356.  
  357.  
  358.           The System Alias File
  359.           The System Alias File
  360.           The System Alias File
  361.  
  362.           Beginning with release 1.11x, UUPC/extended also supports a
  363.           system wide alias file.  The system alias file can be used to
  364.           reroute mail for local addresses to local or remote users or
  365.           groups, or to pipe mail into a program (such as an automated
  366.           response program).  RMAIL checks all local addresses that it
  367.           processes against the system alias file.  If an alias is found,
  368.           the mail is redirected but the mail header is never changed.
  369.  
  370.           To be used, the system wide alias file must be called ALIASES
  371.                                                                 ALIASES
  372.                                                                 ALIASES60
  373.           and reside in the UUPC/extended configuration directory.  While
  374.           the user alias file performs a simple text substitution, the
  375.           system alias file interacts more subtly with the rest of mail
  376.           delivery.
  377.  
  378.           As in the user alias file, blank lines and lines beginning with a
  379.           pound sign (#) are ignored.  Unlike the user alias file, aliases
  380.           may span more than one line, and one or more blank lines must
  381.                                                                    must
  382.                                                                    must be
  383.           inserted between alias.  Also, the system alias file does not
  384.                                                                does not
  385.                                                                does not
  386.           include the full (human) name of the aliased address.  The
  387.           general format of an alias in the system alias file is:
  388.  
  389.             alias:  address1
  390.                address2
  391.                address3 ...
  392.  
  393.           or
  394.  
  395.             alias:
  396.                address1
  397.                               
  398.  
  399.           60This file, which has a fixed name, should not be confused with
  400.           the user alias file described above on page 135.
  401.  
  402.           10/04/93                  - 137 -
  403.  
  404.  
  405.  
  406.           UUPC/extended 
  407.                         
  408.                         1.12b Installation and 
  409.                               Installation and 
  410.                               Installation and User's Reference
  411.                                                User's Reference
  412.                                                User's Reference
  413.  
  414.  
  415.                address2
  416.                address3
  417.  
  418.           At least one address must be specified, and only one address may
  419.           appear per line.  The address may take one of the following
  420.           formats:
  421.  
  422.             address
  423.             address
  424.             address   Simple address, subject to normal forwarding rules
  425.                       on the local system.
  426.  
  427.             \address
  428.             \address
  429.             \address  An address prefixed by a backslash.  Remote
  430.                       addresses are delivered normally, but local
  431.                       addresses are delivered without user id
  432.                       verification or forwarding.
  433.  
  434.             |command
  435.             |command
  436.             |command  An MS-DOS, OS/2, or Windows NT command prefixed by
  437.                       an "or bar" ( | ).  The mail, including the header,
  438.                       is piped into the specified command.
  439.  
  440.             pathname
  441.             pathname
  442.             pathname  The absolute path name of a file.  To be recognized
  443.                       as a file, the file must begin with a slash (/), a
  444.                       tilde (~), or a driver letter/colon sequence (x:).
  445.                       The mail is appended at the end of the specified
  446.                       file normally, with a line of binary ones
  447.                       separating mail items just as if it were a mailbox.
  448.  
  449.               Note:
  450.               Note:
  451.               Note: For file names beginning with tilde (~), the file name
  452.                     is expanded as described in UUPC/extended Command
  453.                                                 UUPC/extended Command
  454.                                                 UUPC/extended Command
  455.                     Reference
  456.                     Reference
  457.                     Reference, page 49.
  458.  
  459.             :include: pathname
  460.             :include: pathname
  461.             :include: pathname     The indicated file is read for
  462.                       additional addresses.  The entire included file is
  463.                       read.  Blank lines are ignored in the included
  464.                       file, but unlike the system aliases file blank
  465.                       lines do not
  466.                             do not
  467.                             do not indicate the alias is ended.
  468.  
  469.           One special rule applies to the above.  If a simple local address
  470.           appears in the system aliases file, then when forwarding rules
  471.           are applied it will not
  472.                               not
  473.                               not be looked up in the system aliases file a
  474.           second time.  If the same address appears in either a file
  475.           included by the system aliases file or in a FORWARD
  476.                                                       FORWARD
  477.                                                       FORWARD file the
  478.           system alias will 
  479.                        will 
  480.                        will be used.  This rule allows a group of systems
  481.           to all use the same system alias file to forward mail to users
  482.           spread across the systems but at the same time allows the use of
  483.           system aliases in mailing lists or personal FORWARD
  484.                                                       FORWARD
  485.                                                       FORWARD files.  For
  486.           example, given the following systems alias file on the systems
  487.           mine.woods.com, cottage.woods.com, and atlarge.woods.com:
  488.  
  489.             dopey:  dopey@mine.woods.com
  490.  
  491.             sneezy: sneezy@mine.woods.com
  492.  
  493.             doc:         doc@mine.woods.com
  494.  
  495.             swhite: swhite@cottage.woods.com
  496.                                     -138-                     10/04/93
  497.  
  498.  
  499.  
  500.                                         Advanced Installation and
  501.                                         Advanced Installation and
  502.                                         Advanced Installation and
  503.           Configuration Topics
  504.           Configuration Topics
  505.           Configuration Topics
  506.  
  507.             prince: prince@atlarge.woods.com
  508.  
  509.           If mail is sent from any of these systems to the user swhite
  510.                                                                 swhite
  511.                                                                 swhite, the
  512.           system aliases file will cause it to be rerouted to
  513.           swhite@cottage.woods.com.  However, once cottage.woods.com
  514.           receives the mail it will process the alias once
  515.                                                       once
  516.                                                       once and then deliver
  517.           it normally.
  518.  
  519.  
  520.           The FORWARD file
  521.           The FORWARD file
  522.           The FORWARD file
  523.  
  524.           As noted above, a user can also use a file to direct how mail
  525.           inbound to the user is handled.  This file must be named FORWARD
  526.                                                                    FORWARD
  527.                                                                    FORWARD
  528.           and reside in the user's home directory as defined in the PASSWD
  529.                                                                     PASSWD
  530.                                                                     PASSWD
  531.           file or [userid].RC file.  The file format is simply one or more
  532.           addresses on separate lines:
  533.  
  534.             address1
  535.             address2
  536.             address3
  537.  
  538.           These addresses are in the same format as the system alias file
  539.           addresses described in The System Alias File, above.  Blank lines
  540.           and comment lines with a pound sign (#) in the first column are
  541.           ignored but do not
  542.                          not
  543.                          not terminate reading of the file.
  544.  
  545.           As an example, the following file, if saved in the user's home
  546.           directory under the name FORWARD
  547.                                    FORWARD
  548.                                    FORWARD, would cause the mail to be
  549.           formatted to the console via the UUPC/extended FMT program (See
  550.           FMT
  551.           FMT
  552.           FMT, page 47.) to be forwarded  to the postmaster normally, to be
  553.           saved in the mailbox for user BOGUS without checking to see if
  554.           BOGUS exists or has forwarding enabled, and finally to be saved
  555.           in the user's home directory in the file BKUPMAIL.TXT:
  556.  
  557.                |FMT
  558.                postmaster
  559.                \bogus
  560.                ~/BKUPMAIL.TXT
  561.  
  562.  
  563.           Controlling Routing for Entire Systems and Subdomains
  564.           Controlling Routing for Entire Systems and Subdomains
  565.           Controlling Routing for Entire Systems and Subdomains
  566.  
  567.  
  568.           Overview of  Mail Routing
  569.           Overview of  Mail Routing
  570.           Overview of  Mail Routing
  571.  
  572.           By default, RMAIL and MAIL combine to deliver mail in the
  573.           following fashion:
  574.  
  575.             *  Mail to a user id without a host name is delivered locally,
  576.                as described in An Overview of RMAIL
  577.                                An Overview of RMAIL
  578.                                An Overview of RMAIL on page 133.
  579.  
  580.             *  Mail to the current system's host name (as defined by the
  581.                UUPC.RC NodeName= 
  582.                        NodeName= 
  583.                        NodeName= line) is delivered locally.
  584.  
  585.  
  586.           10/04/93                  - 139 -
  587.  
  588.  
  589.  
  590.           UUPC/extended 
  591.                         
  592.                         1.12b Installation and 
  593.                               Installation and 
  594.                               Installation and User's Reference
  595.                                                User's Reference
  596.                                                User's Reference
  597.  
  598.  
  599.             *  If the FromDomain=
  600.                       FromDomain=
  601.                       FromDomain= line is not defined in UUPC.RC, then mail
  602.                to the current system's domain name (as defined by the
  603.                UUPC.RC Domain=
  604.                        Domain=
  605.                        Domain= line) is delivered locally.
  606.  
  607.               Note:
  608.               Note:
  609.               Note: The use of the FromDomain=
  610.                                    FromDomain=
  611.                                    FromDomain= keyword is documented below,
  612.                     as part of The Ever So English Sport of Site Hiding
  613.                                The Ever So English Sport of Site Hiding
  614.                                The Ever So English Sport of Site Hiding,
  615.                     page 143.
  616.  
  617.             *  If the FromDomain=
  618.                       FromDomain=
  619.                       FromDomain= line is defined in UUPC.RC, then mail to
  620.                the current system's domain name (as defined by the UUPC.RC
  621.                Domain=
  622.                Domain=
  623.                Domain= line) is queued as mail for the system listed on the
  624.                UUPC.RC MailServ=
  625.                        MailServ=
  626.                        MailServ= line.
  627.  
  628.             *  Mail to a simple system name listed in the SYSTEMS 
  629.                                                           SYSTEMS 
  630.                                                           SYSTEMS file is
  631.                queued for that system.
  632.  
  633.             *  Mail to a system of the form system.UUCP where system is
  634.                listed in the SYSTEMS
  635.                              SYSTEMS
  636.                              SYSTEMS file is queued for that system.
  637.  
  638.             *  Mail to a system with a system name listed in the SYSTEMS
  639.                                                                  SYSTEMS
  640.                                                                  SYSTEMS
  641.                file and the local domain name61 is queued for that system.
  642.  
  643.             *  All other mail is queued for the system defined as the mail
  644.                server (as defined by the UUPC.RC MailServ=
  645.                                                  MailServ=
  646.                                                  MailServ= line).
  647.  
  648.           You may sometimes need to override the default rules.  For
  649.           example, a system which is not directly connected may still be
  650.           routed via a system other than the default mail server, or the
  651.           local system's mail may be passed to a gateway program for
  652.           delivery on a LAN.  UUPC/extended handles such overrides via a
  653.           HOSTPATH 
  654.           HOSTPATH 
  655.           HOSTPATH file.  If used, the file must
  656.                                             must
  657.                                             must be called HOSTPATH 
  658.                                                            HOSTPATH 
  659.                                                            HOSTPATH  and
  660.           must reside in the UUPC/extended configuration directory.
  661.  
  662.           Within the file, blank lines and lines which begin with a pound
  663.           sign (#) are ignored.  Other lines have one of three formats,
  664.           with common guidelines:
  665.  
  666.             *  The operands must be separated by white space.
  667.  
  668.             *  All operands must fit on one line.
  669.  
  670.             *  The victim (the system for which rerouting is desired) may
  671.                be specified as a simple host name (dino), a fully qualified
  672.                domain name (dino.bedrock.bc), or a sub-domain prefixed by
  673.  
  674.                               
  675.  
  676.           61The local domain name is taken from the LocalDomain=
  677.                                                     LocalDomain=
  678.                                                     LocalDomain= line in
  679.           the UUPC.RC file if it exists.  Otherwise, if the Domain= 
  680.                                                             Domain= 
  681.                                                             Domain= value
  682.           ends in UUCP, UUCP is defined as the local domain, else two level
  683.           domain names (x.y) are used as-is, and all longer domain names
  684.           are stripped of the first name (for example, kendra would be
  685.           stripped from kendra.kew.com) and the rest is used as the local
  686.           domain.
  687.  
  688.                                     -140-                     10/04/93
  689.  
  690.  
  691.  
  692.                                         Advanced Installation and
  693.                                         Advanced Installation and
  694.                                         Advanced Installation and
  695.           Configuration Topics
  696.           Configuration Topics
  697.           Configuration Topics
  698.  
  699.                an asterisk (*.bedrock.bc) to denote all hosts within a sub-
  700.                domain.
  701.  
  702.             *  A canonical-name may be a simple host name or a fully
  703.                qualified domain name, but it cannot
  704.                                              cannot
  705.                                              cannot be a generic sub-domain
  706.                definition.
  707.  
  708.           For a entry defining the routing of a system or sub-domain, the
  709.           syntax is simply:
  710.  
  711.             victim  canonical-name
  712.  
  713.           Where victim is the system or sub-domain to be routed via
  714.           canonical-name.  For an entry defining a system or sub-domain as
  715.           an alias of another system, the syntax is similar but adds a
  716.           literal equals sign (=) between the two names:
  717.  
  718.             victim  =    canonical-name
  719.  
  720.           Where victim is the system or sub-domain that is to be considered
  721.           equivalent to the system canonical-name.  Lastly, when mail for a
  722.           system or sub-domain is to be piped into a program, the equals
  723.           sign is replaced by a pipe (|) symbol:
  724.  
  725.             victim  |    program-name
  726.  
  727.           The use of these entries is described below in separate sections.
  728.  
  729.               Note:
  730.               Note:
  731.               Note: When the HOSTPATH
  732.                              HOSTPATH
  733.                              HOSTPATH file is used to alias systems or
  734.                     change default routes, the original system information
  735.                     is not
  736.                        not
  737.                        not changed in the mail header or in commands passed
  738.                     to other systems.  This means that the systems defined
  739.                     by canonical-name must have at least the same amount of
  740.                     information about routing as the local UUPC/extended
  741.                     system has.  (The reason is simple: If you screw with
  742.                     something long enough you will break it, and mail
  743.                     headers are no exception.)
  744.  
  745.  
  746.           Routing Mail Via Non-Default Mail Servers
  747.           Routing Mail Via Non-Default Mail Servers
  748.           Routing Mail Via Non-Default Mail Servers
  749.  
  750.           As noted above, mail for other than the local system or directly
  751.           connected systems is routed to the default mail server.  This is
  752.           desirable when a system only calls a mail server and/or a few
  753.           other systems, as the local system will automatically route to
  754.           each of these.  However, if any directly connected systems other
  755.           than the mail server call additional systems, then UUPC/extended
  756.           must be explicitly told about them.  Once these new routes are
  757.           defined, other systems could be routed via these newly defined
  758.           systems, and so on.
  759.  
  760.           For example, if the local system calls system fee in addition to
  761.           its regular mail server, and fee provides the cheapest route to
  762.           systems fie, foe, and foo, then the following entries would be
  763.           required in the HOSTPATH
  764.                           HOSTPATH
  765.                           HOSTPATH file:
  766.           10/04/93                  - 141 -
  767.  
  768.  
  769.  
  770.           UUPC/extended 
  771.                         
  772.                         1.12b Installation and 
  773.                               Installation and 
  774.                               Installation and User's Reference
  775.                                                User's Reference
  776.                                                User's Reference
  777.  
  778.  
  779.             fie          fee
  780.             foe          fee
  781.             foo          fee
  782.  
  783.           Once fie, foe, and foo are defined, additional systems can be
  784.           routed via them, up to one hundred systems deep:
  785.  
  786.             giant        fie
  787.             bean.sales.com    foe
  788.             *.bean.stalk.com  foo
  789.  
  790.           Note the sub-domain reference for *.bean.stalk.com; this defines
  791.           that all systems that may exist in that domain
  792.           (low.bean.stalk.com, middle.bean.stalk.com,
  793.           way.up.there.bean.stalk.com) will all
  794.                                             all
  795.                                             all be routed via fee, foo, and
  796.           then on to systems in the bean.stalk.com domain.
  797.  
  798.               Note:
  799.               Note:
  800.               Note: If the canonical system name is not known to the local
  801.                     system, it is presumed to be routed via the default
  802.                     mail server.  This effectively negates the routing
  803.                     entry in HOSTPATH
  804.                              HOSTPATH
  805.                              HOSTPATH.
  806.  
  807.  
  808.           Preventing Mail For The Local Domain From Leaving The Local
  809.           Preventing Mail For The Local Domain From Leaving The Local
  810.           Preventing Mail For The Local Domain From Leaving The Local
  811.           System
  812.           System
  813.           System
  814.  
  815.           A special case of routing is when a route is specified via the
  816.           local system.  If an otherwise unknown system or domain is
  817.           defined to be routed via the local system, mail for that system
  818.           is rejected as unreachable and bounced.  This allows the gateway
  819.           for a domain to prevent mail from leaving the domain via a
  820.           HOSTPATH
  821.           HOSTPATH
  822.           HOSTPATH entry like so:
  823.  
  824.           *.my.domain.com          localhost
  825.  
  826.           If the local system is localhost, then mail for otherwise unknown
  827.           systems within the my.domain.com domain will bounce to the mail
  828.           server.  (Mail for the mail server will itself will be delivered
  829.           normally, because the mail server is defined in the SYSTEMS
  830.                                                               SYSTEMS
  831.                                                               SYSTEMS
  832.           file.)
  833.  
  834.  
  835.           Aliasing Systems Via The HOSTPATH File
  836.           Aliasing Systems Via The HOSTPATH File
  837.           Aliasing Systems Via The HOSTPATH File
  838.  
  839.           At times, it is not enough to route mail via a particular system.
  840.           For example, if a system is renamed or has a different domain
  841.           name than the local domain, then the two names for the system
  842.           must be made equivalent via the HOSTPATH
  843.                                           HOSTPATH
  844.                                           HOSTPATH file.  For example, to
  845.           define bull as an alias of cow:
  846.  
  847.             bull    = cow
  848.  
  849.           If a system is both aliased and explicitly routed, then  the
  850.           route will override the alias.
  851.  
  852.                                     -142-                     10/04/93
  853.  
  854.  
  855.  
  856.                                         Advanced Installation and
  857.                                         Advanced Installation and
  858.                                         Advanced Installation and
  859.           Configuration Topics
  860.           Configuration Topics
  861.           Configuration Topics
  862.  
  863.           Aliases for systems are taken into consideration when performing
  864.           implicit user alias lookups.  Thus, if the system bull is aliased
  865.           as above and a user alias exists for a user at system cow, mail
  866.           sent to the user at system bull will use the user alias for user
  867.           at system cow.  For a full discussion of implicit user alias
  868.           processing, see Implicit User Alias Processing, (or, What Your
  869.                           Implicit User Alias Processing, (or, What Your
  870.                           Implicit User Alias Processing, (or, What Your
  871.           Polar Bear Never Told You about Aliases)
  872.           Polar Bear Never Told You about Aliases)
  873.           Polar Bear Never Told You about Aliases), page 137.
  874.  
  875.  
  876.           The Ever So English Sport of Site Hiding
  877.           The Ever So English Sport of Site Hiding
  878.           The Ever So English Sport of Site Hiding
  879.  
  880.           One special combination of routing and aliasing is so common as
  881.           to not always even require a HOSTPATH
  882.                                        HOSTPATH
  883.                                        HOSTPATH entry at all. Site hiding,
  884.           the ability to allow multiple systems to share a single domain
  885.           name62 to the outside world, is enabled by the FromDomain=
  886.                                                          FromDomain=
  887.                                                          FromDomain=
  888.           keyword in the UUPC.RC file.  This keyword overrides the Domain=
  889.                                                                    Domain=
  890.                                                                    Domain=
  891.           keyword in selected mail headers, and automatically aliases the
  892.           value of the Domain=
  893.                        Domain=
  894.                        Domain= header to the mail server.  For example, if
  895.           four systems, all in the "forest.oz" domain, share the domain
  896.           name used by their mail server, then each hidden system would
  897.           have UUPC.RC entries like:
  898.  
  899.             Domain=lions.forest.oz
  900.             FromDomain=forest.oz
  901.             MailServ=toto
  902.  
  903.             Domain=tigers.forest.oz
  904.             FromDomain=forest.oz
  905.             MailServ=toto
  906.  
  907.             Domain=bears.forest.oz
  908.             FromDomain=forest.oz
  909.             MailServ=toto
  910.  
  911.             Domain=ohmy.forest.oz
  912.             FromDomain=forest.oz
  913.             MailServ=toto
  914.  
  915.           Mail for each of the systems would appear to come from forest.oz,
  916.           and internally UUPC/extended would automatically alias toto to
  917.           forest.oz.  Note that mail to a simple user id would be expanded
  918.           to include the FromDomain
  919.                          FromDomain
  920.                          FromDomain name, which would mean it would also be
  921.           routed to toto.
  922.  
  923.  
  924.                               
  925.  
  926.           62Across the puddle, the rocket scientists controlling domain
  927.           names in Great Britain in 1992 were charging for each system in a
  928.           domain hierarchy, which led numerous small sites to cluster
  929.           themselves under one name.  Never mind, that even UUPC/extended
  930.           will handle sub-domains correctly and thus the authorities need
  931.           not concern themselves with sites within a domain, but what do we
  932.           Yanks know?
  933.  
  934.           10/04/93                  - 143 -
  935.  
  936.  
  937.  
  938.           UUPC/extended 
  939.                         
  940.                         1.12b Installation and 
  941.                               Installation and 
  942.                               Installation and User's Reference
  943.                                                User's Reference
  944.                                                User's Reference
  945.  
  946.  
  947.           Setting up the central server requires a small amount of
  948.           additional work.  Each user on each hidden system must have a
  949.           corresponding entry in the system alias file on the central
  950.           server (See The System Alias File
  951.                       The System Alias File
  952.                       The System Alias File, page 137.).  
  953.                                                           
  954.                                                            You must use the
  955.           full system name (lions.forest.oz, etc.) or simple system name
  956.           (lions, tigers, bears, ohmy ...) in the system aliases file, not
  957.                                                                        not
  958.                                                                        not
  959.           the FromDomain
  960.               FromDomain
  961.               FromDomain which is the same for all systems.  Also, the mail
  962.           server can be defined to be hidden as well, with UUPC.RC entries
  963.           like:
  964.  
  965.             NodeName=toto
  966.             MailServ=wizard
  967.             Domain=toto.forest.oz
  968.             FromDomain=forest.oz
  969.  
  970.           However, in this case, you must define forest.oz to be an alias
  971.           of the local system because otherwise the default would be to
  972.           forward mail for forest.oz to its mail server, in this example
  973.           wizard.  The alias would take the form of a single HOSTPATH
  974.                                                              HOSTPATH
  975.                                                              HOSTPATH entry
  976.           like so:
  977.  
  978.             forest.oz    =    toto
  979.  
  980.  
  981.           Using UUPC/extended As A Mail Gateway
  982.           Using UUPC/extended As A Mail Gateway
  983.           Using UUPC/extended As A Mail Gateway
  984.  
  985.           The final use of the HOSTPATH
  986.                                HOSTPATH
  987.                                HOSTPATH file is to direct mail for a system
  988.           or domain to an external program for processing.  This processing
  989.           is invoked via the or bar (|) separating the victim from the
  990.           canonical name.  In this case, the canonical name is actually the
  991.           program to run.  The following arguments are passed to the
  992.           program:
  993.  
  994.             The victim for whom routing is being done.
  995.  
  996.             The actual host name of the addressee.
  997.  
  998.             The user id of the addressee.
  999.  
  1000.           The mail to be delivered is read by the gateway program from
  1001.           standard input.  For example, to route all mail for the
  1002.           funky.lan.com domain to a gateway program called foogate, all the
  1003.           following to the local HOSTPATH file:
  1004.  
  1005.             *.funky.lan.com   |    foogate
  1006.  
  1007.  
  1008.           Using UUPC/extended Under Windows 3.x
  1009.           Using UUPC/extended Under Windows 3.x
  1010.           Using UUPC/extended Under Windows 3.x
  1011.  
  1012.            Warning:
  1013.            Warning:
  1014.            Warning: As this document went to press for release 1.12b of
  1015.                     UUPC/extended, work was still being finished on the
  1016.                     initial Windows 3.x support for UUPC/extended.  The
  1017.                     programs included should be viewed as in the final
  1018.                     testing phase and not formally released to production.
  1019.  
  1020.                                     -144-                     10/04/93
  1021.  
  1022.  
  1023.  
  1024.                                         Advanced Installation and
  1025.                                         Advanced Installation and
  1026.                                         Advanced Installation and
  1027.           Configuration Topics
  1028.           Configuration Topics
  1029.           Configuration Topics
  1030.  
  1031.                     Please report any problems with the Windows version of
  1032.                     UUPC/extended to help@kew.com
  1033.                                      help@kew.com
  1034.                                      help@kew.com.
  1035.  
  1036.           See General Advice on Multitasking Environments
  1037.               General Advice on Multitasking Environments
  1038.               General Advice on Multitasking Environments 
  1039.                                                           
  1040.                                                           on page 148 
  1041.                                                                       
  1042.                                                                       for
  1043.           various considerations to keep in mind when running multiple
  1044.           copies of UUPC/extended programs on a single system.
  1045.  
  1046.           Unlike the DOS, Windows NT, and OS/2 versions of UUPC/extended,
  1047.           the Windows version is not self-sufficient; the Windows version
  1048.           primarily exists to support UUCICO in the Windows environment,
  1049.           which alleviates performance problems with the DOS version of the
  1050.           UUCICO program under Windows. In addition, most of  the utilities
  1051.           (including UUSUB, UUCP, etc.) are included.
  1052.  
  1053.           However, the Windows version of MAIL is a straight port of the
  1054.           DOS MAIL program (it does not support pull down menus or dialog
  1055.           boxes), and both MAIL and UUXQT operate more efficiently under
  1056.           DOS than Windows.  Thus, binaries for these programs and their
  1057.           support modules RMAIL and RNEWS are not included for Windows.63
  1058.  
  1059.           It is specifically recommended
  1060.                 specifically recommended
  1061.                 specifically recommended that the DOS versions of MAIL,
  1062.           UUXQT, and RMAIL be used in conjunction with the Windows version
  1063.           of UUPOLL, UUCICO, UUSTAT, and UUNAME.64  To do so, install the
  1064.           Windows supplied programs in the \UUPC\WINBIN directory and when
  1065.           running Windows place the \UUPC\WINBIN directory before the
  1066.           \UUPC\BIN directory in your PATH.  This may require altering your
  1067.           path when you enter and exit Windows.
  1068.  
  1069.           If you use the Windows version of UUXQT or MAIL, you must
  1070.                                                                must
  1071.                                                                must also
  1072.           use the Windows versions of RMAIL and RNEWS.  This is because a)
  1073.           UUPC/extended Windows programs cannot detect when DOS programs
  1074.           exit,65 and b) a special flag (-f) is passed to the RMAIL and
  1075.  
  1076.                               
  1077.  
  1078.           63Because we strongly 
  1079.                        strongly 
  1080.                        strongly discourage using the Windows versions of
  1081.           UUXQT, MAIL, RMAIL and RNEWS, they must be built from the
  1082.           available source files using Turbo C++ 3.1 or Borland C++ 3.1.
  1083.  
  1084.           64The gory details:  Several UUPC/extended programs such as MAIL
  1085.           and UUXQT invoke child programs such as RMAIL and RNEWS to
  1086.           process data for them.  When running RMAIL and/or RNEWS, the
  1087.           invoking program usually redirects the input and output streams
  1088.           (called stdin and stdout), so that instead of reading from the
  1089.           keyboard, the child programs data read and write disk files.
  1090.           Unfortunately, stdin and stdout cannot be redirected under
  1091.           Windows, and as a consequence, programs that read from a
  1092.           redirected stdin and stdout under DOS must be restructured for
  1093.           Windows.
  1094.  
  1095.           65An obvious technical failure on our part, but Windows 3.x is
  1096.           not our strong suite.  Give us DOS or a 32-bit operating system
  1097.           any day.  We're open to suggestions, of course, on how to fix
  1098.           this.
  1099.  
  1100.           10/04/93                  - 145 -
  1101.  
  1102.  
  1103.  
  1104.           UUPC/extended 
  1105.                         
  1106.                         1.12b Installation and 
  1107.                               Installation and 
  1108.                               Installation and User's Reference
  1109.                                                User's Reference
  1110.                                                User's Reference
  1111.  
  1112.  
  1113.           RNEWS programs to take the place of file redirection, which is
  1114.           not available under Windows.
  1115.  
  1116.  
  1117.           Using UUPC/extended under OS/2 and Windows NT
  1118.           Using UUPC/extended under OS/2 and Windows NT
  1119.           Using UUPC/extended under OS/2 and Windows NT
  1120.  
  1121.           UUPC/extended programs run as 16-bit66 native text mode
  1122.           applications under OS/2 1.3 and as 32-bit native text mode
  1123.           applications under OS/2 2.x and Windows NT.  Given enough system
  1124.           resources, either OS/2 or Windows NT can support multiple
  1125.           UUCICO/UUPOLL processes in background without affecting
  1126.           foreground performance.  DOS versions of all programs except
  1127.           UUCICO can also be used in the respective DOS environments.  The
  1128.           DOS UUCICO (and by extension UUPOLL) should not be used in a DOS
  1129.           box because overhead from simulating the DOS serial port
  1130.           environment can impact transfer speeds and can cause transmission
  1131.           errors (resulting in resent data, also impacting transfer
  1132.           speeds).
  1133.  
  1134.               Note:
  1135.               Note:
  1136.               Note: Under OS/2, DOS performance problems can be somewhat
  1137.                     alleviated by using an OS/2 specific FOSSIL driver
  1138.                     (such as the one supplied with the SIO.SYS driver),
  1139.                     which uses blocked I/O.
  1140.  
  1141.           See General Advice on Multitasking Environments
  1142.               General Advice on Multitasking Environments
  1143.               General Advice on Multitasking Environments, page 148, 
  1144.                                                                      
  1145.                                                                      for
  1146.           various considerations when running multiple UUPC/extended
  1147.           programs at once under OS/2 and Windows NT.
  1148.  
  1149.  
  1150.           Using UUPC/extended on a LAN
  1151.           Using UUPC/extended on a LAN
  1152.           Using UUPC/extended on a LAN
  1153.  
  1154.           UUPC/extended can be used in a LAN environment via a shared
  1155.           network drive, or using Universal Naming Convention (UNC) share
  1156.           names.  In addition, UUCICO has limited direct network support
  1157.           (see Specialized Communications Drivers
  1158.                Specialized Communications Drivers
  1159.                Specialized Communications Drivers on page 147, below).
  1160.  
  1161.           However, it is not possible to protect the UUPC configuration
  1162.           directory from the network nodes (MAIL and RMAIL require access
  1163.           to the SEQF
  1164.                  SEQF
  1165.                  SEQF, PASSWD
  1166.                        PASSWD
  1167.                        PASSWD, 
  1168.                                
  1169.                                and SYSTEMS
  1170.                                    SYSTEMS
  1171.                                    SYSTEMS files), and thus local users can
  1172.           learn the passwords for remote systems and, in some
  1173.           configurations, read other users' mail.  Network administrators
  1174.                                                    Network administrators
  1175.                                                    Network administrators
  1176.           must determine if this is a security exposure
  1177.           must determine if this is a security exposure
  1178.           must determine if this is a security exposure.
  1179.  
  1180.               Note:
  1181.               Note:
  1182.               Note: Effective with release 1.12a, the SYSTEMS file and
  1183.                     PASSWD files can be renamed using the UUPC.RC variables
  1184.                     Passwd
  1185.                     Passwd
  1186.                     Passwd and Systems
  1187.                                Systems
  1188.                                Systems.  Thus, two similar UUPC.RC files
  1189.                     pointing at different sets of SYSTEMS and PASSWD files
  1190.                     can be used; general users can access world readable
  1191.                     files with fake password data, and a specially
  1192.                               
  1193.  
  1194.           6616-bit support for OS/2  1.x  will be dropped and 32-bit
  1195.           support phased in late in 1993.  Please contact help@kew.com if
  1196.           you have a continued need for 16-bit OS/2 support.
  1197.  
  1198.                                     -146-                     10/04/93
  1199.  
  1200.  
  1201.  
  1202.                                         Advanced Installation and
  1203.                                         Advanced Installation and
  1204.                                         Advanced Installation and
  1205.           Configuration Topics
  1206.           Configuration Topics
  1207.           Configuration Topics
  1208.  
  1209.                     authorized user can access the live SYSTEMS and PASSWD
  1210.                     files used by UUCICO to make and accept calls.
  1211.  
  1212.  
  1213.           Configuring using Universal Naming Convention (UNC) names
  1214.           Configuring using Universal Naming Convention (UNC) names
  1215.           Configuring using Universal Naming Convention (UNC) names
  1216.  
  1217.           UUPC/extended can be configured using Universal Naming Convention
  1218.           (UNC) names instead of conventional file names to refer to its
  1219.           configuration files.  Different from conventional file names, UNC
  1220.           names look like this:
  1221.  
  1222.             \\machinename\sharename\path\filename.ext
  1223.  
  1224.           Where machinename is the name of the remote system where the
  1225.           share point is located, sharename is the name of the remote share
  1226.           point, and path and filename.ext are just like normal paths and
  1227.           file names.  Many different PC network operating systems,
  1228.           including Novell, Lantastic, Windows for Workgroups, and Windows
  1229.           NT, allow you to use UNC names when opening files over the
  1230.           network.
  1231.  
  1232.               Note:
  1233.               Note:
  1234.               Note: If you use UNC names in your UUPC.RC or [userid].RC
  1235.                     files, you must make sure that RMAIL.EXE and RNEWS.EXE
  1236.                     can be found in the path, or that the path= line is
  1237.                     specified in UUPC.RC to point to the UNC share point
  1238.                     and directory where RMAIL and RNEWS can be found.
  1239.  
  1240.            Example:
  1241.            Example:
  1242.            Example: Some typical lines that might be in a UUPC.RC
  1243.                     configured to use UNC names might be:
  1244.  
  1245.             Path=\\dino\uupc\dosbin
  1246.             ConfDir=\\dino\uupc
  1247.             NewsDir=\\dino\uupc\news
  1248.  
  1249.  
  1250.           Specialized Communications Drivers
  1251.           Specialized Communications Drivers
  1252.           Specialized Communications Drivers
  1253.  
  1254.           Specialized communications drivers are enabled in a modem file
  1255.           via the Suite= 
  1256.                   Suite= 
  1257.                   Suite= keyword as described in the modem file keyword
  1258.           table on page 121 in Error! Cannot open file.
  1259.                                Error! Cannot open file.
  1260.                                Error! Cannot open file.
  1261.  
  1262.           Under MS-DOS, UUCICO supports connections driven by:
  1263.  
  1264.           1.The internal communications driver (COMMFIFO), which directly
  1265.             controls to the Universal Asynchronous Receiver/Transmitter
  1266.             (UART) driving the serial port.
  1267.  
  1268.           2.A generic FOSSIL interface which supports any FOSSIL (INT 14)
  1269.             driver which conforms to Version 5 of the FOSSIL
  1270.             specification.
  1271.  
  1272.           3.An Artisoft Lantastic specific driver for use with the
  1273.             ArtiComm product.  This Lantastic utility allows modems on an
  1274.             a LAN to be shared by workstations.
  1275.  
  1276.           10/04/93                  - 147 -
  1277.  
  1278.  
  1279.  
  1280.           UUPC/extended 
  1281.                         
  1282.                         1.12b Installation and 
  1283.                               Installation and 
  1284.                               Installation and User's Reference
  1285.                                                User's Reference
  1286.                                                User's Reference
  1287.  
  1288.  
  1289.           Under Windows, Windows NT, and OS/2, UUCICO will use any serial
  1290.           device supported by the system.  In addition, TCP/IP connections
  1291.           over a LAN be made if such support is installed under Windows or
  1292.           Windows NT.   Under OS/2 2.x, named pipe connections over a LAN
  1293.           be made if such support is installed.
  1294.  
  1295.           For connections which UUCICO does not directly support via LAN
  1296.           protocols (i.e. IPX or NETBIOS), RMAIL can be used as gateway to
  1297.           programs that do.  See Using UUPC/extended As A Mail Gateway
  1298.                                  Using UUPC/extended As A Mail Gateway
  1299.                                  Using UUPC/extended As A Mail Gateway,
  1300.           page 144, for details.
  1301.  
  1302.  
  1303.           General Advice on Multitasking Environments
  1304.           General Advice on Multitasking Environments
  1305.           General Advice on Multitasking Environments
  1306.  
  1307.           UUPC/extended includes specific support for environments where
  1308.           more than one program may be accessing UUPC/extended files at a
  1309.           time.  Some of this support, such as checking the time stamp of a
  1310.           mailbox before overwriting it when exiting MAIL, requires little
  1311.           additional time and is always active. Other support requires
  1312.           special processing to perform and must be enabled via the
  1313.           addition of the multitask
  1314.                           multitask
  1315.                           multitask option to the options=
  1316.                                                   options=
  1317.                                                   options= line in the
  1318.           UUPC.RC.  Under DOS, you should also load the SHARE TSR program.
  1319.  
  1320.               Note:
  1321.               Note:
  1322.               Note:  Under all environments except DOS, the multitask
  1323.                                                             multitask
  1324.                                                             multitask
  1325.                      option should always
  1326.                                    always
  1327.                                    always be enabled in the UUPC.RC file,
  1328.                      and may enabled under DOS as desired.
  1329.  
  1330.           Specifically, the multitask
  1331.                             multitask
  1332.                             multitask option enables:
  1333.  
  1334.             *  If a permission denied error is returned when opening files,
  1335.                UUPC/extended retries for up to 20 seconds waiting for the
  1336.                file to become available.
  1337.  
  1338.             *  Log files are written to temporary files in the spool
  1339.                directory and then appended to the permanent log when the
  1340.                program exits.
  1341.  
  1342.             *  If the syslog
  1343.                       syslog
  1344.                       syslog option is enabled, the SYSLOG 
  1345.                                                     SYSLOG 
  1346.                                                     SYSLOG file is opened
  1347.                and closed for each file transmitted or received.
  1348.  
  1349.             *  UUCICO creates a lock file when connecting to a system to
  1350.                insure only one conversation can go on with that system at
  1351.                time.
  1352.  
  1353.             *  UUXQT creates a lock file when processing commands from a
  1354.                system to insure only one UUXQT is processing commands from
  1355.                that system at a time.
  1356.  
  1357.             *  When mail is read from the system mailbox for the user, it
  1358.                is copied to the user's home directory and the mailbox is
  1359.                cleared to allow additional deliveries while the user is
  1360.                reading mail.
  1361.  
  1362.           This additional processing prevents conflicts such as multiple
  1363.           programs writing to log files or mailboxes, and attempts to
  1364.                                     -148-                     10/04/93
  1365.  
  1366.  
  1367.  
  1368.                                         Advanced Installation and
  1369.                                         Advanced Installation and
  1370.                                         Advanced Installation and
  1371.           Configuration Topics
  1372.           Configuration Topics
  1373.           Configuration Topics
  1374.  
  1375.           insure programs do not abort when files such as the SEQF
  1376.                                                               SEQF
  1377.                                                               SEQF file are
  1378.           being updated and are thus inaccessible.  The only major
  1379.           remaining exposure is that a program can explicitly write to a
  1380.           mail file in a user's directory, but this is uncommon and MAIL
  1381.           will detect when the file size or date changes and warn the user
  1382.           before losing the other program's changes.
  1383.  
  1384.  
  1385.           Passive polling: making other systems do the work by calling you
  1386.           Passive polling: making other systems do the work by calling you
  1387.           Passive polling: making other systems do the work by calling you
  1388.  
  1389.           What if you want to have other systems dial in to yours to route
  1390.           mail and news, rather than calling them?  To configure
  1391.           UUPC/extended to allow other systems to call yours, you will need
  1392.           to modify several of the UUPC configuration files.
  1393.  
  1394.           In addition, the owners of the other systems will have to modify
  1395.           configuration files on their machines.  Describing how to do that
  1396.           is beyond the scope of this documentation, but descriptions of
  1397.           how to configure many other systems can be found in Managing UUCP
  1398.           and Usenet.
  1399.  
  1400.           To allow a remote system to dial in, you'll need to do the
  1401.           following:
  1402.  
  1403.           A.Modify your SYSTEMS, PASSWD, and PERMISSN files.
  1404.  
  1405.           B.Test your machine's new configuration.
  1406.  
  1407.           C.Test having their machine call yours.
  1408.  
  1409.            Example:
  1410.            Example:
  1411.            Example: Let's assume that one of your UUCP neighbors, whose
  1412.                     machine is named "bosox," decides that she wants to be
  1413.                     able to dial in to your machine, called "snuffles."
  1414.  
  1415.  
  1416.           Modifying your SYSTEMS, PASSWD, and PERMISSNS files
  1417.           Modifying your SYSTEMS, PASSWD, and PERMISSNS files
  1418.           Modifying your SYSTEMS, PASSWD, and PERMISSNS files
  1419.  
  1420.           We'll go through the changes that need to be made to each of
  1421.           these files one at a time.
  1422.  
  1423.           1.SYSTEMS
  1424.  
  1425.           In your SYSTEMS file, you will need to add a line for the remote
  1426.           system.
  1427.  
  1428.           If you already successfully call the other system, then that line
  1429.           in your SYSTEMS file is good enough:  You don't need to make
  1430.           further changes.
  1431.  
  1432.           If you don't already call the remote system, then add a line to
  1433.           your SYSTEMS file that looks like this:
  1434.  
  1435.            Example: 
  1436.            Example: 
  1437.            Example:  bosox Never TBWORLD 38400 999-9999 gG
  1438.  
  1439.           Replace bosox with the name of their machine.
  1440.           10/04/93                  - 149 -
  1441.  
  1442.  
  1443.  
  1444.           UUPC/extended 
  1445.                         
  1446.                         1.12b Installation and 
  1447.                               Installation and 
  1448.                               Installation and User's Reference
  1449.                                                User's Reference
  1450.                                                User's Reference
  1451.  
  1452.  
  1453.           As described in Error! Bookmark not defined.
  1454.                           Error! Bookmark not defined.
  1455.                           Error! Bookmark not defined., page 25,  the
  1456.           second entry on this line describes how often the remote system
  1457.           is being called.  "Never" means that you never call the remote
  1458.           system.  Because you never call them, the modem type, outgoing
  1459.           baud rate, phone number, and protocol fields are not used.
  1460.           Despite that, they still have to be filled in.
  1461.  
  1462.           2.PASSWD
  1463.  
  1464.           You will also need to add a line to your PASSWD file for the
  1465.           remote machine.  For more information about the PASSWD file
  1466.           format, see the documentation in the file itself, or in step
  1467.           Error! Bookmark not defined.
  1468.           Error! Bookmark not defined.
  1469.           Error! Bookmark not defined. of Installation
  1470.                                           Installation
  1471.                                           Installation, page 27.
  1472.  
  1473.           As documented in the PASSWD file itself, the PASSWD line you'll
  1474.           want to add will look something like this:
  1475.  
  1476.            Example:
  1477.            Example:
  1478.            Example: Ubosox:Apple#Juice:::bosox
  1479.  
  1480.           Replace Ubosox with their dial-in user name, Apple#Juice with
  1481.           their password, and bosox with the name of their machine.
  1482.  
  1483.           3.  PERMISSN
  1484.  
  1485.           For a simple configuration, add a couple of lines like the
  1486.           following to your PERMISSN file:
  1487.  
  1488.            Example:
  1489.            Example:
  1490.            Example: LOGNAME=Ubosox VALIDATE=bosox MACHINE=bosox \
  1491.                      SENDFILES=yes REQUEST=yes COMMANDS=rmail:rnews
  1492.  
  1493.           Replace Ubosox with their dial-in user name from your PASSWD
  1494.           file, and bosox with their machine name.
  1495.  
  1496.  
  1497.           Test your machine's new configuration
  1498.           Test your machine's new configuration
  1499.           Test your machine's new configuration
  1500.  
  1501.           To test your new configuration, run UUNAME, and then UUXQT.  If
  1502.           they do not print out any warnings, then you have probably
  1503.           configured your PASSWD, SYSTEMS, and PERMISSN files correctly.
  1504.  
  1505.  
  1506.           Test having their machine call yours
  1507.           Test having their machine call yours
  1508.           Test having their machine call yours
  1509.  
  1510.           Once your neighbor has configured their machine, they can try
  1511.           calling in.  If they are using UUPC/extended, they need only run
  1512.           UUCICO or UUIO:
  1513.  
  1514.             UUCICO -s yoursystem   or
  1515.             UUIO -s yoursystem
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.                                     -150-                     10/04/93
  1523.  
  1524.  
  1525.  
  1526.                                         Advanced Installation and
  1527.                                         Advanced Installation and
  1528.                                         Advanced Installation and
  1529.           Configuration Topics
  1530.           Configuration Topics
  1531.           Configuration Topics
  1532.  
  1533.           If they are not running UUPC/extended, they should consult their
  1534.           system's documentation.67
  1535.  
  1536.  
  1537.           Using FOSSIL communications drivers with UUPC/extended
  1538.           Using FOSSIL communications drivers with UUPC/extended
  1539.           Using FOSSIL communications drivers with UUPC/extended
  1540.  
  1541.           As of version 1.11z, the DOS version of UUPC/extended supports
  1542.           using a special type of communications driver called a FOSSIL
  1543.           (Fido-Opus-Seadog Standard Interface Layer).  A number of drivers
  1544.           exist supporting the FOSSIL standard, and these drivers are used
  1545.           by a wide variety of PC bulletin board programs, particularly in
  1546.           the FidoNet electronic mail and bulletin-board world.  Because of
  1547.           this large installed base, FOSSIL drivers are robust and have
  1548.           been tested on a variety of systems.
  1549.  
  1550.           While the internal COMMFIFO driver handles most serial ports with
  1551.           no trouble, FOSSIL drivers allow UUCICO to run on an even wider
  1552.           variety of systems.  FOSSIL drivers can be used with UUCICO to
  1553.           support any of the following situations:
  1554.  
  1555.           . FOSSIL already is installed for other programs
  1556.  
  1557.           . Special serial port configurations such as non-standard
  1558.             interrupts used for COM3 or COM4
  1559.  
  1560.           . UUCICO using COMMFIFO cannot initialize the modem
  1561.  
  1562.           . Running DOS UUCICO under OS/2
  1563.  
  1564.               Note:
  1565.               Note:
  1566.               Note: Kendra Electronic Wonderworks does not endorse or
  1567.                     support any particular FOSSIL driver.
  1568.  
  1569.           Here's how you configure UUPC/extended versions 1.11z and later
  1570.           for use with FOSSIL drivers.
  1571.  
  1572.  
  1573.             Materials needed:
  1574.             Materials needed:
  1575.             Materials needed:
  1576.  
  1577.           * A FOSSIL driver
  1578.  
  1579.           * A text editor
  1580.  
  1581.           * The latest version of PKUNZIP
  1582.  
  1583.  
  1584.             Steps to perform:
  1585.             Steps to perform:
  1586.             Steps to perform:
  1587.  
  1588.           1)
  1589.           1)
  1590.           1) 
  1591.              
  1592.              Get a FOSSIL driver.
  1593.  
  1594.           2)
  1595.           2)
  1596.           2) 
  1597.              
  1598.              Install the FOSSIL driver.
  1599.                               
  1600.  
  1601.           67As usual, Managing UUCP and Usenet has many useful suggestions
  1602.           on various system behaviors.
  1603.  
  1604.           10/04/93                  - 151 -
  1605.  
  1606.  
  1607.  
  1608.           UUPC/extended 
  1609.                         
  1610.                         1.12b Installation and 
  1611.                               Installation and 
  1612.                               Installation and User's Reference
  1613.                                                User's Reference
  1614.                                                User's Reference
  1615.  
  1616.  
  1617.           3)
  1618.           3)
  1619.           3) 
  1620.              
  1621.              Edit your .MDM file, adding Suite=FOSSIL.
  1622.  
  1623.           4)
  1624.           4)
  1625.           4) 
  1626.              
  1627.              Reboot your system if CONFIG.SYS was edited.
  1628.  
  1629.           5)
  1630.           5)
  1631.           5) 
  1632.              
  1633.              Test the results.
  1634.  
  1635.  
  1636.             Instructions:
  1637.             Instructions:
  1638.             Instructions:
  1639.  
  1640.           1)
  1641.           1)
  1642.           1)Get a FOSSIL driver.  These are available from many sources,
  1643.             including by anonymous UUCP from kewgate, and by anonymous FTP
  1644.             from any Simtel-20 mirror site, including wuarchive.wustl.edu
  1645.             and ftp.uu.net.  Three drivers tested with UUPC/extended are:
  1646.  
  1647.                BNU170.ZIP
  1648.                OCOM_531.ZIP
  1649.                X00V124.ZIP
  1650.  
  1651.             Other FOSSIL drivers should work as well.
  1652.  
  1653.           2)
  1654.           2)
  1655.           2)Install the FOSSIL driver.
  1656.  
  1657.             The FOSSIL drivers all come with installation instructions.
  1658.             You will have to tune them for use with UUPC/extended,
  1659.             however.  If you have a high-speed modem (9600 baud or
  1660.             greater), and you use large window-size protocols like G or v,
  1661.             you will need to install your FOSSIL driver with larger
  1662.             transmit and receive buffers than the defaults.  The largest
  1663.             size you should need is 4 KB.
  1664.  
  1665.             See the FOSSIL driver's instructions for further details.
  1666.  
  1667.                Examples:
  1668.                Examples:
  1669.                Examples:
  1670.  
  1671.           For a high-speed configuration, here are the settings our friend
  1672.           Fredrick Watt used for installing each of the three tested FOSSIL
  1673.           drivers on tosci's:
  1674.  
  1675.             BNU170
  1676.             BNU170
  1677.             BNU170: Nothing was added to CONFIG.SYS.  In AUTOEXEC.BAT, Fred
  1678.                     added the BNU directory to the path and then added:
  1679.  
  1680.                          BNU /T:4096 /R:4096 /F- /Z0
  1681.  
  1682.            X00V124
  1683.            X00V124
  1684.            X00V124: Nothing was added to AUTOEXEC.BAT.  In CONFIG.SYS, Fred
  1685.                     added:
  1686.  
  1687.                          DEVICE=C:\X00\X00.SYS E F=15 R=4096 T=4096
  1688.  
  1689.           OCOM_531
  1690.           OCOM_531
  1691.           OCOM_531: Nothing was added to CONFIG.SYS.  In AUTOEXEC.BAT, Fred
  1692.                     added the directory with the driver to the path and
  1693.                     then added:
  1694.  
  1695.                          OPUSCOMM
  1696.                          OCOM_CFG C S2=4096,4096
  1697.  
  1698.                                     -152-                     10/04/93
  1699.  
  1700.  
  1701.  
  1702.                                         Advanced Installation and
  1703.                                         Advanced Installation and
  1704.                                         Advanced Installation and
  1705.           Configuration Topics
  1706.           Configuration Topics
  1707.           Configuration Topics
  1708.  
  1709.               Note:
  1710.               Note:
  1711.               Note: S2=4096,4096 set the comm buffers for COM2 only -- your
  1712.                     setting may differ depending on your communications
  1713.                     port.  Read the instructions for the driver.
  1714.  
  1715.           3)
  1716.           3)
  1717.           3)In tosci's .MDM file, add the line Suite=fossil
  1718.                                                Suite=fossil
  1719.                                                Suite=fossil.
  1720.  
  1721.            Example:
  1722.            Example:
  1723.            Example: In tosci's TBWORLD.MDM file, Fred added the line
  1724.                     DOS.Suite=FOSSIL
  1725.                     DOS.Suite=FOSSIL
  1726.                     DOS.Suite=FOSSIL.  Since toscis runs more than one
  1727.                     operating system, Fred needed DOS.Suite
  1728.                                                   DOS.Suite
  1729.                                                   DOS.Suite so that OS/2
  1730.                     and Windows NT still use the internal serial port
  1731.                     drivers.  If you don't use additional operating
  1732.                     systems, there is no need for the DOS. 
  1733.                                                       DOS. 
  1734.                                                       DOS. prefix.
  1735.  
  1736.           4)
  1737.           4)
  1738.           4)Reboot your system.
  1739.  
  1740.           If everything was configured properly, you'll get a sign-on
  1741.           message from the FOSSIL driver you installed.
  1742.  
  1743.           5)
  1744.           5)
  1745.           5)Test the results.
  1746.  
  1747.           Call one of your neighbors with the new driver, and enjoy.
  1748.  
  1749.  
  1750.           When things go wrong
  1751.           When things go wrong
  1752.           When things go wrong
  1753.  
  1754.           Check the buffer sizes the driver is installed with.  UUCICO,
  1755.           which can queue 4K of data at once, can easily overrun the
  1756.           standard buffer sizes used by FOSSIL drivers.
  1757.  
  1758.           The FOSSIL driver documentation is often helpful.  In addition,
  1759.           several of the FOSSIL driver packages come with diagnostic
  1760.           programs that display the status of various RS-232 lines, so you
  1761.           can see whether data is actually getting sent.
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.           10/04/93                  - 153 -
  1785.  
  1786.