home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / MISC / SQSH_100.ZIP / SQUISH.PRN < prev    next >
Encoding:
Text File  |  1991-11-04  |  254.6 KB  |  6,396 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          Squish Version 1.0 Reference Manual
  28.             Copyright 1990, 1991 by Scott J. Dudley.  All rights reserved.
  29.                               Created November 3, 1991.
  30.  
  31.  
  32.                        Documentation produced by Scott Dudley.
  33.  
  34.  
  35.  
  36.                                   TABLE OF CONTENTS
  37.  
  38.  
  39.           LICENCE . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  40.  
  41.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   6
  42.                About Squish . . . . . . . . . . . . . . . . . . . . . .   6
  43.                Features . . . . . . . . . . . . . . . . . . . . . . . .   6
  44.                System requirements  . . . . . . . . . . . . . . . . . .   8
  45.                Squish, Money and You  . . . . . . . . . . . . . . . . .   9
  46.  
  47.           NETWORK PRIMER  . . . . . . . . . . . . . . . . . . . . . . .  10
  48.                The Basics . . . . . . . . . . . . . . . . . . . . . . .  10
  49.                The Outside World  . . . . . . . . . . . . . . . . . . .  11
  50.                Is There an Echo In Here?  . . . . . . . . . . . . . . .  13
  51.  
  52.           INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .  15
  53.                Assumptions  . . . . . . . . . . . . . . . . . . . . . .  15
  54.                Quick Installation . . . . . . . . . . . . . . . . . . .  16
  55.                     Modifying CONFIG.SYS  . . . . . . . . . . . . . . .  18
  56.                     Customizing SQUISH.CFG  . . . . . . . . . . . . . .  19
  57.                          Configuring NETMAIL and BAD_MSGS . . . . . . .  22
  58.                     Configuring EchoMail areas  . . . . . . . . . . . .  24
  59.                          Declaring Areas in SQUISH.CFG  . . . . . . . .  24
  60.                          Declaring Areas in AREAS.BBS . . . . . . . . .  25
  61.                     EchoMail Areas  . . . . . . . . . . . . . . . . . .  26
  62.                Elementary Routing . . . . . . . . . . . . . . . . . . .  27
  63.                     The Send Command  . . . . . . . . . . . . . . . . .  28
  64.                     The Route Command . . . . . . . . . . . . . . . . .  29
  65.                     Wildcards . . . . . . . . . . . . . . . . . . . . .  30
  66.                          The All and World Wildcards  . . . . . . . . .  30
  67.                          Address Abbreviations  . . . . . . . . . . . .  32
  68.                     Examples  . . . . . . . . . . . . . . . . . . . . .  33
  69.                Batch Files  . . . . . . . . . . . . . . . . . . . . . .  36
  70.                     Configuring your Mailer . . . . . . . . . . . . . .  36
  71.                     Configuring your BBS  . . . . . . . . . . . . . . .  38
  72.  
  73.           OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . .  40
  74.                Squish Command Line Parameters and Syntax  . . . . . . .  40
  75.                Command Line Switches  . . . . . . . . . . . . . . . . .  43
  76.                Running Squish in Multipass Mode . . . . . . . . . . . .  46
  77.  
  78.           AREAS.BBS REFERENCE . . . . . . . . . . . . . . . . . . . . .  47
  79.  
  80.           SQUISH.CFG REFERENCE  . . . . . . . . . . . . . . . . . . . .  48
  81.                Configuration Options  . . . . . . . . . . . . . . . . .  48
  82.                Area Definitions . . . . . . . . . . . . . . . . . . . .  67
  83.                     Area Types  . . . . . . . . . . . . . . . . . . . .  67
  84.                     Area Tags and Paths . . . . . . . . . . . . . . . .  67
  85.                     Flags . . . . . . . . . . . . . . . . . . . . . . .  68
  86.                     Split Area Definitions  . . . . . . . . . . . . . .  71
  87.  
  88.  
  89.  
  90.           ARCHIVERS AND MESSAGE COMPRESSION . . . . . . . . . . . . . .  72
  91.  
  92.           ROUTING . . . . . . . . . . . . . . . . . . . . . . . . . . .  74
  93.                Generic Routing Commands . . . . . . . . . . . . . . . .  74
  94.                Schedules  . . . . . . . . . . . . . . . . . . . . . . .  77
  95.                BinkleyTerm Routing Commands . . . . . . . . . . . . . .  80
  96.                Dynamic Routing (FrontDoor)  . . . . . . . . . . . . . .  82
  97.  
  98.           SECURITY  . . . . . . . . . . . . . . . . . . . . . . . . . .  83
  99.  
  100.           MULTIZONE OPERATION . . . . . . . . . . . . . . . . . . . . .  85
  101.  
  102.           POINTS (4D, FAKENETS AND BOSSNODES) . . . . . . . . . . . . .  87
  103.                Fakenet Points . . . . . . . . . . . . . . . . . . . . .  87
  104.                4D Points  . . . . . . . . . . . . . . . . . . . . . . .  87
  105.                Remapping  . . . . . . . . . . . . . . . . . . . . . . .  88
  106.  
  107.           USING SQUISH-FORMAT MESSAGE AREAS . . . . . . . . . . . . . .  89
  108.  
  109.           SQUISH-FORMAT MESSAGE UTILITIES . . . . . . . . . . . . . . .  93
  110.                SQPACK:  Weekly maintenance  . . . . . . . . . . . . . .  93
  111.                SQCONVER:  Conversion between *.MSG and *.SQ?  . . . . .  94
  112.                SQSET:  Control for message deletion . . . . . . . . . .  96
  113.                SQINFO:  Diagnostics . . . . . . . . . . . . . . . . . .  97
  114.                SQREIDX:  Repair (minor) . . . . . . . . . . . . . . . .  98
  115.                SQFIX:  Repair (major) . . . . . . . . . . . . . . . . .  99
  116.                SSTAT:  Statistics generation  . . . . . . . . . . . . . 100
  117.  
  118.           APPENDICES  . . . . . . . . . . . . . . . . . . . . . . . . . 102
  119.                Appendix A.  Errorlevels . . . . . . . . . . . . . . . . 102
  120.                Appendix B.  Problem Reporting . . . . . . . . . . . . . 102
  121.  
  122.           GLOSSARY  . . . . . . . . . . . . . . . . . . . . . . . . . . 103
  123.  
  124.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
  125.  
  126.  
  127.  
  128.                                        LICENCE
  129.  
  130.           Copyright 1991 by Scott J. Dudley.  All rights reserved. 
  131.           COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED WITHOUT WRITTEN
  132.           CONSENT FROM THE AUTHOR.
  133.  
  134.           Noncommercial distribution and/or use is permitted under the
  135.           following terms:
  136.  
  137.           1)   You may copy and distribute verbatim copies of the Squish
  138.                source, documentation, and executable code as you receive
  139.                it, in any medium, provided that you conspicuously and
  140.                appropriately publish on each copy a valid copyright notice
  141.                "Copyright 1991 by Scott J. Dudley"; keep intact the notices
  142.                on all files that refer to this Licence Agreement and to the
  143.                absence of any warranty;  PROVIDE UNMODIFIED COPIES OF THE
  144.                DOCUMENTATION AS PROVIDED WITH THE PROGRAM; and give any
  145.                other recipients of the Squish program a copy of this
  146.                Licence Agreement along with the program.  You may charge a
  147.                distribution fee for the physical act of transferring a
  148.                copy, but no more than is necessary to recover your actual
  149.                costs incurred in the transfer. Under no circumstances is
  150.                Squish to be distributed in such a way as to be construed as
  151.                "value added" in a sales transaction, such as, but not
  152.                limited to, software bundled with a modem or CD-ROM software
  153.                collections, without the prior written consent of the
  154.                author.
  155.  
  156.           2)   You may modify your copy or copies of Squish or any portion
  157.                of it, and copy and distribute such modifications under the
  158.                terms of Paragraph 1 above, provided that you also do the
  159.                following:
  160.  
  161.                a) cause the modified files to carry prominent notices
  162.                stating that you changed the files and the date of any
  163.                change;
  164.  
  165.                b) cause the executable code of such modified version to
  166.                clearly identify itself as such in the course of its normal
  167.                operation;
  168.  
  169.                c) if the modified version is not a "port", but operates in
  170.                the same hardware and/or software environment as the
  171.                original distribution, make the original version equally
  172.                available, clearly identifying same as the original,
  173.                unmodified version;
  174.  
  175.                d) cause the whole of any work that you distribute or
  176.                publish, that in whole or in part contains or is a
  177.                derivative of Squish or any part thereof, to be licensed at
  178.  
  179.  
  180.                         Squish v1.00 Reference Manual - Page 1
  181.  
  182.  
  183.  
  184.                no charge to all third parties on terms identical to those
  185.                contained in this Licence Agreement (except that you may
  186.                choose to grant more extensive warranty protection to some
  187.                or all third parties, at your option); and:
  188.  
  189.                e) send the complete source code modifications to Scott
  190.                Dudley at the addresses listed below,  for the purpose of
  191.                evaluation for inclusion in future releases of Squish. 
  192.                Should your source code be included in Squish, Scott Dudley
  193.                retains all rights for redistribution of the code as part of
  194.                Squish and all derivative works, with appropriate credit
  195.                given to the author of the modification;
  196.  
  197.                f) You may charge a distribution fee for the physical act of
  198.                transferring a copy, but no more than is necessary to
  199.                recover your actual costs incurred in the transfer, and you
  200.                may at your option offer warranty protection in exchange for
  201.                a fee;
  202.  
  203.                g) when distributing modified versions of Squish, you must
  204.                not change the name of the program or the official version
  205.                number, except to append an identifier which indicates that
  206.                modifications have been made.  For ports to other operating
  207.                systems, the following convention must be followed:
  208.  
  209.                     Squish v<v>.<os>.R<r>
  210.  
  211.                ...where <v> is the official Squish version number, <os> is
  212.                the name of the operating system which the port runs under,
  213.                and <r> (optional) is the OS-specific revision number.  For
  214.                example, the second OS/2 revision of Squish 1.02 must have a
  215.                version string in this format:  `Squish v1.02.OS/2.R2'
  216.  
  217.                Similarly, modifications to Squish which are designed to run
  218.                under MS-DOS must also follow a naming convention.  The
  219.                version string must read:
  220.  
  221.                     Squish v<v>.<i>.<r>
  222.  
  223.                where <v> is the official Squish version number, <i> is
  224.                three initials (indicating your first, middle and last
  225.                names), and <r> (optional) is the revision number of your
  226.                modifications.
  227.  
  228.                For example, a version of Squish 2.00 modified by Joe T.
  229.                SysOp must have a version string in this format: `Squish
  230.                v2.00.jts.1'
  231.  
  232.           3)   Mere aggregation of another unrelated program with this
  233.                program and documentation (or derivative works) on a volume
  234.  
  235.  
  236.                         Squish v1.00 Reference Manual - Page 2
  237.  
  238.  
  239.  
  240.                of a storage or distribution medium does not bring the other
  241.                program under the scope of these terms.
  242.  
  243.           4)   You may copy and distribute Squish and its associated
  244.                documentation (or a portion or derivative of it, under
  245.                Paragraph 2) in object code or executable form under the
  246.                terms of Paragraphs 1 and 2 above provided that you also do
  247.                one of the following:
  248.  
  249.                a) accompany it with the complete corresponding
  250.                machine-readable source code, which must be distributed
  251.                under the terms of Paragraphs 1 and 2 above; or,
  252.  
  253.                b) accompany it with a written offer, valid for at least
  254.                three years, to give any third party free (except for a
  255.                nominal shipping charge) a complete machine-readable copy of
  256.                the corresponding source code, to be distributed under the
  257.                terms of Paragraphs 1 and 2 above; or,
  258.  
  259.                c) accompany it with the information you received as to
  260.                where the corresponding source code may be obtained. (This
  261.                alternative is allowed only for noncommercial distribution
  262.                and only if you received the program in object code or
  263.                executable form alone.)
  264.  
  265.                For an executable file, complete source code means  all the
  266.                source code for all modules it contains; but, as a special
  267.                exception, it need not include source code for modules which
  268.                are standard libraries that accompany the operating system
  269.                on which the executable file runs.
  270.  
  271.           5)   You may not copy, sublicense, distribute or transfer Squish
  272.                and its associated documentation except as expressly
  273.                provided under this Licence Agreement.  Any attempt
  274.                otherwise to copy, sublicense, distribute or transfer Squish
  275.                is void and your rights to use the program under this
  276.                Licence agreement shall be automatically terminated.
  277.  
  278.                However, parties who have received computer software
  279.                programs from you with this Licence Agreement will not have
  280.                their licences terminated so long as such parties remain in
  281.                full compliance, and notify Scott Dudley of their intention
  282.                to comply with this Agreement.
  283.  
  284.           6)   You may not incorporate parts of Squish into a program which
  285.                is NOT completely free for ALL users. If you wish to use
  286.                Squish in such a way, you must obtain written permission
  287.                from Scott Dudley before using any of the Squish code.
  288.  
  289.  
  290.  
  291.  
  292.                         Squish v1.00 Reference Manual - Page 3
  293.  
  294.  
  295.  
  296.           7)   You may not incorporate parts of Squish into a FUNCTIONALLY
  297.                SIMILAR program, including other bulletin board packages or
  298.                tossers/scanners.  If you are writing another BBS or remote
  299.                host package, you must contact Scott Dudley before using any
  300.                of the Squish code.
  301.  
  302.           8)   The privileges granted above apply only to noncommercial
  303.                users of the Squish software.  You are a NONCOMMERCIAL user
  304.                only if you are running Squish a private individual with no
  305.                "sponsors", "backers", and only if your BBS is not making
  306.                (or helping to make) a profit.  You are a COMMERCIAL user if
  307.                you make a profit from running your BBS.  You are also a
  308.                COMMERCIAL user if your BBS is being run by (or for) any
  309.                corporation, government, company, foundation, church,
  310.                school, or any other organization  You are also a COMMERCIAL
  311.                user if your system is used to advertise such a commercial
  312.                organization for the purposes of making a profit.
  313.  
  314.                This licence only governs NONCOMMERCIAL users.  If you are a
  315.                COMMERCIAL user, you are not licensed to use or distribute
  316.                this software without the prior written consent of Scott
  317.                Dudley.  If you wish to run Squish as a commercial user,
  318.                please see the section below on site licences.
  319.  
  320.           9)   This licence may be revoked by Scott Dudley without prior
  321.                notice.
  322.  
  323.                                      NO WARRANTY
  324.  
  325.           BECAUSE SQUISH IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY
  326.           NO WARRANTY.  EXCEPT WHEN OTHERWISE STATED IN WRITING, SCOTT
  327.           DUDLEY AND/OR OTHER PARTIES PROVIDE SQUISH "AS IS" WITHOUT
  328.           WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
  329.           NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  330.           FITNESS FOR A  PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  331.           QUALITY AND PERFORMANCE OF SQUISH, AND THE ACCURACY OF ITS
  332.           ASSOCIATED DOCUMENTATION, IS WITH YOU.  SHOULD SQUISH OR ITS
  333.           ASSOCIATED DOCUMENTATION PROVE DEFECTIVE, YOU ASSUME THE COST OF
  334.           ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  335.  
  336.           IN NO EVENT WILL SCOTT DUDLEY BE RESPONSIBLE IN ANY WAY FOR THE
  337.           BEHAVIOUR OF MODIFIED VERSIONS OF SQUISH. IN NO EVENT WILL SCOTT
  338.           DUDLEY AND/OR ANY OTHER PARTY WHO MAY MODIFY AND REDISTRIBUTE
  339.           SQUISH AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  340.           INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL,
  341.           INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  342.           INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  343.           DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY THIRD
  344.           PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  345.  
  346.  
  347.  
  348.                         Squish v1.00 Reference Manual - Page 4
  349.  
  350.  
  351.  
  352.           PROGRAMS) SQUISH, EVEN IF SCOTT DUDLEY HAS BEEN ADVISED OF THE
  353.           POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  354.  
  355.           You can contact the author at any of the addresses listed below:
  356.  
  357.           FidoNet:    1:249/106
  358.           IMEXnet:    89:487/106
  359.           Internet:   sjd@f106.n249.z1.fidonet.org
  360.           CServe:     >INTERNET:sjd@f106.n249.z1.fidonet.org
  361.           BBS:        (613) 389-8315, 14.4K/HST
  362.  
  363.           Surface mail:
  364.  
  365.           777 Downing St.
  366.           Kingston, Ont.
  367.           Canada  K7M 5N3
  368.  
  369.           The author can also be reached through the EchoMail conferences
  370.           called MUFFIN (Max support) and TUB (Squish support).
  371.  
  372.           Sending correspondence via electronic mail is strongly preferred. 
  373.           However, if you expect to receive a reply via surface mail,
  374.           please enclose a self-addressed, stamped envelope.  Maximus users
  375.           outside of Canada should include an international postal reply
  376.           coupon instead of a stamp.
  377.  
  378.           DO NOT ATTEMPT TO CONTACT THE AUTHOR BY TELEPHONE!  VOICE SUPPORT
  379.           WILL NOT BE PROVIDED FOR NONCOMMERCIAL USERS!
  380.  
  381.           Please feel free to contact the author at any time to share your
  382.           comments about this software and/or licensing policies.
  383.  
  384.           Our thanks to Richard Stallman at the Free Software Foundation,
  385.           Inc. and BBS Co. for most of the wording of this licence.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.                         Squish v1.00 Reference Manual - Page 5
  405.  
  406.  
  407.  
  408.                                      INTRODUCTION
  409.  
  410.  
  411.           About Squish
  412.  
  413.           Squish is a multi-featured, FidoNet-compatible EchoMail
  414.           processor.  Squish incorporates most of the common EchoMail
  415.           functions into one integrated package, including tossing,
  416.           scanning, packing, point remapping and topic linking.
  417.  
  418.           Although Squish was designed to be used with Maximus-CBCS 2.0 or
  419.           above, Squish is compatible with other software which supports
  420.           either the Squish or the *.MSG message base standards.  Squish is
  421.           not merely a "giveaway" utility; rather, Squish is a full-
  422.           featured conference manager, making it highly competitive with
  423.           most stand-alone packages on the market today.
  424.  
  425.  
  426.           Features
  427.  
  428.           Some of the features in Squish version 1.0 include:
  429.  
  430.           *    One-pass tossing and scanning, with full support for
  431.                "passthru" areas.  Outbound messages can be built directly
  432.                from the inbound *.PKT files, without needing to stop over
  433.                in the message areas.
  434.  
  435.           *    Internal support for both BinkleyTerm and FrontDoor-style
  436.                routing.
  437.  
  438.           *    Squish supports both the standard *.MSG format and the
  439.                proprietary, flat-file *.SQ? format on an area-by-area
  440.                basis.
  441.  
  442.           *    Superior multi-zone operation.  Primary addresses can be
  443.                selected on an area-by-area basis, as can SEEN-BYs and
  444.                numerous other features.  It's now easily possible (and
  445.                practical!) to use a single configuration file for multiple,
  446.                unrelated FidoNet-technology networks.
  447.  
  448.           *    True support for the BinkleyTerm "busy flags".  Instead of
  449.                remaining blocked while Binkley is sending mail to another
  450.                node (and therefore holding up processing), packets are
  451.                simply queued for later use.  All processing is performed in
  452.                a separate working directory, and packets are only
  453.                transferred to the Binkley outbound area as necessary. 
  454.                Since Squish stays out of the way of other mail-handling
  455.                tasks, Squish offers a significant performance advantage
  456.                over other mail processors.
  457.  
  458.  
  459.  
  460.                         Squish v1.00 Reference Manual - Page 6
  461.  
  462.  
  463.  
  464.           *    Areas can be defined in AREAS.BBS for compatibility with
  465.                other programs, but areas can also be defined in the main
  466.                Squish configuration file.
  467.  
  468.           *    Support for all archiving and dearchiving programs, past and
  469.                future, through the use of a flexible archiver control file.
  470.  
  471.           *    Verbose binary statistical information (optional).  Squish
  472.                provides enough information for external utilities to
  473.                provide a 100% accurate billing report for NECs or hubs,
  474.                based on mail volume.
  475.  
  476.           *    Point support, running as either a bossnode or a point, for
  477.                both 4D and "fakenet" points.
  478.  
  479.           *    Support for the "2+" 4D packet header proposal, including
  480.                zone and point numbers.
  481.  
  482.           *    "Point directory" support for BinkleyTerm 2.50 and above. 
  483.                Squish is the first publicly-available program to support
  484.                the Binkley point directories both conveniently and
  485.                efficiently.
  486.  
  487.           *    Squish also features a built-in node remapper and topic
  488.                linker.  The remapper is not limited to points; it also
  489.                supports wildcards and soundex name matching.  The topic
  490.                linker supports both *.MSG and *.SQ? areas, so no external
  491.                reply linker is required.
  492.  
  493.           *    Squish can optionally swap to XMS, EMS or disk when running
  494.                external programs.  Squish can therefore be used in many
  495.                tight-memory situations, since Squish will only occupy 3K of
  496.                memory when swapped out.  (DOS only.)
  497.  
  498.           *    Squish runs under OS/2 in protected mode, in addition to
  499.                running under DOS in real mode.  The OS/2 version of Squish
  500.                includes a special serialization feature to allow Squish to
  501.                be run conveniently in a multi-line environment.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.                         Squish v1.00 Reference Manual - Page 7
  517.  
  518.  
  519.  
  520.  
  521.           System requirements
  522.  
  523.           Although Squish was designed to be as generic as possible, the
  524.           following system configuration is required as a minimum:
  525.  
  526.           *    An IBM PC, XT, AT or PS/2, or a 100% compatible.
  527.  
  528.           *    A hard drive, with at least two megabytes of free space for
  529.                the installation, plus space to hold the inbound packet
  530.                files, local message areas, and generated packets.
  531.  
  532.           *    Software supporting either the *.MSG or *.SQ? message
  533.                formats.
  534.  
  535.           *    A front-end which is compatible with either BinkleyTerm or
  536.                FrontDoor.
  537.  
  538.           In addition, Squish-DOS requires MS/PC-DOS 3.0 or above, and
  539.           Squish-OS/2 requires OS/2 (IBM or MS) 1.2 or above.  If you wish
  540.           to handle compressed mail, Squish will also require an external
  541.           archiving program.
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.                         Squish v1.00 Reference Manual - Page 8
  573.  
  574.  
  575.  
  576.  
  577.           Squish, Money and You
  578.  
  579.           In general, Squish is a freeware program.  If you are a
  580.           noncommercial user and you abide by the terms given in the
  581.           licence, there is NO CHARGE for running Squish.  NONCOMMERCIAL
  582.           USERS ARE STILL WELCOME TO RUN SQUISH WITHOUT PAYING A CENT.
  583.  
  584.           Unlike other software, this program has no crippled features,
  585.           extra bells'n'whistles or "registration incentives".  There is
  586.           one simple difference between the commercial and noncommercial
  587.           versions of Squish:  the commercial version entitles you to
  588.           legally use Squish in a commercial environment.
  589.  
  590.           If you are a COMMERCIAL USER as defined in point 8) of the
  591.           licence above, you must obtain a licence before using Squish. 
  592.           Please see ORDER.FRM for more information.  If you did not
  593.           receive a copy of the order form with this document, contact the
  594.           author at one of the addresses listed in the licence for more
  595.           information.
  596.  
  597.           If you are a NONCOMMERCIAL user as defined in the licence above,
  598.           you are welcome to use Squish for free.  However, Squish is an
  599.           extremely large and complex program, and simply maintaining the
  600.           existing code is consuming a large percentage of my time. 
  601.           Donations of any value (or even just a postcard) will be gladly
  602.           accepted.  However, noncommercial donations are on a VOLUNTARY
  603.           basis and are NOT REQUIRED.
  604.  
  605.           However, BOTH commercial and noncommercial users must abide by
  606.           several restrictions before using Squish.  The main points in the
  607.           licence are:
  608.  
  609.           *    You may not distribute Squish on a CD-ROM, WORM, or as any
  610.                other form of a "value added" good in a sales transaction. 
  611.                You may not bundle Squish with other software without prior
  612.                written permission of the author.
  613.  
  614.           *    You may modify Squish, but only under the conditions given
  615.                in the licence.
  616.  
  617.           *    You may not incorporate parts of Squish into another BBS
  618.                package.
  619.  
  620.           *    You may not incorporate parts of Squish into another program
  621.                which is not completely free for all users.
  622.  
  623.           Other than the above, there are few restrictions on the use of
  624.           Squish.  Please read the licence agreement carefully, since
  625.           additional restrictions or qualifications may apply to you.
  626.  
  627.  
  628.                         Squish v1.00 Reference Manual - Page 9
  629.  
  630.  
  631.  
  632.                                     NETWORK PRIMER
  633.  
  634.           This section is intended as a primer for SysOps who are new to
  635.           FidoNet or a FidoNet Technology Network (FTN).  This section
  636.           covers many of the terms and concepts which are required for
  637.           everyday FidoNet operations.  Those who are familiar with
  638.           EchoMail and mail routing should feel free to skip on to the next
  639.           section, entitled "Installation".
  640.  
  641.  
  642.           The Basics
  643.  
  644.           The term "FidoNet" refers to an amateur electronic mail network,
  645.           run collectively by a group of system operators.  In the
  646.           beginning, FidoNet started out as a simple system for exchanging
  647.           private messages between different bulletin boards.  Since then,
  648.           FidoNet has grown into a full-fledged electronic mail and
  649.           conferencing network which has members in most countries of the
  650.           world.
  651.  
  652.           FidoNet itself is organized into a numerical hierarchy of
  653.           "zones", "regions", "nets", "nodes" and "points".  Each member of
  654.           FidoNet, individually known as a "node", can be uniquely
  655.           identified by that system's zone, net, node and point numbers. 
  656.           To define each term:
  657.  
  658.           Zones are wide geographical areas, usually covering one or more
  659.           continents.  At the time of writing, FidoNet currently has six
  660.           zones:  zone 1 (North America), zone 2 (Europe), zone 3
  661.           (Oceania), zone 4 (South America), zone 5 (Africa) and zone 6
  662.           (Asia).
  663.  
  664.           Nets cover a much smaller area than zones; a net usually
  665.           encompasses a large city and the surrounding area.  There are
  666.           usually many nets within each zone, each of which represents a
  667.           small geographical area within that zone.
  668.  
  669.           Nodes are individual systems.  Most nodes consist of bulletin
  670.           board systems, although a few nodes are devoted exclusively to
  671.           handling mail.  If you wish to become a member of FidoNet and you
  672.           are running a BBS, this is probably where you will start.
  673.  
  674.           Points are users on an individual system.  Normally, points do
  675.           not run full-time systems, since they simply send and receive
  676.           mail through their "bossnodes" (the nodes where the points pick
  677.           up their mail).  As the size of the network grows, points are
  678.           becoming increasingly popular.  If you don't wish to run a full-
  679.           time system, this is probably where you'll start.
  680.  
  681.  
  682.  
  683.  
  684.                        Squish v1.00 Reference Manual - Page 10
  685.  
  686.  
  687.  
  688.           These four terms can be combined to give a "network address"
  689.           which identifies any one node in the network.  The format of a
  690.           FidoNet address is as follows:
  691.  
  692.                zone:net/node[.point]
  693.  
  694.           For example, given a user in zone 1, in net 249, with a node
  695.           number of 106, and a point number of 2, that user's full address
  696.           would be '1:249/106.2'.  The point number is optional, so both
  697.           1:249/106 and 1:249/106.0 refer to the bossnode of 1:249/106.2.
  698.  
  699.           This mode of addressing is sometimes referred to as "4D" or four-
  700.           dimensional, since it includes the four basic elements of a
  701.           network address.
  702.  
  703.  
  704.           The Outside World
  705.  
  706.           Like other electronic mail systems, it's possible to enter a
  707.           private message on a FidoNet system and have that message be
  708.           delivered to its final destination in a short period of time. 
  709.           FidoNet systems "talk" with each other over telephone lines,
  710.           using one or more sophisticated handshaking protocols.  To get a
  711.           message (known in this context as "NetMail") from point "A" to
  712.           point "B", the following sequence of events has to occur:
  713.  
  714.           *    The message is created.  Most Fido-compatible software
  715.                packages can be used to generate a private message to a user
  716.                on another node.  The destination address is entered, using
  717.                the standard 4D addressing scheme.
  718.  
  719.           *    The on-disk message is then converted to packet (or *.PKT)
  720.                form.  If you are running BinkleyTerm, this will be
  721.                performed by Squish after a user logs off.  If you are
  722.                running FrontDoor or a similar mailer type, this will be
  723.                performed by the mailer itself on startup, or while your
  724.                mailer is connected to other systems.
  725.  
  726.                There are four reasons for converting a message into a
  727.                packet:
  728.  
  729.                1)   The packet structure is much more flexible than the
  730.                     local message structure.  All of the fields (such as
  731.                     the To:, From: and Subject: fields) in a packet are
  732.                     variable length, whereas the fields in stored messages
  733.                     are fixed-length.
  734.  
  735.                2)   Packets are the "compatibility layer".  Since all
  736.                     systems convert messages to the *.PKT format before
  737.                     sending them to another system, there are few
  738.  
  739.  
  740.                        Squish v1.00 Reference Manual - Page 11
  741.  
  742.  
  743.  
  744.                     compatibility problems.  This means that systems can
  745.                     store their local message bases in different formats,
  746.                     but still be able to exchange messages easily.  In
  747.                     addition, more than one message can be stored in a
  748.                     single packet.  Sometimes hundreds (or even thousands)
  749.                     of messages can be stored in a single packet.
  750.  
  751.                3)   Messages in a packet can have a different address from
  752.                     the packet itself.  The packet itself has a destination
  753.                     (the system where you'll be sending that packet
  754.                     directly to), but each message has an individual
  755.                     destination address.  This is useful, for example, when
  756.                     a long-distance call is required to connect with
  757.                     certain parts of the network.  The message's final
  758.                     destination always stays the same, but by sending the
  759.                     packet to someone who is local to you (and then having
  760.                     that someone send it to another local system, and so
  761.                     on), costs can be controlled quite effectively.  Since
  762.                     the interim destination of packet doesn't need to be
  763.                     the same as the final destination of the message,
  764.                     routing of messages via the lowest-cost route can be
  765.                     performed.
  766.  
  767.                4)   Packets can be given a "flavour".  A "flavour" (or a
  768.                     behaviour characteristic) helps your system decide what
  769.                     to do with an individual message.  For example, the
  770.                     "hold" flavour instructs your system to hold the
  771.                     message and wait for the destination system to call and
  772.                     pick it up.  Other flavours include "crash" (send a
  773.                     message directly to the destination), "direct" (same as
  774.                     crash), and "normal" (wait for later routing commands).
  775.  
  776.                Packets always have an extension of *.PKT.  (Qualifier:  if
  777.                you are running a BinkleyTerm system, they may have an
  778.                extension of *.HUT, *.OUT, *.CUT, or *.DUT on your local
  779.                system, but Binkley always changes them to *.PKT files
  780.                before they are sent to another system.)
  781.  
  782.           *    After the packet is created, it can be optionally archived
  783.                using a file compression utility.  Compression is useful
  784.                when transferring large volumes of mail or sending to long-
  785.                distance sites, since compressing mail saves both time and
  786.                money.
  787.  
  788.           *    The system which created the message then tries to call the
  789.                destination system.  Obviously, if both systems are fairly
  790.                busy, this may take a while.  Messages are sent back and
  791.                forth between systems through the use of mailers, also known
  792.                as "front ends".  Mailers call out to deliver waiting mail,
  793.  
  794.  
  795.  
  796.                        Squish v1.00 Reference Manual - Page 12
  797.  
  798.  
  799.  
  800.                handle incoming messages and files, and in general,
  801.                supervise the entire file transfer.
  802.  
  803.           *    After the two mailers connect (using one of several FidoNet
  804.                protocols), waiting mail and files are transferred between
  805.                the two systems.
  806.  
  807.           *    After the transfer completes, the receiving system then
  808.                tries to import the message.  If the packet was compressed
  809.                by the sender, it will be decompressed.  The *.PKT files
  810.                will then be imported (otherwise known as "tossed") into the
  811.                local message base, ready for the recipient to read.
  812.  
  813.           Although transferring NetMail can involve much more than just
  814.           what is given above, this should give you a grasp on NetMail
  815.           fundamentals.
  816.  
  817.  
  818.           Is There an Echo In Here?
  819.  
  820.           In the beginning, FidoNet consisted solely of nodes exchanging
  821.           NetMail.  The only way to get a message from "here" to "there"
  822.           was to send a private NetMail message.  However, a technology
  823.           called "EchoMail" was developed in late 1985; EchoMail is
  824.           analogous to a public message area or conference, but EchoMail
  825.           areas (sometimes known as "echoes") are shared among several
  826.           other systems.
  827.  
  828.           EchoMail is organized into different groups of echoes, each with
  829.           a different topic.  For example, the topics of FidoNet echoes
  830.           range from Maximus Support to deep-sea fishing and many more
  831.           special-interest groups.  To facilitate topic-oriented EchoMail,
  832.           each echo must given a tag (or area name).  This tag is used to
  833.           uniquely identify that EchoMail area when transferring messages
  834.           with other systems.  (It doesn't matter what you call the echo on
  835.           YOUR system, as long as you are using the same tag as everyone
  836.           else.)  Area tags are one word only, although they can include
  837.           periods and underscores.  To start receiving an echo area, you
  838.           need to know the tag of that area.  For example, the area tag for
  839.           the echo dealing with hardware and other technical issues is
  840.           "TECH".
  841.  
  842.           EchoMail messages are normally public, and they are entered in a
  843.           message area just like a normal message.  EchoMail messages also
  844.           look like normal, locally-entered messages, but with some special
  845.           control information at the bottom of each message.
  846.  
  847.           After an EchoMail message is saved, an EchoMail utility (such as
  848.           Squish) is invoked to "scan" that message out to the rest of the
  849.           network.  Unlike NetMail, EchoMail areas have an electronic
  850.  
  851.  
  852.                        Squish v1.00 Reference Manual - Page 13
  853.  
  854.  
  855.  
  856.           topology.  Some echoes are very large, and as such, the cost to
  857.           directly send a message to each system which carried that echo
  858.           would be prohibitive.  Instead, each system carrying that echo
  859.           only transfers EchoMail messages to neighbouring systems.  (The
  860.           neighbour you receive an echo from is also known as your "feed".) 
  861.           EchoMail messages get sent from the originating system to its
  862.           neighbours, and from those systems to their neighbours, and so
  863.           on.  Despite this "hoppity-hop" method of transferring messages,
  864.           EchoMail is fairly quick; it can often take less than three days
  865.           for a message to travel from the USA to Australia and back.
  866.  
  867.           Just like NetMail, echoes are sent to other systems in packets.
  868.           EchoMail messages are almost always compressed, since most of the
  869.           popular echoes have a daily throughput anywhere from 20 to 200
  870.           messages per day.
  871.  
  872.           Squish handles EchoMail automatically, just like NetMail. 
  873.           However, you have to tell Squish the names of the areas that you
  874.           wish to carry, in addition to who your "neighbours" are for each
  875.           echo.  (Information on doing this is covered in greater detail in
  876.           the installation section.)
  877.  
  878.           There is much more to both NetMail and EchoMail than mentioned
  879.           above; however, you should now be comfortable enough with FidoNet
  880.           terminology to start installing Squish itself.
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.                        Squish v1.00 Reference Manual - Page 14
  909.  
  910.  
  911.  
  912.                                      INSTALLATION
  913.  
  914.           Assumptions
  915.  
  916.           Before proceeding any further, you should already have a FidoNet-
  917.           compatible front end installed, in addition to a software package
  918.           which reads either *.MSG or *.SQ? format message areas.  In
  919.           addition, you should have a set of working batch files for your
  920.           system.
  921.  
  922.           This installation guide only covers the bare essentials, and it
  923.           glosses over what is required to run Squish as an EchoMail "leaf
  924.           node" (a system which only transfers mail with one other system).
  925.  
  926.           Before reading this section, you should be at least somewhat
  927.           familiar with network terminology and operations; if not, read
  928.           over the prior section entitled "NETWORK PRIMER".  A minimal
  929.           knowledge of batch files is helpful but not completely necessary.
  930.  
  931.           The quick installation also assumes that you will be using the
  932.           *.MSG format for storing messages.  If you wish to use the Squish
  933.           format, please see the section entitled "USING SQUISH-FORMAT
  934.           MESSAGE AREAS".
  935.  
  936.           This installation procedure doesn't deal with any advanced
  937.           topics, so most of the command examples have been simplified to
  938.           make the installation process easier.  For full descriptions of
  939.           each command, please consult the reference material contained
  940.           later in this manual.
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.                        Squish v1.00 Reference Manual - Page 15
  965.  
  966.  
  967.  
  968.  
  969.           Quick Installation
  970.  
  971.           To install Squish, your first task is to PRINT OUT AND READ THIS
  972.           DOCUMENT.  At the very least, you should print the section on
  973.           installation.
  974.  
  975.           After reading the installation section at least once, you should
  976.           decompress all of the Squish files from the distribution archive
  977.           into a separate directory.  You can place Squish anywhere you
  978.           desire, although all of the examples in this manual use C:\Squish
  979.           as the base directory.
  980.  
  981.           After everything has been decompressed, you will need to load an
  982.           ASCII text editor to modify the Squish configuration files.  Any
  983.           plain text editor will do, including QEdit, DOS 5.0's EDIT, any
  984.           word processor in "non-document" mode, or even EDLIN.
  985.  
  986.           The four main Squish configuration files are:
  987.  
  988.           SQUISH.CFG
  989.  
  990.           This is the main configuration file.  Information about your
  991.           system is kept in here, including your system addresses,
  992.           passwords, run-time options, and (optionally) EchoMail area
  993.           definitions.
  994.  
  995.           ROUTE.CFG
  996.  
  997.                This is the control file used for mail routing and
  998.                schedules.  This file is used for both FrontDoor and
  999.                BinkleyTerm-style systems, although it plays only a minimal
  1000.                role when used with FD.
  1001.  
  1002.           COMPRESS.CFG
  1003.  
  1004.                This holds information about all of the archiving programs
  1005.                on your system.  Squish uses this information to
  1006.                automatically identify the type of incoming archives, and it
  1007.                uses the commands within to add to and extract from
  1008.                archives.  This file is compatible with the compression
  1009.                configuration file used by Maximus-CBCS 2.0 or above.
  1010.  
  1011.           AREAS.BBS (optional)
  1012.  
  1013.                AREAS.BBS has historically been used to define EchoMail
  1014.                conference information, including the name of the
  1015.                conference, where to store the local message base, where to
  1016.                send the messages to, and so on.  Squish fully supports the
  1017.                AREAS.BBS format; however, Squish also supports message area
  1018.  
  1019.  
  1020.                        Squish v1.00 Reference Manual - Page 16
  1021.  
  1022.  
  1023.  
  1024.                definition in SQUISH.CFG.  For flexibility, areas can be
  1025.                declared in both AREAS.BBS and SQUISH.CFG, which provides
  1026.                for complete compatibility with all existing software.
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.                        Squish v1.00 Reference Manual - Page 17
  1077.  
  1078.  
  1079.  
  1080.  
  1081.           Modifying CONFIG.SYS
  1082.  
  1083.           Before modifying the Squish configuration files, you must first
  1084.           make sure that your system has been configured properly.  Squish
  1085.           is a disk-intensive program, and it keeps a number of files open
  1086.           at the same time.  To make sure that your system is set up to
  1087.           allow this, use an ASCII text editor to edit C:\CONFIG.SYS.
  1088.  
  1089.           Inside CONFIG.SYS, there should be a line which reads 'FILES=n',
  1090.           where 'n' is a number from 8 through 255.  If this line doesn't
  1091.           exist, it should be added.  For Squish, you must make sure that
  1092.           'n' is no less than 30.  If you are running a multitasking
  1093.           system, even more file handles (50 or 60) may be necessary. 
  1094.           Having more than 30 file handles is allowable, but having less
  1095.           than 30 will certainly cause problems.
  1096.  
  1097.           After you have changed your FILES statement, save CONFIG.SYS. 
  1098.           Since CONFIG.SYS is only read once when the computer starts up,
  1099.           you must reboot to make sure that your changes are recognized by
  1100.           the operating system.
  1101.  
  1102.           WARNING!  IF YOU INTEND TO USE SQUISH-FORMAT MESSAGE AREAS IN A
  1103.           MULTITASKING OR NETWORK ENVIRONMENT, YOU *MUST* INSTALL
  1104.           SHARE.EXE!  Squish uses SHARE for file and record locking, and if
  1105.           two programs are accessing the flat-file Squish format without
  1106.           SHARE loaded, message base corruption will occur.
  1107.  
  1108.           To install SHARE.EXE, either add this line:
  1109.  
  1110.                INSTALL=C:\DOS\SHARE.EXE
  1111.  
  1112.           to your CONFIG.SYS, or add the following line:
  1113.  
  1114.                SHARE
  1115.  
  1116.           to the end of your AUTOEXEC.BAT.  Both methods have the same
  1117.           effect.  (Note:  DOS 5.0 users must install SHARE by the
  1118.           CONFIG.SYS method.)
  1119.  
  1120.           Novell users:  Squish doesn't directly support Novell record
  1121.           locking.  However, if you load INT2F.COM (which maps Squish's
  1122.           file locking calls to a Novell-compatible format), you won't need
  1123.           to install SHARE.EXE.
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.                        Squish v1.00 Reference Manual - Page 18
  1133.  
  1134.  
  1135.  
  1136.  
  1137.           Customizing SQUISH.CFG
  1138.  
  1139.           After modifying CONFIG.SYS, you can now start configuring Squish
  1140.           itself.  For starters, SQUISH.CFG needs to be modified to suit
  1141.           your system.  Although you will see many options in the
  1142.           configuration file, only a few need to be modified to get a
  1143.           minimal Squish system up and running.  When performing a new
  1144.           installation, most of the options in SQUISH.CFG should be left
  1145.           alone, since the defaults are acceptable in most cases.  However,
  1146.           you will need to modify the following keywords:
  1147.  
  1148.           Address
  1149.  
  1150.                This keyword must be modified to match your system's actual
  1151.                network address.  If you are already a member of FidoNet or
  1152.                some other network, include your full 4D address here,
  1153.                including your zone, net and node number.  If you do not
  1154.                have a node number, set your address to "1:-1/-1" until you
  1155.                receive an official address.
  1156.  
  1157.                If you are running a point system, please see the SQUISH.CFG
  1158.                reference for more information on configuring Squish for use
  1159.                in a point environment.
  1160.  
  1161.           NetFile
  1162.  
  1163.                This keyword tells Squish where to find inbound files.  This
  1164.                is commonly referred to as a "NetFile path" or an "inbound
  1165.                directory", since this is where your front end places
  1166.                inbound *.PKT files and compressed archives.
  1167.  
  1168.           AreasBBS
  1169.  
  1170.                This keyword points Squish to the location of an AREAS.BBS
  1171.                file.  This file is optional, so if you do NOT have any
  1172.                software which uses an AREAS.BBS, this statement can be
  1173.                commented out.  If you are new to FidoNet, please see the
  1174.                section entitled "Configuring EchoMail Areas" to decide
  1175.                which format is best for you.
  1176.  
  1177.           ArcmailAttach
  1178.  
  1179.                If you are running FrontDoor, InterMail, D'Bridge, or any
  1180.                other front-end which requires a "NetMail attach message" to
  1181.                send files, then this keyword should be enabled.
  1182.  
  1183.                Otherwise, if you are running BinkleyTerm or any other
  1184.                program that uses the "outbound area" concept, this
  1185.                statement should be commented out (disabled).
  1186.  
  1187.  
  1188.                        Squish v1.00 Reference Manual - Page 19
  1189.  
  1190.  
  1191.  
  1192.           Compress
  1193.  
  1194.                The "Compress" keyword specifies the location of the
  1195.                archiver configuration file.  If you wish to put
  1196.                COMPRESS.CFG somewhere else (or if you wish to use a
  1197.                compatible COMPRESS.CFG, as used by Maximus-CBCS), you can
  1198.                specify an alternate path and filename here.  Otherwise,
  1199.                this option should be left alone.
  1200.  
  1201.           Routing
  1202.  
  1203.                The "Routing" keyword gives the location of your routing
  1204.                control file.  If you are using the default configuration,
  1205.                you can leave this as is.
  1206.  
  1207.           Outbound
  1208.  
  1209.                This keyword specifies a directory to use for building
  1210.                packets and file attaches.  This keyword is required for
  1211.                both FrontDoor and Binkley-style systems.
  1212.  
  1213.                In a Binkley environment, this should be the "root name" of
  1214.                the BinkleyTerm outbound area.
  1215.  
  1216.                In a FrontDoor environment, this will be the base directory
  1217.                used for building packets and compressed mail archives.
  1218.  
  1219.                No directory extensions should be given for this keyword. 
  1220.                For multi-zone systems, Binkley adds an extension to the
  1221.                base directory (to separate the mail for each zone). 
  1222.                However, Squish will add the OUTBOUND.### zone extensions
  1223.                AUTOMATICALLY, you should just specify the path (without an
  1224.                extension).  Squish will also create a private work area
  1225.                (with a .SQ extension) for both Binkley and FrontDoor-style
  1226.                systems.
  1227.  
  1228.           LogFile
  1229.  
  1230.                The LogFile keyword specifies the path and filename of the
  1231.                Squish log file.  This log file uses a Binkley and Maximus-
  1232.                compatible format, so the logs can all be stored in one file
  1233.                if you so desire.
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.                        Squish v1.00 Reference Manual - Page 20
  1245.  
  1246.  
  1247.  
  1248.           Origin
  1249.  
  1250.                The Origin keyword is only required if you are not using
  1251.                AREAS.BBS.  (AREAS.BBS includes a default origin line, so
  1252.                you can skip this keyword if you are using AREAS.BBS.) 
  1253.                Squish needs a default origin line to place at the end of
  1254.                messages, just in case a message being scanned didn't
  1255.                already contain one.  Generally, this line should contain
  1256.                the name of your system, your location, and your phone
  1257.                number.  The text in your origin line text should be no more
  1258.                than 60 characters (letters/numbers) long.
  1259.  
  1260.           For a normal system, the above changes should be enough to get
  1261.           your system up and running.  Later, once your system is running
  1262.           reliably, the control files can be modified to suit your personal
  1263.           preferences.
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.                        Squish v1.00 Reference Manual - Page 21
  1301.  
  1302.  
  1303.  
  1304.  
  1305.           Configuring NETMAIL and BAD_MSGS
  1306.  
  1307.           After customizing the main configuration file, you need to
  1308.           declare at least three messages areas.  For starters, a NetMail
  1309.           area is required; this is where messages to and from other
  1310.           systems are stored.  Squish requires at least one netmail area. 
  1311.           Secondly, a bad messages area is also required, since Squish
  1312.           needs a place to store invalid messages.
  1313.  
  1314.           Netmail areas are declared by placing a 'NetArea' line in
  1315.           SQUISH.CFG.  A sample NetArea declaration might look like this:
  1316.  
  1317.                NetArea   NETMAIL   C:\Max\Msg\Net
  1318.  
  1319.           'NetArea' is the area type.  This tells Squish that the area
  1320.           contains netmail.
  1321.  
  1322.           The next part of the line is a one-word 'area tag', which is
  1323.           simply a short form for the area name.  In the case above,
  1324.           'NETMAIL' is the area tag.  All areas must be given a unique area
  1325.           tag, but aside from that, the area tag you give to a NetMail area
  1326.           (whether it be 'NETMAIL' or 'WOMBAT') is of little importance.
  1327.  
  1328.           Finally, the last item in the line is the path to the area
  1329.           itself.  For *.MSG format areas, this should be a separate
  1330.           directory on your hard drive.  Squish will create nonexistent
  1331.           directories when importing messages, so you don't have to create
  1332.           the directory right away.
  1333.  
  1334.           *    Tip for advanced users:  A Squish-format netmail area can be
  1335.                used instead of *.MSG.  For more information, see the
  1336.                documentation for 'NetArea' in the SQUISH.CFG reference.
  1337.  
  1338.           Next, an area to hold bad messages must be created.  This area
  1339.           will be used to store insecure messages, messages destined for
  1340.           unknown areas, and other messages that Squish can't process.  The
  1341.           format for a 'BadArea' line is very similar to that of netmail
  1342.           areas:
  1343.  
  1344.                BadArea   BAD_MSGS  C:\Max\Msg\Bad
  1345.  
  1346.           'BadArea' is the area type, and it tells Squish that the area
  1347.           will be used to hold bad messages.  WARNING!  If you are using
  1348.           MsgTrack or some other message-bouncing utility, ensure that each
  1349.           program has its own "bad messages" area.  Otherwise, Squish will
  1350.           erroneously attempt to toss bounced messages.
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.                        Squish v1.00 Reference Manual - Page 22
  1357.  
  1358.  
  1359.  
  1360.           The next part of the line is the area tag, which has the same
  1361.           restrictions as the tag for netmail areas.  'BAD_MSGS" is
  1362.           suggested for the area tag, but any other single word will do.
  1363.  
  1364.           As with netmail areas, the last part of the line contains the
  1365.           path to your bad messages directory.  Again, the bad messages
  1366.           area defaults to the *.MSG format, so this should be the name of
  1367.           a separate directory on your hard drive.
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.                        Squish v1.00 Reference Manual - Page 23
  1413.  
  1414.  
  1415.  
  1416.  
  1417.           Configuring EchoMail areas
  1418.  
  1419.           After creating the definitions for both NETMAIL and BAD_MSGS, the
  1420.           next task is to define one or more EchoMail areas.  Squish
  1421.           supports two different methods of declaring echoes; the best
  1422.           method for you depends on your system configuration.
  1423.  
  1424.           First of all, EchoMail areas can be declared in SQUISH.CFG.  The
  1425.           format for defining echoes is almost identical to the formats for
  1426.           NETMAIL and BAD_MSGS, so it's easy to remember.  In addition,
  1427.           several Squish-specific flags can only be used in SQUISH.CFG.
  1428.  
  1429.           Secondly, areas can also be declared in AREAS.BBS.  This file is
  1430.           the "standard" for EchoMail area definitions, and many other
  1431.           programs support AREAS.BBS.  The format of AREAS.BBS is less
  1432.           flexible than the format of SQUISH.CFG, so several Squish-
  1433.           specific options are not available when using AREAS.BBS. 
  1434.           However, if you are converting from another program and already
  1435.           have an AREAS.BBS, this is probably the wisest option.
  1436.  
  1437.           *    Tip for advanced users:  Squish can handle areas defined in
  1438.                both SQUISH.CFG and AREAS.BBS.  You can even declare one
  1439.                area in both places, if you need compatibility with other
  1440.                programs and also Squish-specific features.  For more
  1441.                details, please see the EchoArea portion of the SQUISH.CFG
  1442.                reference.
  1443.  
  1444.  
  1445.           Declaring Areas in SQUISH.CFG
  1446.  
  1447.           If you have decided to declare your EchoMail areas in SQUISH.CFG,
  1448.           then read on.  Otherwise, skip ahead to "Elementary Routing". 
  1449.           Remember, if you are not using AREAS.BBS to define your echoes,
  1450.           you must enable the 'Origin' statement in SQUISH.CFG.  (See the
  1451.           "Customizing SQUISH.CFG" section for more details.)
  1452.  
  1453.           Defining an EchoMail area in SQUISH.CFG is similar to defining
  1454.           netmail and bad message areas.  A sample echo definition might
  1455.           look like this:
  1456.  
  1457.                EchoArea  MUFFIN    E:\Msg\Muffin  1:123/456
  1458.  
  1459.           'EchoArea' tells Squish that the area we are defining is an
  1460.           EchoMail area.
  1461.  
  1462.           'MUFFIN' is the tag for this area.  Unlike the tags defined for
  1463.           NetMail and bad message areas, the tag that you specify for
  1464.           EchoMail areas is important, since the tag is used as the area
  1465.           name when sending EchoMail to other systems.  Area tags are
  1466.  
  1467.  
  1468.                        Squish v1.00 Reference Manual - Page 24
  1469.  
  1470.  
  1471.  
  1472.           usually short, and spaces are not allowed.  You must ensure that
  1473.           your system is using the same echo tag as your feed, so it's best
  1474.           to call your feed and get the required tag information in
  1475.           advance.
  1476.  
  1477.           'E:\Msg\Muffin' is the path to the EchoMail area.  By default,
  1478.           echoes use the *.MSG format, so a separate directory is required
  1479.           for each echo.  If this directory does not exist, Squish will
  1480.           create it automatically.
  1481.  
  1482.           Finally, '1:123/456' is the address of the system from which you
  1483.           receive the echo.  This tells Squish that it's okay to accept
  1484.           mail from that address, and it also tells Squish to send locally-
  1485.           entered messages to that system.  As many addresses can be listed
  1486.           as desired, with a space between each address.  If you are a leaf
  1487.           node, you'll only need to list the address of your feed.  Full 4-
  1488.           dimensional addresses (zone, net, node and point) are acceptable.
  1489.  
  1490.           In addition, a number of special flags can follow the addresses. 
  1491.           These flags can be used for many purposes, including declaring
  1492.           the area to be Squish format, defining a primary address, or
  1493.           declaring an area as 'passthru'.  For more information, please
  1494.           see the EchoArea portion of the SQUISH.CFG reference.
  1495.  
  1496.           Any number of EchoMail areas can be defined, limited by available
  1497.           memory.  However, each area must be defined on a separate line in
  1498.           the configuration file.
  1499.  
  1500.  
  1501.           Declaring Areas in AREAS.BBS
  1502.  
  1503.           If you have already defined your EchoMail areas in SQUISH.CFG,
  1504.           then skip ahead to "Elementary Routing".  Otherwise, read on.
  1505.  
  1506.           AREAS.BBS is the de facto standard for defining EchoMail areas,
  1507.           so you'll have the highest degree of compatibility if you declare
  1508.           your areas using this method.  AREAS.BBS contains two separate
  1509.           components:  a default origin line, and also a number of echo
  1510.           definitions.
  1511.  
  1512.  
  1513.  
  1514.           Default Origin Line
  1515.  
  1516.           The very first line of AREAS.BBS is interpreted in a special
  1517.           manner.  The line should have the following format:
  1518.  
  1519.                <default_origin>! <sysop_name>
  1520.  
  1521.  
  1522.  
  1523.  
  1524.                        Squish v1.00 Reference Manual - Page 25
  1525.  
  1526.  
  1527.  
  1528.           <default_origin> is the default origin line to use for all of
  1529.           your echoes.  Normally, this should include your system name,
  1530.           location, and phone number, or anything else that will fit in
  1531.           under 60 characters.
  1532.  
  1533.           <sysop_name> should be your name.  For historic purposes, this
  1534.           should be separated from the default origin line by an
  1535.           exclamation point.  Squish doesn't use the name you specify here,
  1536.           but it should be included for compatibility with other programs.
  1537.  
  1538.           For example, the first line in AREAS.BBS might look like this:
  1539.  
  1540.           MyBBS * Anytown, Anystate * (123) 456-7890! Joe SysOp
  1541.  
  1542.           In this example, the default origin line would be "MyBBS *
  1543.           Anytown, Anystate * (123) 456-7890", and the SysOp name would be
  1544.           "Scott Dudley".
  1545.  
  1546.  
  1547.           EchoMail Areas
  1548.  
  1549.           Following the default origin line can be any number of EchoMail
  1550.           areas.  All echoes must each be defined on a separate line, using
  1551.           the following format:
  1552.  
  1553.                <path>  <tag>  <nodes>
  1554.  
  1555.           <path> is the name of the directory in which the *.MSG files are
  1556.           to be kept.  As with other *.MSG-type areas, each echo should
  1557.           have its own separate directory.  If the directory does not
  1558.           exist, it will be automatically created.
  1559.  
  1560.           <tag> specifies the area tag for this area.
  1561.  
  1562.           <nodes> is a list of zero or more nodes to which will be sending
  1563.           the specified echo to you.  Normally, for a leaf node, you will
  1564.           only be sending the echo to one place:  to your feed.  All of the
  1565.           addresses go after the area tag, with at least one space between
  1566.           each address.
  1567.  
  1568.           For example, the following line could be used as an entry for the
  1569.           MUFFIN echo:
  1570.  
  1571.           C:\MAX\MSG\MUFFIN   MUFFIN    1:123/999 888 777
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.                        Squish v1.00 Reference Manual - Page 26
  1581.  
  1582.  
  1583.  
  1584.  
  1585.           Elementary Routing
  1586.  
  1587.           After you have configured the EchoMail areas available on your
  1588.           system, your attention should be turned to mail routing.  In
  1589.           Squish, routing is based on the idea of schedules and control
  1590.           files.  A schedule is simply a set of routing commands which can
  1591.           be performed as a single unit.  Schedules can be run either all
  1592.           day, during certain times of the day only, or on manual request. 
  1593.           Most nodes will only need one schedule, since the majority of
  1594.           systems use the same set of routing commands 24 hours a day.
  1595.  
  1596.           Commands in ROUTE.CFG have three purposes:
  1597.  
  1598.           *    Firstly, routing can direct NetMail from one system to
  1599.                another.  (Normally, EchoMail is not routed.)  For example,
  1600.                routing commands could redirect all NetMail destined for
  1601.                1:123/456 to 1:987/654.  If 1:987/654 is a local call, but
  1602.                1:123/456 is not, then it's obviously useful to send mail
  1603.                via the system which is local to you.  For ArcmailAttach
  1604.                systems, this feature is usually handled by your mailer.
  1605.  
  1606.           *    Secondly, routing can control whether or not mail is
  1607.                compressed.  When sending large volumes of EchoMail,
  1608.                external programs such as ARC and ZIP can be used to
  1609.                compress mail packets.  This reduces the amount of time it
  1610.                takes to transmit mail, which in turn reduces long-distance
  1611.                phone charges.
  1612.  
  1613.           *    Finally, routing also controls the 'flavour' of outbound
  1614.                mail.  All outbound mail has a flavour (or priority) which
  1615.                controls when the mail gets sent.  By default, Squish
  1616.                creates all outbound packets with a "normal" flavour. 
  1617.                However, the routing commands can be used to change this
  1618.                flavour to "crash" (send this mail immediately), "direct" (a
  1619.                synonym for crash), or "hold" (do not call out; hold mail
  1620.                for pick-up).  The flavour of messages can also be changed
  1621.                by your mailer (depending on when phone rates are the
  1622.                cheapest, for example), but ROUTE.CFG is used to assign a
  1623.                default flavour to each outbound packet.
  1624.  
  1625.           In general, ROUTE.CFG starts off with a section of global routing
  1626.           commands (which are run every time Squish scans the netmail
  1627.           area), followed by a set of zero or more schedules.  The commands
  1628.           within the global section and each schedule all use the same
  1629.           format; the only difference is when the commands are executed.
  1630.  
  1631.           No matter what, commands in the global section of the routing
  1632.           control file are ALWAYS executed.  Even when explicitly running a
  1633.           different schedule, the global commands are still run first. 
  1634.  
  1635.  
  1636.                        Squish v1.00 Reference Manual - Page 27
  1637.  
  1638.  
  1639.  
  1640.           Therefore, the global section should contain commands that you
  1641.           want to run every time that Squish is executed.  Everything
  1642.           between the first line of ROUTE.CFG and the first 'Sched'
  1643.           statement is considered to be a global command and is treated
  1644.           accordingly.
  1645.  
  1646.           Since most nodes will not require schedules, only basic routing
  1647.           information is described here.  Most nodes will have all of their
  1648.           routing commands in the global section of the routing file, which
  1649.           is what this quick installation describes.
  1650.  
  1651.           Routing commands in ROUTE.CFG are executed from top to bottom in
  1652.           sequence.  In other words, if you place a certain routing command
  1653.           before another, you can be assured that Squish will process each
  1654.           command in the order you specified.
  1655.  
  1656.           By default, unless routing commands are used for a given node,
  1657.           mail will be sent directly to that node, uncompressed, using the
  1658.           normal message flavour.  However, various routing commands can be
  1659.           used to modify this behaviour.
  1660.  
  1661.  
  1662.           The Send Command
  1663.  
  1664.           The most basic form of routing is the 'Send' command.  This
  1665.           command instructs Squish to compress mail for the specified
  1666.           nodes, and to give the resulting mail a flavour.  The Send
  1667.           command does NOT perform any readdressing; it simply modifies the
  1668.           flavour and compression of the mail, without changing that mail's
  1669.           destination.
  1670.  
  1671.           The format for the Send command is as follows:
  1672.  
  1673.           Send <flavour> <node> [<nodes>...]
  1674.  
  1675.           <flavour> specifies the flavour to use for the resulting
  1676.           compressed mail archive.  Valid flavours are normal, crash, hold
  1677.           and direct.
  1678.  
  1679.           Following the flavour comes a list of one or more nodes.  Squish
  1680.           will search for normal-flavoured, uncompressed mail destined to
  1681.           any of the specified nodes, and compress and flavour that mail
  1682.           accordingly.  For example, given the following command:
  1683.  
  1684.                Send Crash 1:123/456
  1685.  
  1686.           Squish would take all normal-flavoured packets for 123/456,
  1687.           compress them using the default archiver. and send the compressed
  1688.           mail archive to 123/456 using the crash flavour.
  1689.  
  1690.  
  1691.  
  1692.                        Squish v1.00 Reference Manual - Page 28
  1693.  
  1694.  
  1695.  
  1696.           You can specify more than one node for a Send command, but Squish
  1697.           behaves exactly as if each node were in a separate Send command
  1698.           of its own.  If you wish to route mail for one system through
  1699.           another, then the Route command must be used instead.
  1700.  
  1701.           In other words, the following command:
  1702.  
  1703.                Send Crash 123/456 234/567 345/678
  1704.  
  1705.           is completely identical to this:
  1706.  
  1707.                Send Crash 123/456
  1708.                Send Crash 234/567
  1709.                Send Crash 345/678
  1710.  
  1711.           Both of these commands would compress normal-flavoured packets
  1712.           for 123/456, 234/567 and 345/678, give the compressed mail the
  1713.           crash flavour, and send the resulting archives to 123/456,
  1714.           234/567 and 345/678 (respectively).
  1715.  
  1716.           If you are using an ArcmailAttach mailer, then the 'Send' command
  1717.           is probably the only one you'll need.  Dynamic routing is
  1718.           performed by your mailer, so the only reason for using ROUTE.CFG
  1719.           is to compress and flavour mail, which is exactly what the Send
  1720.           keyword does.
  1721.  
  1722.  
  1723.           The Route Command
  1724.  
  1725.           The Route command is similar to the Send command; however, Route
  1726.           can be used to change the destination address of mail (otherwise
  1727.           known as routing that mail), whereas Send only sends mail
  1728.           directly to its destination. The Route command is normally NOT
  1729.           required for systems using the ArcmailAttach keyword.  If you are
  1730.           running an ArcmailAttach mailer, most messages will be routed on-
  1731.           the-fly, so you can safely skip this section.
  1732.  
  1733.           The format of the Route command is as follows:
  1734.  
  1735.                Route <flavour> <target> [<nodes>...]
  1736.  
  1737.           As with the Send command, <flavour> specifies the message flavour
  1738.           to give the resulting archive.  Valid flavours are normal, crash,
  1739.           direct, and hold.
  1740.  
  1741.           <target> specifies the address of the routing target.  Mail for
  1742.           all of the other nodes will be packaged up, given the specified
  1743.           flavour, and sent to this address.  In other words, this is where
  1744.           all of the routed mail will be sent.  In addition, mail addressed
  1745.           to the target itself will also be flavoured and sent accordingly. 
  1746.  
  1747.  
  1748.                        Squish v1.00 Reference Manual - Page 29
  1749.  
  1750.  
  1751.  
  1752.           Make sure that you have the permission of the target node before
  1753.           routing mail through his/her system.
  1754.  
  1755.           <nodes> is the optional list of network addresses for which
  1756.           Squish should readdress mail.  Squish will look for normal-
  1757.           flavoured, uncompressed packets for these nodes, and then route
  1758.           them through the specified target.
  1759.  
  1760.           For example, the following route command:
  1761.  
  1762.                Route Crash 123/456 234/567 345/678
  1763.  
  1764.           would take mail for 123/456, 234/567 and 345/678, compress it
  1765.           using the default archiver, and send it all to 123/456 using the
  1766.           crash flavour.  Note the difference between Route and Send: 
  1767.           whereas Send will send the mail to each node individually, Route
  1768.           will send all of the mail to the first node specified.  The
  1769.           difference between Route and Send is a fundamental concept in
  1770.           Squish routing.
  1771.  
  1772.  
  1773.           Wildcards
  1774.  
  1775.           The Route and the Send commands provide the framework for a very
  1776.           flexible routing system.  However, the Route and Send commands
  1777.           are often not enough to accomplish a particular task.  For
  1778.           example, to route mail for all nodes in net 123 through another
  1779.           node, is it necessary to explicitly give the node number for each
  1780.           system?  Fortunately, the answer is no.
  1781.  
  1782.  
  1783.           The All and World Wildcards
  1784.  
  1785.           In both SQUISH.CFG and ROUTE.CFG, Squish supports a form of
  1786.           wildcards.  These wildcards can be used to specify a particular
  1787.           node or range of nodes for a particular routing command.  The
  1788.           most basic form of wildcard is 'All'.  'All' can be used in place
  1789.           of a zone, net, node or point number, and it instructs Squish to
  1790.           process mail for all nodes which match the rest of the address.
  1791.  
  1792.           For example, given the following command:
  1793.  
  1794.                Send Crash 106/All
  1795.  
  1796.           Squish would then scan for normal packets destined to any node in
  1797.           net 106, compress the packet, give it the crash flavour, and send
  1798.           the resulting archive directly to its destination.
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.                        Squish v1.00 Reference Manual - Page 30
  1805.  
  1806.  
  1807.  
  1808.           Wildcards can also be used with the 'Route' command.  To use the
  1809.           same example, but to have all of net 106's mail routed through
  1810.           one node, the following could be used:
  1811.  
  1812.                Route Crash 106/123 106/All
  1813.  
  1814.           As above, this would compress normal-flavoured packets for nodes
  1815.           in net 106, and give the resulting archives the crash flavour. 
  1816.           However, all of the archives would be sent to 106/123, where they
  1817.           could be handled by routing commands on 106/123's system.
  1818.  
  1819.           Squish also supports zone wildcards.  For example, the following
  1820.           command:
  1821.  
  1822.                Route Crash 2:123/456 2:All
  1823.  
  1824.           would take mail for all addresses in zone 2, compress it, and
  1825.           sent it all through 2:123/456.
  1826.  
  1827.           Finally, the 'World' wildcard can be used to specify all
  1828.           uncompressed and normal-flavoured packets, no matter where they
  1829.           are addressed.  This is typically useful for "clean-up"
  1830.           situations and for taking care of mail that has no applicable
  1831.           routing commands.  'World' is equivalent to 'All:All'.  For
  1832.           example, the following command:
  1833.  
  1834.                Route Crash 1:987/654 World
  1835.  
  1836.           would cause all remaining, normal-flavoured mail to be compressed
  1837.           and sent to 987/654.
  1838.  
  1839.           As before, all of these wildcards can be used for both the Send
  1840.           and Route commands, in addition to most of the other commands in
  1841.           ROUTE.CFG and SQUISH.CFG.
  1842.  
  1843.           IMPORTANT NOTE FOR ARCMAILATTACH SYSTEMS:
  1844.  
  1845.           By default, Squish leaves outbound packets in an uncompressed
  1846.           form.  However, ArcmailAttach mailers only recognize compressed
  1847.           archives, so you MUST ensure that all packets that Squish creates
  1848.           are compressed.  To do this, you must add the following statement
  1849.           to the end of your ROUTE.CFG:
  1850.  
  1851.                Send Normal World
  1852.  
  1853.           This instructs Squish to archive all remaining packets, and to
  1854.           give the resulting archives a normal flavour.  This makes sure
  1855.           that your mailer can see all of the packets that Squish
  1856.           generates, even if you have not added specific routing commands
  1857.           for an individual node.
  1858.  
  1859.  
  1860.                        Squish v1.00 Reference Manual - Page 31
  1861.  
  1862.  
  1863.  
  1864.  
  1865.           Address Abbreviations
  1866.  
  1867.           Although full 4D addresses can be specified almost everywhere,
  1868.           Squish also permits several shortcuts to save on typing.  When
  1869.           Squish encounters a node number, it will save a copy of that
  1870.           address.  Later, if Squish comes across an incomplete address, it
  1871.           will use that saved copy to fill in missing information.  Squish
  1872.           can use short forms to handle zone and net numbers; however, a
  1873.           node number must always be specified.
  1874.  
  1875.           For example, the following Route command:
  1876.  
  1877.                Route Crash 1:12/34 1:12/45 1:23/45 2:23/56 2:23/67 2:34/67
  1878.  
  1879.           could be rewritten as follows:
  1880.  
  1881.                Route Crash 1:12/34 45 23/45 2:23/56 67 34/67
  1882.  
  1883.           which has the same effect.  In this case, Squish assumes zone 1
  1884.           and net 12 when it comes to the lone "45", based on the previous
  1885.           address.  The "23/45" address is also assumed to be in zone 1,
  1886.           again because of the earlier zone 1 address.  The "2:23/56" is
  1887.           used to start a new set of zone and net defaults, so the full
  1888.           address is required.  As with "45, the "67" assumes the zone and
  1889.           net numbers of the last address.  Finally, a zone number of 2 is
  1890.           assumed for the last address because of the earlier "2:".
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.                        Squish v1.00 Reference Manual - Page 32
  1917.  
  1918.  
  1919.  
  1920.  
  1921.           Examples
  1922.  
  1923.           This section contains several simple routing files, including
  1924.           comments, which should demonstrate the uses of the various
  1925.           routing commands.  In ROUTE.CFG, comment lines start with either
  1926.           a semi-colon (;) or a percent sign (%).  (Everything on the line
  1927.           following either of those characters will be ignored.)
  1928.  
  1929.  
  1930.           Example 1: Simple ArcmailAttach routing
  1931.  
  1932.           % Sample routing file #1.  This example demonstrates a minimal
  1933.           % system configuration.  This type of routing file is the most
  1934.           % useful when using the ArcmailAttach keyword:  since all
  1935.           % routing is performed by your mailer, the only purpose for
  1936.           % ROUTE.CFG is to tell Squish which messages to compress.
  1937.           %
  1938.           % This routing file simply compresses all mail and sends it
  1939.           % to the mail's final destination.  (However, these messages
  1940.           % can be routed by your mailer using dynamic routing.)
  1941.  
  1942.                Send Normal World
  1943.  
  1944.           % The above statement tells Squish to take mail for everyone
  1945.           % (ie. 'World'), place it into an archive, and give it the normal
  1946.           % flavour.  Unless you have a special configuration, this is all
  1947.           % of the routing that you have to do for ArcmailAttach systems.
  1948.  
  1949.  
  1950.  
  1951.  
  1952.           Example 2: Simple BinkleyTerm Routing
  1953.  
  1954.           % Sample routing file #2.  This example demonstrates a minimal
  1955.           % system configuration for a BinkleyTerm mailer.  This example
  1956.           % assumes several things:
  1957.           %
  1958.           % 1) You will be connecting with another node on a fairly
  1959.           %    frequent basis, and you'll be routing most of your
  1960.           %    long-distance netmail through this system.  (Most
  1961.           %    Net Echo Coordinators are willing to route netmail
  1962.           %    for little or no charge, but you should ask before
  1963.           %    doing so.)
  1964.           %
  1965.           % 2) You want to send mail directly to nodes in your own
  1966.           %    net.  Since those nodes are local to your system, sending
  1967.           %    netmail directly is usually much faster.
  1968.           %
  1969.           % 3) You may also be sending netmail to selected long-distance
  1970.  
  1971.  
  1972.                        Squish v1.00 Reference Manual - Page 33
  1973.  
  1974.  
  1975.  
  1976.           %    nodes, and you want EchoMail for those systems to be sent
  1977.           %    directly, as opposed to being sent through your local
  1978.           %    coordinator.
  1979.           %
  1980.           % This example also uses a fictitious network address of
  1981.           % 123/456.  Obviously, your own net and node number should
  1982.           % be substituted for this address, or -1/-1 if you have no
  1983.           % network address.
  1984.  
  1985.           % The first command instructs Squish to send netmail directly
  1986.           % to all systems in net 123.  Mail will be archived, given
  1987.           % the "crash" flavour, and sent directly to its destination.
  1988.           %
  1989.           % Most of your mail will probably be to and from local systems,
  1990.           % so sending it directly is usually the best route.
  1991.  
  1992.                Send Crash 1:123/All
  1993.  
  1994.           % The next command also tells Squish to send mail directly
  1995.           % to nodes 111/222, 222/333 and 333/444.  These addresses
  1996.           % are presumably long-distance nodes with which you talk
  1997.           % frequently, and you therefore want to send your
  1998.           % NetMail directly, as opposed to routing it.  If you
  1999.           % don't communicate with any long-distance nodes, this
  2000.           % command can be commented out.
  2001.           %
  2002.           % However, if you are running any EchoMail conferences of
  2003.           % your own, and you are feeding the conference to other nodes
  2004.           % from your system, you should include the addresses of those
  2005.           % nodes here.  It is considered to be impolite and against
  2006.           % FidoNet policy to route unsolicited EchoMail through
  2007.           % other systems, so you should usually send EchoMail
  2008.           % directly.  All of the routing commands apply to both
  2009.           % NetMail and EchoMail, so you should make sure that you have
  2010.           % added the appropriate commands to deal with systems that
  2011.           % receive EchoMail from you.
  2012.  
  2013.                Send Crash 1:111/222 333/444 555/666
  2014.  
  2015.           % The third and last command tells Squish to send mail for
  2016.           % everywhere else to 1:123/3, which is presumably your area
  2017.           % coordinator.
  2018.           %
  2019.           % Notice how this statement is positioned below all of the
  2020.           % other routing commands.  Since Route and Send only operate
  2021.           % on uncompressed packets with a normal flavour, this command
  2022.           % ignores mail which has been processed by the two other
  2023.           % commands; it will only route mail which has not been already
  2024.           % processed.
  2025.           %
  2026.  
  2027.  
  2028.                        Squish v1.00 Reference Manual - Page 34
  2029.  
  2030.  
  2031.  
  2032.           % However, if this command was mistakenly placed above the
  2033.           % other two commands, you would find that ALL of your mail
  2034.           % was being sent to 123/3 regardless.  Since the mail
  2035.           % is archived and changed to a crash flavour by this
  2036.           % command, the following Send commands would not find any
  2037.           % mail to process, which was probably not your original
  2038.           % intent.
  2039.  
  2040.                Route Crash 1:123/3 World
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.                        Squish v1.00 Reference Manual - Page 35
  2085.  
  2086.  
  2087.  
  2088.  
  2089.           Batch Files
  2090.  
  2091.           After adding the appropriate routing commands, the final step in
  2092.           the installation is to modify the batch files for your mailer and
  2093.           your BBS.  At a bare minimum, Squish must be run in two different
  2094.           situations:
  2095.  
  2096.           1)   After receiving mail.  When your mailer receives mail from
  2097.                another system, Squish needs to be executed to decompress
  2098.                the mail and import it into your local message base. 
  2099.                Optionally, Squish can also scan out or export mail at the
  2100.                same time, if you are sending an echo to someone else.
  2101.  
  2102.           2)   After entering messages locally.  When a message is entered,
  2103.                either through a BBS or an external editor, Squish must be
  2104.                called to export the locally-entered messages.  There are
  2105.                several variations on this theme (after entering EchoMail,
  2106.                after entering NetMail, or both), but the same general
  2107.                process is followed for each variation.
  2108.  
  2109.  
  2110.           Configuring your Mailer
  2111.  
  2112.           First of all, your mailer must be configured to either run an
  2113.           external program when mail has been received, or else to drop
  2114.           back to the calling batch file with an errorlevel.  If you don't
  2115.           know how errorlevels work, you should refer to the Maximus-CBCS
  2116.           Operations Manual for a hand-holding tutorial.  Section eight of
  2117.           the Maximus installation covers errorlevels and batch files. 
  2118.           This gives a general overview of concepts and terminology, which
  2119.           will be helpful when setting up Squish.
  2120.  
  2121.           Assuming that you have batch file basics covered, the first step
  2122.           is to find out which errorlevel your mailer uses when mail is
  2123.           received.  For BinkleyTerm, this errorlevel is specified by the
  2124.           'E2' and 'E3' flags in your BINKLEY.EVT configuration file.  For
  2125.           FrontDoor, this errorlevel is specified in the Mailer /
  2126.           Errorlevels / ReceivedMail option in SETUP.EXE.  For other
  2127.           systems, please consult your mailer's documentation.
  2128.  
  2129.           The next step is to invoke Squish when the specified errorlevel
  2130.           is found.  Assuming that your mailer exits with an errorlevel of
  2131.           100 after receiving mail, the following should be placed in your
  2132.           batch file, immediately after running your mailer:
  2133.  
  2134.           :Loop
  2135.           bt unattended                        ; Other commands here
  2136.           if errorlevel 100   goto SquishIn    ; Toss messages
  2137.           if errorlevel  96   goto BBS         ; Call a BBS program
  2138.  
  2139.  
  2140.                        Squish v1.00 Reference Manual - Page 36
  2141.  
  2142.  
  2143.  
  2144.           if errorlevel  48   goto BBS         ; Call a BBS program
  2145.           ... and so on ...
  2146.  
  2147.           Only the lines labelled ':Loop' and 'SquishIn' are required by
  2148.           Squish itself.  The other lines should have be added so that your
  2149.           BBS is run for human callers; they are not mandatory for Squish's
  2150.           operation, and the errorlevels may be different (depending on
  2151.           which BBS package you run).  The errorlevel procedure is the same
  2152.           for FrontDoor, except that 'fd' should be substituted for 'bt
  2153.           unattended'.  Please consult your mailer's documentation to learn
  2154.           how to start up a different type of mailer.
  2155.  
  2156.           The ':Loop' label should be placed just before your mailer's
  2157.           command-line.  After tossing and scanning mail, Squish will jump
  2158.           back up to this label and restart your mailer.
  2159.  
  2160.           The 'if errorlevel 100' statement checks for the "received mail"
  2161.           errorlevel, and if found, it jumps to the part of the batch file
  2162.           which starts up Squish.
  2163.  
  2164.           Keep in mind that all errorlevels must be in DESCENDING ORDER. 
  2165.           When interpreting each 'if errorlevel' statement, DOS performs a
  2166.           check to see if the current errorlevel is GREATER THAN OR EQUAL
  2167.           TO the specified errorlevel.  To ensure that each line is
  2168.           executed only when you want it to, all of the errorlevels have to
  2169.           be in descending order.
  2170.  
  2171.           After adding the check for receiving mail, you should now create
  2172.           the portion of the batch file which actually invokes Squish. 
  2173.           Near the end of your batch file, but before any final 'exit' or
  2174.           ':end' statements, add the following:
  2175.  
  2176.           :SquishIn
  2177.           cd\Squish
  2178.           squish in out squash link
  2179.           cd\Bink
  2180.           goto Loop
  2181.  
  2182.           This does five things:
  2183.  
  2184.           1)   The ':SquishIn' label is referenced by the earlier 'if
  2185.                errorlevel' statement.  This is where your batch file will
  2186.                jump to if mail is received.
  2187.  
  2188.           2)   The 'cd\Squish' changes the current directory to \Squish,
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.                        Squish v1.00 Reference Manual - Page 37
  2197.  
  2198.  
  2199.  
  2200.                which is presumably where SQUISH.EXE and its associated
  2201.                configuration files are kept.
  2202.  
  2203.           3)   The 'squish in out squash link' command starts Squish in
  2204.                one-pass mode.  This command will cause Squish to check for
  2205.                incoming mail, decompress it, toss it to the local message
  2206.                bases, scan it out to other nodes (if necessary), pack
  2207.                messages and create ARCmail attaches in your netmail area,
  2208.                and finally, to link reply chains.  For more information on
  2209.                Squish's command-line parameters, please see the section
  2210.                entitled "Squish Command Line Parameters and Syntax".
  2211.  
  2212.           4)   The 'cd\Bink' command tells DOS to change back to your
  2213.                mailer's directory.  (If you are running FrontDoor, this
  2214.                will probably be 'cd\FD' or something similar.)  Unless this
  2215.                line is included, your mailer may not operate properly after
  2216.                Squish runs.
  2217.  
  2218.           5)   The 'goto Loop' command causes your batch file to loop back
  2219.                to the top again, and to restart your mailer.  Unless this
  2220.                command is included, Squish would simply drop back to the
  2221.                operating system, or possibly execute other unwanted
  2222.                commands in your batch file.  To make sure that this looping
  2223.                works, ensure that there's a ':Loop' label right above the
  2224.                line that calls your mailer.  (See above for more details.)
  2225.  
  2226.  
  2227.           Configuring your BBS
  2228.  
  2229.           After making the above modifications, Squish should be fully
  2230.           operational when receiving mail.  The only other modification you
  2231.           need to make are to your BBS's or off-line reader's batch files. 
  2232.           The procedure is similar:  determine which errorlevel is used
  2233.           when mail is entered, and jump to the appropriate portion of the
  2234.           batch file.
  2235.  
  2236.           For example, Maximus-CBCS uses the following errorlevels:
  2237.  
  2238.           Errorlevel 12: Caller entered EchoMail (and maybe NetMail)
  2239.           Errorlevel 11: Caller entered NetMail (but not EchoMail)
  2240.           Others:        Caller entered neither NetMail nor EchoMail
  2241.  
  2242.           The two separate cases -- NetMail/EchoMail, and NetMail only --
  2243.           must be treated differently.  When EchoMail is entered (and
  2244.           possibly NetMail as well), the echoes must be scanned for
  2245.           messages to export, and the netmail area must be packed (or
  2246.           scanned for ARCmail attaches).  However, when only NetMail is
  2247.           entered, only the packing/scanning needs to be performed.  What
  2248.           follows is a simple batch file which demonstrates how to
  2249.           implement Squish on a Maximus system.  This assumes that you have
  2250.  
  2251.  
  2252.                        Squish v1.00 Reference Manual - Page 38
  2253.  
  2254.  
  2255.  
  2256.           configured Max's "Log EchoMail" feature and that it points to the
  2257.           file C:\MAX\ECHOTOSS.LOG.
  2258.  
  2259.           max -p%1 -b%2 -t%3      ; Other parameters here
  2260.           if errorlevel  12   goto SquishOut
  2261.           if errorlevel  11   goto SquishSquash
  2262.           if errorlevel   5   goto Recycle
  2263.           ... and so forth ...
  2264.  
  2265.           As before, only the 'SquishOut' and 'SquishSquash' lines are
  2266.           required by Squish.
  2267.  
  2268.           After taking care of the other errorlevels, you should insert the 
  2269.           following two sections in your BBS's batch file:
  2270.  
  2271.           :SquishOut
  2272.           cd\Squish                                ; Chg to Squish dir.
  2273.           squish out squash -fc:\max\echotoss.log  ; Export messages
  2274.           del c:\max\echotoss.log
  2275.           goto End
  2276.  
  2277.           :SquishSquash
  2278.           cd\Squish
  2279.           squish squash                      ; Pack msgs and do ArcAttaches
  2280.           goto End
  2281.  
  2282.           The section marked ':SquishOut' invokes Squish and instructs it
  2283.           to scan the EchoMail areas listed in ECHOTOSS.LOG.  If your BBS
  2284.           program or off-line reader is not capable of generating an
  2285.           ECHOTOSS.LOG, then simply omit the '-fc:\max\echotoss.log'. 
  2286.           Omitting that command-line option will cause Squish to scan all
  2287.           EchoMail areas every time it is run, which is usually much slower
  2288.           than using ECHOTOSS.LOG for scanning.  (Please see the section
  2289.           entitled "Squish Command Line Parameters and Syntax" for
  2290.           information on the format of ECHOTOSS.LOG.)
  2291.  
  2292.           After exporting messages, the 'squash' portion of the command
  2293.           line tells Squish to pack netmail messages, create ARCmail
  2294.           attaches, and execute the commands in ROUTE.CFG.
  2295.  
  2296.           The ':SquishSquash' portion of the batch file does the same
  2297.           thing, except that it skips scanning the EchoMail areas, and
  2298.           simply runs Squish in a mode which packs netmail messages and
  2299.           executes ROUTE.CFG.
  2300.  
  2301.           This concludes the Squish installation procedure.  If you have
  2302.           followed all of these steps, you should have a working version of
  2303.           Squish that tosses, scans, packs, links, slices and dices.  For
  2304.           advanced tricks and tips on operating Squish, please read through
  2305.           the rest of this manual at your leisure.
  2306.  
  2307.  
  2308.                        Squish v1.00 Reference Manual - Page 39
  2309.  
  2310.  
  2311.  
  2312.                                       OPERATION
  2313.  
  2314.  
  2315.           Squish Command Line Parameters and Syntax
  2316.  
  2317.           Squish operates in several modes, all of which are controllable
  2318.           from the command line.  The command line itself is broken down
  2319.           into a series of "actions" and "switches".  Actions are single
  2320.           words which control Squish's processing modes, such as tossing
  2321.           and scanning messages.  Switches are used to modify the behaviour
  2322.           of those modes, such as only scanning certain areas, not
  2323.           displaying any output, and so on.  The format of the command line
  2324.           is as follows:
  2325.  
  2326.                SQUISH <mode> <switches>
  2327.  
  2328.           Modes
  2329.  
  2330.           <mode> consists of one or more of the following keywords:
  2331.  
  2332.           IN        Toss (import) messages.  This option causes Squish to
  2333.                     check for packets and compressed mail archives in all
  2334.                     of the NetFile directories, and to import any messages
  2335.                     that it finds.
  2336.  
  2337.           OUT       Scan (export) messages.  This option causes Squish to
  2338.                     scan all EchoMail areas for new messages.  If Squish
  2339.                     finds a new message, that message will be exported to
  2340.                     all of the nodes listed in that area's definition. 
  2341.                     Squish uses the SEEN-BYs to keep track of which nodes
  2342.                     the message has already been sent to, so the message
  2343.                     may not be exported to all of the nodes listed.
  2344.  
  2345.                     If both the IN and OUT actions are specified on the
  2346.                     same command line, Squish will function in "single
  2347.                     pass" mode.  "Single pass" means that Squish will both
  2348.                     toss and scan messages at the same time (which yields
  2349.                     higher performance).  Single pass mode is especially
  2350.                     useful for systems running many "passthru" areas, since
  2351.                     messages will be written directly to the output *.PKT
  2352.                     files, as opposed to making a temporary stop in a
  2353.                     message area.  Consequently, using passthru message
  2354.                     areas in multipass mode is MUCH slower than using
  2355.                     passthru areas in single-pass mode.
  2356.  
  2357.                     However, you should ONLY use the "IN" parameter when
  2358.                     there are messages to be tossed.  When running with
  2359.                     "IN" and "OUT", Squish will only scan those areas to
  2360.                     which messages are being tossed.  Therefore, when you
  2361.  
  2362.  
  2363.  
  2364.                        Squish v1.00 Reference Manual - Page 40
  2365.  
  2366.  
  2367.  
  2368.                     wish to only scan messages, the `IN' parameter should
  2369.                     NOT be specified.
  2370.  
  2371.                     When the OUT command is specified alone, Squish will
  2372.                     scan all EchoMail areas on the system.  When used in
  2373.                     conjunction with the IN command, Squish will scan
  2374.                     messages as it tosses.  In addition, if Squish detects
  2375.                     that unsent messages exist in an EchoMail area, Squish
  2376.                     will invoke a full scan of that area before tossing to
  2377.                     it.
  2378.  
  2379.           SQUASH    For a BinkleyTerm system, the SQUASH command packs
  2380.                     messages from the NetMail areas, scans the outbound
  2381.                     areas, performs mail routing, and compresses packets.
  2382.  
  2383.                     For a FrontDoor-style system, the SQUASH command
  2384.                     compresses packets, scans the NetMail area, creates
  2385.                     ARCmail attach messages, and optionally kills any
  2386.                     orphaned archives.
  2387.  
  2388.                     If the SQUASH command is specified on the same command
  2389.                     line as IN and OUT, the single pass MaxMsgs mode can
  2390.                     also be used to limit outbound packet sizes.
  2391.  
  2392.           LINK      Relink reply chains.  The LINK command will read all
  2393.                     messages in an EchoMail area and create reply links for
  2394.                     each message (based on the subject fields).  Relinking
  2395.                     allows other software to perform "threaded reading" on
  2396.                     message bases, which is an easy and convenient way of
  2397.                     viewing messages.
  2398.  
  2399.                     When combined with the IN and OUT commands, only those
  2400.                     areas which received messages will be linked.
  2401.  
  2402.           RESCAN    Rescan one or more EchoMail areas.  The RESCAN command 
  2403.                     provides a convenient way to rescan EchoMail areas from
  2404.                     the command line, instead of fiddling with 1.MSG and
  2405.                     other system files.
  2406.  
  2407.                     Unlike the other modes, RESCAN cannot be combined with
  2408.                     other switches or actions.  The format for the RESCAN
  2409.                     command is:
  2410.  
  2411.                     SQUISH RESCAN <echo_or_tosslog> <node>
  2412.  
  2413.                     <echo_or_tosslog> is either the tag of an EchoMail
  2414.                     area, or the name of an ECHOTOSS.LOG-format file
  2415.                     (containing a list of area tags).
  2416.  
  2417.  
  2418.  
  2419.  
  2420.                        Squish v1.00 Reference Manual - Page 41
  2421.  
  2422.  
  2423.  
  2424.                     <node> specifies the node number for which the
  2425.                     specified EchoMail areas should be rescanned.
  2426.  
  2427.                     After processing the command line, Squish will
  2428.                     immediately rescan ALL of the messages in the specified
  2429.                     areas.  The SEEN-BYs will not be updated in the on-disk
  2430.                     message base, the high water mark will be left
  2431.                     untouched, and the messages will not be sent to anyone
  2432.                     except the listed node.
  2433.  
  2434.                     This command was designed for NECs and other EchoMail
  2435.                     hubs who wish to rescan entire message bases for nodes
  2436.                     who have just connected to a particular echo.
  2437.  
  2438.                     Warning!  If you wish to specify command line switches
  2439.                     in conjunction with the RESCAN command, those switches
  2440.                     must precede the rescan command on the command line. 
  2441.                     In other words, to leave all packets in the OUTBOUND.SQ
  2442.                     area, use `SQUISH -L RESCAN AREANAME NET/NODE'.
  2443.  
  2444.           With the exception of RESCAN, all of these modes can be specified
  2445.           at the same time for optimum performance.  The command "SQUISH IN
  2446.           OUT SQUASH LINK" instructs Squish to toss and scan messages in
  2447.           single pass mode, to pack messages from the NetMail area, to
  2448.           route and compress packets, and to relink reply chains.
  2449.  
  2450.  
  2451.           Certain combinations of the Squish command line parameters are
  2452.           useful only in certain situations.  Namely, the "IN" command must
  2453.           only be used when there are packets to be tossed, so care must be
  2454.           taken to use "IN" only when necessary.
  2455.  
  2456.           The following command lines are recommended for various
  2457.           situations:
  2458.  
  2459.           After receiving EchoMail or NetMail from another system:
  2460.  
  2461.                SQUISH IN OUT SQUASH LINK (with an optional -fECHOTOSS.LOG)
  2462.  
  2463.           After EchoMail and/or NetMail has been entered locally:
  2464.  
  2465.                SQUISH OUT SQUASH LINK (with an optional -fECHOTOSS.LOG)
  2466.  
  2467.           After NetMail has been entered locally:
  2468.  
  2469.                SQUISH SQUASH
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.                        Squish v1.00 Reference Manual - Page 42
  2477.  
  2478.  
  2479.  
  2480.           Command Line Switches
  2481.  
  2482.           In addition to <mode>, Squish accepts any of the following
  2483.           command line switches:
  2484.  
  2485.           -a<file>  The -a switch instructs Squish to use the specified
  2486.                     AREAS.BBS-like file, overriding the filename specified
  2487.                     in SQUISH.CFG.
  2488.  
  2489.           -c<file>  The -c switch instructs Squish to use a configuration
  2490.                     file with the specified path and filename, as opposed
  2491.                     to looking for SQUISH.CFG in the current directory.
  2492.  
  2493.           -f<file>  The -f switch specifies the name of an ECHOTOSS.LOG-
  2494.                     type file which contains a list of echo tags to
  2495.                     process.  When used in conjunction with the IN command,
  2496.                     Squish will create a log of all non-passthru echoes
  2497.                     that received messages during the current session. 
  2498.                     When used in conjunction with the OUT or LINK commands,
  2499.                     Squish will only process echoes listed in the
  2500.                     ECHOTOSS.LOG file.
  2501.  
  2502.                     Although the -f switch was designed to be used with a
  2503.                     tosslog filename, it can also specify the name of a
  2504.                     single EchoMail area to be processed.  For example,
  2505.                     "SQUISH OUT -fMUFFIN" would instruct Squish to scan the
  2506.                     MUFFIN echo for new messages.
  2507.  
  2508.                     WARNING!  Squish will never delete ECHOTOSS.LOG.  When
  2509.                     tossing, Squish will simply append to the log you
  2510.                     specify (to fully supporting multi-line systems).  It
  2511.                     is assumed that your batch files will delete
  2512.                     ECHOTOSS.LOG after performing all necessary processing;
  2513.                     this must always be done, or else ECHOTOSS.LOG will
  2514.                     grow and grow after each successive invocation of
  2515.                     Squish.
  2516.  
  2517.           -l        The -l switch (BinkleyTerm systems only) instructs
  2518.                     Squish to leave *.OUT packets in the OUTBOUND.SQ
  2519.                     holding area.  Before Squish terminates, it normally
  2520.                     moves all unrouted packets from OUTBOUND.SQ to the
  2521.                     proper zoned outbound area.  However, if you are
  2522.                     running Squish in a multipass environment, you may wish
  2523.                     to leave the packets in the OUTBOUND.SQ area between
  2524.                     passes to shield the packets from other programs on
  2525.                     multitasking or multi-line systems.
  2526.  
  2527.           -o        The -o switch (BinkleyTerm systems only) instructs
  2528.  
  2529.  
  2530.  
  2531.  
  2532.                        Squish v1.00 Reference Manual - Page 43
  2533.  
  2534.  
  2535.  
  2536.                     Squish NOT to pack messages in the NetMail area when
  2537.                     performing a SQUASH command.  Squish will still scan
  2538.                     the outbound area and archive packets, but no NetMail
  2539.                     messages will be processed.
  2540.  
  2541.                     If you need to run an external utility over your
  2542.                     NetMail area (such as a message tracker or
  2543.                     readdresser), this option will allow you to use MaxMsgs
  2544.                     with a one-pass IN OUT SQUASH command line.  Squish can
  2545.                     be run with IN OUT SQUASH and the -o switch, and then
  2546.                     your external utility can be run, followed by a
  2547.                     separate SQUISH SQUASH without the -o switch.
  2548.  
  2549.           -q        The -q switch enables "quiet mode".  Quiet mode
  2550.                     suppresses most of the information displayed while a
  2551.                     packet is tossing, although Squish will still display
  2552.                     the name and origination addresses for each packet. 
  2553.                     Although this option makes the Squish screen display
  2554.                     less informative, the -q makes Squish run slightly
  2555.                     faster.
  2556.  
  2557.           -s<sched> The -s switch instructs Squish to process the specified
  2558.                     schedule when performing the SQUASH command.  If no
  2559.                     schedule is specified, Squish will execute the global
  2560.                     commands, plus any schedule which is within the current
  2561.                     time period.  If an explicit schedule is specified on
  2562.                     the command line, only that schedule and the global
  2563.                     commands will be executed.
  2564.  
  2565.           -t        The -t switch toggles the status of Squish's secure
  2566.                     mode.  In other words, if you have `Secure' turned ON
  2567.                     in SQUISH.CFG, using -t will temporarily turn OFF
  2568.                     Secure more.  Likewise, if you have Secure turned OFF
  2569.                     in SQUISH.CFG, using -t will temporarily turn ON secure
  2570.                     mode.
  2571.  
  2572.           -v        The -v switch toggles the use of "Statistics Mode".  If
  2573.                     "Statistics" is turned ON in the configuration file,
  2574.                     this switch will temporarily disable statistics mode. 
  2575.                     Similarly, if "Statistics" is turned OFF in the
  2576.                     configuration file, -v will temporarily turn it back
  2577.                     on.  This switch can be used to create statistics
  2578.                     information only when mail is received from a certain
  2579.                     node.
  2580.  
  2581.           -z        The -z switch instructs Squish to scan non-passthru
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.                        Squish v1.00 Reference Manual - Page 44
  2589.  
  2590.  
  2591.  
  2592.                     areas only.  Normally, when Squish is invoked with the
  2593.                     OUT command, it will scan all of the areas defined in
  2594.                     SQUISH.CFG and/or AREAS.BBS.  However, if you normally
  2595.                     do not keep any messages in your passthru areas, this
  2596.                     switch will cause Squish to skip those areas and
  2597.                     marginally speed up processing.
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.                        Squish v1.00 Reference Manual - Page 45
  2645.  
  2646.  
  2647.  
  2648.  
  2649.           Running Squish in Multipass Mode
  2650.  
  2651.           The easiest and most efficient way to run Squish is in "single
  2652.           pass" mode, meaning that Squish will toss, scan, and pack
  2653.           messages all at the same time.  However, Squish can also be run
  2654.           in multipass mode, meaning that tossing, scanning and packing can
  2655.           be separated into two or three different passes.  Some of the
  2656.           reasons for using multipass mode are:
  2657.  
  2658.           *    Decreased memory requirements.  When running in single pass
  2659.                mode, Squish needs enough memory to buffer the packet being
  2660.                tossed, to hold the incoming messages, and buffers for
  2661.                outbound messages.  When running in multipass mode, Squish
  2662.                only needs to keep one part of the message in memory at a
  2663.                time, thereby reducing memory requirements of the DOS
  2664.                version by 60K or more.
  2665.  
  2666.           *    Some preprocessing utilities may need to be run between
  2667.                passes.  For example, several utilities may need to be run
  2668.                over the message bases after a message has been tossed, but
  2669.                before that message is scanned out to other systems. 
  2670.                Multipass mode allows for this type of external utility.
  2671.  
  2672.           The key to multipass mode is the use of ECHOTOSS.LOG.  The -f
  2673.           switch should be used to keep a log of tossed messages, such that
  2674.           Squish scans and links only those areas which received messages.
  2675.  
  2676.           Invoking Squish in multipass mode is usually done in the
  2677.           following manner:
  2678.  
  2679.           SQUISH IN -fECHOTOSS.LOG
  2680.           rem * Other external utilities here
  2681.           SQUISH OUT -fECHOTOSS.LOG
  2682.           rem * Other external utilities here
  2683.           SQUISH SQUASH
  2684.           rem * Other external utilities here
  2685.           SQUISH LINK -fECHOTOSS.LOG
  2686.           del ECHOTOSS.LOG
  2687.  
  2688.           Depending on your processing requirements, you may wish to run
  2689.           two passes at the same time (such as SQUASH and LINK, or IN and
  2690.           OUT), but the general format remains the same.  Squish will be
  2691.           somewhat slower when running in multipass mode, especially when
  2692.           the IN and OUT passes are separated.  However, this method of
  2693.           operation allows for flexibility and allows other external
  2694.           utilities to be inserted into the tossing/scanning process.
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.                        Squish v1.00 Reference Manual - Page 46
  2701.  
  2702.  
  2703.  
  2704.                                  AREAS.BBS REFERENCE
  2705.  
  2706.           Squish supports the definition of EchoMail areas in the standard
  2707.           AREAS.BBS file.  However, this format was designed for use with
  2708.           older systems, and as such, it doesn't support many of the new
  2709.           features that Squish offers.  Regardless, some users may find it
  2710.           advantageous to declare areas in AREAS.BBS for compatibility
  2711.           reasons.
  2712.  
  2713.           The first line of AREAS.BBS is always your default origin line;
  2714.           this text will be added to messages which do not already have an
  2715.           origin line.  After the text of the origin line, you should place
  2716.           an exclamation mark, followed by your name.  Squish doesn't use
  2717.           the SysOp name, but other programs may require it.
  2718.  
  2719.           For example, the first line in AREAS.BBS might look like this:
  2720.  
  2721.           Fowl Weather Post * Kingston, Ont., Canada !Scott Dudley
  2722.  
  2723.           Following the default origin line should be one or more EchoMail
  2724.           area definitions.  An EchoMail area definition has the following
  2725.           format:
  2726.  
  2727.                [#][$]<path> <tag> [nodes...]
  2728.  
  2729.           Both the '#' and '$' characters are optional.  If a '#' is placed
  2730.           before the path, that area will be treated as a passthru area. 
  2731.           (For more information on passthru areas, please see the section
  2732.           entitled "Area Definitions" in the SQUISH.CFG reference.)
  2733.  
  2734.           If a '$' is placed before the path, that area will be treated as
  2735.           a Squish (*.SQ?) format message area.  (For more information,
  2736.           please see the section entitled "USING SQUISH-FORMAT MESSAGE
  2737.           AREAS".)
  2738.  
  2739.           Both the '#' and '$' characters should come immediately before
  2740.           the first character of the area's path.  No spaces are permitted.
  2741.  
  2742.           <path> should specify the path of the EchoMail area.  For a *.MSG
  2743.           area, this should be the name of directory in which the *.MSG
  2744.           files are kept.  For a Squish (*.SQ?) area, this should specify
  2745.           the path and root filename of the message area.
  2746.  
  2747.           <tag> should be the one-word area tag to be used for that area.
  2748.  
  2749.           [nodes] is the optional list of nodes to whom you send that echo.
  2750.  
  2751.           For examples, please see the distribution copy of AREAS.BBS.
  2752.  
  2753.  
  2754.  
  2755.  
  2756.                        Squish v1.00 Reference Manual - Page 47
  2757.  
  2758.  
  2759.  
  2760.                                  SQUISH.CFG REFERENCE
  2761.  
  2762.           SQUISH.CFG is the main Squish configuration file.  SQUISH.CFG
  2763.           controls most aspects of Squish's operation, including the
  2764.           message areas it uses, the directories where it places files, and
  2765.           even how to remap messages addressed to certain users.
  2766.  
  2767.           SQUISH.CFG is divided into two logical sections:  firstly, there
  2768.           is the main configuration section.  This section contains
  2769.           information about your system and everything else that Squish
  2770.           needs to know.  Secondly, there is an optional area configuration
  2771.           section.  This part of the configuration file allows you to
  2772.           define NetMail, EchoMail, dupe storage and bad message areas for
  2773.           your system.
  2774.  
  2775.           SQUISH.CFG is an ASCII file, so it can be edited using a text
  2776.           editor (or a word processor in non-document mode).  Lines which
  2777.           begin with a semicolon (;) are treated as comments and are
  2778.           ignored.
  2779.  
  2780.  
  2781.           Configuration Options
  2782.  
  2783.           This section describes all of the commands and options available
  2784.           in the system information section of SQUISH.CFG.  For information
  2785.           on defining EchoMail, NetMail, bad message or dupe storage areas,
  2786.           please see the next section.
  2787.  
  2788.           The following is an alphabetical listing of keywords in
  2789.           SQUISH.CFG.  Descriptions are given for all keywords, and
  2790.           examples are given where appropriate.
  2791.  
  2792.           AddMode (BinkleyTerm systems only)
  2793.  
  2794.                The AddMode keyword enables the "add mode" functionality of
  2795.                the outbound directory manager.  Add mode causes new file
  2796.                attaches to be merged into existing attaches of different
  2797.                flavours.  When add mode is turned on, Squish will perform
  2798.                some special processing before creating a file attach. 
  2799.                Instead of simply creating an attach with the specified
  2800.                flavour, it will first scan the outbound directory to see if
  2801.                any other attaches exist for the same node.  If a non-
  2802.                normal-flavoured attach is found, add mode will cause Squish
  2803.                to add the current file to that attach, regardless of the
  2804.                flavour specified for the "Route" or "Send" commands.
  2805.  
  2806.                This verb is useful in many situations, such as when a node
  2807.                goes down for a short period of time.  With add mode turned
  2808.                on, simply change the flavour of the existing attaches in
  2809.                the outbound area to "hold".  When Squish scans out more
  2810.  
  2811.  
  2812.                        Squish v1.00 Reference Manual - Page 48
  2813.  
  2814.  
  2815.  
  2816.                mail for that node, it will notice the hold attach and it
  2817.                will hold all new mail as well.  This means that no
  2818.                modifications to your routing control files are necessary,
  2819.                even if you are using "Route Crash" or "Send Crash" for that
  2820.                particular node.
  2821.  
  2822.                By default, with add mode disabled, Squish will simply use
  2823.                the given flavour, without attempting to check for other
  2824.                existing attaches.
  2825.  
  2826.           Address <node> [<node>...]
  2827.  
  2828.                The Address keyword defines one or more network addresses
  2829.                used by your system.  The first address specified in
  2830.                SQUISH.CFG is considered to be your "primary address", and
  2831.                this address will be used for all outbound mail (unless told
  2832.                otherwise -- see the documentation on the EchoArea keyword
  2833.                in the "Area Definitions" section of the SQUISH.CFG
  2834.                reference).
  2835.  
  2836.                Squish handles full 4D addresses and is capable of running
  2837.                as either a bossnode or a point.
  2838.  
  2839.                For a normal network node, only one address statement is 
  2840.                required.  Your primary address should be declared in this
  2841.                format:
  2842.  
  2843.                     Address 1:123/456
  2844.  
  2845.                where "1:123/456" is your full network address, including
  2846.                zone number.
  2847.  
  2848.                For fakenet points, two addresses are required.  The first
  2849.                address declared in SQUISH.CFG should be your fakenet
  2850.                address, and the second address should be your full 4D point
  2851.                address.  Both addresses must include the proper zone
  2852.                number.  For example, a fakenet point at 1:123/456.1 (using
  2853.                a fakenet of 12345) might use the following set of address
  2854.                statements:
  2855.  
  2856.                     Address 1:12345/1
  2857.                     Address 1:123/456.1
  2858.  
  2859.                In addition, fakenet points must also use the "PointNet"
  2860.                verb, below.
  2861.  
  2862.                For 4D points, only one address is required.  This address
  2863.                should be your full 4D point address, and it should be
  2864.                declared as the first address in your configuration file. 
  2865.  
  2866.  
  2867.  
  2868.                        Squish v1.00 Reference Manual - Page 49
  2869.  
  2870.  
  2871.  
  2872.                For example, a 4D point of 1:123/456 might use the following
  2873.                address statement:
  2874.  
  2875.                     Address 1:123/456.1
  2876.  
  2877.                However, to use 4D points, all of your software must be able
  2878.                to handle 4D addresses, and your mailer and EchoMail
  2879.                processors must compliant with the proposed "2+" packet
  2880.                type.
  2881.  
  2882.                After you have defined your primary address, any number of
  2883.                AKA (Also-Known-As) addresses may be listed.  These
  2884.                addresses won't be used for outgoing mail, but Squish will
  2885.                use these AKAs to determine whether or not a packet is
  2886.                destined for your system.
  2887.  
  2888.                Any number of AKAs may be specified, up to the limit of
  2889.                available memory.
  2890.  
  2891.           AddToSeen <node> [<node>...]
  2892.  
  2893.                The AddToSeen keyword globally adds a node number to the
  2894.                SEEN-BYs of all EchoMail areas which are processed by your
  2895.                system.  The AddToSeen keyword specifies one or more two-
  2896.                dimensional address (net/node only) which are to be added. 
  2897.                This keyword adds these addresses to ALL echoes, so it
  2898.                should be only used in special situations.  By default, your
  2899.                primary address is added to the SEEN-BYs for all areas.  For
  2900.                information on changing your primary address, or for adding
  2901.                to the SEEN-BYs on an area-by-area basis, please see the
  2902.                "Flags" section of the SQUISH.CFG reference.
  2903.  
  2904.           ArcmailAttach
  2905.  
  2906.                The ArcmailAttach keyword informs Squish that your mailer
  2907.                requires "ARCmail file attaches" to transmit EchoMail to
  2908.                other systems.  Mailers such as FrontDoor, D'Bridge, and
  2909.                InterMail require this keyword, whereas others (such as
  2910.                BinkleyTerm) do not.  If you are not running any of the
  2911.                above pieces of software, please consult your mailer's
  2912.                documentation to determine whether or not it requires
  2913.                ARCmail attaches.
  2914.  
  2915.                When this keyword is enabled, Squish operates differently in
  2916.                several ways:
  2917.  
  2918.                *    Packing of the NetMail area is disabled.  Mailers which
  2919.                     require ARCmail attaches perform dynamic packing on
  2920.                     their own, so this portion of the Squish code is
  2921.                     automatically disabled.
  2922.  
  2923.  
  2924.                        Squish v1.00 Reference Manual - Page 50
  2925.  
  2926.  
  2927.  
  2928.                *    ARCmail attach messages will be generated for outbound
  2929.                     EchoMail.  This support is internal to Squish, so no
  2930.                     external utilities are required.
  2931.  
  2932.                *    Most of the routing code for the SQUISH SQUASH command
  2933.                     is disabled.  Again, since ARCmail attach mailers
  2934.                     perform dynamic routing, these features are not
  2935.                     required.
  2936.  
  2937.                *    Squish will only write packets to the OUTBOUND.SQ area,
  2938.                     and it will disable the use of BinkleyTerm-style "zoned
  2939.                     outbound directories".
  2940.  
  2941.                *    Squish will enable 4D point support, since most ARCmail
  2942.                     attach mailers are capable of handling 4D  points.
  2943.  
  2944.                By default, ARCmail attach support is disabled.  This means
  2945.                that:
  2946.  
  2947.                *    Squish will perform packing of the NetMail area. 
  2948.                     Squish will gateroute messages, handle file attaches,
  2949.                     file requests and update requests, in addition to the
  2950.                     optional deletion and truncation of attached files. 
  2951.                     Messages will be packed from all areas declared using
  2952.                     the 'NetArea' keyword.
  2953.  
  2954.                *    Squish will perform static routing and packing in the
  2955.                     outbound areas.  If the BinkPoint verb is implemented,
  2956.                     Squish will enable support for 4D points on a
  2957.                     BinkleyTerm-style system.
  2958.  
  2959.                *    Squish will directly process BinkleyTerm-style zoned
  2960.                     outbound directories and enable full support for all
  2961.                     commands in ROUTE.CFG.
  2962.  
  2963.                Unless the ArcmailAttach verb is set correctly, Squish may
  2964.                produce unpredictable and unreliable results on your system. 
  2965.                Make sure that this verb is set appropriately before running
  2966.                Squish.
  2967.  
  2968.           AreasBBS <filespec>
  2969.  
  2970.                The AreasBBS keyword specifies the path and name of a 
  2971.                ConfMail-compatible AREAS.BBS file, which is one way of
  2972.                defining EchoMail areas.  Please see the section entitled
  2973.                "AREAS.BBS REFERENCE" for more information on using this
  2974.                command.  Note:  the '-a' command-line switch can also be
  2975.                used to override the filename given for this command.
  2976.  
  2977.  
  2978.  
  2979.  
  2980.                        Squish v1.00 Reference Manual - Page 51
  2981.  
  2982.  
  2983.  
  2984.           BatchUnarc
  2985.  
  2986.                The BatchUnarc keyword instructs Squish to decompress all
  2987.                compressed mail bundles at the same time.  By default,
  2988.                Squish will decompress one mail bundle, toss all of the
  2989.                packets in it, decompress the next bundle, toss those
  2990.                packets, and so on.  Although this method makes efficient
  2991.                use of disk space, there is a slight chance that messages
  2992.                may get out-of-order, depending on the order in which the
  2993.                compressed mail archives arrived on your system.
  2994.  
  2995.                The BatchUnarc keyword instructs Squish to decompress all of
  2996.                the  compressed mail archives at once, and to then toss the
  2997.                *.PKT files.  Squish always sorts packets by date before
  2998.                tossing, so this ensures that messages will not get out of
  2999.                order.
  3000.  
  3001.           BinkPoint (BinkleyTerm systems only)
  3002.  
  3003.                The BinkPoint keyword enables the BinkleyTerm 2.50+ point 
  3004.                directory support.  When this keyword is enabled, Squish
  3005.                will turn on full 4D address support, and Squish can then
  3006.                communicate freely with 4D points running BinkleyTerm.
  3007.  
  3008.                If you are using 4D points with Binkley 2.50 or above, BOTH
  3009.                the boss and the point must have this keyword enabled.
  3010.  
  3011.           Buffers <size>
  3012.  
  3013.                The Buffers keyword can be used to limit Squish's memory
  3014.                usage.  <size> can be either "Large", "Medium" or "Small". 
  3015.                Small buffers are typically useful on an end node which does
  3016.                NOT forward mail to anyone else.
  3017.  
  3018.                Using small buffers will save approximately 64K of memory
  3019.                over large buffers, but doing so will make scanning
  3020.                relatively slow.
  3021.  
  3022.                Medium buffers are a compromise, and they will use about 30K
  3023.                less memory than large buffers.
  3024.  
  3025.                A buffer setting of "Large" is the default (and is also the
  3026.                fastest).
  3027.  
  3028.                Keep in mind that reducing the level of buffering will have
  3029.                an impact on speed.  If you want Squish to run as fast as
  3030.                possible, use large buffers.  If you want Squish to run in
  3031.                as little memory as possible, use small buffers.  If you
  3032.                want a compromise, try using medium buffers.
  3033.  
  3034.  
  3035.  
  3036.                        Squish v1.00 Reference Manual - Page 52
  3037.  
  3038.  
  3039.  
  3040.                Other tips for reducing memory usage:
  3041.  
  3042.                *    Reduce the "MaxAttach" and "MaxPkt" settings.  A value
  3043.                     of 64 for each setting works for most systems.
  3044.  
  3045.                *    Reduce the "Duplicates" setting.  However, since this
  3046.                     impairs Squish's ability to identify duplicate
  3047.                     messages, doing so is not recommended.
  3048.  
  3049.                *    Run SQUISH SQUASH in a separate pass from SQUISH IN
  3050.                     OUT.  If memory is really tight, run everything in its
  3051.                     own separate pass.  (See the section entitled "Running
  3052.                     Squish in Multipass Mode" in the OPERATION section for
  3053.                     more information.)
  3054.  
  3055.           BusyFlags (BinkleyTerm systems only)
  3056.  
  3057.                The BusyFlags keyword enables "busy flag" support for
  3058.                BinkleyTerm  systems.  This option is required when using
  3059.                more than one copy of BinkleyTerm with the same outbound
  3060.                area; the busy flags provide for file locking, which prevent
  3061.                collisions when two different nodes attempt to send mail at
  3062.                the same time.
  3063.  
  3064.                Squish has full support for the busy flag mechanism.  To
  3065.                further help throughput, Squish also performs most of its
  3066.                operations in a separate holding directory, outside of the
  3067.                main zoned outbound directories.  Files are only transferred
  3068.                to the outbound directories as necessary, which minimizes
  3069.                the "down time" for any given node.  In addition, if Squish
  3070.                attempts to send mail to a node which is busy due to mailer
  3071.                activity on another line, the packet will be simply queued
  3072.                for later use, as opposed to waiting for that node to become
  3073.                free again.  Unlike other mail processors, this means that
  3074.                Squish never has to wait because of mail activity occurring
  3075.                on other lines of a multi-line system, which makes Squish
  3076.                the ideal choice for a multi-line BinkleyTerm installation.
  3077.  
  3078.           CheckZones
  3079.  
  3080.                The CheckZones keyword instructs Squish to check the zone
  3081.                numbers on all incoming packets.  This option is enabled in
  3082.                the default configuration file; however, it may cause
  3083.                problems in secure mode with older, non-zone-aware systems. 
  3084.                Commenting out this option tells Squish not to check the
  3085.                zone number when performing security checks on inbound
  3086.                packets, which may help if you have to deal with such older
  3087.                software.
  3088.  
  3089.  
  3090.  
  3091.  
  3092.                        Squish v1.00 Reference Manual - Page 53
  3093.  
  3094.  
  3095.  
  3096.           Compress <filespec>
  3097.  
  3098.                The Compress keyword gives the path and filename of the
  3099.                compression configuration file.  Squish can use almost any
  3100.                external program to compress mail, including ARC, PKArc,
  3101.                PKZip, LHarc (both 1.xx and 2.xx), ZOO, PAK, ARJ, and more. 
  3102.                Squish's compression support is completely user-definable,
  3103.                so new archivers can be added to the configuration file with
  3104.                ease.  For more information, please see the documentation on
  3105.                the "Pack" and "DefaultPacker" keywords, and also the
  3106.                section entitled "ARCHIVES AND MESSAGE COMPRESSION".
  3107.  
  3108.           DefaultPacker <packer>
  3109.  
  3110.                The DefaultPacker keyword instructs Squish to use <packer>
  3111.                as the default packer for compressed mail.  <packer> must be
  3112.                the name of a packer defined in the compression
  3113.                configuration file.
  3114.  
  3115.                NOTE!  The official standard for compressed mail in FidoNet
  3116.                is the version 5 ARC format.  Unless you have a good reason
  3117.                for changing the default, ARC should be left as the default
  3118.                packer.  Packer types can be changed on a node-by-node basis
  3119.                through the "Pack" verb, so DefaultPacker should only be
  3120.                used when necessary.
  3121.  
  3122.           Duplicates <number>
  3123.  
  3124.                The Duplicates keyword instructs Squish to keep up to
  3125.                <number> duplicate message IDs for each message area.  By
  3126.                default, Squish stores the IDs of the past 1000 messages. 
  3127.                Unlike other mail processors, Squish uses a highly-accurate
  3128.                64-bit duplicate identifier, so increasing <number> will NOT
  3129.                significantly increase the chances of a duplicate message
  3130.                being falsely detected.
  3131.  
  3132.           ForwardFrom [FILE] <node> [<nodes>...]
  3133.  
  3134.                The ForwardFrom keyword tells Squish that the forwarding of
  3135.                in-transit NetMail messages is allowed, as long as the
  3136.                messages originated FROM any of the specified nodes.  If the
  3137.                "FILE" keyword is added before the first node number, Squish
  3138.                will also properly forward in-transit files.  Any number of
  3139.                nodes may be listed, and wildcards may be used.
  3140.  
  3141.                NOTE!  The ForwardFrom verb allows the specified nodes to
  3142.                forward messages ANYWHERE.  If you have your routing set up
  3143.                to crash all messages to their destinations, this should
  3144.                only be enabled for systems that you trust.  For a more
  3145.                conservative approach, see the ForwardTo keyword.
  3146.  
  3147.  
  3148.                        Squish v1.00 Reference Manual - Page 54
  3149.  
  3150.  
  3151.  
  3152.           ForwardTo [FILE] <node> [<nodes>...]
  3153.  
  3154.                The ForwardTo keyword tells Squish that the forwarding of
  3155.                in-transit NetMail messages is allowed, as long as the
  3156.                messages are destined TO any of the specified nodes.  If the
  3157.                "FILE" keyword is added before the first node number, Squish
  3158.                will also properly forward in-transit files.  Any number of
  3159.                nodes may be listed, and wildcards may be used.
  3160.  
  3161.                This option is appropriate for most systems, since it allows
  3162.                anyone to forward mail to the specified systems, but to
  3163.                those systems only.  Unlike ForwardFrom, this means that you
  3164.                have control over where the messages end up, as opposed to
  3165.                the person who sent the message.
  3166.  
  3167.           GateRoute <flavour> <gate> <node> [<nodes>...] [EXCEPT <node> 
  3168.            [<nodes>...]]
  3169.  
  3170.                The GateRoute keyword causes Squish to perform gaterouting
  3171.                on NetMail messages addressed to the specified gate or any
  3172.                of the following nodes.  Squish follows the FTS-0001
  3173.                standard for gaterouting, so the messages produced by this
  3174.                command should be acceptable to SEAdog and other non-zone-
  3175.                aware mailers.
  3176.  
  3177.                Gaterouting will only be performed on NetMail messages with
  3178.                a flavour of normal.  Messages marked as crash or hold will
  3179.                never be gaterouted; instead, they will be classified as
  3180.                direct interzone messages and will be treated accordingly.
  3181.  
  3182.                <flavour> specifies the flavour to which messages will be
  3183.                converted after gaterouting has taken place.  The gaterouted
  3184.                flavour should usually be normal (so that other commands in
  3185.                ROUTE.CFG can compress and route the mail normally), but you
  3186.                can specify an alternate flavour if you so desire.
  3187.  
  3188.                <gate> specifies the address of the system to which messages
  3189.                should be gaterouted.  This should be the address of an
  3190.                official network zonegate.
  3191.  
  3192.                <node> and <nodes> specify the list of nodes for which
  3193.                gaterouting is to be performed, including wildcards.  All
  3194.                NetMail messages which are addressed to these nodes will be
  3195.                gaterouted through the specified gate system.  (EchoMail
  3196.                should NEVER be gaterouted.)
  3197.  
  3198.                Optionally, a list of exceptions can be given for each
  3199.                zonegate.  Simply add the 'EXCEPT' keyword to the GateRoute
  3200.                line, and for the current GateRoute keyword, Squish will
  3201.  
  3202.  
  3203.  
  3204.                        Squish v1.00 Reference Manual - Page 55
  3205.  
  3206.  
  3207.  
  3208.                ignore all messages addressed to those nodes.  Wildcards are
  3209.                also supported for gaterouting exceptions.
  3210.  
  3211.                For example, to gateroute all messages going from zone 1 to
  3212.                zone 2, with the exception of messages destined for
  3213.                2:123/456, the following gateroute statement could be used:
  3214.  
  3215.                GateRoute 1:1/2  2:All Except 2:123/456
  3216.  
  3217.                In zone 1 of FidoNet, the standard set of gaterouting
  3218.                statements for other zones looks like this:
  3219.  
  3220.                GateRoute 1:1/2  2:All
  3221.                GateRoute 1:1/3  3:All
  3222.                GateRoute 1:1/4  4:All
  3223.                GateRoute 1:1/5  5:All
  3224.                GateRoute 1:1/6  6:All
  3225.  
  3226.           KillBlank
  3227.  
  3228.                The KillBlank verb instructs Squish to delete blank NetMail
  3229.                messages.  Blank netmail messages are commonly generated by
  3230.                ARCmail attach systems, manual file requests, file attaches,
  3231.                and update requests.  By definition, a "blank message" is a
  3232.                message which consists only of a message header, kludge
  3233.                lines and blank lines.
  3234.  
  3235.           KillDupes
  3236.  
  3237.                The KillDupes verb instructs Squish to delete duplicate
  3238.                messages as they are received, as opposed to placing the
  3239.                dupes in the DUPES message area.  If you are encountering a
  3240.                large number of dupes and you already know where the problem
  3241.                is, this keyword can then be enabled to delete the dupes as
  3242.                they are tossed.  However, having a copy of the dupes tossed
  3243.                into the DUPES area is instrumental to determining which
  3244.                system originated the duplicate messages, so this keyword
  3245.                should not be used for normal operation.
  3246.  
  3247.           KillIntransit
  3248.  
  3249.                The KillIntransit verb instructs Squish to delete in-transit
  3250.                NetMail messages.  Normally, Squish leaves in-transit
  3251.                messages in the NetMail area for review by the SysOp, but
  3252.                this keyword will cause Squish to delete in-transit messages
  3253.                as soon as they have been packed up and sent to their
  3254.                destination.
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.                        Squish v1.00 Reference Manual - Page 56
  3261.  
  3262.  
  3263.  
  3264.           LogFile <filespec>
  3265.  
  3266.                The LogFile keyword instructs Squish to keep a log of
  3267.                message information in the specified file.  The log file is
  3268.                Maximus and Binkley-compatible, so it's safe to keep all
  3269.                three logs inside one file.
  3270.  
  3271.                The Squish log file includes information on archives, packet
  3272.                headers, areas which received mail, the amount of mail that
  3273.                was sent from your system, and to whom.  The log file
  3274.                provides one way of obtaining EchoMail statistics; the other
  3275.                way is through analysis of the binary statistics file.  For
  3276.                more information on binary statistics, please see the
  3277.                "Statistics" keyword.
  3278.  
  3279.           MaxAttach <number> (ArcmailAttach systems only)
  3280.  
  3281.                The MaxAttach keyword specifies the maximum number of
  3282.                ARCmail attach messages which can be in your NetMail
  3283.                directory at any given time.  For internal reasons, Squish
  3284.                needs to know how many attaches you'll have concurrently. 
  3285.                The default, 256, is more than enough for most systems. 
  3286.                However, if you transfer an extremely large volume of mail
  3287.                with an ArcmailAttach mailer, you may need to increase this
  3288.                to 512 attaches or more.
  3289.  
  3290.           MaxMsgs <msgs>
  3291.  
  3292.                The MaxMsgs keyword instructs Squish to create a new set of
  3293.                outbound packets after processing every <msg> messages.  The
  3294.                MaxMsgs keyword is useful in NEC situations, especially when
  3295.                a large volume of mail is processed at the same time.  This
  3296.                verb helps to limit the size of packets that Squish
  3297.                generates, by making it taking a break from tossing and
  3298.                scanning after sending every <msgs> messages, and to then go
  3299.                and archive the packets generated so far.
  3300.  
  3301.                This keyword is completely automatic when running in single
  3302.                pass mode; as long as IN, OUT and SQUASH are specified on
  3303.                the command line, Squish will interleave the tossing,
  3304.                scanning and packing automatically.  However, when running
  3305.                Squish in multipass mode, some batch file modifications are
  3306.                required.
  3307.  
  3308.                For multipass mode, after Squish finishes scanning every
  3309.                <msgs> messages, it will stop execution and exit with an
  3310.                errorlevel of 5.  This errorlevel should be trapped by your
  3311.                batch file, and SQUISH SQUASH should be called at that
  3312.                point.  After packing the NetMail area, your batch file
  3313.                should call SQUISH IN OUT again.  For example, the following
  3314.  
  3315.  
  3316.                        Squish v1.00 Reference Manual - Page 57
  3317.  
  3318.  
  3319.  
  3320.                batch file segment could be used to run Squish in multipass
  3321.                mode:
  3322.  
  3323.                :TossIt
  3324.                rem * Perform the main toss/scan cycle
  3325.  
  3326.                SQUISH IN OUT -fECHOTOSS.LOG
  3327.                if errorlevel 5 goto PackIt
  3328.                goto DoneToss
  3329.  
  3330.                :PackIt
  3331.                rem * If we got here, it's because we exceeded MaxMsgs.
  3332.                rem * We use -o, since we don't want to pack the netmail 
  3333.                rem * area right now.
  3334.  
  3335.                SQUISH SQUASH -o
  3336.                goto TossIt
  3337.  
  3338.                :DoneToss
  3339.                rem * Now, perform a full pack to take care of remaining
  3340.                rem * archives, and also to handle any in-transit NetMail.
  3341.                SQUISH SQUASH
  3342.  
  3343.  
  3344.                When using the MaxMsgs keyword, Squish will create a file
  3345.                called MAX_MSGS.DAT in the current directory.  This file is
  3346.                used to maintain information that is required between
  3347.                passes, such as the current location in the packet file and
  3348.                information about the packet itself.
  3349.  
  3350.           MaxPkt <num>
  3351.  
  3352.                The MaxPkt keyword informs Squish that there may be up to
  3353.                <num> packets queued in the OUTBOUND.SQ directory.  For
  3354.                internal reasons, Squish needs to know the maximum number of
  3355.                packets that you'll be keeping in OUTBOUND.SQ.  MaxPkt
  3356.                defaults to 256 packets, which should be more than enough
  3357.                for most systems.  Unless you run a very busy system, you
  3358.                won't need to use this keyword.
  3359.  
  3360.           NetFile [NoPkt] [NoArc] <path>
  3361.  
  3362.                The NetFile keyword specifies the path to one of your
  3363.                inbound directories.  When tossing mail, Squish will look in
  3364.                all of the NetFile directories you specify in the
  3365.                configuration file, and it will attempt to toss from each
  3366.                one.  If the 'NoPkt' modifier is added before the directory
  3367.                name, Squish will never toss plain *.PKT files from that
  3368.                directory.  If the 'NoArc' modifier is added before the
  3369.                directory name, Squish will never toss compressed mail files
  3370.  
  3371.  
  3372.                        Squish v1.00 Reference Manual - Page 58
  3373.  
  3374.  
  3375.  
  3376.                from that directory.  These modifiers can be used in
  3377.                conjunction with BinkleyTerm's three-tiered inbound areas to
  3378.                make your system slightly more secure.
  3379.  
  3380.           Nuke (ArcmailAttach systems only)
  3381.  
  3382.                The Nuke keyword instructs Squish to delete any orphaned
  3383.                compressed mail files in the OUTBOUND.SQ directory.  Before
  3384.                performing a SQUISH SQUASH, Squish will scan the NetMail
  3385.                area for ARCmail attach messages.  It will then scan
  3386.                OUTBOUND.SQ and delete any compressed mail file for which
  3387.                there is no attach.
  3388.  
  3389.                WARNING!  This keyword is dangerous, since accidentally
  3390.                deleting an ARCmail attach message will cause the compressed
  3391.                mail file to be deleted too.  Most systems do NOT require
  3392.                this keyword.  If your mailer supports the ^aFLAGS kludge
  3393.                for truncating files, this is not necessary.  As of this
  3394.                writing, the only mailer which is known to require the Nuke
  3395.                keyword is D'Bridge.
  3396.  
  3397.           OldArcmailExts
  3398.  
  3399.                This keyword instructs Squish to use the old file extension
  3400.                format when creating compressed mail archives.  Normally,
  3401.                Squish creates files with extensions of .MO?, .TU?, .WE?,
  3402.                and so on.  If OldArcmailExts is enabled, Squish will use
  3403.                the .MO? extension only, for compatibility with older
  3404.                systems such as Opus 1.03.
  3405.  
  3406.           Origin <text>
  3407.  
  3408.                The Origin keyword specifies a default origin line to use
  3409.                for EchoMail messages.  If no origin can be found in the
  3410.                body of a message which was originated locally, Squish will
  3411.                use this text as the default origin line.b
  3412.  
  3413.                If you are using AREAS.BBS, this keyword is not required. 
  3414.                The AREAS.BBS format includes a default origin line, and
  3415.                that origin will override the one given in SQUISH.CFG.
  3416.  
  3417.           Outbound <path>
  3418.  
  3419.                This keyword is required for both ArcmailAttach and
  3420.                BinkleyTerm systems.
  3421.  
  3422.                When running Binkley, this keyword gives the path to the
  3423.                base outbound directory.  Specify only the base path of your
  3424.                outbound directory, such as "D:\Bt\Outbound".  If you are
  3425.                using a BinkleyTerm system, Squish will add the zoned
  3426.  
  3427.  
  3428.                        Squish v1.00 Reference Manual - Page 59
  3429.  
  3430.  
  3431.  
  3432.                directory extensions automatically, so only one outbound
  3433.                path needs to be declared.  If a particular outbound
  3434.                directory does not exist, Squish will create it on-the-fly.
  3435.  
  3436.                Squish also creates a directory with an extension of .SQ for
  3437.                both BinkleyTerm and ArcmailAttach systems.  This is used by
  3438.                Squish as a temporary work directory for packets.
  3439.  
  3440.           Pack <packer> <node> [<nodes>...]
  3441.  
  3442.                The Pack keyword instructs Squish to use the specified mail
  3443.                compression program when compressing mail for the listed
  3444.                nodes.  By default, if a node is not listed after any Pack
  3445.                keywords, Squish will use the compressor defined with the
  3446.                DefaultPacker keyword.  If no default packer is declared,
  3447.                Squish will simply use the first packer listed in
  3448.                SQUISH.CFG.  Since the FidoNet standard for mail compression
  3449.                is ARC, you are urged not to change the default.  Instead,
  3450.                the Pack keyword can be used to change the compression
  3451.                method on a node-by-node basis.
  3452.  
  3453.                <packer> specifies the name of a packer, as specified in
  3454.                COMPRESS.CFG.  Please see the section entitled "ARCHIVERS
  3455.                AND MESSAGE COMPRESSION" for information on COMPRESS.CFG.
  3456.  
  3457.                <node> and <nodes> specify the nodes for which this packer
  3458.                should be used.  Any number of nodes may be listed here,
  3459.                including wildcards.  When packing mail for any of the nodes
  3460.                listed after a particular packer, Squish will attempt to run
  3461.                that packer using the information given in COMPRESS.CFG.
  3462.  
  3463.                You can specify as many nodes as you like, and you can also
  3464.                use as many packers and Pack lines as desired.  When
  3465.                unpacking compressed archives, Squish will determine the
  3466.                archive type automatically, again using the information
  3467.                given in COMPRESS.CFG.
  3468.  
  3469.                WARNING!  Squish will not attempt to convert archives from
  3470.                one type to another.  Before changing the compression type
  3471.                for a certain node, make sure that no other compressed mail
  3472.                archives are waiting to be sent to that system.  If there
  3473.                was, Squish would attempt to add a packet to that archive
  3474.                using the wrong archiver, which would certainly cause
  3475.                problems.
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.                        Squish v1.00 Reference Manual - Page 60
  3485.  
  3486.  
  3487.  
  3488.           Password <node> <password>
  3489.  
  3490.                The Password keyword allows passwords to be assigned to
  3491.                individual systems.  For more information on using
  3492.                passwords, please see the section entitled "SECURITY".
  3493.  
  3494.                <node> should specify a single node address.  No wildcards
  3495.                are permitted.
  3496.  
  3497.                <password> is the case-insensitive password to use for the
  3498.                specified node.  Passwords must be eight characters or
  3499.                fewer, with no spaces allowed.
  3500.  
  3501.           PointNet <net>
  3502.  
  3503.                PointNet specifies the "fakenet" number to use for non-4D
  3504.                points.  The fakenet point scheme was designed to work with
  3505.                systems which were unable to support true points, such as
  3506.                BinkleyTerm 2.40 and lower.
  3507.  
  3508.                When this keyword is used on the bossnode system, it causes
  3509.                the specified net number to be stripped from the SEEN-BYs
  3510.                for messages being exported to non-point systems.  The
  3511.                fakenet number will also be used on the bossnode for
  3512.                remapping point addresses.
  3513.  
  3514.                If used on a point system, this keyword ensures that the
  3515.                right address is used on the point's origin line, if Squish
  3516.                is actually forced to add an origin line to a message.
  3517.  
  3518.                NOTE!  The point software should be responsible for placing
  3519.                the correct origin line in messages generated by that point. 
  3520.                Squish will use the correct address if Squish itself inserts
  3521.                the origin, but Squish will never modify an existing origin
  3522.                line.
  3523.  
  3524.           QuietArc
  3525.  
  3526.                The QuietArc keyword instructs Squish to suppress the screen
  3527.                output of external compression utilities.  This option makes
  3528.                the screen look tidier, but it doesn't make any functional
  3529.                changes.
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.                        Squish v1.00 Reference Manual - Page 61
  3541.  
  3542.  
  3543.  
  3544.           Remap <node> <name>
  3545.  
  3546.                The Remap keyword is used to readdress mail with specified
  3547.                addresses in the "To:" field.  Unlike other mail processors,
  3548.                Squish's remapping facility is a full node remapper. 
  3549.                Messages can be remapped anywhere, from a point across the
  3550.                street to another system across the world.
  3551.  
  3552.                <node> specifies the network address of the system for which
  3553.                mail is to be remapped.  This address must be EXPLICIT; if
  3554.                you are remapping mail to a 4D point, then you must specify
  3555.                the address in a 4D format.  If you are remapping mail to a
  3556.                fakenet point, you must specify the node's fakenet address. 
  3557.  
  3558.  
  3559.                <name> should be the name to check for in the "To:" field of
  3560.                inbound messages.  When a NetMail message arrives that is
  3561.                destined for your system, Squish will scan the "To:" field
  3562.                for all of the names listed in Remap statements.  If it
  3563.                finds a match, it will readdress the mail to the appropriate
  3564.                address and write the message back to disk.
  3565.  
  3566.                The <name> field has two special features:
  3567.  
  3568.                *    Name wildcards.  By placing a "*" at the end of a name,
  3569.                     Squish will automatically remap messages which begin
  3570.                     with that text.  For example, using a remap name of 
  3571.                     "Jes*" would remap messages which were to "Jesse
  3572.                     Hollington", "Jesse", and so forth.
  3573.  
  3574.                *    Soundex support.  If Squish can't find an exact match,
  3575.                     it will perform a soundex compare of both the "To:"
  3576.                     field and the Remap names.  If a misspelled match is
  3577.                     found, the message will still be readdressed (and noted
  3578.                     in the log).
  3579.  
  3580.                Remap statements are processed in sequential order, from top
  3581.                to bottom.  Therefore, if you wish to have a "clean up"
  3582.                statement to remap messages which were not caught by other
  3583.                Remap statements, include the command "Remap <node> *" after
  3584.                all other Remap statements.  This will cause Squish to remap
  3585.                all remaining messages to the specified address, even if it
  3586.                couldn't find a match using any of the other Remap
  3587.                statements.
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.                        Squish v1.00 Reference Manual - Page 62
  3597.  
  3598.  
  3599.  
  3600.           Routing <filespec>
  3601.  
  3602.                This keyword specifies the location of the routing
  3603.                configuration file.  By default, Squish will look for
  3604.                ROUTE.CFG in the current directory.
  3605.  
  3606.           SaveControlInfo (Squish message areas only)
  3607.  
  3608.                When this keyword is enabled (as it is in the default
  3609.                configuration file), Squish will preserve SEEN-BY and path
  3610.                information in *.SQ?-style message areas.  If this keyword
  3611.                is commented out, Squish will strip SEEN-BY information from
  3612.                *.SQ? areas (when running in single pass mode ONLY).
  3613.  
  3614.                If you are really tight on disk  space, stripping the SEEN-
  3615.                BYs is one way to reduce disk requirements.  As long as you
  3616.                are running in one-pass mode, the *.SQ? format is safe to
  3617.                use without having SEEN-BYs written to the local message
  3618.                base.  However, Squish will always write SEEN-BY information
  3619.                for *.MSG areas, as it will for *.SQ? areas when running in
  3620.                multipass mode.
  3621.  
  3622.           Secure
  3623.  
  3624.                The Secure keyword enables Squish's packet security
  3625.                features.  For more information, please see the section
  3626.                entitled "SECURITY".
  3627.  
  3628.           Statistics
  3629.  
  3630.                The Statistics keyword turns on a binary statistics file,
  3631.                SQUISH.STA, which is used to hold extremely verbose
  3632.                statistics information about inbound and outbound messages.
  3633.                The Squish statistics file includes enough information to
  3634.                create a 100% accurate billing report for NECs and other
  3635.                EchoMail hubs.  A minimal program (SSTAT) is included, with
  3636.                source, to parse this statistics file and display a billing
  3637.                report.  No plans have been made to revise this utility, but
  3638.                the file format of the statistics file is publicly
  3639.                available, so it's expected that a third-party utility will
  3640.                be required to fully support the statistics information that
  3641.                Squish can produce.
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.                        Squish v1.00 Reference Manual - Page 63
  3653.  
  3654.  
  3655.  
  3656.           StripAttributes
  3657.  
  3658.                The StripAttributes keyword instructs Squish to strip the
  3659.                crash, hold and direct bits from incoming messages.  This
  3660.                keyword is enabled in the default configuration file, since
  3661.                it prevents other systems from overriding your routing by
  3662.                sending a crash-flavoured message through your system. 
  3663.                However, some systems run "power points" which have file
  3664.                attach privileges, so this keyword may need to be disabled
  3665.                to give full control of the system to the points (and
  3666.                everyone else).
  3667.  
  3668.           Swap [filespec]   (DOS version only)
  3669.  
  3670.                The Swap keyword instructs Squish to swap itself out of
  3671.                memory before calling external archiving programs.  If you
  3672.                are running Squish in a restricted environment, swapping can
  3673.                save 200K of conventional memory (or more).
  3674.  
  3675.                By default, Squish will first try to swap itself to XMS and
  3676.                then EMS.  If unsuccessful, Squish will try to swap itself
  3677.                to disk.  When swapping to disk, Squish will use a default
  3678.                swap filename of __SQUISH.~~~ in the current directory. 
  3679.                However, if you wish to specify an alternate path and
  3680.                filename (such as a file on a RAMdisk), you can do so here.
  3681.  
  3682.                THIS KEYWORD MUST SPECIFY A FILENAME, NOT JUST A PATH!
  3683.  
  3684.           TinySeenBys <node> [<nodes>...]
  3685.  
  3686.                The TinySeenBys keyword instructs Squish to strip down the
  3687.                SEEN-BYs to a bare minimum when exporting or scanning
  3688.                messages to the specified nodes.  The SEEN-BYs in the
  3689.                messages sent to those nodes will contain only the addresses
  3690.                of those systems which are listed for the EchoMail area n
  3691.                question.  Any number of nodes may be specified, and
  3692.                wildcards can be used.
  3693.  
  3694.           TossBadMsgs
  3695.  
  3696.                Uncommenting the TossBadMsgs keyword indicates that it's
  3697.                safe to toss messages from your BAD_MSGS area.  Normally,
  3698.                when Squish finds a message with an unknown area tag, or if
  3699.                it finds an insecure message, Squish will place that message
  3700.                in the BAD_MSGS area.  However, if the message later becomes
  3701.                valid (such as when the SysOp adds an EchoArea definition
  3702.                for a previously-unknown area), Squish can automatically
  3703.                toss messages from that area.  This feature can save you
  3704.                from manually moving dozens of misdirected messages.
  3705.  
  3706.  
  3707.  
  3708.                        Squish v1.00 Reference Manual - Page 64
  3709.  
  3710.  
  3711.  
  3712.           Track <filespec>
  3713.  
  3714.                The Track keyword specifies a filename to use as a separate
  3715.                log for in-transit NetMail.  If this keyword is enabled,
  3716.                Squish will log the To:, From: and Subject: lines of all in-
  3717.                transit netmail, in addition to the messages' origination
  3718.                and destination addresses.
  3719.  
  3720.                This keyword is useful for determining exactly who is
  3721.                forwarding messages through your system, and where the final
  3722.                destinations of those messages were.  In addition, Squish
  3723.                will also place a note in the log if an AREA: line was found
  3724.                in the forwarded message, which indicates that the message
  3725.                in question was a routed EchoMail message.
  3726.  
  3727.                WARNING!  This keyword must point to a separate log file. 
  3728.                You cannot use the same log for both Track and LogFile.
  3729.  
  3730.           ZoneGate <target> <node> [<nodes>...]
  3731.  
  3732.                The ZoneGate keyword is used to strip the SEEN-BYs on
  3733.                messages destined for other zones.  According to the FidoNet
  3734.                Technical Standards Committee, SEEN-BYs should be stripped
  3735.                whenever a message crosses a zone boundary.  The procedure
  3736.                of stripping the SEEN-BYs on such a message is called
  3737.                "zonegating".
  3738.  
  3739.                <target> specifies the node for which you are zonegating
  3740.                mail.  All EchoMail messages destined to this node will have
  3741.                their SEEN-BYs stripped.
  3742.  
  3743.                <node> and <nodes> specify one or more nodes to add to the
  3744.                SEEN-BYs of the zonegated messages, AFTER the original SEEN-
  3745.                BYs have been stripped.  These addresses should be two-
  3746.                dimensional (net and node only), since there are no
  3747.                provisions for zone or point numbers in SEEN-BYs.
  3748.  
  3749.                WARNING!  Unlike other mail processors, Squish does not
  3750.                automatically add any addresses to the SEEN-BYs of zonegated
  3751.                messages.  As a bare minimum, you should add your own
  3752.                address and the address of the zonegate.
  3753.  
  3754.                For example, to zonegate messages from 1:123/456 to
  3755.                2:987/654, the following ZoneGate line might be used:
  3756.  
  3757.                     ZoneGate 2:987/654      123/456 987/654
  3758.  
  3759.                Notice that both our address (123/456) and the zonegate's
  3760.                address (987/654) were included in the <nodes> section of
  3761.  
  3762.  
  3763.  
  3764.                        Squish v1.00 Reference Manual - Page 65
  3765.  
  3766.  
  3767.  
  3768.                the command.  Failing to add both of these nodes may cause
  3769.                dupes.
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.                        Squish v1.00 Reference Manual - Page 66
  3821.  
  3822.  
  3823.  
  3824.  
  3825.           Area Definitions
  3826.  
  3827.           Squish supports a flexible method for defining message areas in
  3828.           the Squish configuration file.  The same mechanism is used for
  3829.           defining EchoMail, NetMail, BAD_MSGS and duplicate message areas. 
  3830.           The general format of an area declaration is:
  3831.  
  3832.                <type> <tag> <path> [flags] [nodes]
  3833.  
  3834.  
  3835.           Area Types
  3836.  
  3837.           <type> specifies the type of area to define.  A type must be
  3838.           specified for all areas.  This type should be one of the
  3839.           following keywords:
  3840.  
  3841.           NetArea   This area is defined as a NetMail area.  For
  3842.                     BinkleyTerm systems, Squish will pack messages from all
  3843.                     NetAreas specified.  For ArcmailAttach systems, Squish
  3844.                     will use the first NetArea declared for creating
  3845.                     ARCmail file attaches.
  3846.  
  3847.           EchoArea  This area is defined as an EchoMail area.  Messages can
  3848.                     be tossed to and scanned from this area using the
  3849.                     standard Squish commands.
  3850.  
  3851.           BadArea   This area is defined as a "bad messages" (or BAD_MSGS)
  3852.                     area.  This will be used to store messages with
  3853.                     security violations, messages for unknown areas, and
  3854.                     other messages for which Squish couldn't find a proper
  3855.                     home.
  3856.  
  3857.           DupeArea  This area is defined as a duplicate message area.  If
  3858.                     Squish receives duplicate messages from another system
  3859.                     (and if KillDupes is NOT enabled), those messages will
  3860.                     be placed into this area for review by the SysOp.
  3861.  
  3862.  
  3863.           Area Tags and Paths
  3864.  
  3865.           <tag> specifies a short, one-word area tag (name) to use for the
  3866.           area being defined.  For EchoMail areas, this tag should be the
  3867.           name of the echo.  For other area types, such as NetAreas and
  3868.           BadAreas, any unique tag can be used.
  3869.  
  3870.           <path> specifies the directory and/or filename to use for this
  3871.           message area.  If using the *.MSG format, the name of a separate
  3872.           directory should be given for each area.  If using the Squish
  3873.           format (*.SQ?), a path and root filename (up to eight characters
  3874.  
  3875.  
  3876.                        Squish v1.00 Reference Manual - Page 67
  3877.  
  3878.  
  3879.  
  3880.           with no extension) should be given.  Squish will automatically
  3881.           create areas which do not exist.
  3882.  
  3883.           WARNING!  The <tag> and <path> fields in AREAS.BBS are
  3884.           "reversed", meaning that the path comes before the tag.  If you
  3885.           are used to defining areas in AREAS.BBS, make sure that you use
  3886.           the proper order when defining areas in SQUISH.CFG (tag and then
  3887.           path).
  3888.  
  3889.  
  3890.           Flags
  3891.  
  3892.           [flags] specifies an optional set of flags and options.  A flag
  3893.           consists of a single dash followed by a letter, plus an optional
  3894.           modifier.  The flags currently supported by Squish are:
  3895.  
  3896.           -f             This flag tells Squish that the area is stored in
  3897.                          FTS-0001 (*.MSG) format.  *.MSG is the default
  3898.                          storage format, so this flag usually is not
  3899.                          required.  When the *.MSG format is being used,
  3900.                          the name of the *.MSG directory should be given
  3901.                          for <path>.
  3902.  
  3903.           -p<node>       This flag specifies an alternate primary address
  3904.                          for the current area.  <node> should be a full 4D
  3905.                          address, including zone and point numbers (if
  3906.                          appropriate).
  3907.  
  3908.                          Using an alternate primary address will affect
  3909.                          Squish's operation  in the following ways:
  3910.  
  3911.                          *    The alternate address will be added to the
  3912.                               SEEN-BYs for the specified area, as opposed
  3913.                               to adding the first address declared in
  3914.                               SQUISH.CFG.
  3915.  
  3916.                          *    The alternate address will be added to the
  3917.                               ^aPATH line instead of your normal address.
  3918.  
  3919.                          *    The alternate address will be used when
  3920.                               creating packets with messages from the
  3921.                               specified area.
  3922.  
  3923.                          This flag permits "clean" multi-zone operation
  3924.                          with only one configuration file, even when using
  3925.                          a diverse range of addresses and message areas.
  3926.  
  3927.           -s             This flag strips the private bit from all messages
  3928.  
  3929.  
  3930.  
  3931.  
  3932.                        Squish v1.00 Reference Manual - Page 68
  3933.  
  3934.  
  3935.  
  3936.                          which are tossed to this area.  Unlike other
  3937.                          EchoMail processors, handling of private messages
  3938.                          can be controlled on an area-by-area basis.
  3939.  
  3940.           -x<node>       This flag instructs Squish NOT to accept any
  3941.                          inbound messages in this echo from the specified
  3942.                          address.  This flag can be used to make a certain
  3943.                          node "read only" for one area, since messages
  3944.                          coming from that node will trigger a security
  3945.                          violation and be placed in BAD_MSGS.
  3946.  
  3947.           -0             (That's a zero, not the letter "o".)  This flag
  3948.                          tells Squish that the current area is a "passthru"
  3949.                          area.  This means that messages from this area
  3950.                          don't stay on your system; they are simply scanned
  3951.                          out to the other systems listed for this area and
  3952.                          then deleted.  If you are running Squish in single
  3953.                          pass mode, messages will be scanned directly from
  3954.                          the inbound *.PKT files and will never touch your
  3955.                          message areas.
  3956.  
  3957.           -+<node>       This flag adds a node to the SEEN-BYs for the
  3958.                          current area only.  <node> should be a two-
  3959.                          dimensional address (net/node only).
  3960.  
  3961.                          Note!  If you are using an alternate primary
  3962.                          address, that address will be added to the SEEN-
  3963.                          BYs automatically.
  3964.  
  3965.           -$             This flag tells Squish that the area is stored in
  3966.                          the Squish (*.SQ?) format.  When using this flag,
  3967.                          <path> should specify the full path and root
  3968.                          filename of the Squish area.  (A root filename is
  3969.                          the path and the first eight characters of a DOS
  3970.                          filename, with no extensions permitted.)
  3971.  
  3972.           -$d<num>       This flag specifies that no more than <num> days
  3973.                          worth of messages should be kept in a Squish-style
  3974.                          area.  This causes SQPACK to delete all messages
  3975.                          which are more than <num> days old.  NOTE!  Unlike
  3976.                          -$m, this flag does NOT cause Squish to purge
  3977.                          messages on the fly.  If you choose to delete
  3978.                          message by date, you must run SQPACK once a day. 
  3979.                          Otherwise, if you choose to delete by message
  3980.                          number, you can allow Squish to renumber and purge
  3981.                          the area as it tosses.
  3982.  
  3983.           -$m<msgs>      This flag specifies the maximum number of messages
  3984.  
  3985.  
  3986.  
  3987.  
  3988.                        Squish v1.00 Reference Manual - Page 69
  3989.  
  3990.  
  3991.  
  3992.                          to keep in a Squish-style area.  Normally, Squish
  3993.                          leaves the maximum message counter alone in a
  3994.                          *.SQ? area.  However, if Squish has to create the
  3995.                          area for one reason or another, the maximum
  3996.                          message counter will be set to a value of <msgs>
  3997.                          messages.  Using the -$m switch also implicitly
  3998.                          activates the -$ switch.
  3999.  
  4000.           -$s<msgs>      This flag specifies the number of messages to skip
  4001.                          killing <msgs> messages at the beginning of a
  4002.                          Squish-style area.  This flag must be used in
  4003.                          conjunction with the -$m flag.  See the section
  4004.                          entitled "USING SQUISH-FORMAT MESSAGE AREAS" for
  4005.                          more details.
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.                        Squish v1.00 Reference Manual - Page 70
  4045.  
  4046.  
  4047.  
  4048.  
  4049.           Split Area Definitions
  4050.  
  4051.           Squish allows EchoMail areas to be defined in SQUISH.CFG,
  4052.           AREAS.BBS, and it even allows area definitions to be split
  4053.           between both.  Such splitting is necessary, especially if you
  4054.           want to use Squish-specific features and also wish to remain
  4055.           compatible with the AREAS.BBS file format.
  4056.  
  4057.           When declaring a split area in either SQUISH.CFG or AREAS.BBS,
  4058.           Squish will check to see if that area exists in the list of
  4059.           existing areas.  If it does, Squish will simply add to that
  4060.           area's definition, as opposed to creating a new logical area. 
  4061.           Nodes and flags specified in one file will be automatically
  4062.           applied to the other; in other words, the following two
  4063.           definitions:
  4064.  
  4065.           AREAS.BBS:
  4066.  
  4067.                C:\Msg\Magic     XXYZY          1:123/456 789
  4068.  
  4069.           SQUISH.CFG:
  4070.  
  4071.                EchoArea XXYZY   C:\Msg\Magic -$ -p1:234/567
  4072.  
  4073.           would be equivalent to the following definition in SQUISH.CFG 
  4074.           only:
  4075.  
  4076.                EchoArea XXYZY  C:\Msg\Magic -$ -p1:234/567 1:123/456 789
  4077.  
  4078.           Declaring areas using this method enables all of the new Squish
  4079.           features, but it also allows for compatibility with utilities
  4080.           which use AREAS.BBS for node information, including Areafix and
  4081.           many others.
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.                        Squish v1.00 Reference Manual - Page 71
  4101.  
  4102.  
  4103.  
  4104.                           ARCHIVERS AND MESSAGE COMPRESSION
  4105.  
  4106.           Through the use of external file archiving utilities, Squish is
  4107.           capable of compressing mail that it sends to other systems.  If
  4108.           you are using the Send and Route keywords in ROUTE.CFG, Squish
  4109.           will automatically compress mail for the specified nodes. 
  4110.           Instead of sending *.PKT files, Squish will then send *.MO?,
  4111.           *.TU?, *.WE?, *.TH?, *.FR?, *.SA? and *.SU? files.  (The last
  4112.           part of the file extension will be a single digit; this digit is
  4113.           incremented after creating each archive, which ensures that
  4114.           compressed mail files do not get overwritten once an archive
  4115.           arrives at its destination.)
  4116.  
  4117.           In addition, Squish allows you to define a separate compression
  4118.           program for individual nodes.  Some of the systems you connect
  4119.           with may wish to use ARC, while others may elect to use ZIP and
  4120.           LZH.  The Pack and DefaultPacker statements in SQUISH.CFG can be
  4121.           used to select different archivers for each node.
  4122.  
  4123.           However, Squish takes a new approach to message compression. 
  4124.           Instead of hardcoding support for all of the archivers currently
  4125.           available, Squish uses a "compression configuration file".  Using
  4126.           such a file allows Squish to support as many archive types as
  4127.           possible.  The flexibility of this file even allows Squish to use
  4128.           archiving programs which have not been invented at the time of
  4129.           this writing.
  4130.  
  4131.           In SQUISH.CFG, the Compress keyword controls the location of the
  4132.           compression configuration file.  As distributed, COMPRESS.CFG
  4133.           comes configured for use with ARC, ZIP, PAK, ZOO, ARJ, LHarc 1.13
  4134.           and LHarc 2.xx.  However, new programs can be added to Squish's
  4135.           repertoire on a moment's notice.
  4136.  
  4137.           COMPRESS.CFG is divided into a number of entries, one per
  4138.           archiver.  (As many archivers can be defined as you like, memory
  4139.           limiting.)  Each entry in COMPRESS.CFG looks like this:
  4140.  
  4141.                Archiver <name>
  4142.                     Extension  <ext>
  4143.                     Ident      <pos>,<hexstr>
  4144.                     Add        <cmd>
  4145.                     Extract    <cmd>
  4146.                     View       <cmd>
  4147.                End Archiver
  4148.  
  4149.           The "Archiver" keyword starts off the definition of an archiving
  4150.           program.  <name> specifies the short-form name of the archiver;
  4151.           this short form should be a single word, since Squish uses it to
  4152.           select compression types with the Pack statement in SQUISH.CFG.
  4153.  
  4154.  
  4155.  
  4156.                        Squish v1.00 Reference Manual - Page 72
  4157.  
  4158.  
  4159.  
  4160.           <ext> is the file extension normally used by the specified
  4161.           archiver.  At present, this information is not used by Squish,
  4162.           but it may be used by other programs which share the same
  4163.           COMPRESS.CFG file.
  4164.  
  4165.           Next comes the Ident keyword:  the information provided by this
  4166.           keyword allows Squish to identify archives of unknown types. 
  4167.           Most archiving programs place a special signature at the
  4168.           beginning of a compressed file, so when Squish encounters such a
  4169.           file, these special signatures are used to determine how to
  4170.           unpack the archive.
  4171.  
  4172.           The <pos> number tells Squish where to look for the archiver's
  4173.           signature.  If <pos> is greater than or equal to zero, it is
  4174.           interpreted as an offset from the start of the file, with the
  4175.           first byte being offset 0, the second byte being offset 1, and so
  4176.           on.  If <pos> is negative, Squish will interpret it as an offset
  4177.           from the END of the file, with -2 being the last byte in the
  4178.           file, -3 being the second-last byte in the file, and so on.
  4179.  
  4180.           <hexstr> is an ASCII representation of the archiver's signature. 
  4181.           Every byte in the archiver's signature should be converted to
  4182.           hexadecimal, and then entered into the compression configuration
  4183.           entered as two hexadecimal digits.  Since most archivers use
  4184.           special control characters in their signatures, entering the
  4185.           signatures directly is not possible.  However, by representing
  4186.           each byte as two hexadecimal digits in the range 0-9 and A-F,
  4187.           even the simplest of editors can read the compression
  4188.           configuration file.
  4189.  
  4190.           The Add keyword specifies the command which should be used to add
  4191.           files to the specified type of archive.  Similarly, the Extract
  4192.           and View keywords specify the commands to use for extracting from
  4193.           and viewing archives (respectively).
  4194.  
  4195.           Before executing the archiver, Squish will make two special
  4196.           translations:  all occurrences of the string "%a" will be changed
  4197.           to the name of the archive being processed.  Similarly, all
  4198.           occurrences of the string "%f" will be changed to the name of the
  4199.           file(s) to be added or extracted.  These tokens allow the utmost
  4200.           in flexibility when handling multiple archiving programs.
  4201.  
  4202.           The "End Archiver" keyword signifies the end of an archiver
  4203.           definition.  Each "Archiver" keyword must be followed by an "End
  4204.           Archiver" keyword later in the file.
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.                        Squish v1.00 Reference Manual - Page 73
  4213.  
  4214.  
  4215.  
  4216.                                        ROUTING
  4217.  
  4218.           Squish includes a complete routing control system for both
  4219.           BinkleyTerm and ArcmailAttach mailers.  Squish is capable of
  4220.           generating ARCmail attach messages for systems with dynamic
  4221.           routing, and it also includes a full complement of commands for
  4222.           handling static routing.
  4223.  
  4224.           All of Squish's routing is performed via the ROUTE.CFG file. 
  4225.           Whether you are using dynamic (ArcmailAttach) or static (Binkley)
  4226.           packing, all of the Squish routing commands must be placed in
  4227.           this file.
  4228.  
  4229.           As distributed, all of the commands in your routing control file
  4230.           are executed every time a SQUISH SQUASH is performed.  However,
  4231.           Squish's routing system can be used to implement "schedules",
  4232.           which cause certain routing commands to be performed at certain
  4233.           times.  (Schedules can be run on the basis of the time of day, or
  4234.           they can be simply run on demand.)
  4235.  
  4236.           Commands which are to be always run, regardless of schedules,
  4237.           must be placed in the "global section", or before the first
  4238.           "Sched" statement in ROUTE.CFG.   The only difference between
  4239.           schedules and the global section is when the commands are
  4240.           performed; otherwise, after Squish has started processing a
  4241.           section of the control file (whether it be the global section or
  4242.           a schedule), all routing commands are treated the same.
  4243.  
  4244.  
  4245.           Generic Routing Commands
  4246.  
  4247.           Several routing commands apply to both static and dynamic
  4248.           packing.  Namely, all of following commands can be used equally
  4249.           well on both BinkleyTerm and ArcmailAttach systems:
  4250.  
  4251.           Send <flavour> [NoArc] <node> [<nodes>...]
  4252.  
  4253.                The Send command scans for uncompressed mail with a normal
  4254.                flavour, compresses it, and changes the mail's flavour.  The
  4255.                Send command changes the attributes of the mail, but it
  4256.                never changes the mail's destination address. (If you wish
  4257.                to change the destination address, please see "Route",
  4258.                below.)
  4259.  
  4260.                <flavour> specifies the flavour to use for the resulting
  4261.                compressed mail file.  Squish will assign this flavour to
  4262.                the compressed mail archive after archiving all of the
  4263.                packets for this node.
  4264.  
  4265.  
  4266.  
  4267.  
  4268.                        Squish v1.00 Reference Manual - Page 74
  4269.  
  4270.  
  4271.  
  4272.                The optional NoArc modifier stops Squish from archiving the
  4273.                packet that is created for the specified system.  Squish
  4274.                will simply change all normal-flavoured packets to the
  4275.                specified flavour, placing all of the original packets into
  4276.                one large packet file.  The command "Send <flavour> NoArc
  4277.                <node>" has the same net effect as "Change Normal <flavour>
  4278.                <node>".  This modifier apples to BinkleyTerm systems only.
  4279.  
  4280.                <node> and <nodes> are simply a list of nodes to which mail
  4281.                should be sent.  Squish will expand all node number
  4282.                wildcards and process all normal-flavoured packets for those
  4283.                nodes.
  4284.  
  4285.                In the BinkleyTerm outbound area, using Send (without the
  4286.                NoArc modifier) has the following result:
  4287.  
  4288.                     xxxxyyyy.OUT   -->  xxxxyyyy.MO? + xxxxyyyy.?LO
  4289.  
  4290.                With the NoArc modifier, the result will be as follows:
  4291.  
  4292.                     xxxxyyyy.OUT   -->  xxxxyyyy.?UT
  4293.  
  4294.           Route <flavour> [NoArc] [File] <target> [<nodes>...]
  4295.  
  4296.                The Route command scans for uncompressed mail with a normal
  4297.                flavour, compresses it, changes the mail's flavour, and
  4298.                (unlike Send) readdresses the mail.  The Route command scans
  4299.                for mail addressed to any of the specified nodes, but
  4300.                readdresses that mail to the target.  In other words, Route
  4301.                scans for uncompressed mail destined to <nodes>, archives
  4302.                the mail, and finally sends it to <target>.
  4303.  
  4304.                <flavour> specifies the flavour to use for the resulting
  4305.                compressed file.
  4306.  
  4307.                The NoArc modifier (optional) stops Squish from archiving
  4308.                the resulting mail.  Squish will simply combine all of the
  4309.                specified packets into one, give it the appropriate flavour,
  4310.                and send it to the target without any form of compression. 
  4311.                This modifier applies to BinkleyTerm systems only.  WARNING! 
  4312.                The NoArc modifier causes all 4D zone and point information
  4313.                to be lost!  Only net and node numbers will be maintained
  4314.                for mail routed with the NoArc keyword.
  4315.  
  4316.                The File modifier (optional) instructs Squish to route file
  4317.                attaches in addition to messages.  By default, all file
  4318.                attaches are sent to the specified destination, regardless
  4319.                of flavour.  However, if the File modifier is used, Squish
  4320.                will also scan for and route file attaches.  This modifier
  4321.                applies to BinkleyTerm systems only.
  4322.  
  4323.  
  4324.                        Squish v1.00 Reference Manual - Page 75
  4325.  
  4326.  
  4327.  
  4328.                <target> is the address of the system which will receive the
  4329.                routed packets.  Make sure that you have made prior
  4330.                arrangements with the target to route your mail, since it's
  4331.                discourteous to route mail through someone else's system
  4332.                without asking permission.  Wildcards should not be used
  4333.                when specifying the target address.
  4334.  
  4335.                <nodes> are the addresses for which mail will be routed. 
  4336.                All of the normal-flavoured mail for these addresses will be
  4337.                packaged up and sent to the target.
  4338.  
  4339.                In the BinkleyTerm outbound area, using Route (without any
  4340.                modifiers) has the following result:
  4341.  
  4342.                     xxxxyyyy.OUT   -->  XXXXYYYY.MO? + XXXXYYYY.?LO
  4343.  
  4344.                When using the NoArc modifier, the Route command has the
  4345.                following result:
  4346.  
  4347.                     xxxxyyyy.OUT   -->  XXXXYYYY.?UT
  4348.  
  4349.                The File modifier causes the following changes to take
  4350.                place, in addition to the above:
  4351.  
  4352.                     xxxxyyyy.FLO   -->  XXXXYYYY.?LO
  4353.  
  4354.           Define <token> <text>
  4355.  
  4356.                The Define token is used to provide a short-form for routing
  4357.                commands.  The Define command acts as a macro facility,
  4358.                since it causes all further occurrences of <token> to be
  4359.                replaced by <text>.  As an example, the Define command is
  4360.                useful if there is a common set of nodes for which different
  4361.                routing commands must be applied over and over again.  Given
  4362.                the following Define statement:
  4363.  
  4364.                     Define Hub300  300 301 302 303 304 305 306
  4365.  
  4366.                Squish would translate the word "Hub300" to "300 301 302 303
  4367.                304 305 306" wherever that word occurred later in the file. 
  4368.                If the following route command were given:
  4369.  
  4370.                     Route Crash 1:123/300 Hub300
  4371.  
  4372.                all of the mail for nodes 300 through 306 would be routed
  4373.                through 1:123/300.
  4374.  
  4375.                However, replacements will only take place when the defined
  4376.                <token> is surrounded by whitespace or punctuation.
  4377.  
  4378.  
  4379.  
  4380.                        Squish v1.00 Reference Manual - Page 76
  4381.  
  4382.  
  4383.  
  4384.           Dos <cmd>
  4385.  
  4386.                The Dos command can be used to pass the name of an external
  4387.                command to the operating system.  The command will simply be
  4388.                run via the default command processor (normally COMMAND.COM
  4389.                for DOS, or CMD.EXE for OS/2).
  4390.  
  4391.           Schedules
  4392.  
  4393.           Squish supports the concept of "schedules", which are routing
  4394.           commands that can be run at different times of the day.  Squish
  4395.           also supports a section of global routing commands which are
  4396.           always run.
  4397.  
  4398.           The "Sched" statement in ROUTE.CFG is used to begin a schedule. 
  4399.           All routing commands which precede the first Sched statement are
  4400.           in the "global section", and they are always run when a SQUISH
  4401.           SQUASH is performed.  Squish will execute statements inside a
  4402.           schedule up to the next Sched statement, or until the end of the
  4403.           file is reached.
  4404.  
  4405.           The format of the Sched statement is as follows:
  4406.  
  4407.                Sched <tag> [day] [start] [end]
  4408.  
  4409.           <tag> is a one-word identifier for this schedule.  If you wish to
  4410.           explicitly execute this schedule on demand, then this tag must be
  4411.           specified on the command line through the -s command-line switch. 
  4412.           Otherwise, the name given to each schedule is irrelevant.
  4413.  
  4414.           <day> instructs Squish to execute the schedule on certain days of 
  4415.           the week.  To always execute a schedule, use the word "All".  To
  4416.           execute a schedule on weekends only, use the word "WkEnd".  To
  4417.           have it executed only on weekdays, use "WkDay".  To execute the
  4418.           schedule on a particular day of the week, use the words "Mon",
  4419.           "Tue", "Wed", "Thu", "Fri", "Sat" or "Sun".  To execute the
  4420.           schedule on more than one day of the week, use the "|" (pipe)
  4421.           character to string together two or more of the above words.  For
  4422.           example, "Tue|Wed|Fri" would cause the schedule to be run only on
  4423.           Tuesdays, Wednesdays and Fridays.
  4424.  
  4425.           <start> specifies the starting time for the schedule, specified
  4426.           in 24-hour format (hours:minutes).  The schedule will only be
  4427.           executed if the current time is equal to or greater than the time
  4428.           specified.
  4429.  
  4430.           <end> specifies the ending time for the schedule, specified in
  4431.           24-hour format.  The schedule will only be executed if the
  4432.           current time is equal to or less than the time specified.
  4433.  
  4434.  
  4435.  
  4436.                        Squish v1.00 Reference Manual - Page 77
  4437.  
  4438.  
  4439.  
  4440.           WARNING FOR QMAIL USERS!
  4441.  
  4442.           IF YOU WILL BE RUNNING A SCHEDULE BY THE COMMAND LINE, <tag> IS
  4443.           THE ONLY REQUIRED PARAMETER!  When Squish is scanning through
  4444.           ROUTE.CFG, it will automatically execute any schedules which fall
  4445.           within the specified time frame, regardless of those schedules'
  4446.           tags.  This means that ALL schedules with a date/time of "All
  4447.           00:00 23:59" will be executed.  Unless you want to run all of
  4448.           your schedules each time a SQUISH SQUASH is performed, only use
  4449.           the date and time for schedules which actually need to be run at
  4450.           different times.
  4451.  
  4452.           Example
  4453.  
  4454.           For example, the following ROUTE.CFG segment has a set of global
  4455.           routing commands which are run all the time, a set of commands
  4456.           which are run in the morning, and a set which are run in the
  4457.           afternoon/evening:
  4458.  
  4459.           ; GLOBAL COMMANDS
  4460.           ; Always route mail for net 123.
  4461.  
  4462.           Route Crash  1:123/1  123/All
  4463.  
  4464.           ; Route mail for my NC to the right place.
  4465.  
  4466.           Route Crash  1:222/0 1
  4467.  
  4468.           ; MORNING COMMANDS
  4469.  
  4470.           Sched Morning All 00:00 11:59
  4471.  
  4472.                ; Convert previously-held mail to crash for nodes in zone 2
  4473.  
  4474.                Change Hold Crash 2:All
  4475.                Send Crash 2:All
  4476.  
  4477.           ; AFTERNOON/EVENING COMMANDS
  4478.  
  4479.           Sched Afternoon All 12:00 23:59
  4480.  
  4481.                ; Convert crash zone 2 mail back to hold
  4482.  
  4483.                Change Crash Hold 2:All
  4484.  
  4485.                ; Now send all new zone 2 mail as hold
  4486.  
  4487.                Send Hold 2:All
  4488.  
  4489.           ; COMMANDS RUN ON DEMAND
  4490.  
  4491.  
  4492.                        Squish v1.00 Reference Manual - Page 78
  4493.  
  4494.  
  4495.  
  4496.           Sched PollNEC
  4497.  
  4498.                Poll Crash 1:222/2
  4499.  
  4500.           When run in the morning, Squish would handle routing for nets 123
  4501.           and 222, in addition to sending crashmail to all zone 2 systems. 
  4502.           When run in the afternoon, Squish would still handle routing for
  4503.           nets 123 and 222, but it would send mail to zone 2 systems as
  4504.           hold.  When run with the command line switch "-sPollNEC", Squish
  4505.           would generate a crash poll to node 222/2.
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.                        Squish v1.00 Reference Manual - Page 79
  4549.  
  4550.  
  4551.  
  4552.  
  4553.           BinkleyTerm Routing Commands
  4554.  
  4555.           The following commands can only be used on a BinkleyTerm-style
  4556.           system.  These commands directly modify the outbound directories,
  4557.           so there are no equivalent commands for ArcmailAttach systems.
  4558.  
  4559.           Leave <node> [<nodes>...]
  4560.  
  4561.                The Leave command modifies outbound mail so that it won't be
  4562.                sent by BinkleyTerm.  Squish will rename both *.?UT and
  4563.                *.?LO to an extension which is not recognized by
  4564.                BinkleyTerm, thereby preventing the mail from being sent or
  4565.                picked up.
  4566.  
  4567.                Leaving mail is useful for mail hubs and NECs, since it
  4568.                stops all mail from being sent to the specified nodes.  If
  4569.                your system has a crucial polling window and you want to
  4570.                stop others from calling in to pick up mail, then the Leave
  4571.                command can be used to make that mail inaccessible.
  4572.  
  4573.                To convert mail back to its original form after using
  4574.                "Leave", see the documentation for the Unleave command.
  4575.  
  4576.                As many nodes can be specified for the Leave command as
  4577.                necessary.  Wildcards are permitted.
  4578.  
  4579.                In the BinkleyTerm outbound area, using Leave has the
  4580.                following result:
  4581.  
  4582.                     xxxxyyyy.?UT   -->  xxxxyyyy.N?T
  4583.                     xxxxyyyy.?LO   -->  xxxxyyyy.N?O
  4584.  
  4585.           Unleave <node> [<nodes>...]
  4586.  
  4587.                The Unleave command undoes all of the changes which were
  4588.                made by the Leave command.  Mail which was left for the
  4589.                specified nodes will be converted back so that it can be
  4590.                sent.
  4591.  
  4592.                As many nodes can be specified for the Unleave command as
  4593.                necessary.  Wildcards are permitted.
  4594.  
  4595.                In the BinkleyTerm outbound area, using Unleave has the
  4596.                following result:
  4597.  
  4598.                     xxxxyyyy.N?T   -->  xxxxyyyy.?UT
  4599.  
  4600.                     xxxxyyyy.?LO   -->  xxxxyyyy.N?O
  4601.  
  4602.  
  4603.  
  4604.                        Squish v1.00 Reference Manual - Page 80
  4605.  
  4606.  
  4607.  
  4608.           Change <from_flavour> <to_flavour> <node> [<nodes>...]
  4609.  
  4610.                The Change command is used to change the flavour of existing
  4611.                packets and file attaches.
  4612.  
  4613.                <from_flavour> specifies the flavour to convert FROM.  Only
  4614.                mail of this flavour will be converted.  Valid flavours are
  4615.                crash, hold, direct and normal.
  4616.  
  4617.                <to_flavour> specifies the flavour to convert TO.  All types
  4618.                of mail with a <from_flavour> will be converted to the
  4619.                <to_flavour>.  Valid flavours are crash, hold, direct and
  4620.                normal.
  4621.  
  4622.                <node> and <nodes> specify the nodes for which mail should
  4623.                be converted.  Squish will process mail which are addressed
  4624.                to these nodes only, and apply the specified conversions.
  4625.  
  4626.                In the BinkleyTerm outbound area, using Change has the
  4627.                following result:
  4628.  
  4629.                     xxxxyyyy.?UT   -->  xxxxyyyy.?UT
  4630.                     xxxxyyyy.?LO   -->  xxxxyyyy.?UT
  4631.  
  4632.           Poll <flavour> <node> [<nodes>...]
  4633.  
  4634.                The Poll command is used to generate a poll to another
  4635.                system, even if there is no other mail waiting for that
  4636.                node.
  4637.  
  4638.                <flavour> specifies the flavour to use when creating the
  4639.                poll.   Valid flavours are normal, crash, hold, and direct.
  4640.  
  4641.                <node> and <nodes> specify the node numbers which should be
  4642.                polled.  Wildcards are NOT permitted.
  4643.  
  4644.                In the BinkleyTerm outbound area, using Poll has the
  4645.                following result:
  4646.  
  4647.                     Create: xxxxyyyy.?LO
  4648.  
  4649.           HostRoute <flavour> [File] [NoArc] <node> [<nodes>...]
  4650.  
  4651.                HostRoute is similar to the Route and Send commands, except
  4652.                that HostRoute will route normal-flavoured mail to each
  4653.                node's net host, as opposed to routing it all through a
  4654.                central hub.  (In other words, mail for 123/456 will be
  4655.                routed through 123/0, just as mail for 678/901 will be
  4656.                routed through 678/0.)
  4657.  
  4658.  
  4659.  
  4660.                        Squish v1.00 Reference Manual - Page 81
  4661.  
  4662.  
  4663.  
  4664.                <flavour> specifies the flavour to use when creating the
  4665.                routed packets.
  4666.  
  4667.                The File modifier instructs Squish to route files in
  4668.                addition to messages.  In general, the HostRouting of files
  4669.                is discouraged.
  4670.  
  4671.                The NoArc modifier stops Squish from archiving the resulting
  4672.                packets.  Messages will be sent to the net hosts in an
  4673.                uncompressed form.
  4674.  
  4675.                <node> and <nodes> specify the nodes for which routing will
  4676.                take place.  Wildcards are permitted.
  4677.  
  4678.                In the BinkleyTerm outbound area, using HostRoute has the
  4679.                following result:
  4680.  
  4681.                     xxxxyyyy.OUT   -->  xxxx0000.?UT
  4682.  
  4683.                The File modifier causes the following changes to take
  4684.                place, in addition to the above:
  4685.  
  4686.                     xxxxyyyy.FLO   -->  xxxx0000.?LO
  4687.  
  4688.  
  4689.           Dynamic Routing (FrontDoor)
  4690.  
  4691.           Squish has only minimal support for dynamic routing, since
  4692.           dynamic routing is always performed by your mailer.  The Route
  4693.           command CAN be used to route mail, but using your mailer to
  4694.           perform all routing is recommended.
  4695.  
  4696.           All schedules for an ArcmailAttach mailer should end with the
  4697.           command "Send Normal World".  This command compresses all
  4698.           remaining mail and gives it a flavour of normal.  Since
  4699.           ArcmailAttach mailers only recognize compressed mail, this
  4700.           command is required to ensure that all mail is properly sent.
  4701.  
  4702.  
  4703.  
  4704.  
  4705.  
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.  
  4713.  
  4714.  
  4715.  
  4716.                        Squish v1.00 Reference Manual - Page 82
  4717.  
  4718.  
  4719.  
  4720.                                        SECURITY
  4721.  
  4722.           In most environments, EchoMail security is not a problem. 
  4723.           However, in some instances, other systems may attempt to inject
  4724.           unwanted mail into normal EchoMail areas.  Squish provides two
  4725.           forms of protection against this:
  4726.  
  4727.           *    "Secure mode".  When the "Secure" keyword is added to
  4728.                SQUISH.CFG, Squish will check the origination addresses of
  4729.                all incoming packets, and it will only toss messages from
  4730.                systems which are listed in the "<nodes>" section of your
  4731.                area definitions.  In other words, unless you have added the
  4732.                address 123/456 to the definition for a particular echo,
  4733.                that node will not be able to send messages in that echo to
  4734.                your system.
  4735.  
  4736.                Secure mode provides protection against unlisted systems
  4737.                "crashing" messages into an EchoMail area through your
  4738.                system.  If messages cannot be tossed due to a security
  4739.                violation, they will be placed in your BAD_MSGS area.
  4740.  
  4741.           *    Packet passwords.  Although secure mode protects against
  4742.                most unwanted packets, other systems may try to send you
  4743.                mail using the address of another node.  Squish protects
  4744.                against this by allowing packet passwords to be used; by
  4745.                using Password statements in SQUISH.CFG, you can declare a
  4746.                password for nodes that you regularly connect with.
  4747.  
  4748.                Passwords are "bidirectional", meaning that the same
  4749.                password is used for both sending and receiving mail.  The
  4750.                packet password must be the same for both sides of the link. 
  4751.                In other words, if node 123/456 wants to use the password
  4752.                "qwerty" for node 234/567, the configuration file on 123/456
  4753.                must look like this:
  4754.  
  4755.                     Password 234/567 Qwerty
  4756.  
  4757.                and the configuration file on 234/567 must look like this:
  4758.  
  4759.                     Password 123/456 Qwerty
  4760.  
  4761.                In either case, the intent is to list the password to use
  4762.                when sending mail to the other system.  When creating
  4763.                packets for that system, Squish will insert the specified
  4764.                password into the packet.  In addition, when tossing packets
  4765.                from that system, Squish will check to make sure that the
  4766.                password is the same as the one listed in your configuration
  4767.                file.  If the two passwords do not match, the incident will
  4768.                be noted in the log, and the packet will be renamed to *.BAD
  4769.                and will not be tossed.
  4770.  
  4771.  
  4772.                        Squish v1.00 Reference Manual - Page 83
  4773.  
  4774.  
  4775.  
  4776.           *    Multiple NetFile paths.  Squish supports multiple NetFile
  4777.                paths with varying attributes in SQUISH.CFG.  When used with
  4778.                a mailer which allows different inbound directories to be
  4779.                declared for passworded and non-passworded systems, the
  4780.                modifiers for the NetFile keyword (such as NoArc and NoPkt)
  4781.                can be used to stop Squish from tossing certain types of
  4782.                mail from certain systems.  This helps prevent so-called
  4783.                "ARCmail bombs" from being decompressed and filling up all
  4784.                of your disk space.
  4785.  
  4786.           *    Receive-only nodes.  The -x<node> flag can be used with an
  4787.                EchoArea definition to stop Squish from tossing messages
  4788.                from a certain node in a certain echo.  This allows an echo
  4789.                to be sent to a system, but it stops that system from
  4790.                sending any messages back into the echo.
  4791.  
  4792.           If all of these security features are enabled, Squish becomes a
  4793.           very secure and rigid mail processor.  Most of these features
  4794.           won't be necessary for day-to-day operation, but they will become
  4795.           extremely useful when trying to stop unwanted mail from entering
  4796.           your system.
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.                        Squish v1.00 Reference Manual - Page 84
  4829.  
  4830.  
  4831.  
  4832.                                  MULTIZONE OPERATION
  4833.  
  4834.           Squish was designed especially for use on a multizone system.  In
  4835.           addition to full zone and point support, Squish can use an
  4836.           alternate primary addresses for each individual message area on
  4837.           your system.  Squish can control the SEEN-BYs on an area-by-area
  4838.           basis, generate packets with proper 4D addressing information,
  4839.           and more.
  4840.  
  4841.           The first key to multizone operation is the -p flag in
  4842.           SQUISH.CFG.  This flag allows an alternate primary address to be
  4843.           selected for each individual message area.  Squish will use the
  4844.           alternate address when adding to the ^aPATH line, SEEN-BYs and
  4845.           the message origin.  In addition, the origination address in
  4846.           outbound packets will also use your alternate address for that
  4847.           area.
  4848.  
  4849.           To use the -p flag, simply place that flag and your alternate
  4850.           primary address before all the addresses of the systems that you
  4851.           feed.  For example, to declare an alternate primary address of
  4852.           89:487/106, in an area called "IMEX.R82" (which you receive from
  4853.           89:487/0), the following line should be used in SQUISH.CFG:
  4854.  
  4855.                EchoArea  IMEX.R82  C:\Msg\ImexR82 -p89:487/106 89:487/0
  4856.  
  4857.           The alternate primary address also changes your default address
  4858.           for the area definition, so the following would have the same
  4859.           effect:
  4860.  
  4861.                EchoArea  IMEX.R82  C:\Msg\ImexR82 -p89:487/106 0
  4862.  
  4863.           Squish can support an unlimited number of alternate primary
  4864.           addresses, as long as you use the proper -p flag for each area. 
  4865.           The -p flag is not required for areas which use your primary
  4866.           address (the first address declared in SQUISH.CFG), since Squish
  4867.           will use your first address by default.
  4868.  
  4869.           Squish is also capable of adding node numbers to the SEEN-BYs for
  4870.           one area only.  In a manner similar to using alternate primary
  4871.           addresses, simply add a -+<node> flag for each area and for each
  4872.           node that you wish to add.  (Your alternate primary address will
  4873.           be added automatically, so you don't need to worry about adding
  4874.           it as well.)
  4875.  
  4876.           For example, if you wanted to add the nodes 487/2 and 487/3 to 
  4877.           messages passing through your system in the ABC echo, using an
  4878.           alternate address of 89:487/106, the following declaration in
  4879.           SQUISH.CFG would do the job:
  4880.  
  4881.                EchoArea ABC C:\Msg\ABC -p89:487/106 -+487/2 -+3 487/0
  4882.  
  4883.  
  4884.                        Squish v1.00 Reference Manual - Page 85
  4885.  
  4886.  
  4887.  
  4888.           Finally, you should make sure that you have declared all of your
  4889.           alternate primary addresses using the Address keyword in
  4890.           SQUISH.CFG.  Otherwise, Squish won't realize that messages for
  4891.           your alternate address are really for your system, and it will
  4892.           try to forward them as in-transit netmail.
  4893.  
  4894.           That's all there is to it!  No secondary configuration files, and
  4895.           more importantly, no kludges are required.  Squish provides
  4896.           transparent support for multizone systems, with a minimum amount
  4897.           of hassle and with no speed drawbacks.
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.                        Squish v1.00 Reference Manual - Page 86
  4941.  
  4942.  
  4943.  
  4944.                          POINTS (4D, FAKENETS AND BOSSNODES)
  4945.  
  4946.           Squish incorporates full support for 4D and fakenet points, both
  4947.           as a point itself and as the managing bossnode.  Bossnodes can
  4948.           also transparently support both types of points, still using the
  4949.           same configuration file.
  4950.  
  4951.           Fakenet Points
  4952.  
  4953.           In the early days of FidoNet, support for true points was minimal
  4954.           or nonexistent.  As a workaround, instead of giving true 4D
  4955.           addresses to a system's points, a dummy net number was created. 
  4956.           In turn, the node numbers in that net would actually represent
  4957.           points of the bossnode.  Since this dummy net/node combination
  4958.           was a simple net/node address (with no point numbers), adapting
  4959.           existing software was no problem.  This net number would be used
  4960.           for internal communication between the bossnode and the points. 
  4961.           For example, if 123/456 were using a dummy net number of 14122,
  4962.           the fakenet version of the address 123/456.1 would be 14122/1.
  4963.  
  4964.           When using the fakenet scheme, it is vitally important to ensure
  4965.           that fakenet numbers do not "escape" out into the rest of the
  4966.           net.  Since many systems could theoretically be using the same
  4967.           dummy network number, the fakenet addresses are usually stripped
  4968.           or converted by the boss system before messages are sent to the
  4969.           rest of the network.
  4970.  
  4971.           Squish supports fakenet points through the use of the "PointNet"
  4972.           keyword in SQUISH.CFG.  Simply specify which dummy net you are
  4973.           using, and Squish will automatically handle the details of
  4974.           stripping and adding SEEN-BYs.
  4975.  
  4976.           NOTE!  As the boss of a fakenet system, you should make sure to
  4977.           use the actual fakenet number whenever you refer to one of your
  4978.           points.  Since Squish supports both 4D and fakenet points in the
  4979.           same configuration, you must be careful to use the correct
  4980.           address.  In other words, if you have a fakenet point at
  4981.           123/456.1, with a fakenet address of 14122/1, you must ensure
  4982.           that your control files and AREAS.BBS always refer to this point
  4983.           as 14122/1.  4D addresses can only be used when dealing with true
  4984.           4D points.
  4985.  
  4986.           4D Points
  4987.  
  4988.           Squish supports true 4D points in addition to fakenet points. 
  4989.           However, to use 4D points, both the bossnode and the point must
  4990.           be running 4D-capable tossers, scanners and mailers.  As of this
  4991.           writing, the only 4D mailers in common use are FrontDoor,
  4992.           InterMail, D'Bridge, and BinkleyTerm 2.50+.  4D tossers and
  4993.           scanners include Squish, TosScan, Imail and others.  Unless all
  4994.  
  4995.  
  4996.                        Squish v1.00 Reference Manual - Page 87
  4997.  
  4998.  
  4999.  
  5000.           of your software supports 4D addressing and the "2+" packet
  5001.           header proposal, you won't be able to use 4D points.
  5002.  
  5003.           Squish supports 4D points in an extremely simple manner; just 
  5004.           use the 4D point address like a normal address.  Squish will
  5005.           automatically handle the tossing and scanning of messages from 4D
  5006.           points, and there is no need to remap addresses.  SEEN-BYs are
  5007.           ignored when sending messages to 4D points, since SEEN-BY lines
  5008.           are only two-dimensional.
  5009.  
  5010.           As with fakenet points, make sure that you always use the 4D
  5011.           address when referring to 4D points.  If you attempt to mix and
  5012.           match 4D and fakenet addresses for the same node, Squish may not
  5013.           work the way you intended it to.
  5014.  
  5015.  
  5016.           Remapping
  5017.  
  5018.           Squish includes a built-in node remapper.  This remapper
  5019.           readdresses inbound netmail based on the "To:" field, and it also
  5020.           remaps outbound netmail by changing the fakenet back to a 4D
  5021.           address, if applicable.
  5022.  
  5023.           When specifying point numbers in the remapper, make sure that you
  5024.           specify either a 4D or a fakenet address, as appropriate.  Again,
  5025.           since Squish supports both 4D and fakenet points in the same
  5026.           configuration, you must make sure to use ONLY fakenet addresses
  5027.           for fakenet points, and ONLY 4D addresses for 4D points.
  5028.  
  5029.           For more information on the remapper, please see the
  5030.           documentation for the Remap keyword in the SQUISH.CFG reference.
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.                        Squish v1.00 Reference Manual - Page 88
  5053.  
  5054.  
  5055.  
  5056.                           USING SQUISH-FORMAT MESSAGE AREAS
  5057.  
  5058.           In addition to the FidoNet standard *.MSG format, Squish also
  5059.           supports the proprietary, flat-file *.SQ? message base.  This
  5060.           message base was designed from the ground up to be fast, reliable
  5061.           and small.  Some of the key features of the Squish message format
  5062.           are:
  5063.  
  5064.           *    Flat-file message areas.  A separate message database per
  5065.                message area.  Using a separate message file for each area
  5066.                still provides for quick access, but if disaster should
  5067.                happen (such as a message base crash), only one area will be
  5068.                damaged.
  5069.  
  5070.           *    Maintainability.  The Squish format utilizes a customized
  5071.                circular file structure.  For the most part, Squish message
  5072.                areas are completely self-maintaining.  If a message is
  5073.                deleted in a Squish message base, the space left by that
  5074.                message can be reused when more messages are written to the
  5075.                area.  Squish attempts to fill the message base in an
  5076.                optimal manner, so "packing" is not as important as it is
  5077.                with other message base types.  Depending on the volume of
  5078.                mail you process, Squish areas may only need to be packed
  5079.                once a week!  Squish areas are also renumbered on the fly,
  5080.                so an external renumbering utility is not required. 
  5081.                Finally, the Squish file format also allows for a "maximum
  5082.                message limit" to be set for any given area.  This limit
  5083.                will be used to automatically purge old messages as new ones
  5084.                are written to the message base, which eliminates the need
  5085.                for an external message deletion utility.  A separate set of
  5086.                message numbers is maintained for each message area, which
  5087.                eliminates the "messages in this area are numbered 89,216
  5088.                through 90,784" eyesore of other message formats.
  5089.  
  5090.           *    Reliability.  The Squish format was designed to make message
  5091.                recovery an easy task, even in the event of a total message
  5092.                base crash.  The SQFIX utility can be used to fix a damaged
  5093.                Squish area with no user intervention.  SQFIX has a high
  5094.                success rate; in most cases, not a single message will be
  5095.                lost!  The only disadvantage to SQFIX is that the sequential
  5096.                order of messages within a base may be lost; but this is a
  5097.                small price to pay for an automated message recovery system.
  5098.  
  5099.           *    Speed.  Since Squish uses a flat-file message base, it is
  5100.                much faster than the FTS-0001 *.MSG format.  Based on
  5101.                preliminary testing, Squish is also faster at tossing
  5102.                messages than QECHO 2.66 and several other utilities which
  5103.                use the Hudson message format.
  5104.  
  5105.  
  5106.  
  5107.  
  5108.                        Squish v1.00 Reference Manual - Page 89
  5109.  
  5110.  
  5111.  
  5112.           *    Size.  Messages are stored in the equivalent of a random-
  5113.                access file with a record length of 1 byte, so no "blocks"
  5114.                are necessary.  Unlike the Hudson format, Squish stores
  5115.                messages directly after one another with no padding.  When
  5116.                the SEEN-BY information is turned off, Squish message bases
  5117.                are consistently smaller than the equivalent Hudson-format
  5118.                message base.
  5119.  
  5120.           *    Multitasking and LAN awareness.  Squish was designed from
  5121.                the ground up to be compatible with multitasking and network
  5122.                systems.  Multiple programs, such as Squish and Maximus, can
  5123.                access the same message base at the same time with no danger
  5124.                of corruption.
  5125.  
  5126.           *    Flexible structure.  Squish areas have built-in support for
  5127.                full 4D origination and destination addresses, date-of-
  5128.                creation and date-of-arrival binary timestamps, and more. 
  5129.                In addition, ^A kludge lines are stored in a separate
  5130.                logical record before the message body, providing a unified
  5131.                way for developers to access message control information.
  5132.  
  5133.           Even with all of these advanced features, the Squish format is
  5134.           easy to use.  Squish format areas can be declared in both
  5135.           SQUISH.CFG and AREAS.BBS, although the maximum message limit can
  5136.           only be set in SQUISH.CFG for compatibility reasons.
  5137.  
  5138.           On disk, Squish message bases are stored using two files per
  5139.           message area.  To name a Squish area, you must specify a path and
  5140.           a "root filename".  A root filename is the base part of a
  5141.           filename, eight characters or fewer, with no extension.  Squish
  5142.           will then add the appropriate extensions to access the message
  5143.           data and index files.
  5144.  
  5145.           The Squish message format itself only requires two files per
  5146.           message area:
  5147.  
  5148.           areaname.SQD   This file is used to store the message data. 
  5149.                          Information about the area, the number of
  5150.                          messages, message headers, the message body, and
  5151.                          the linked lists are all stored in this file.
  5152.  
  5153.           areaname.SQI   This file is used to store the message index. 
  5154.                          This contains a copy of the "To:" field in the
  5155.                          message header, and it allows the Squish format to
  5156.                          be accessed quickly in a non-linear fashion.
  5157.  
  5158.           The above are the only required files for a Squish-format area. 
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.                        Squish v1.00 Reference Manual - Page 90
  5165.  
  5166.  
  5167.  
  5168.           However, other programs create files with similar extensions,
  5169.           such as:
  5170.  
  5171.           areaname.SQB   This file is used by the Squish tosser to store
  5172.                          duplicate message information.
  5173.  
  5174.           areaname.SQL   This file is used by Maximus-CBCS to store
  5175.                          lastread pointer information.
  5176.  
  5177.           To declare a Squish-format area in AREAS.BBS, simply add a "$"
  5178.           character to the beginning of the path.  In other words, to
  5179.           convert the following to a Squish-format area:
  5180.  
  5181.                E:\MSG\ASDF    ASDF 249/99
  5182.  
  5183.           simply add a "$" at the beginning to make it look like this:
  5184.  
  5185.                $E:\MSG\ASDF   ASDF 249/99
  5186.  
  5187.           For an area declared in SQUISH.CFG, simply add a "-$" flag to the
  5188.           area definition.  In other words, given the following definition
  5189.           for a *.MSG area:
  5190.  
  5191.                EchoArea  ASDF E:\MSG\ASDF    249/99
  5192.  
  5193.           a "-$" should be inserted to convert the area to the Squish
  5194.           format, like this:
  5195.  
  5196.                EchoArea  ASDF E:\MSG\ASDF -$ 249/99
  5197.  
  5198.           To add a maximum message limit to a Squish area, the "-$m" flag
  5199.           can be used in SQUISH.CFG.  For example, to limit the ASDF area
  5200.           to 100 messages, the following definition could be used:
  5201.  
  5202.                EchoArea  ASDF E:\MSG\ASDF -$m100  249/99
  5203.  
  5204.           When using the above definition, Squish will automatically purge
  5205.           messages such that no more than 100 messages are in the area at
  5206.           once time.  A limit on the maximum age of messages can also be
  5207.           set using the -$d flag.  However, purging messages by date is
  5208.           only performed when SQPACK is run, so Squish won't delete by date
  5209.           on-the-fly.  For more information on the -$, -$d and -$m flags,
  5210.           please see the SQUISH.CFG reference.
  5211.  
  5212.           Currently, up to a maximum of 5,200 messages can be stored in a
  5213.           single Squish-style message area.  However, this per-area limit
  5214.           is imposed by memory segmentation and is *NOT* a limitation of
  5215.           the file structure.  If there is enough demand, the MsgAPI code
  5216.           can be upgraded to accommodate as many messages as will fit into
  5217.           memory.  (Under OS/2, this change could be accomplished by simply
  5218.  
  5219.  
  5220.                        Squish v1.00 Reference Manual - Page 91
  5221.  
  5222.  
  5223.  
  5224.           installing a new copy of MSGAPI.DLL.)  If you are interested in
  5225.           such a change, please let the author know in a NetMail message in
  5226.           the TUB EchoMail area.
  5227.  
  5228.           In terms of usage, Squish will automatically create nonexistent
  5229.           areas, so you don't have to worry about creating them manually. 
  5230.           Squish treats *.SQ? areas just like *.MSG areas in all respects,
  5231.           including direct tossing and scanning.  However, Squish areas can
  5232.           be accessed much faster than their *.MSG counterparts, and Squish
  5233.           areas will also use less disk space.
  5234.  
  5235.           Once you have tossed messages to a Squish-format message base,
  5236.           those messages can be accessed with any program which supports
  5237.           the Squish format.  Currently, Maximus-CBCS is the only program
  5238.           which fully supports Squish message bases, but more are sure to
  5239.           follow.
  5240.  
  5241.           If you are using the -$m flag, Squish areas are mostly self-
  5242.           maintaining.  However, small "holes" can creep into the message
  5243.           base over time, even with the circular file format.  For this
  5244.           reason, the SQPACK program can be run at predefined intervals to
  5245.           pack and compress message bases.  Also, if you are using the -$d
  5246.           option, SQPACK must be run to delete old, expired message. For
  5247.           information on installing SQPACK, please continue reading in the
  5248.           next section, entitled "SQUISH-FORMAT MESSAGE UTILITIES".
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.                        Squish v1.00 Reference Manual - Page 92
  5277.  
  5278.  
  5279.  
  5280.                            SQUISH-FORMAT MESSAGE UTILITIES
  5281.  
  5282.           In addition to the main tosser/scanner/packer, the Squish package
  5283.           includes several utility programs designed to help users of
  5284.           Squish-format message bases.
  5285.  
  5286.           SQPACK:  Weekly maintenance
  5287.  
  5288.           The SQPACK program is used to "pack" Squish-format message areas. 
  5289.           Over the course of time, small holes can develop in Squish
  5290.           message areas, so SQPACK can be used to recover this wasted
  5291.           space.  If you are using the -$m flags on your areas, you
  5292.           probably won't need to run SQPACK more than once a week. 
  5293.           However, if you are killing messages by age (through the -$d
  5294.           flag), you'll need to run SQPACK whenever you wish to delete
  5295.           messages.
  5296.  
  5297.           The command-line format for SQPACK is as follows:
  5298.  
  5299.                SQPACK <filespec>
  5300.  
  5301.           <filespec> should specify the name and path of a Squish-format
  5302.           message data file.  Wildcards are allowed.  For example, to pack
  5303.           the message in the file D:\MSG\MUFFIN.SQD, the following command
  5304.           should be issued:
  5305.  
  5306.                SQPACK D:\MSG\MUFFIN.SQD
  5307.  
  5308.           In addition, if there are a number of message areas in the D:\MSG
  5309.           directory, the following command could be given to pack all of
  5310.           those areas:
  5311.  
  5312.                SQPACK D:\MSG\*.SQD
  5313.  
  5314.           When SQPACK finishes processing all of the selected areas, it
  5315.           will print out a short statistics report detailing how much space
  5316.           was used before, how much space is used now, and a percentage
  5317.           savings.  This percentage can guide you when figuring out how
  5318.           often to run SQPACK.
  5319.  
  5320.           Note to Maximus users
  5321.  
  5322.           In addition to the name of a Squish data file, SQPACK can also
  5323.           accept the name of a Max 2.00 AREA.DAT file.  If you enter
  5324.           "SQPACK D:\MAX\AREA.DAT", SQPACK will automatically pack all of
  5325.           the Squish-format areas defined in AREA.DAT.
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.                        Squish v1.00 Reference Manual - Page 93
  5333.  
  5334.  
  5335.  
  5336.  
  5337.           SQCONVER:  Conversion between *.MSG and *.SQ?
  5338.  
  5339.           The SQCONVER utility is used to convert message areas between the
  5340.           *.MSG and Squish message formats.  SQCONVER is normally run from
  5341.           the OS prompt, and it can only be run on one area at a time.
  5342.  
  5343.           SQCONVER uses the following command-line format:
  5344.  
  5345.                SQCONVER <from_path> <from_type> <to_path> <to_type> <zone>
  5346.  
  5347.           <from_path> specifies the directory or root filename of the area
  5348.           that you wish to convert.
  5349.  
  5350.           <from_type> specifies the type of the <from_path> area.  Valid
  5351.           types are either "*.MSG" or "Squish".
  5352.  
  5353.           <to_path> specifies the directory or root filename for the area
  5354.           to be created.
  5355.  
  5356.           <to_type> specifies the type of the <to_path> area.  Valid types
  5357.           are either "*.MSG" or "Squish".
  5358.  
  5359.           <zone> specifies your default zone number.  Since *.MSG format
  5360.           messages don't always have zone numbers available, you must tell
  5361.           SQCONVER which default zone number is used in that area.
  5362.  
  5363.           For example, to convert a *.MSG area in C:\MAX\MSG\LOCAL to a
  5364.           Squish area called C:\MAX\MSG\PRIVATE.SQ?, the following command
  5365.           line would be used:
  5366.  
  5367.                SQCONVER C:\Max\Msg\Local *.MSG C:\Max\Msg\Private Squish 1
  5368.  
  5369.           The above assumes that you are in zone 1; for other zones, simply
  5370.           substitute your default zone number for the "1".
  5371.  
  5372.           To convert an area back from Squish format to *.MSG, the
  5373.           following could be used:
  5374.  
  5375.                SQCONVER C:\Msg\Sqarea Squish C:\Msg\Msg_Area *.MSG 1
  5376.  
  5377.           Also, please note that both Squish and *.MSG areas can have the
  5378.           same name.  Since *.MSG messages are placed inside a separate
  5379.           directory, and Squish areas are placed in *.SQ? files in the
  5380.           directory above, the following command is perfectly acceptable:
  5381.  
  5382.           SQCONVER C:\Msg\Local *.MSG C:\Msg\Local Squish 1
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.                        Squish v1.00 Reference Manual - Page 94
  5389.  
  5390.  
  5391.  
  5392.           The above command would convert all of the messages in
  5393.           C:\Msg\Local\*.MSG and place those messages in the files called
  5394.           C:\Msg\Local.SQ?.
  5395.  
  5396.           WARNING!  You must exercise caution when converting a Squish area
  5397.           back to the *.MSG format.  Since SEEN-BYs are not updated in
  5398.           Squish EchoMail messages, converting a Squish area to *.MSG may
  5399.           cause messages in that area to be rescanned.  You should make
  5400.           sure that the high water marker is properly set when converting a
  5401.           Squish area back to *.MSG.  (Converting *.MSG areas to Squish is
  5402.           not a problem, since Squish will never scan a converted Squish-
  5403.           format message.)
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.                        Squish v1.00 Reference Manual - Page 95
  5445.  
  5446.  
  5447.  
  5448.  
  5449.           SQSET:  Control for message deletion
  5450.  
  5451.           The SQSET utility is used to manually update the "maximum message
  5452.           limit" and "protected messages" for a given message area.  These
  5453.           limits can be set automatically in SQUISH.CFG using the -$m and
  5454.           -$s flags in SQUISH.CFG, but some users may prefer to set these
  5455.           limits from the OS prompt.
  5456.  
  5457.           The command-line format of SQSET is as follows:
  5458.  
  5459.                SQSET <area> [<max_msgs> [<skip_msgs>]]
  5460.  
  5461.           <area> specifies the path and root filename of a Squish-format
  5462.           message area.
  5463.  
  5464.           <max_msgs> specifies the maximum number of messages to keep in
  5465.           this area at one time.  The next time a message is written to
  5466.           this area, Squish will automatically delete and renumber messages
  5467.           such that there are no more than <max_msgs> in the area.  If this
  5468.           parameter is omitted, Squish will simply display the current
  5469.           settings for <max_msgs> and <skip_msgs>.
  5470.  
  5471.           <skip_msgs> specifies the number of messages to skip at the
  5472.           beginning of the area, before starting to automatically delete
  5473.           messages.  When <skip_msgs> is used, <max_msgs> must also be
  5474.           specified.  When Squish is deleting old messages, this command
  5475.           causes it to only start deleting after the first <skip_msgs>
  5476.           messages.  This is useful for keeping "posting rules" as the
  5477.           first message in each area, or for keeping a certain number of
  5478.           messages for an indefinite length of time.
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.  
  5499.  
  5500.                        Squish v1.00 Reference Manual - Page 96
  5501.  
  5502.  
  5503.  
  5504.  
  5505.           SQINFO:  Diagnostics
  5506.  
  5507.           SQINFO is a diagnostics and information utility for Squish-format
  5508.           message areas.  SQINFO will walk through both the chain of
  5509.           message frames and also the chain of free frames, displaying
  5510.           information about each message and reporting any errors it comes
  5511.           across.  SQINFO can be used to quickly diagnose problems in a
  5512.           Squish-format message area.
  5513.  
  5514.           This program is not required for normal use, so it can be deleted
  5515.           if disk space is at a premium.  SQINFO is primarily of interest
  5516.           for third-party utility authors who are writing *.SQ?-compatible
  5517.           programs.
  5518.  
  5519.           The command line format of SQINFO is as follows:
  5520.  
  5521.                SQINFO <area> [-q] [-b] [-e]
  5522.  
  5523.           <area> should be the path and root filename of a Squish-format
  5524.           message area.
  5525.  
  5526.           -q is the optional "quick" switch.  Instead of displaying a
  5527.           verbose report on each message, SQINFO will simply list the
  5528.           location of each message.  SQINFO will still check for and notify
  5529.           the user of errors, since this option simply disables most screen
  5530.           output.
  5531.  
  5532.           -b is the optional "bugfind" switch.  When in this mode, SQINFO
  5533.           will display nothing except the area name.  SQINFO will still
  5534.           check for errors, but it won't tell you where the error occurred. 
  5535.           This mode is useful when checking a large number of areas for
  5536.           problems; simply run "SQINFO <area> -b" over all message areas,
  5537.           and then rerun SQINFO (without the -b) on areas which have
  5538.           problems.
  5539.  
  5540.           -e is the optional "errorlevel" switch.  When in this mode,
  5541.           SQINFO will operate as in "bugfind" mode, but it is also geared
  5542.           for batch operation.  SQINFO will not prompt the user to press a
  5543.           key, and it will return an errorlevel based on the condition of
  5544.           the base.  If the message area is okay, SQINFO returns an
  5545.           errorlevel of 0.  If the message area is damaged, SQINFO will
  5546.           return an errorlevel of 1.
  5547.  
  5548.           The -q, -b and -e options are mutually exclusive.  Only one of
  5549.           the above switches can be specified on the command line.
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.                        Squish v1.00 Reference Manual - Page 97
  5557.  
  5558.  
  5559.  
  5560.  
  5561.           SQREIDX:  Repair (minor)
  5562.  
  5563.           SQREIDX is an indexing utility for Squish-format message areas. 
  5564.           This utility can be used to correct simple indexing problems, but
  5565.           it is not required for normal use.  If more than just the index
  5566.           is damaged (as reported by SQINFO), SQFIX should be used instead.
  5567.  
  5568.           The command-line format of SQREIDX is:
  5569.  
  5570.           SQREIDX <area>
  5571.  
  5572.           <area> should be the path and root filename of the Squish-format
  5573.           message area with the grunged index.
  5574.  
  5575.           SQREIDX will recreate the index for <area> by walking through the
  5576.           message chains in the data file, and then by rewriting the
  5577.           original index.  If the index is not the only problem with the
  5578.           area, the full-fledged SQFIX should be used instead.
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.                        Squish v1.00 Reference Manual - Page 98
  5613.  
  5614.  
  5615.  
  5616.  
  5617.           SQFIX:  Repair (major)
  5618.  
  5619.           SQFIX is a full-fledged restoration utility for Squish-format
  5620.           message areas.  Even when run on a heavily-damaged area, SQFIX
  5621.           can recover all of the messages which were not individually
  5622.           damaged.  SQFIX is completely automated and requires no operator
  5623.           assistance.  The command-line format for SQFIX is:
  5624.  
  5625.                SQFIX <area>
  5626.  
  5627.           <area> should specify the path and root filename of the message
  5628.           area to be fixed.
  5629.  
  5630.           Squish will automatically restore a damaged fixed area.  If the
  5631.           area can be fixed, the old data files will be renamed to
  5632.           <areaname>.XXD and <areaname>.XXI.
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.                        Squish v1.00 Reference Manual - Page 99
  5669.  
  5670.  
  5671.  
  5672.  
  5673.           SSTAT:  Statistics generation
  5674.  
  5675.           If the Statistics option is enabled in the Squish configuration
  5676.           file, Squish will create a binary statistics log.  This log
  5677.           contains a great deal of information, but not in a human-readable
  5678.           format.  The SSTAT utility included with Squish is very minimal;
  5679.           since the source for SSTAT is distributed in this archive, an
  5680.           easier-to-use statistics utility will probably be written by a
  5681.           third-party author.
  5682.  
  5683.           SSTAT is more of a billing report generator than an analysis
  5684.           utility; unless you are scanning mail to someone else, SSTAT
  5685.           won't produce any output.  However, if your system does scan mail
  5686.           to more than one system, SSTAT is capable of producing a 100%
  5687.           accurate billing report for each system, based on the volume of
  5688.           mail sent to each node that you feed.
  5689.  
  5690.           SSTAT works from a configuration file called SSTAT.CFG.  This
  5691.           file must be in the current directory when SSTAT is run, as must
  5692.           SQUISH.STA (the statistics log produced by Squish).
  5693.  
  5694.           SSTAT.CFG is a free-format configuration file, similar in nature
  5695.           to SQUISH.CFG and ROUTE.CFG.  At the current time, SSTAT only
  5696.           handles the following two keywords:
  5697.  
  5698.           Track <node> [<nodes>...]
  5699.  
  5700.                This keyword causes SSTAT to track mail for the specified
  5701.                nodes.  <node> can be a full-fledged address, including
  5702.                zone, net, node and point number.  SSTAT will track all mail
  5703.                which is addressed to that node.  Wildcards may NOT be used.
  5704.  
  5705.           Area <tag> [<tag>...]
  5706.  
  5707.                This keyword causes SSTAT to track mail for the specified
  5708.                area tags only.  SSTAT will only report mail for the
  5709.                specified areas, and these areas will be the only ones
  5710.                included as part of the billing reports.
  5711.  
  5712.           A sample SSTAT.CFG is included in the distribution archive. 
  5713.           After you have customized SSTAT.CFG, let Squish run for a while,
  5714.           and then run SSTAT.  If all goes well, and if you are scanning
  5715.           mail to at least one other node, SSTAT should produce a highly-
  5716.           detailed report describing all of the message activity on your
  5717.           system.  SSTAT performs two sets of calculations:  one set is
  5718.           based on the number of messages sent to each node, while the
  5719.           other is based on the quantity of bytes sent to each node.  In
  5720.           most cases, the number representing the quantity of bytes sent is
  5721.           usually more reflective of long-distance telephone charges.
  5722.  
  5723.  
  5724.                        Squish v1.00 Reference Manual - Page 100
  5725.  
  5726.  
  5727.  
  5728.           At the end of the report, SSTAT will include an overall summary
  5729.           with percentage totals, suitable for use in a cost-sharing
  5730.           arrangement.  SSTAT uses a sophisticated algorithm for
  5731.           determining the TRUE cost of messages, but in short, the billing
  5732.           scheme works like this:
  5733.  
  5734.           1)   For each area listed in SSTAT.CFG, SSTAT will determine the
  5735.                total quantity of mail (whether that be bytes or messages)
  5736.                that you received in the area.  Squish will divide this
  5737.                number by the total quantity of mail received in ALL areas
  5738.                listed in SSTAT.CFG.  The result of the division is a
  5739.                percentage for the area; this percentage represents the area
  5740.                as a portion of your total inbound mail.  In other words, if
  5741.                you multiply your long-distance charges by this percentage,
  5742.                the result will represent how much it cost to bring in the
  5743.                specified area.
  5744.  
  5745.           2)   For each area listed in SSTAT.CFG, and for each node listed
  5746.                within each area, SSTAT will calculate the total quantity of
  5747.                mail sent to that node for that area.  SSTAT will then
  5748.                divide this by the total quantity of mail sent to all nodes
  5749.                within that area.  The result of this division represents
  5750.                the percentage of mail (within that area) which is being
  5751.                consumed by the node in question.
  5752.  
  5753.           3)   For each node in each area, the percentage determined in
  5754.                step 2) is then multiplied by the percentage determined in
  5755.                step 1) for that area.  This figure now represents the
  5756.                actual percentage that this node must pay for receiving the
  5757.                mail in that area.
  5758.  
  5759.           4)   The percentages for each node are then summed up for each
  5760.                area, which represents the percentage total as shown at the
  5761.                end of the billing report.  This percentage represents the
  5762.                actual amount that this node should pay for any long-
  5763.                distance charges in a cost-sharing system.
  5764.  
  5765.           Unlike the rest of Squish, the SSTAT utility and the accompanying
  5766.           sources are public domain.  If SSTAT doesn't do exactly what you
  5767.           want, please feel free to revise the program to meet your needs.
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.                        Squish v1.00 Reference Manual - Page 101
  5781.  
  5782.  
  5783.  
  5784.                                       APPENDICES
  5785.  
  5786.  
  5787.           Appendix A.  Errorlevels
  5788.  
  5789.           Squish will set one of several errorlevels after termination. 
  5790.           The errorlevels currently supported by Squish are:
  5791.  
  5792.           Erl  Action
  5793.  
  5794.           0    No tossing or scanning took place.
  5795.           1    Error.  Squish encountered some sort of fatal error and had
  5796.                to abort.
  5797.           2    Sent EchoMail.  This means that Squish exported one or more
  5798.                EchoMail messages.  (This errorlevel is only used when
  5799.                performing "SQUISH OUT" as part of a multipass operation.)
  5800.           3    Tossed NetMail only.  This means that Squish tossed one or
  5801.                more packets, but only NetMail was received.
  5802.           4    Tossed EchoMail and/or NetMail.  This means that Squish
  5803.                tossed one or more packets containing EchoMail (and possibly
  5804.                NetMail).
  5805.           5    MaxMsgs was reached.  This means that Squish reached the
  5806.                MaxMsgs limit when processing mail in a multipass
  5807.                environment.  This means that SQUISH SQUASH should be
  5808.                invoked, followed by another round of exporting.
  5809.  
  5810.           With the exception of errorlevel 1, higher errorlevel numbers
  5811.           will take precedence.  In other words, if EchoMail and/or NetMail
  5812.           was tossed, but MaxMsgs was also reached, Squish will exit with
  5813.           an errorlevel of 5.
  5814.  
  5815.  
  5816.  
  5817.           Appendix B.  Problem Reporting
  5818.  
  5819.           If you discover a problem in the Squish software, you are
  5820.           encouraged to report this problem to the author.  Problem reports
  5821.           can be placed in the TUB or MUFFIN echomail areas (for Squish and
  5822.           Maximus, respectively).  If the problem is urgent, you can also
  5823.           send a NetMail message to the author at 1:249/106.
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.                        Squish v1.00 Reference Manual - Page 102
  5837.  
  5838.  
  5839.  
  5840.                                        GLOSSARY
  5841.  
  5842.           *.MSG
  5843.  
  5844.                The message format originally used by Fido, also used as the
  5845.                FidoNet standard for local message storage  The *.MSG system
  5846.                requires a separate directory for each message area, and a
  5847.                separate file for each message.  This makes the *.MSG format
  5848.                inefficient, in terms of both disk space and time.  For
  5849.                compatibility reasons, Squish uses the *.MSG format by
  5850.                default.
  5851.  
  5852.           *.SQ?
  5853.  
  5854.                The message format originally used by Maximus.  *.SQ? (or
  5855.                "Squish format") uses two files per area; a .SQI file
  5856.                contains a message index, and the other contains the message
  5857.                headers and text.
  5858.  
  5859.           *.PKT
  5860.  
  5861.                The "transport layer" for FidoNet-compatible messages. 
  5862.                Packets are used when transferring messages between two
  5863.                different FidoNet systems.  Since all systems use the same
  5864.                type of packet, *.PKT can be used to transfer messages
  5865.                between systems which use unlike message bases (such as
  5866.                *.MSG and the QuickBBS/Hudson format).  See also "2+" and
  5867.                "StoneAge".
  5868.  
  5869.           2+
  5870.  
  5871.                A new, backwards-compatible form of *.PKT files.  The
  5872.                original packet design had no allowances for zone and point
  5873.                information; the 2+ packet format corrects this shortcoming. 
  5874.                Squish creates 2+ packets by default, but it can also handle
  5875.                StoneAge packets.  See also "*.PKT" and "StoneAge".
  5876.  
  5877.           4D
  5878.  
  5879.                A term used to refer to a full FidoNet address.  An address
  5880.                in the form "zone:net/node.point" is called 4D because it
  5881.                allows for four-dimensional addressing.
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.  
  5892.                        Squish v1.00 Reference Manual - Page 103
  5893.  
  5894.  
  5895.  
  5896.           archiver
  5897.  
  5898.                An archiver is a program used to compress files.  Archivers
  5899.                are very useful in a FidoNet environment, since compressing
  5900.                mail can reduce its size by up to 80%.
  5901.  
  5902.           ARCmail
  5903.  
  5904.                ARCmail refers to both a program from System Enhancement
  5905.                Associates and to a mail compression format.  Mail which is
  5906.                compressed using the ARC archiver is referred to as
  5907.                "ARCmail".  Similarly, mail compressed with ZIP is called
  5908.                "ZIPmail", mail compressed with LHarc is referred to as
  5909.                "LZHmail", and so on.
  5910.  
  5911.           ArcmailAttach
  5912.  
  5913.                An ArcmailAttach system is a mailer which requires "file
  5914.                attaches" to send compress mail bundles.  ArcmailAttach is
  5915.                not specific to the ARCmail compression method; it simply
  5916.                means that a different method is used for creating
  5917.                compressed mail bundles.  Mailers such as FrontDoor,
  5918.                InterMail, D'Bridge and Dutchie require the "ArcmailAttach"
  5919.                keyword in SQUISH.CFG.
  5920.  
  5921.           AREAS.BBS
  5922.  
  5923.                A ConfMail-compatible file containing a list of message
  5924.                directories, addresses, and area tags.  Squish can use
  5925.                AREAS.BBS, but areas must be declared in SQUISH.CFG to use
  5926.                some of Squish's advanced features.
  5927.  
  5928.           busy flag
  5929.  
  5930.                A semaphore file used in the BinkleyTerm outbound area. 
  5931.                Busy flags are used to ensure that two programs don't access
  5932.                the same file at the same time, when running in a
  5933.                multitasking or a network environment.
  5934.  
  5935.           crash
  5936.  
  5937.                A message flavour.  Crash means that a message should be
  5938.                sent directly to its destination, with no routing implied. 
  5939.                Crash usually implies "send it NOW".
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.                        Squish v1.00 Reference Manual - Page 104
  5949.  
  5950.  
  5951.  
  5952.           direct
  5953.  
  5954.                A message flavour.  Direct is identical to crash in all
  5955.                respects, except that the message will be governed by your
  5956.                mailer's event schedule.
  5957.  
  5958.           duplicate messages (dupes)
  5959.  
  5960.                A second copy of an EchoMail message.  When problems crop up
  5961.                in EchoMail topology, copies of old messages occasionally
  5962.                get dumped into the system.  Squish usually detects and
  5963.                stops most duplicate messages.
  5964.  
  5965.           EchoMail
  5966.  
  5967.                A message conferencing system originally devised by Jeff
  5968.                Rush.  Squish fully supports the EchoMail format.
  5969.  
  5970.           errorlevel
  5971.  
  5972.                An errorlevel is a number set by a DOS or OS/2 program when
  5973.                that program terminates.  This number can be later checked
  5974.                for in a batch or command file, and various actions can be
  5975.                taken based on that number.
  5976.  
  5977.           FD
  5978.  
  5979.                A synonym for FrontDoor.
  5980.  
  5981.           feed
  5982.  
  5983.                A "feed" is the system which sends you mail for a particular
  5984.                EchoMail area.
  5985.  
  5986.           flavour
  5987.  
  5988.                A 'flavour' is also known as a priority.  Flavours can be
  5989.                used to override other routing commands and to explicitly
  5990.                send mail directly to a given node.
  5991.  
  5992.           FroDo
  5993.  
  5994.                A synonym for FrontDoor.
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.                        Squish v1.00 Reference Manual - Page 105
  6005.  
  6006.  
  6007.  
  6008.           FrontDoor
  6009.  
  6010.                A mailer written by Joaquim Homrighausen and Advanced
  6011.                Engineering.
  6012.  
  6013.           front end
  6014.  
  6015.                A synonym for "mailer".
  6016.  
  6017.           FTS-0001
  6018.  
  6019.                A document describing the base level of FidoNet
  6020.                compatibility.  "FTS" is an acronym for "FidoNet Technical
  6021.                Standard".  Squish is compliant with FTS-0001.
  6022.  
  6023.           hold
  6024.  
  6025.                A message flavour indicating that the message in question
  6026.                should be placed on hold for pick-up.
  6027.  
  6028.           host-routed
  6029.  
  6030.                Host-routed means that the messages in question will be sent
  6031.                to the network host (net/0), as opposed to being sent
  6032.                directly to the destination.  Squish can optionally perform
  6033.                host routing.
  6034.  
  6035.           mailer
  6036.  
  6037.                A FidoNet-compatible program which answers the phone and
  6038.                interacts with other systems, which includes transferring
  6039.                files, messages, and system information.  Common mailers
  6040.                include BinkleyTerm, FrontDoor and D'Bridge.
  6041.  
  6042.           maximum message limit
  6043.  
  6044.                In Squish-format message areas, a limit can be set on the
  6045.                maximum number of messages to allow in a given area.  Once
  6046.                this limit is exceeded, messages will be purged from the
  6047.                beginning of the message area until the message count falls
  6048.                below the maximum.
  6049.  
  6050.           net
  6051.  
  6052.                As part of a 4D network address, a "net" is a small
  6053.                geographical area, usually encompassing a large city and the
  6054.                surrounding area.
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.                        Squish v1.00 Reference Manual - Page 106
  6061.  
  6062.  
  6063.  
  6064.           NetMail
  6065.  
  6066.                NetMail is a direct, point-to-point transfer of private
  6067.                messages.  NetMail is analogous to "Email".
  6068.  
  6069.           node
  6070.  
  6071.                As part of a 4D network address, a "node" is a single system
  6072.                or computer within a net.
  6073.  
  6074.           normal
  6075.  
  6076.                A message priority.  Normal-flavoured messages can be
  6077.                routed, but if no routing is applied, a normal message will
  6078.                be sent directly to its destination.
  6079.  
  6080.           origin line
  6081.  
  6082.                A control line near the bottom of an EchoMail message.  The
  6083.                origin line identifies the origination point of a message. 
  6084.                Most origin lines have the following form:
  6085.  
  6086.                * Origin: name (address)
  6087.  
  6088.                where "name" is a brief description of the system, and
  6089.                "address" is a full 4D network address.
  6090.  
  6091.           outbound areas (outbound directories)
  6092.  
  6093.                A set of directories used for storing outbound mail. 
  6094.                BinkleyTerm and Opus are the only common mailers which use
  6095.                outbound areas.
  6096.  
  6097.           point
  6098.  
  6099.                As part of a 4D network address, a "point" is a single user
  6100.                on an individual node.
  6101.  
  6102.           remap
  6103.  
  6104.                Remapping is the process of readdressing inbound messages
  6105.                based on the name in the "To:" field.  For example, messages
  6106.                are commonly remapped for points, since the point number may
  6107.                be occasionally omitted when specifying a system address.
  6108.  
  6109.  
  6110.  
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.                        Squish v1.00 Reference Manual - Page 107
  6117.  
  6118.  
  6119.  
  6120.           SEEN-BY
  6121.  
  6122.                A control line at the bottom of an EchoMail message.  SEEN-
  6123.                BYs are used to determine which systems have already been
  6124.                sent a particular message.
  6125.  
  6126.           SHARE.EXE
  6127.  
  6128.                A DOS program used to enable file locking.  SHARE must be
  6129.                loaded if you wish to use Squish-format message areas in a
  6130.                multitasking environment.
  6131.  
  6132.           StoneAge
  6133.  
  6134.                A term applied to the original *.PKT design.  StoneAge
  6135.                packets do not support zone or point information.  See also
  6136.                "2+" and "*.PKT".
  6137.  
  6138.           tear line
  6139.  
  6140.                A control line at the bottom of an EchoMail message.  A tear
  6141.                line is used to end the message body, and it usually
  6142.                contains a short, product-specific banner.  A tear line
  6143.                begins with three dashes, such as "--- Squish v1.00".
  6144.  
  6145.           wildcards
  6146.  
  6147.                Squish uses wildcards to specify multiple nodes for routing
  6148.                commands.  For more information, please see the section
  6149.                entitled "Wildcards".
  6150.  
  6151.           zone
  6152.  
  6153.                In a 4D network address, a "zone" is a wide geographical
  6154.                area, usually covering one continent or more.
  6155.  
  6156.           zonegate
  6157.  
  6158.                A zonegate is a system which sends EchoMail to more than one
  6159.                zone.  Squish is capable of acting as a zonegate.
  6160.  
  6161.  
  6162.  
  6163.  
  6164.  
  6165.  
  6166.  
  6167.  
  6168.  
  6169.  
  6170.  
  6171.  
  6172.                        Squish v1.00 Reference Manual - Page 108
  6173.  
  6174.  
  6175.  
  6176.                                         INDEX
  6177.  
  6178.           .MO?  . . . . . . . . . 59, 72                           107, 108
  6179.           -$  . . . . . . . .  69-71, 91     Address . . . . . . . . . . 19
  6180.           -$m . . . .  69, 70, 91-93, 96     alternate primary
  6181.           -$s . . . . . . . . . . 70, 96               address . 68, 69, 85
  6182.           -+  . . . . . . . . . . 69, 85     ARC . . .  27, 54, 60, 72, 104
  6183.           -0  . . . . . . . . . . . . 69     archive . . 16, 28-31, 33, 44,
  6184.           -a  . . . . . . . . . . 43, 51                57, 60, 72, 73, 74,
  6185.           -c  . . . . . . . . . . . . 43                                100
  6186.           -f  . . . . . . . . 43, 46, 68     archiver  . 7, 20, 28, 30, 60,
  6187.           -l  . . . . . . . . . . 42, 43                        72, 73, 104
  6188.           -o  . . . . . . . . 43, 44, 58     ARCmail .  38, 39, 41, 50, 51,
  6189.           -p  . . . . . . . . 39, 68, 85                56, 57, 59, 67, 74,
  6190.           -q  . . . . . . . . . . 44, 97                            84, 104
  6191.           -s  . . . . . . . . 44, 68, 77     ARCmail bombs . . . . . . . 84
  6192.           -x  . . . . . . . . . . 69, 84     area tag   13, 22, 23, 26, 47,
  6193.           -z  . . . . . . . . . . . . 44                             64, 67
  6194.           *.?LO . . . . . . . . . . . 80     Areafix . . . . . . . . . . 71
  6195.           *.?UT . . . . . . . . . . . 80     AREAS.BBS . 7, 16, 17, 19, 21,
  6196.           *.BAD . . . . . . . . . . . 83                 24-26, 43, 45, 47,
  6197.           *.FR? . . . . . . . . . . . 72                51, 59, 68, 71, 87,
  6198.           *.MO? . . . . . . . . . . . 72                        90, 91, 104
  6199.           *.MSG . . 6-8, 15, 22, 23, 25,     AreasBBS  . . . . . . . 19, 51
  6200.                      26, 47, 63, 67, 68,     ARJ . . . . . . . . . . 54, 72
  6201.                      89, 91, 92, 94, 95,     AUTOEXEC.BAT  . . . . . . . 18
  6202.                                      103     BAD_MSGS  . 22-24, 64, 67, 69,
  6203.           *.OUT . . . . . . . . . 12, 43                                 83
  6204.           *.PKT .  6, 11-13, 19, 40, 52,     batch file  . .  36-39, 57, 58
  6205.                         58, 69, 72, 103,     BINKLEY.EVT . . . . . . . . 36
  6206.                                      108     BinkleyTerm . 6-8, 11, 12, 16,
  6207.           *.SA? . . . . . . . . . . . 72                19, 20, 33, 36, 41,
  6208.           *.SQ? . . 6-8, 15, 47, 63, 67,                     43, 48, 50-53,
  6209.                      69, 70, 89, 92, 94,                  59-61, 67, 74-76,
  6210.                                  97, 103                    80-82, 87, 104,
  6211.           *.SQD . . . . . . . . . . . 93                           106, 107
  6212.           *.SU? . . . . . . . . . . . 72     BinkleyTerm 2.50  .  7, 52, 87
  6213.           *.TH? . . . . . . . . . . . 72     bossnode  .  7, 11, 49, 61, 87
  6214.           *.TU? . . . . . . . . . . . 72     busy flag . . . . . .  53, 104
  6215.           *.WE? . . . . . . . . . . . 72     Change  . . . . . . 75, 78, 81
  6216.           ^aFLAGS . . . . . . . . . . 59     comment . . . . . . . . . . 33
  6217.           ^aPATH  . . . . . . . . 68, 85     Compress  . . . . . . . . . 20
  6218.           <areaname>.XXD  . . . . . . 99     COMPRESS.CFG   16, 20, 60, 72,
  6219.           <areaname>.XXI  . . . . . . 99                                 73
  6220.           <areaname>.XXI. . . . . . . 99     CONFIG.SYS  . . . . . . 18, 19
  6221.           1.MSG . . . . . . . . . . . 41     ConfMail  . . . . . .  51, 104
  6222.           2+  . . .  7, 50, 88, 103, 108     crash . 12, 27-32, 34, 35, 49,
  6223.           4D   7, 11, 19, 32, 49-52, 61,                54, 55, 64, 76, 78,
  6224.                      62, 68, 75, 85, 87,                   79, 81, 89, 104,
  6225.                        88, 90, 103, 106,                                105
  6226.  
  6227.  
  6228.                        Squish v1.00 Reference Manual - Page 109
  6229.  
  6230.  
  6231.  
  6232.           D'Bridge  19, 50, 59, 87, 104,     LHarc . . . . . .  54, 72, 104
  6233.                                      106     link  .  37, 38, 41-43, 46, 83
  6234.           decompress  . . 16, 36, 38, 52     mailer  .  11, 27, 29, 31, 33,
  6235.           direct  12, 27-29, 55, 64, 81,                 36-38, 50, 53, 57,
  6236.                             92, 105, 107                59, 82, 84, 104-106
  6237.           Dos . . . . . . . . . . . . 77     mailers .  12, 13, 31, 50, 51,
  6238.           dupe  . . . . . . . . . . . 48                    55, 74, 82, 87,
  6239.           DUPES . . . . . .  56, 66, 105                      104, 106, 107
  6240.           duplicate  53, 54, 56, 67, 91,     MAX_MSGS.DAT  . . . . . . . 58
  6241.                                      105     maximum message limit . 89-91,
  6242.           dynamic packing . . . . 50, 74                            96, 106
  6243.           dynamic routing .  29, 33, 51,     Maximus  5, 6, 13, 16, 20, 36,
  6244.                                   74, 82                 38, 57, 90, 91-93,
  6245.           ECHOTOSS.LOG  . 39, 41, 43, 46                           102, 103
  6246.           errorlevel  36-39, 57, 58, 97,     multi-line  . . . .  7, 43, 53
  6247.                                 102, 105     multi-zone  . . . .  6, 20, 68
  6248.           EXCEPT  . 2-4, 37, 39, 42, 55,     multipass  40, 43, 46, 53, 57,
  6249.                          56, 81, 97, 105                        58, 63, 102
  6250.           exceptions  . . . . . . 55, 56     name wildcards  . . . . . . 62
  6251.           fakenet  7, 49, 61, 62, 87, 88     NEC . . . . . . . . . . . . 57
  6252.           FD  . . . . .  16, 37, 38, 105     net . . .  10, 11, 19, 22, 25,
  6253.           feed  14, 25, 26, 85, 100, 105                 30-34, 42, 50, 61,
  6254.           FidoNet . 5, 6, 10, 11, 13-15,                65, 69, 75, 78, 81,
  6255.                      19, 34, 54, 56, 60,                  82, 87, 100, 103,
  6256.                         65, 87, 89, 103,                           106, 107
  6257.                                 104, 106     NetMail . . .  11, 13, 14, 19,
  6258.           file attaches  20, 48, 50, 51,                 22-24, 27, 33, 34,
  6259.                      56, 67, 75, 81, 104                36, 38, 39, 41, 42,
  6260.           file requests . . . . . 51, 56                    44, 48, 50, 51,
  6261.           flavour  12, 27-31, 33-35, 48,                 54-59, 62, 65, 67,
  6262.                      49, 55, 74, 75, 81,                   86, 88, 92, 102,
  6263.                              82, 104-106                                107
  6264.           front end . . . .  15, 19, 106     NoArc . . . 58, 75, 76, 82, 84
  6265.           FrontDoor .  6, 8, 11, 16, 19,     node  .  6, 7, 10, 11, 15, 19,
  6266.                       20, 36-38, 41, 50,                 25, 26, 28, 29-34,
  6267.                        82, 87, 104, 105,                 41, 42, 44, 48-50,
  6268.                                      106                  52-55, 60-62, 64,
  6269.           FTS-0001  . .  55, 68, 89, 106                65, 68, 69, 71, 72,
  6270.           gateroute . . . . . 51, 55, 56                 74, 75, 79-85, 87,
  6271.           gaterouting . . . . . . 55, 56                 88, 100, 101, 103,
  6272.           global section  27, 28, 74, 77                           105, 107
  6273.           hold  .  8, 12, 22, 27-29, 46,     NoPkt . . . . . . . . . 58, 84
  6274.                      48, 49, 55, 63, 64,     normal   1, 12, 13, 21, 27-31,
  6275.                          78, 79, 81, 106                33, 34, 48, 49, 55,
  6276.           host-routed . . . . . . .  106                 56, 68, 74-76, 81,
  6277.           HostRoute . . . . . . . 81, 82                82, 83, 88, 97, 98,
  6278.           Imail . . . . . . . . . . . 87                                107
  6279.           InterMail . .  19, 50, 87, 104     Opus 1.03 . . . . . . . . . 59
  6280.           label . . . . . . . . . 37, 38     origin line .  21, 25, 26, 47,
  6281.           LAN . . . . . . . . . . . . 90                        59, 61, 107
  6282.  
  6283.  
  6284.                        Squish v1.00 Reference Manual - Page 110
  6285.  
  6286.  
  6287.  
  6288.           OS/2  . . 2, 7, 8, 77, 91, 105                             72, 74
  6289.           OUT . 4, 6, 7, 10, 12, 13, 16,          Unleave  . . . . . . . 80
  6290.                       19, 27, 34, 36-46,     routing . . 6, 10, 12, 16, 20,
  6291.                      48, 52, 53, 57, 58,                    24, 25, 27, 28,
  6292.                      63, 64, 69, 75, 76,                 29-31, 33, 34, 36,
  6293.                          82, 87, 93, 102                41, 49, 51, 54, 63,
  6294.           outbound area . 6, 19, 20, 43,                64, 74, 76-82, 104,
  6295.                      44, 48, 53, 75, 76,                            105-108
  6296.                               80-82, 104     scan  . 13, 30, 36, 38-46, 48,
  6297.           outbound directories   51, 53,                58, 59, 62, 75, 95,
  6298.                                  80, 107                                100
  6299.           OUTBOUND.###  . . . . . . . 20     schedule   27, 44, 74, 77, 78,
  6300.           OUTBOUND.SQ .  42, 43, 51, 58,                                105
  6301.                                       59     SEAdog  . . . . . . . . . . 55
  6302.           packet  . 7, 8, 11-13, 27, 30,     secure mode . . . . 44, 53, 83
  6303.                      41, 44, 46, 50, 53,     security   53, 61, 63, 67, 69,
  6304.                      57, 58, 60, 63, 75,                             83, 84
  6305.                              83, 88, 103     SEEN-BY . . .  63, 88, 90, 108
  6306.           PAK . . . . . . . . . . 54, 72     semaphore . . . . . . . .  104
  6307.           passthru  .  6, 25, 40, 43-45,     SHARE.EXE . . . . . .  18, 108
  6308.                                   47, 69     single pass . . 40-42, 46, 57,
  6309.           point  6, 7, 9-11, 19, 25, 26,                             63, 69
  6310.                       30, 49, 50-52, 57,     soundex . . . . . . . .  7, 62
  6311.                      61, 62, 65, 68, 75,     split area  . . . . . . . . 71
  6312.                         85, 87, 88, 100,     SQCONVER  . . . . . . . . . 94
  6313.                            103, 107, 108     SQFIX . . . . . . . 89, 98, 99
  6314.           point directory . . . . . .  7     SQINFO  . . . . . . . . 97, 98
  6315.           primary address .  25, 49, 50,     SQPACK  . . . . . .  69, 91-93
  6316.                               68, 69, 85     SQREIDX . . . . . . . . . . 98
  6317.           private messages   10, 69, 107     SQSET . . . . . . . . . . . 96
  6318.           quiet mode  . . . . . . . . 44     SQUASH  37-39, 41, 42, 44, 46,
  6319.           remapper  . . . . .  7, 62, 88                51, 53, 57, 58, 59,
  6320.           reply chains  . . . 38, 41, 42                    74, 77, 78, 102
  6321.           RESCAN  . . . . . . . . 41, 42     SQUISH  1-9, 11, 13-22, 24-34,
  6322.           root filename  47, 67, 69, 90,                 36-65, 67-106, 108
  6323.                                94, 96-99     SQUISH.CFG  .  16, 17, 19, 22,
  6324.           ROUTE.CFG . 16, 27-31, 33, 39,                    24, 25, 30, 31,
  6325.                      51, 55, 63, 72, 74,                  43-45, 47-50, 59,
  6326.                              77, 78, 100                    60, 68, 71, 72,
  6327.                Define .  10, 16, 24, 48,                 83-88, 90, 91, 96,
  6328.                               67, 72, 76                           100, 104
  6329.                Leave  . . 20, 42, 43, 80          AddMode  . . . . . . . 48
  6330.                Poll . . . . . . . 79, 81          Address  . . . . . 49, 86
  6331.                Route  12, 16, 27-35, 39,          AddToSeen  . . . . . . 50
  6332.                      42, 48, 49, 51, 55,          ArcmailAttach  .  19, 27,
  6333.                       63, 72, 74-78, 81,                29, 31, 33, 50, 51,
  6334.                         82, 100, 29, 30,                57, 59, 60, 67, 74,
  6335.                               72, 75, 76                        80, 82, 104
  6336.                Sched   28, 44, 74, 77-79          BadArea  . . . . . 22, 67
  6337.                Send . 28-30, 34, 35, 48,          BatchUnarc . . . . . . 52
  6338.  
  6339.  
  6340.                        Squish v1.00 Reference Manual - Page 111
  6341.  
  6342.  
  6343.  
  6344.                BinkPoint  . . . . 51, 52     SSTAT.CFG . . . . . . 100, 101
  6345.                Buffers  . . . . . . . 52     StoneAge  . . . . . . 103, 108
  6346.                BusyFlags  . . . . . . 53     tag . . 13, 22-26, 41, 47, 64,
  6347.                CheckZones . . . . . . 53                67, 68, 77, 78, 100
  6348.                Compress . . . 20, 54, 72     tear line . . . . . . . .  108
  6349.                DefaultPacker  .  54, 60,     toss   22, 36, 38, 40, 42, 46,
  6350.                                   72, 54                     52, 58, 64, 83
  6351.                DupeArea . . . . . . . 67     TosScan . . . . . . . . . . 87
  6352.                Duplicates . . . . 53, 54     update requests . . . . 51, 56
  6353.                EchoArea  24, 25, 49, 64,     wildcard  . . . . . . . 30, 31
  6354.                       67, 71, 84, 85, 91     World  10, 11, 30, 31, 33, 35,
  6355.                ForwardFrom  . . . 54, 55                             62, 82
  6356.                ForwardTo  . . . . 54, 55     ZIP . . . . . . .  27, 72, 104
  6357.                GateRoute  . . 51, 55, 56     zone  .  6, 7, 10, 11, 19, 20,
  6358.                KillBlank  . . . . . . 56                25, 30, 31, 32, 49,
  6359.                KillDupes  . . . . 56, 67                53, 55, 56, 65, 68,
  6360.                KillIntransit  . . . . 56                75, 78, 79, 85, 94,
  6361.                LogFile  . . . 20, 57, 65                      100, 103, 108
  6362.                MaxAttach  . . . . 53, 57     zoned outbound
  6363.                MaxMsgs   41, 44, 57, 58,               directories . 51, 53
  6364.                                      102     zonegating  . . . . . . . . 65
  6365.                MaxPkt . . . . . . 53, 58     ZOO . . . . . . . . . . 54, 72
  6366.                NetArea  . . . 22, 51, 67
  6367.                NetFile  . 19, 40, 58, 84
  6368.                Nuke . . . . . . . . . 59
  6369.                OldArcmailExts . . . . 59
  6370.                Origin . . 21, 24-26, 47,
  6371.                          59, 61, 85, 107
  6372.                Outbound . 6, 19, 20, 27,
  6373.                       31, 41-44, 46, 48,
  6374.                       49, 51, 53, 57-60,
  6375.                       63, 75, 76, 80-82,
  6376.                         85, 88, 104, 107
  6377.                Pack . . . . . . . 54, 60
  6378.                Password . . . . . 61, 83
  6379.                PointNet . . . 49, 61, 87
  6380.                QuietArc . . . . . . . 61
  6381.                Remap  .  48, 62, 88, 107
  6382.                SaveControlInfo  . . . 63
  6383.                Secure .  44, 53, 59, 63,
  6384.                                   83, 84
  6385.                Statistics .  44, 57, 63,
  6386.                                  93, 100
  6387.                StripAttributes  . . . 64
  6388.                Swap . . . . . . .  7, 64
  6389.                TinySeenBys  . . . . . 64
  6390.                TossBadMsgs  . . . . . 64
  6391.                ZoneGate . .  55, 65, 108
  6392.           SSTAT . . . . . . 63, 100, 101
  6393.                Track  . . .  40, 65, 100
  6394.  
  6395.  
  6396.                        Squish v1.00 Reference Manual - Page 112