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