home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / btos232.lzh / BT_USER.DOC < prev    next >
Text File  |  1989-09-04  |  173KB  |  3,508 lines
  1.           
  2.           
  3.           
  4.           
  5.           
  6.           ****   *         *      *             *******                 TM
  7.           *   *            *      *                *
  8.           *   *  *  * **   *   *  *   ***   *   *  *   ***   * **  *** **  
  9.           ****   *  **  *  *  *   *  *   *  *   *  *  *   *  **    *  *  * 
  10.           *   *  *  *   *  ***    *  ****   *   *  *  ****   *     *  *  * 
  11.           *   *  *  *   *  *  *   *  *      *   *  *  *      *     *  *  * 
  12.           ****   *  *   *  *   *  *   ****   ****  *   ****  *     *  *  * 
  13.                                                 *
  14.           Version 2.30 - User's Guide           *        September 4, 1989
  15.                                              ***
  16.           
  17.           
  18.           
  19.           
  20.                   A Freely Available FidoNet Compatible Electronic
  21.                       Mail Interface and Dumb Terminal Package
  22.           
  23.           
  24.           
  25.           
  26.                  Software Written by Vince Perriello and Bob Hartman
  27.                      Documentation Written by Alan D. Applegate
  28.           
  29.           
  30.           
  31.           
  32.                   Copyright (C) 1988, 1989 Bit Bucket Software, Co.
  33.                                A Delaware Corporation
  34.                                  All Rights Reserved
  35.           
  36.                       Terms and Conditions Contained Separately
  37.           
  38.           
  39.           
  40.           
  41.                               Bit Bucket Software, Co.
  42.                             427-3 Amherst St., Suite 232
  43.                                   Nashua, NH 03063
  44.           
  45.           
  46.           
  47.           
  48.                         "BinkleyTerm" and "Freely Available"
  49.                      are trademarks of Bit Bucket Software, Co.
  50.           
  51.           
  52.           
  53.           
  54.           
  55.  
  56.                 BinkleyTerm Version 2.30 - User's Guide - Page 2
  57.  
  58.           TABLE OF CONTENTS
  59.           
  60.           Section 1 - General Information                             4
  61.                How to Use This Manual                                 4
  62.                Acknowledgements                                       5
  63.                Kudos                                                  6
  64.                Forward                                                7
  65.                Introduction                                           8
  66.                General Requirements                                   9
  67.                Memory Requirements                                    9
  68.                Modem Requirements                                     10
  69.           
  70.           Section 2 - Operation as a Terminal Communications Program  11
  71.                Terminal Mode Overview                                 11
  72.                VT-100 Emulation                                       12
  73.                External Protocols                                     12
  74.           
  75.           Section 3 - Operation as a Automated Electronic Mailer      13
  76.                Unattended Mode Overview                               13
  77.                The BinkleyTerm Concept                                14
  78.                How BinkleyTerm Handles Mail                           14
  79.                     Idea #1                                           14
  80.                     Idea #2                                           15
  81.                     Idea #3                                           15
  82.                     Idea #4                                           15
  83.                     A Sample Message, Start to Finish                 17
  84.                     The Concept of Cost                               18
  85.                     Alternative Method                                18
  86.                Windowed Interface                                     19
  87.                     Current Settings                                  19
  88.                     Today at a Glance                                 19
  89.                     Pending Outbound Mail                             20
  90.                     Recent Activity                                   21
  91.                     Transfer Status                                   21
  92.                Control                                                21
  93.                     Errorlevels and Batch Files                       22
  94.                     What is an Errorlevel?                            23
  95.                     What Errorlevels BinkleyTerm Produces             24
  96.                     Making Errorlevels Work for You                   26
  97.                     Errorlevels, Batch Files and ExtrnMail            26
  98.                     Errorlevels, Batch Files and Housekeeping         26
  99.                     DOS Shell Keys                                    26
  100.                     Using Errorlevels                                 27
  101.                     What Now?                                         27
  102.                     Errorlevel and Batch File Hints and Kinks         28
  103.                     Environment Variable                              30
  104.                Configuration File                                     30
  105.                     BTCTL                                             30
  106.                Nodelist                                               31
  107.                     FIDOUSER.LST                                      31
  108.                     Version 5 Nodelist                                32
  109.                     Version 6 Nodelist                                32
  110.  
  111.  
  112.                 BinkleyTerm Version 2.30 - User's Guide - Page 3
  113.  
  114.                     QuickBBS Nodelist                                 32
  115.                     TBBS Nodelist                                     33
  116.                     Nodelist Support Information                      33
  117.                Zone Support                                           34
  118.                Multiple Network Operation                             35
  119.                Security                                               35
  120.                     Prot                                              36
  121.                     Known                                             36
  122.                     Default                                           36
  123.                     Security - Session Passwording                    36
  124.                     Security - Secured Inbound File Areas             37
  125.                     Security - Controlling File Requests              38
  126.                     Security - Response File Templates                39
  127.                BBS Interface                                          39
  128.                     BBS Exit                                          39
  129.                     BBS Spawn                                         40
  130.                     BBS Batch                                         40
  131.                     BBS Batch Method Flowchart                        42
  132.                     Banner                                            42
  133.                External Mail Programs                                 43
  134.                User-Selected BBS Functionality                        43
  135.                File Requests                                          45
  136.                Update Requests                                        47
  137.                Request Response Files                                 48
  138.                Function Requests                                      49
  139.                     $ Function Requests                               49
  140.                     + Function Requests                               50
  141.                     Function Request Notes                            50
  142.                A Word About Point Networks                            51
  143.           
  144.           Section 4 - Problem Solving                                 52
  145.                BinkleyTerm Support                                    52
  146.                Troubleshooting                                        52
  147.                     Baud Rate Locking Trouble                         52
  148.                     Outward Dial Aborting                             52
  149.                     False Call Collision Reports                      53
  150.                     FOSSIL Driver Compatibility Problems              53
  151.                     BinkleyTerm Will Not Recognize Node Address       53
  152.                     TBBS Difficulty - BinkleyTerm Runtime Errors      53
  153.                     DOS Shells Not Working Correctly                  53
  154.                     Zone Support Does Not Operate Correctly           54
  155.                     Date Rollover Problem                             54
  156.                Glossary                                               54
  157.           
  158.           
  159.                               
  160.           
  161.           
  162.           
  163.           
  164.           
  165.           
  166.           
  167.           
  168.  
  169.                 BinkleyTerm Version 2.30 - User's Guide - Page 4
  170.  
  171.           +-------------+
  172.           | +---------+ |
  173.           | | Section | |   BinkleyTerm User's Guide
  174.           | |    1    | |   GENERAL INFORMATION
  175.           | +---------+ |
  176.           +-------------+
  177.           
  178.           HOW TO USE THIS MANUAL
  179.           
  180.           The documentation for BinkleyTerm is supplied in two parts.  
  181.           
  182.           The User's Guide (named BT_USER.DOC) explains how to install
  183.           BinkleyTerm.  It also describes basic operational procedures. 
  184.           New users may find some concepts or terminology unfamiliar; a
  185.           glossary is provided toward the end of the User's Guide.  
  186.           
  187.           Concepts and terminology that may be of interest to experienced
  188.           users and new users alike are covered in the Reference Guide
  189.           (named BT_REF.DOC) an alphabetically arranged manual separate
  190.           from the User's Guide. 
  191.           
  192.           For inquiries, questions or comments regarding BinkleyTerm,
  193.           please refer to the User's Guide section "BinkleyTerm Support." 
  194.           
  195.           Some material in the section "How BinkleyTerm Handles Mail" is
  196.           excerpted from MATRIX.DOC, and is Copyright (C) 1987 Wynn Wagner
  197.           III, All Rights Reserved.  Used by permission.
  198.           
  199.           Some material in the section "Control" was written by Ron
  200.           McKenzie, and is Copyright (C) 1989 Ron McKenzie, All Rights
  201.           Reserved.  Used by permission.
  202.           
  203.           
  204.           
  205.           
  206.           
  207.           
  208.           
  209.           
  210.           
  211.           
  212.           
  213.           
  214.           
  215.           
  216.           
  217.           
  218.           
  219.           
  220.           
  221.           
  222.           
  223.           
  224.           
  225.  
  226.                 BinkleyTerm Version 2.30 - User's Guide - Page 5
  227.  
  228.           ACKNOWLEDGEMENTS
  229.           
  230.           The following names are either trademarks, registered trademarks,
  231.           and/or the efforts of the person and/or company named:
  232.           
  233.           Fido, FidoNet - Tom Jennings, Fido Software
  234.           MS-DOS, Microsoft C - Microsoft Corporation
  235.           IBM, PC-DOS - International Business Machines Corporation
  236.           Opus-CBCS, ZedZap, YooHoo, WaZOO, OpusNode - Wynn Wagner III
  237.           ARC, SEAdog, SEAlink, XlatList, ARCmail, GroupMail - Thom
  238.                Henderson, System Enhancement Associates, Inc.
  239.           VT-100, DEC, DEC Rainbow, VAX, VMS - Digital Equipment
  240.           Corporation
  241.           FANSI-CONSOLE - Hersey Micro Consulting
  242.           Hayes - Hayes Microcomputer Products Corporation
  243.           Zmodem - Chuck Forsberg, Omen Technologies, Inc.
  244.           ConfMail, ParseLst, oMMM, Opus!Comm - Bob Hartman, Spark
  245.                Software, Inc. 
  246.           oMMM - BS Software, Marshall Presnell, Jim Nutt
  247.           msged - Jim Nutt
  248.           XlaxNode - Scott Samet
  249.           Heath/Zenith - Heath/Zenith Electronics, Inc. 
  250.           Sanyo - Sanyo Electric Co. (Japan) Ltd.
  251.           DoubleDOS - SoftLogic Solutions, Inc. 
  252.           DESQview - Quarterdeck Office Systems, Inc. 
  253.           Telix - Colin Sampaleanu, Exis Inc.
  254.           Sirius - Bob Klahn, Micro Solutions 
  255.           OOPS - Tom Kashuba 
  256.           AMAX - Alan Applegate 
  257.           Dutchie - Henk Wevers 
  258.           PC Pursuit - GTE/Telenet 
  259.           EchoMail - Jeff Rush 
  260.           ProComm - Datastorm Technologies, Inc. 
  261.           Qmodem - The Forbin Project 
  262.           TBBS - Phil Becker, eSoft, Inc.
  263.           QuickBBS - Adam Hudson 
  264.           X00 - Ray Gwinn, RENEX Corporation 
  265.           DECCOMM - Vince Perriello, VEP Software
  266.           Atari, ST - Atari, Inc.
  267.           Commodore, Amiga -  Commodore International
  268.           USRobotics, HST - USRobotics, Inc.
  269.           RBBS-PC - Capital PC Users Group, Thomas J. Mack
  270.           FrontDoor - Joaquim Homrighausen
  271.           D'Bridge - Chris Irwin
  272.           
  273.           Every effort has been made to identify and give credit for
  274.           trademarks mentioned in this documentation.  Any failure to
  275.           mention a particular trademark in the above list that may be
  276.           found in the text, or failure to give proper credit for a
  277.           particular trademark, constitutes merely an oversight and should
  278.           not be construed as intentional, or in any way a claim of rights
  279.           to the trademark.
  280.           
  281.           PLEASE NOTE!  Throughout this documentation, the mention of any
  282.  
  283.                 BinkleyTerm Version 2.30 - User's Guide - Page 6
  284.  
  285.           particular software package or system should not be construed as
  286.           an endorsement of any kind on the part of the authors.
  287.           
  288.           KUDOS
  289.                    
  290.           A number of people have been involved in the creation,
  291.           development and testing of this program, or have contributed to
  292.           it in one way or another.
  293.           
  294.           Tom Jennings, of course, gets credit for creating the beast that
  295.           brought us all together and defining the basic method of mail
  296.           transfer that we still use.  Wynn Wagner gets our thanks for
  297.           releasing source code for his file transfer routines and sending
  298.           some of his WaZOO source code as well for inclusion.  Thom
  299.           Henderson gets a humble tip of the hat for SEAdog, the
  300.           prototypical mail-only front-end which was the basis for our
  301.           front-end design, and for SEAlink, his extension of Xmodem/Telink
  302.           which doubled the speed of network mail transfers overnight. 
  303.           Chuck Forsberg of Omen Technologies gets our thanks for
  304.           developing and implementing the original Zmodem protocol.
  305.           
  306.           Then there are the guys who have put to the test everything the
  307.           authors thought would be worthwhile, the BinkleyTerm Beta Test
  308.           Team, members both past and present.  Without you, who knows what
  309.           we'd have wound up with.
  310.           
  311.           
  312.           
  313.           
  314.           
  315.           
  316.           
  317.           
  318.           
  319.           
  320.           
  321.           
  322.           
  323.           
  324.           
  325.           
  326.           
  327.           
  328.           
  329.           
  330.           
  331.           
  332.           
  333.           
  334.           
  335.           
  336.           
  337.           
  338.           
  339.  
  340.                 BinkleyTerm Version 2.30 - User's Guide - Page 7
  341.  
  342.           FORWARD
  343.           
  344.           There is no question that BinkleyTerm is an extremely powerful
  345.           communications tool.  We also make no secret of the fact that
  346.           BinkleyTerm is an extremely complex communications tool.  
  347.           
  348.           A set of documentation the size of an unabridged dictionary
  349.           (about 150mm thick or so) would still not address every possible
  350.           use of BinkleyTerm in every possible environment.  BinkleyTerm
  351.           can run on a number of personal computer platforms - a total of
  352.           several thousand brands and models.  Hundreds of different modems
  353.           can be used.  It works with several operating environments such
  354.           as DESQview and DoubleDOS.  In addition, BinkleyTerm is designed
  355.           with an open architecture, so it can be used with several BBS
  356.           packages, nodelist processors, mail processors, editors, and so
  357.           on.  BinkleyTerm "ports" have been made for entirely different
  358.           platforms such as the Atari ST, Commodore Amiga and VAX/VMS based
  359.           systems.  You begin to get the scope of what's involved.
  360.           
  361.           This documentation attempts to cover fairly broad generalities in
  362.           configuring and operating BinkleyTerm.  It cannot and will not
  363.           cover all possibilities or circumstances.  Hopefully it will
  364.           serve as a starting point - a ground level from which you may
  365.           grow and expand.  Further, this documentation describes only the
  366.           version of BinkleyTerm provided by the original authors - that
  367.           which runs in the PC-DOS/MS-DOS environment.
  368.           
  369.           Most of the enjoyment of the electronic mail hobby comes from
  370.           trying new things - tweaking the system.  Although BinkleyTerm is
  371.           a dependable, powerful program that is not especially difficult
  372.           to get going, it does provide ample opportunity to experiment and
  373.           have fun.  
  374.           
  375.           Still, if you're looking for something that will meld itself into
  376.           your computer in just a few minutes and work without modification
  377.           forever more, BinkleyTerm should probably not be your first
  378.           choice.  In exchange for a little complexity, we give you power
  379.           and an incredible amount of configurability and compatibility.
  380.           
  381.           If you become frustrated with BinkleyTerm, call on others in your
  382.           area who have configured it for an environment similar to yours. 
  383.           We estimate that several thousand people around the world are
  384.           BinkleyTerm users, and someone close to you in your network no
  385.           doubt runs BinkleyTerm.  With an architecture as open as that of
  386.           BinkleyTerm, your best source of information is someone who has
  387.           the benefit of time and experience configuring it.  Of course,
  388.           you will eventually become an expert yourself!  Enjoy it, and
  389.           delight in the wonder of technology.
  390.           
  391.                Alan D. Applegate,
  392.                Vice-President,
  393.                Bit Bucket Software, Co.
  394.           
  395.           
  396.  
  397.                 BinkleyTerm Version 2.30 - User's Guide - Page 8
  398.  
  399.           INTRODUCTION
  400.           
  401.           BinkleyTerm is an advanced, state-of-the-art telecommunications
  402.           tool.  It is primarily designed for the semi-automated sending
  403.           and receiving of electronic mail and files within FidoNet-
  404.           compatible electronic mail networks.
  405.           
  406.           When used as a mailer, BinkleyTerm is designed to communicate
  407.           with any FidoNet-compatible mail interface or BBS package.  The
  408.           program uses standard FidoNet protocol, as well as certain
  409.           modified protocols supported by programs such as SEAdog and Opus-
  410.           CBCS.  It also offers easy-to-use event scheduling, single
  411.           keystroke spawning to other programs (DOS shell), excellent
  412.           support for high speed modems, advanced session recovery, inbound
  413.           call collision detection, and much more. 
  414.           
  415.           When used as a dumb terminal, BinkleyTerm offers a rich selection
  416.           of file transfer protocols for exchanging files with a host
  417.           system.  The program also offers keyboard macros, optional VT-100
  418.           emulation, echoing of the on-line session to a flat text file or
  419.           printer, support for baud rates of 300 to 38,400 and more. 
  420.           
  421.           BinkleyTerm can be used as a dumb terminal program exclusively,
  422.           as a mail interface for a Point system, or as a front end mail
  423.           interface for an electronic bulletin board system (BBS).
  424.           
  425.           Mail interface and dumb terminal operations can be switched in
  426.           and out with a minimum of effort providing dual functionality. 
  427.           
  428.           BinkleyTerm is one of several software packages to utilize the
  429.           FOSSIL standard communications driver.  This standard allows for
  430.           consistent console (keyboard and screen) and communications port
  431.           I/O operations.  By using a FOSSIL driver, BinkleyTerm is capable
  432.           of running on practically any MS-DOS/PC-DOS capable machine, even
  433.           those that are not 100% IBM hardware compatible. 
  434.           
  435.           BinkleyTerm endeavors to provide you with the widest possible
  436.           variety of advanced features, combined with solid and efficient
  437.           operation in a wide range of hardware environments.  
  438.           
  439.           
  440.           
  441.           
  442.           
  443.           
  444.           
  445.           
  446.           
  447.           
  448.           
  449.           
  450.           
  451.           
  452.           
  453.  
  454.                 BinkleyTerm Version 2.30 - User's Guide - Page 9
  455.  
  456.           GENERAL REQUIREMENTS
  457.           
  458.                - A personal computer running MS-DOS or PC-DOS, with at
  459.                least 256k of available RAM.
  460.           
  461.                - MS-DOS or PC-DOS, Version 2.10 or greater, Version 3.20 or
  462.                higher preferred.
  463.           
  464.                - An auto-dial, auto-answer modem; should be mostly "Hayes
  465.                compatible."  See "Modem Requirements" below.
  466.           
  467.                - A FOSSIL driver designed for your particular hardware.
  468.           
  469.                - One 360k floppy disk drive (Terminal Mode).
  470.           
  471.                - At least two 360k floppy disk drives, more space and/or
  472.                hard disk recommended (Unattended Mode).
  473.           
  474.                - Basic knowledge of computer-based telecommunications,
  475.                without which you would have no need for BinkleyTerm.
  476.           
  477.           Please note that when using BinkleyTerm as a front-end mailer for
  478.           a BBS system, a hard disk is required.  The more space you have
  479.           for such an operation, the better off you'll be.
  480.           
  481.           You will also need various utilities and adjunct programs, which
  482.           vary with your application.
  483.           
  484.           MEMORY REQUIREMENTS
  485.           
  486.           BinkleyTerm requires approximately 185k of RAM in any operational
  487.           mode with the non-overlay version (BTBIG.EXE) and somewhat less
  488.           for overlay version (BT.EXE).  When used for Unattended Mode,
  489.           additional memory sufficient to hold the nodelist index file
  490.           (usually NODELIST.IDX) will also be required.  Keep in mind that
  491.           a small amount of overhead will also be required to accommodate a
  492.           FOSSIL driver, as well as a VFOSSIL if one is used.  At least a
  493.           512k system is recommended when using DOS shells, or when
  494.           BinkleyTerm is used in a multi-tasking environment.  BinkleyTerm
  495.           should, however, be completely functional even on a system with
  496.           only 256k of RAM.
  497.           
  498.           BinkleyTerm is not currently capable of taking direct advantage
  499.           of extended (AT style) or expanded (EEMS, EMS 4.0) memory, and
  500.           having such memory installed will not be of direct benefit to
  501.           BinkleyTerm. Some multi-taskers, such as DESQview, are able to
  502.           take advantage of such memory to BinkleyTerm's ultimate benefit. 
  503.           Please note, however, that when using the 'SwapDir' configuration
  504.           file statement, a RAM disk with at 150k of available space is
  505.           highly recommended for efficient operation.  Typically RAM disks
  506.           can be placed in extended or expanded memory.  Refer to the
  507.           Reference Guide section "Configuration File" for details on the
  508.           'SwapDir' statement and its use.
  509.           
  510.  
  511.                BinkleyTerm Version 2.30 - User's Guide - Page 10
  512.  
  513.           When used as a front end mailer for a BBS system, it is HIGHLY
  514.           RECOMMENDED that the 'BBS Batch' method of accessing your BBS be
  515.           implemented for the most efficient use of memory.  Please refer
  516.           to the applicable sections of the documentation for further
  517.           information.
  518.           
  519.           MODEM REQUIREMENTS
  520.           
  521.           A modem that is generally "Hayes compatible" is required for
  522.           BinkleyTerm operation.  Such modems are typically referred to as
  523.           "smart" modems.  Most popular, late model modems you're apt to
  524.           own meet this requirement.  Since you configure the various modem
  525.           command strings, the modem does not need to be 100% Hayes "AT"
  526.           command set compatible, but it does need to use the "AT" style of
  527.           issuing modem commands.
  528.           
  529.           Most smart modems are capable of returning VERBAL (full words) or
  530.           NUMERIC (numbers only) response codes; the modem must be
  531.           configured in such a way as to use the VERBAL codes ONLY.
  532.           
  533.           BinkleyTerm can be operative if the modem supports just one modem
  534.           response string - CONNECT.  (See below for qualifications
  535.           required of the CONNECT string.)
  536.           
  537.           BinkleyTerm has been programmed to handle and respond
  538.           appropriately to the following modem response strings:  NO
  539.           ANSWER, BUSY, RING, VOICE, NO DIAL TONE, NO DIALTONE, ERROR, NO
  540.           CARRIER, DIAL TONE and DIALING.
  541.           
  542.           The following response strings are recognized, but are ignored: 
  543.           RRING, RINGING and RING RESPONSE.
  544.           
  545.           With the exception of the CONNECT response, any other data
  546.           provided by the modem after a given response string is ignored. 
  547.           For example, "NO CARRIER DETECTED" would be handled in the same
  548.           manner as a "NO CARRIER" response.
  549.           
  550.           Since BinkleyTerm uses the CONNECT string to determine connection
  551.           baud rates, the modem should be capable of sending such strings. 
  552.           Generally, CONNECT is a default, and indicates a 300 baud
  553.           connection.  Other possible connections should be CONNECT 1200
  554.           for a 1200 baud connection, CONNECT 2400 for a 2400 baud
  555.           connection, and so on, up to the maximum supported speed.
  556.           
  557.           Note also that BinkleyTerm recognizes the response CONNECT 1275
  558.           for split-speed modems.
  559.           
  560.           If you are experiencing modem difficulties, try one or all of the
  561.           following configuration file statements:  'SlowModem', 'SameRing'
  562.           and/or 'NoCollide'.  Additionally, not all modems are capable of
  563.           using the 'Answer' statement and its related modem configuration. 
  564.           Explanations of all these statements can be found in the
  565.           Reference Guide section, "Configuration File."
  566.           
  567.  
  568.                BinkleyTerm Version 2.30 - User's Guide - Page 11
  569.  
  570.           +-------------+
  571.           | +---------+ |
  572.           | | Section | |   BinkleyTerm User's Guide
  573.           | |    2    | |   OPERATION AS A TERMINAL COMMUNICATIONS PROGRAM
  574.           | +---------+ |
  575.           +-------------+
  576.           
  577.           TERMINAL MODE OVERVIEW
  578.           
  579.           This section describes the installation and operation of
  580.           BinkleyTerm in the Terminal Mode.
  581.           
  582.           BinkleyTerm's Terminal Mode offers functionality similar to that
  583.           provided by programs such as Telix, ProComm or Qmodem.  You can
  584.           use your computer and modem to call out to on-line services and
  585.           electronic bulletin board systems (BBS).
  586.           
  587.           BinkleyTerm offers a full selection of file transfer protocols
  588.           for use in exchanging files with remote systems.  Also offered is
  589.           optional VT-100 terminal emulation, an open architecture for
  590.           adding additional file transfer protocols, support for high speed
  591.           modems up to 38,400 baud, session logging to a flat file or
  592.           printer, and more. 
  593.           
  594.           BinkleyTerm also features Zmodem Auto-Downloads.  Once the
  595.           transfer begins at the remote host, BinkleyTerm will detect the
  596.           unique Zmodem start-of-transfer signal, and will immediately go
  597.           into Zmodem download mode.  If for some reason the Auto-Download
  598.           does not occur, a Zmodem download can always be initiated
  599.           manually.
  600.           
  601.           To install and operate BinkleyTerm for use exclusively in
  602.           Terminal Mode, follow these steps. 
  603.           
  604.                - Prepare disk media.  Create a sub-directory on your hard
  605.                disk, or format a single diskette.
  606.           
  607.                - Move the software to the newly prepared media.
  608.           
  609.                - With a standard text editor, or with DOS' EDLIN command,
  610.                edit the sample configuration file, BINKLEY.CFG, included in
  611.                the distribution archive or diskette.  The parameters needed
  612.                are outlined in the file itself on comment lines, or you may
  613.                refer to the Reference Guide for more information.
  614.           
  615.                - Obtain and properly install a FOSSIL driver in accordance
  616.                with the directions included with your driver.  (Refer to
  617.                the Glossary for more information on FOSSIL drivers.)
  618.           
  619.                - Invoke BinkleyTerm (enter 'BT' on the command line).
  620.           
  621.                - Press Alt-F10 for a brief help screen.
  622.           
  623.           The various keystrokes available in Terminal Mode are covered in
  624.  
  625.                BinkleyTerm Version 2.30 - User's Guide - Page 12
  626.  
  627.           detail in the Reference Guide.
  628.           
  629.           VT-100 EMULATION
  630.           
  631.           VT-100 terminal emulation is provided optionally by BinkleyTerm. 
  632.           Outward keystrokes are always active with the VT-100 keypad
  633.           mapping (as shown in the Reference Guide).  However, incoming
  634.           screen control codes require ANSI X3.64 support, such as that
  635.           provided in firmware on a DEC Rainbow computer. 
  636.           
  637.           For users of IBM PC computers and compatibles, external ANSI
  638.           support is required, as provided by FANSI-CONSOLE, a separately
  639.           available utility.  Load FANSI-CONSOLE in accordance with its
  640.           directions prior to running BinkleyTerm for full VT-100 terminal
  641.           emulation.
  642.           
  643.           EXTERNAL PROTOCOLS
  644.           
  645.           BinkleyTerm provides a rich selection of file transfer protocols,
  646.           hard coded for ease of use and efficient operation.  On occasion
  647.           however, other protocols may also be desired.
  648.           
  649.           BinkleyTerm supports special external file transfer programs that
  650.           conform to the standard used by Opus-CBCS.  External file
  651.           transfer protocols MUST identify themselves as being compatible
  652.           with Opus-CBCS in order to work with BinkleyTerm.  Such protocols
  653.           are often available from Opus-CBCS systems.
  654.           
  655.           Protocols currently available include WXmodem, Kermit and others. 
  656.           To use such an external protocol, add a 'Protocol' statement to
  657.           your configuration file along with the required path information,
  658.           as illustrated in the Reference Guide section "Configuration
  659.           File." 
  660.           
  661.           Some of the Opus-CBCS compatible protocols are specially designed
  662.           and optimized for BBS use, and may not be operable in
  663.           BinkleyTerm's Terminal Mode.  Check the individual package for
  664.           information, or test the performance of the package on your own.
  665.           
  666.           "True" external protocols, those that are designed to be accessed
  667.           by any communications program via a DOS shell, can also be used
  668.           with BinkleyTerm.  BinkleyTerm provides a DOS shell command that
  669.           can be invoked during a communications session.  An external
  670.           protocol of this type can then be executed from the DOS command
  671.           line, or from a batch file, depending on your situation. 
  672.           External protocols such as Jmodem and BiModem can be accessed in
  673.           this manner.
  674.                    
  675.                    
  676.                    
  677.                    
  678.                    
  679.                    
  680.                    
  681.  
  682.                BinkleyTerm Version 2.30 - User's Guide - Page 13
  683.  
  684.              +-------------+
  685.              | +---------+ |
  686.              | | Section | |   BinkleyTerm User's Guide
  687.              | |    3    | |   OPERATION AS AN AUTOMATED ELECTRONIC MAILER
  688.              | +---------+ |
  689.              +-------------+
  690.           
  691.           UNATTENDED MODE OVERVIEW
  692.           
  693.           This section describes the installation and use of BinkleyTerm in
  694.           Unattended Mode.  This mode is used when BinkleyTerm is to
  695.           function as a front-end mail interface, whether in a BBS or
  696.           "Point" environment.  The Glossary provides information on BBS
  697.           and Point systems.
  698.           
  699.           BinkleyTerm, in this operational mode, provides functionality
  700.           similar to that provided by programs such as SEAdog, Dutchie,
  701.           FrontDoor, D'Bridge and other FidoNet compatible mailers. 
  702.           BinkleyTerm answers the telephone, and exchanges mail with other
  703.           compatible mail interface packages, or in the case of a human
  704.           caller, passes control of the connection to a BBS system. 
  705.           
  706.           Due to the complexity and widely varying combinations of hardware
  707.           and software, only a generalized, broad explanation of the
  708.           installation procedure can be given.
  709.           
  710.                - Prepare your disk media.  Normally, this would involve
  711.                selecting and/or creating a hard disk sub-directory.
  712.           
  713.                - Move BinkleyTerm and the distribution files to this new
  714.                directory.
  715.           
  716.                - Using any standard text editor, make the necessary changes
  717.                to the configuration file included with the distribution
  718.                archive or package.  Refer to the Reference Manual section
  719.                "Configuration File" for more information.
  720.           
  721.                - Run the BTCTL program included in the distribution
  722.           package.
  723.           
  724.                - Obtain and install a FOSSIL driver.  Refer to the Glossary
  725.                for more information.  
  726.           
  727.                - Obtain the necessary utilities and programs for packing
  728.                and unpacking mail.  Install them in accordance with the
  729.                instructions included with each package.
  730.           
  731.                - If you're a fully qualified FidoNet node (not a Point),
  732.                obtain a current nodelist.  Process it into usable form. 
  733.           
  734.                - Make the appropriate changes to an existing batch file
  735.                used to start your BBS.  If the installation is completely
  736.                new, or if your BBS does not use a batch file, create one. 
  737.                Refer to the section "Control" for more information.
  738.  
  739.                BinkleyTerm Version 2.30 - User's Guide - Page 14
  740.  
  741.           
  742.                - Start your system.  Test a remote call if possible.
  743.           
  744.                - Alt-F10 displays a brief help file of commands available
  745.                in Unattended Mode.
  746.           
  747.           THE BINKLEYTERM CONCEPT
  748.           
  749.           It is important to remember that BinkleyTerm is a mailer program
  750.           with a completely open architecture.  As such, BinkleyTerm can be
  751.           operated with a tremendous variety of BBS systems, mail packing
  752.           and unpacking programs, and accessories.  
  753.           
  754.           BinkleyTerm will answer the telephone and respond to another mail
  755.           program.  Mail will be placed in an incoming files area.  If the
  756.           caller is human, control is passed entirely to the BBS program,
  757.           if one is installed.  It is the responsibility of third-party
  758.           software to unpack the mail received, and add it to your message
  759.           base.  
  760.           
  761.           On the outward side, BinkleyTerm uses an outbound holding area to
  762.           hold outward mail.  It is the responsibility of third-party
  763.           packing software to pack new messages into the required format,
  764.           and place them in the outbound area.  
  765.           
  766.           BinkleyTerm neither packs nor unpacks mail.  Allowing this 
  767.           functionality to be provided by other software allows BinkleyTerm
  768.           to be compatible with practically any BBS software, regardless of
  769.           message base structure.
  770.           
  771.           For mail handling, you might use programs such as ConfMail and
  772.           oMMM to process mail, along with programs such as Sirius or msged
  773.           to read and enter messages, or allow your users to do so in a BBS
  774.           installation such as Opus-CBCS or Fido.  Some BBS packages, such
  775.           as TBBS and QuickBBS come complete with their own proprietary
  776.           packing and unpacking software.  Finding the utilities and
  777.           programs needed to work with your system is your responsibility. 
  778.           
  779.           HOW BINKLEYTERM HANDLES MAIL
  780.           
  781.           Sending outbound mail with BinkleyTerm is fairly simple.  The
  782.           concept of mail handling with BinkleyTerm is the same concept
  783.           that Opus-CBCS uses.  If you're already familiar with Opus, then
  784.           BinkleyTerm will fall into place easily.  If you are a complete
  785.           neophyte, this section is intended to give you an understanding
  786.           of the concept.
  787.           
  788.                                        Idea #1
  789.           
  790.           Mail events are less important than they are with other mailing
  791.           methods and systems.  With BinkleyTerm's events, you paint with a
  792.           wide brush telling the system what to do with 'classes' of remote
  793.           systems.  
  794.           
  795.  
  796.                BinkleyTerm Version 2.30 - User's Guide - Page 15
  797.  
  798.           When systems handled mail only at specific times, routing and
  799.           times were of great importance.  Because more and more systems
  800.           can process mail at any time, the idea of a schedule becomes less
  801.           important.  The item of prime importance with BinkleyTerm is
  802.           COST.  We are going to try and relieve you of the tedious details
  803.           of scheduling, and concentrate on doing things for the least
  804.           cost.  More on this later.
  805.           
  806.                                        Idea #2
  807.           
  808.           Another new idea deals with the way that packets are created.  
  809.           
  810.           If you have used other mailer systems, you're probably used to
  811.           seeing packets generated several times.  With some programs,
  812.           packets are built every time a mail schedule starts.  As a
  813.           result, one message may be put into a packet several times.
  814.           
  815.           With BinkleyTerm, packets are built once by an external mail
  816.           packing program.  Most often, this is a program called oMMM. 
  817.           They may be remarked and rerouted once they're built, but they
  818.           are physically built only once, and placed in a special sub-
  819.           directory called the outbound holding area.
  820.           
  821.           NOTE:  oMMM stands for Opus Matrix Message Masher, and was
  822.           originally designed for use with the Opus-CBCS system as its
  823.           packer.  BinkleyTerm is able to use oMMM because it chose to
  824.           implement the holding area in a compatible (although not
  825.           identical) way.  oMMM may not have to be used at all; in some
  826.           cases, the mail packing program for your particular environment
  827.           may handle oMMM-like functions internally.
  828.           
  829.                                        Idea #3
  830.           
  831.           BinkleyTerm uses 'Continuous Mail.'  If you are already using a
  832.           program that supports 'Crash Mail' then you understand a little
  833.           of what Continuous Mail does.  Continuous Mail differs from Crash
  834.           Mail in a couple of areas.
  835.           
  836.           In other mailer systems, you would mark a message as 'Crash'
  837.           meaning that you wanted this message to go out NOW.  These mailer
  838.           programs would shut down human caller access to the BBS and try
  839.           like heck to get the message through.
  840.           
  841.           BinkleyTerm uses Continuous Mail, meaning that this is a message
  842.           going to a system that can accept mail at any time of day. 
  843.           BinkleyTerm makes no frantic attempts to dial out, rather it will
  844.           try and deliver the message between callers.  
  845.           
  846.                                        Idea #4
  847.           
  848.           The driving forces of outbound traffic are file names!
  849.           
  850.           You'll have a special sub-directory set aside just for packets,
  851.           compressed mail packets and other network files.  This sub-
  852.  
  853.                BinkleyTerm Version 2.30 - User's Guide - Page 16
  854.  
  855.           directory belongs to BinkleyTerm, which will maintain the
  856.           directory for you.  It's a good idea not to play with this area
  857.           unless you know exactly what you're doing. 
  858.           
  859.           Note also that when zoned operation is active (BinkleyTerm
  860.           default) there are separate outbound areas for each zone.  The
  861.           default outbound area (for your zone) and one additional area for
  862.           each other zone you deal with.  The names of these additional
  863.           areas are simply the outbound area name, with a three-digit
  864.           extension that is the zone number in hexadecimal with leading
  865.           zeroes.  See "Zone Support" for information.
  866.           
  867.           The file names of the packets tell BinkleyTerm how to treat the
  868.           different packets.  Here's a typical packet name:
  869.           
  870.                00680024.OUT
  871.           
  872.           That says that the packet is for 0068/0024 (in hexadecimal) or
  873.           104/36 in more familiar terms.  The ".OUT" means it is a Normal
  874.           packet.
  875.           
  876.           Other packet extensions include:
  877.           
  878.                .HUT . . . Hold this packet for pickup by the remote system.
  879.                .CUT . . . The other system can receive Continuous Mail.
  880.                .DUT . . . Direct, meaning the other system can NOT receive
  881.                           Continuous Mail.
  882.           
  883.           One nice thing is that you can manually change the file extension
  884.           if you need to, or you can use fancy utilities such as AMAX to do
  885.           this sort of thing for you on your command.
  886.           
  887.           For the remainder of this section, we'll assume that you'll be
  888.           using oMMM as your mail packer.  As mentioned previously, you may
  889.           be using another program that has oMMM-like functionality; it
  890.           depends on your environment.  
  891.           
  892.           The oMMM program knows about these extensions and creates them
  893.           based on information you put into the oMMM control file.  You'll
  894.           have statements like this:
  895.           
  896.                NormHold  124/102
  897.           
  898.           Any messages you enter to 124/102 would be turned into a .HUT
  899.           packet file, placed into the outbound area, and BinkleyTerm would
  900.           hold that packet for 124/102 to call and pick it up. 
  901.           
  902.           Files are also sent through FidoNet compatible networks.  oMMM
  903.           builds and maintains a file that tells BinkleyTerm what files to
  904.           send (or hold) for whom.  A typical 'file attach' file might be
  905.           named: 
  906.           
  907.                00680024.FLO
  908.           
  909.  
  910.                BinkleyTerm Version 2.30 - User's Guide - Page 17
  911.  
  912.           This would designate a that there is a file waiting to be sent to
  913.           0068/0024 (in hexadecimal) or 104/36 in more familiar terms.  The
  914.           ".FLO" says it is a Normal file attach.  File attach files are
  915.           also called 'flow files' - named after the .FLO file extension.
  916.           
  917.           Other flow file extensions are:
  918.           
  919.                .HLO . . . Hold these files for pickup by the remote system.
  920.           
  921.                .CLO . . . The other system can receive Continuous Mail.    
  922.                .DLO . . . Direct, meaning the other system can NOT receive
  923.                           Continuous Mail.
  924.           
  925.           A flow file is just a text file.  It contains a list of files
  926.           that are to be sent to another system:
  927.           
  928.                #c:\binkley\outbound\0000fc9c.mo1
  929.                ^c:\myfiles\wizzle.doc
  930.                c:\pascal\notes.doc
  931.           
  932.           The '#' prior to a flow file entry says to truncate the file to
  933.           zero-length after successfully sending the file to the remote
  934.           system.  This is normally only employed when sending compressed
  935.           mail (archived mail) to the remote.  The '^' prior to a flow file
  936.           entry says to delete the file after sending.  
  937.           
  938.           The oMMM program will put messages into archives for you. 
  939.           Details on how this is done can be found in the oMMM
  940.           documentation.  The point is that oMMM combines the functionality
  941.           of "generating packets" with that of programs like ARCmail. 
  942.           
  943.                           A Sample Message, Start to Finish
  944.           
  945.           So here's a practical example.  Say I enter a message to Rod
  946.           Lamping at 104/610.  I mark the message as KILL/SENT when I enter
  947.           it.  I also enter the message designating a file to attach to
  948.           Rod, named C:\FILE\REQ\FOOBAR.ARC.
  949.           
  950.           I then enter a message in an EchoMail conference.  My conference
  951.           host is Phil Kaiser at 104/904, for whom I hold my mail for
  952.           pickup. 
  953.           Among other things, I have two lines in my oMMM control file:
  954.           
  955.                NormCM    104/610
  956.                OneHold   104/904
  957.           
  958.           'NormCM' tells oMMM to mark the message as Continuous Mail (since
  959.           Rod runs a mailer 24 hours a day).  'OneHold' tells oMMM to
  960.           archive the mail to 104/904, and mark it Hold-for-Pickup.  Refer
  961.           to the oMMM documentation for the full set of available oMMM
  962.           control file statements.
  963.           
  964.           First, my EchoMail utilities are run to turn EchoMail messages
  965.           into Normal packets, and place them in the outbound area for
  966.  
  967.                BinkleyTerm Version 2.30 - User's Guide - Page 18
  968.  
  969.           processing by oMMM.  Next, I execute oMMM.  It first scans the
  970.           NetMail message area (where I entered my message to Rod) and
  971.           turns new messages there into Normal packets, and if there are
  972.           files attached, it creates Normal flow files.  oMMM's second step
  973.           is to use its control file, and apply the statements in the file
  974.           against the mail in the outbound area that is marked as Normal.
  975.           
  976.           Since I have Rod's board listed as NormCM, oMMM renames the file
  977.           extension of the Normal packet and flow file for Rod to .CUT and
  978.           .CLO respectively, for Continuous Mail.  Since I have Phil's
  979.           board listed as OneHold, first oMMM archives the packets to Phil,
  980.           then creates a flow file with a file extension of .HLO for Hold-
  981.           for-Pickup. 
  982.           
  983.           I would then have the following in my outbound area:
  984.           
  985.                00680262.CUT   Message to Rod
  986.                00680262.CLO   Flow File to Rod
  987.                00680388.HLO   Flow File to Phil
  988.                0000FC9C.MO1   Archived Message to Phil
  989.           
  990.           For more information on how oMMM works, refer to the oMMM
  991.           documentation.
  992.           
  993.                                  The Concept of Cost
  994.           
  995.           As mentioned earlier, one of the prime considerations with
  996.           BinkleyTerm is sending mail for the least cost.  Cost is, of
  997.           course, determined by the nodelist entry.  With a properly
  998.           compiled nodelist, local FidoNet nodes have '0' in the cost field
  999.           for their nodelist entry (assuming local calls are free of
  1000.           charge).  Other entries have cost fields that realistically
  1001.           reflect the actual cost of sending mail to a particular node.
  1002.           
  1003.           In most areas, it is cheapest to send toll calls during nighttime
  1004.           house.  Therefore, BinkleyTerm is normally set-up to send such
  1005.           mail only during nighttime hours.
  1006.           
  1007.           The 'L' flag used when scheduling events designates 'local only.' 
  1008.           As already mentioned, nodes with a '0' cost field are assumed to
  1009.           be local.  When the flag is applied to an event, only local calls
  1010.           are made.  The 'L' flag should be used whenever it costs the most
  1011.           money to make toll calls, and removed for events during which
  1012.           toll calls are cheapest.  More about this is in the Reference
  1013.           Manual section, "Scheduling Events."
  1014.           
  1015.                                  Alternative Method
  1016.           
  1017.           Randy Bush of 1:105/6 has assembled a package called MOOO which
  1018.           allows the Dutchie mail packer to be used with BinkleyTerm.  This
  1019.           will allow routing commands familiar to grizzled FidoNet veterans
  1020.           to be used with BinkleyTerm.
  1021.           
  1022.           
  1023.  
  1024.                BinkleyTerm Version 2.30 - User's Guide - Page 19
  1025.  
  1026.           WINDOWED INTERFACE
  1027.           
  1028.           BinkleyTerm features a windowed user interface.  The windowed
  1029.           interface provides "at-a-glance" convenience for watching mail
  1030.           sessions in progress, as well as determining what activity has
  1031.           taken place with the system recently.
  1032.           
  1033.           If a Video FOSSIL (VFOSSIL) is installed, the windowing
  1034.           operations can take place much faster than they would without
  1035.           one.  It is recommended that a VFOSSIL be used with BinkleyTerm.
  1036.           
  1037.           Some more recent VFOSSIL implementations may also allow
  1038.           BinkleyTerm to be used on EGA and VGA systems in extended text
  1039.           modes of 132 columns by 43 lines.  The mode switching must be
  1040.           performed by the utility software that accompanied your video
  1041.           card prior to invoking BinkleyTerm.
  1042.           
  1043.           There are five information windows displayed on-screen.  
  1044.           
  1045.                                   Current Settings
  1046.           
  1047.           This window contains various information about your system,
  1048.           including the current date and time, current event, port and
  1049.           current baud rate, status and multi-tasker type, if any.
  1050.           
  1051.           The current event line features a number, and a list of event
  1052.           flags.  The number corresponds to which entry in the BinkleyTerm
  1053.           configuration file contains the line that covers the current
  1054.           event.  The first 'Event' statement in the configuration file
  1055.           would be event 1, the second would be event 2, and so on.  The
  1056.           flags are letters that are a subset of those used with event
  1057.           scheduling.  Here is a list of letters that may be found in this
  1058.           window:
  1059.           
  1060.                C    Continuous Mail Only Event
  1061.                L    Local Only Event
  1062.                N    Do Not Accept Inbound File Requests
  1063.                R    Receive Only Event
  1064.                B    BBS Use Allowed
  1065.                D    Dynamic Event
  1066.                K    Do Not Send to #CM Nodes
  1067.           
  1068.           Note that not all event flags will be displayed in the window. 
  1069.           For complete details and use information, see "Scheduling Events"
  1070.           in the Reference Guide.
  1071.           
  1072.                                   Today at a Glance
  1073.           
  1074.           This window contains several lines of information regarding the
  1075.           activity on your system since midnight.  Note that the totals
  1076.           given apply only to calls handled by BinkleyTerm's Unattended
  1077.           (mailer) Mode, and do not include Terminal Mode totals.
  1078.           
  1079.           The first line, "BBS/Mail," lists how many bbs calls and mail
  1080.  
  1081.                BinkleyTerm Version 2.30 - User's Guide - Page 20
  1082.  
  1083.           calls have come in, separated by a slash.  For example, 2/15
  1084.           would indicate 2 BBS calls and 15 mail calls since midnight.
  1085.           
  1086.           The second line, "Calls Out," lists the number of dial attempts
  1087.           that have been made by your system, successful or otherwise.  
  1088.           
  1089.           The third line, "Good/Cost," shows how many successful outward
  1090.           connects have been made and the cumulative cost of all the
  1091.           successful calls, separated by a slash.  For example, 3/100 would
  1092.           indicate that 3 successful outbound calls have been placed, and
  1093.           that together, they cost 100 units (in the United States, units
  1094.           are cents, which would mean that the cost was 100 cents or
  1095.           $1.00).  The cost is calculated based on the cost shown in your
  1096.           compiled nodelist files; the cost shown there is assumed to be a
  1097.           per-minute value in calculating a per-call cost.
  1098.           
  1099.           The fourth line, "Files I/O," shows how many files (packets,
  1100.           compressed mail or other incoming files) have been received and
  1101.           sent, separated by a slash.  For example, 12/3 would indicate
  1102.           that 12 files have been received, and 3 have been sent.  
  1103.           
  1104.           Finally, the fifth line indicates the type of last call.  If the
  1105.           last call was incoming, the display will indicate whether the
  1106.           call was a BBS call, external mail call, or the node address will
  1107.           be displayed if it was a mail call.  If the last successful call
  1108.           was outgoing, the node address will be displayed.  
  1109.           
  1110.                                 Pending Outbound Mail
  1111.           
  1112.           This window displays a list of systems for whom mail is pending,
  1113.           along with related information.  The window can be scrolled using
  1114.           PgUp, PgDn, Home, End, Up-Arrow and Down-Arrow keys.  The top
  1115.           line of the window lists the node that is being called, or was
  1116.           just called.  The second line lists the node that will be called
  1117.           next.
  1118.           
  1119.           Various information about the mail for the various nodes is also
  1120.           displayed.  The columns are marked by a single letter.  The
  1121.           column letters and their meaning are:  
  1122.           
  1123.                C    Continuous Mail 
  1124.                H    Hold-for-Pickup Mail 
  1125.                D    Direct Mail 
  1126.                N    Normal Mail 
  1127.                R    File and/or Update Request
  1128.                S    Status
  1129.           
  1130.           The symbol shown under the C, H, D, N and R columns is:
  1131.           
  1132.                *    Mail of This Type Pending
  1133.           
  1134.           
  1135.           
  1136.           
  1137.  
  1138.                BinkleyTerm Version 2.30 - User's Guide - Page 21
  1139.  
  1140.           The symbols shown under the S column are:
  1141.           
  1142.                x    Too Many Bad Connects (Undialable)
  1143.                #    Already Called, But Mail Still Pending
  1144.                -    Cannot Call During This Event
  1145.                !    Node Not Found in Nodelist
  1146.           
  1147.           When BinkleyTerm is making an outbound call, the node you are
  1148.           calling is highlighted in the Pending Outbound Mail window.  This
  1149.           allows you to know which node has been called, even after the
  1150.           pertinent information has scrolled out of the Recent Activity
  1151.           window (described below).  This feature can also be helpful in
  1152.           determining whether an active mail session was initiated by you,
  1153.           or was started by an incoming call.
  1154.           
  1155.           The outbound area is re-scanned for new additions under the
  1156.           following circumstances:
  1157.           
  1158.                - After a keyboard shell has been invoked
  1159.                - After 'AfterMail' is run (if designated)
  1160.                - After 'Packer' is run (if designated)
  1161.                - After message editor (Alt-E) has been run
  1162.                - After 10 minutes of no activity
  1163.           
  1164.           Note the 'AfterMail', 'Packer' and 'Reader' (message editor) are
  1165.           designated in the configuration file.  Refer to the Reference
  1166.           Guide section "Configuration File" for additional information.
  1167.           
  1168.                                    Recent Activity
  1169.           
  1170.           This window is similar to the main section of previous
  1171.           BinkleyTerm displays, in that it gives various information about
  1172.           what the system is currently doing, or has just done.  This
  1173.           includes identification of the remote system, the type of
  1174.           connection, what files were transferred, etc.
  1175.           
  1176.           Any feedback available about the current or recent activity of
  1177.           the system is shown in this window.  
  1178.           
  1179.                                    Transfer Status
  1180.           
  1181.           This window gives particulars about current file transfers that
  1182.           may be taking place if a connection is active.  For WaZOO/ZedZap
  1183.           connections, this includes filename and the number of bytes
  1184.           transferred; for other connections, the number of blocks
  1185.           transferred may be given.  
  1186.           
  1187.           CONTROL
  1188.           
  1189.           In Unattended Mode, BinkleyTerm is normally used with batch files
  1190.           that control system operation.  You'll have a batch file used to
  1191.           invoke BinkleyTerm and invoke system utilities such mail
  1192.           processors.  
  1193.           
  1194.  
  1195.                BinkleyTerm Version 2.30 - User's Guide - Page 22
  1196.  
  1197.           Since BinkleyTerm can be used in such a wide variety of
  1198.           situations, there is not a particular "correct" or "incorrect"
  1199.           way to configure BinkleyTerm.  The remainder of this section
  1200.           explains some of the operational theory and methods behind batch
  1201.           processing as it applies to BinkleyTerm. 
  1202.           
  1203.           If you are adding BinkleyTerm to an existing FidoNet compatible
  1204.           BBS system, chances are excellent that you are already familiar
  1205.           with batch files and the various tricks that they must typically
  1206.           perform in a FidoNet environment. 
  1207.           
  1208.           If advanced batch processing is beyond your scope, it is highly
  1209.           recommended that you review your DOS manual, or the numerous
  1210.           third-party DOS usage guides for information to get you started.
  1211.           
  1212.           One of the fundamentals of using batch files with BinkleyTerm is
  1213.           the concept of the 'errorlevel.'  This DOS environment variable
  1214.           is set to a given value when a program completes execution.  A
  1215.           batch file can detect and act upon the value, branching to
  1216.           various parts of the batch file.  This section provides many good
  1217.           tips and ideas for errorlevel and batch file processing.  Also
  1218.           consult your DOS manual for additional information.
  1219.           
  1220.           A practical application might be after BinkleyTerm receives mail. 
  1221.           BinkleyTerm would exit to the batch file, setting the errorlevel
  1222.           to a predetermined value.  The batch file detects the value, and
  1223.           branches to a section in the batch file where mail unpacking
  1224.           programs are invoked.  The batch file would then be restarted,
  1225.           invoking BinkleyTerm to again wait for or send mail.
  1226.           
  1227.                NOTE:  The remainder of the "Control" section was
  1228.                written by Ron McKenzie of 1:104/45.1.  My gracious
  1229.                thanks to him for the insights presented here, and for
  1230.                the time he contributed to its composition.  This
  1231.                section was sorely needed (and requested) by many
  1232.                BinkleyTerm users.
  1233.           
  1234.                     - Alan D. Applegate
  1235.           
  1236.                              Errorlevels and Batch Files
  1237.           
  1238.           Errorlevels present a difficult hurdle to the new user of
  1239.           BinkleyTerm, especially those with no experience operating a BBS
  1240.           or a Point.  In addition, BinkleyTerm's great flexibility
  1241.           confuses some Sysops.  Few things are "fixed" or "cast in
  1242.           concrete."  This section attempts to draw together pertinent
  1243.           information from many sources relating to errorlevels and their
  1244.           use in crafting a batch file to operate a BBS or a Point.  Also
  1245.           presented are some accumulated bits of wisdom gathered by the
  1246.           author in the course of creating his own Point.
  1247.           
  1248.           This section looks at what errorlevels are, which errorlevels are
  1249.           returned by BinkleyTerm, distinguishes between those errorlevel
  1250.           values set by BinkleyTerm and by the user, shows how you use
  1251.  
  1252.                BinkleyTerm Version 2.30 - User's Guide - Page 23
  1253.  
  1254.           errorlevels in your batch file and, finally, offers some hints
  1255.           and shortcuts.
  1256.           
  1257.                               What is an "Errorlevel?"
  1258.           
  1259.           An errorlevel is a numeric value which a program may "return"
  1260.           when it terminates.  The name is misleading because the value
  1261.           returned is really an exit code, rather than an indication of an
  1262.           error per se.  It distinguishes different types of normal exits,
  1263.           in addition to denoting an abnormal condition on exit.  The
  1264.           software's creator (or, in some instances, the program's user)
  1265.           sets the value(s).
  1266.           
  1267.           Errorlevels permit the user to craft a batch (.BAT) file, using
  1268.           DOS batch commands such as IF and GOTO, to logically organize the
  1269.           BBS or Point operating process.  Automagically, this batch file
  1270.           determines which tasks need be performed and in what order.  It
  1271.           branches between tasks based on the exit code generated by each
  1272.           program and on the program logic created by the Sysop.
  1273.           
  1274.           For example, an editor might return the following:
  1275.           
  1276.                Exit
  1277.                Code Condition
  1278.                ---- ----------------------------
  1279.                3    EchoMail and NetMail Created
  1280.                2    EchoMail Only Created
  1281.                1    NetMail Only Created
  1282.                0    No Mail Created
  1283.           
  1284.           For another example, the ConfMail mail processing program returns
  1285.           the following errorlevels in the Import mode:
  1286.           
  1287.                Exit
  1288.                Code Condition
  1289.                ---- ----------------------------
  1290.                2    Severe Error in Processing
  1291.                1    Messages Were Imported
  1292.                0    No Messages Imported
  1293.           
  1294.           Branching or jumping within the batch files is facilitated with
  1295.           the use of labels.  A label is used to identify a particular
  1296.           block within the batch file.  For example, you might choose to
  1297.           label a portion of your batch file "nodelist" because that
  1298.           particular section of the file handles nodelist processing.
  1299.           
  1300.           Labels are designated with a colon, followed by the label name. 
  1301.           You may wish to identify the top of the file with a label to make
  1302.           re-starting the batch file as easy as using a GOTO statement.
  1303.           
  1304.           Here is a short example of the use of labels:
  1305.           
  1306.                :start
  1307.                myprog -p1 
  1308.  
  1309.                BinkleyTerm Version 2.30 - User's Guide - Page 24
  1310.  
  1311.                if errorlevel 2 goto process
  1312.                if errorlevel 1 goto start
  1313.                if errorlevel 0 goto end
  1314.           
  1315.                :process
  1316.                proc -c -d1
  1317.                if errorlevel 1 goto start
  1318.                if errorlevel 0 goto end
  1319.           
  1320.                :end
  1321.           
  1322.           Note that the top of the file is identified by a label named
  1323.           "start" and that other sections are labeled as well.  The batch
  1324.           file starts out by invoking a program called MYPROG.  Once MYPROG
  1325.           exits, the errorlevel values determine where in the file that
  1326.           control will be passed.  One errorlevel references another label
  1327.           that in turn will cause a program named PROC to be run.  Another
  1328.           branch goes back to the top of the file, and yet another goes to
  1329.           the end of the file.  The PROC program also gives errorlevels
  1330.           that are processed by the batch file.
  1331.              
  1332.           Errorlevels and associated batch processing commands permit
  1333.           tailoring the batch file and bypassing of unnecessary processing
  1334.           steps, saving substantial amounts of time, which, in turn,
  1335.           translates into more time for user-access and other processes. 
  1336.           (There is NEVER too much time.)
  1337.           
  1338.                         What Errorlevels BinkleyTerm Produces
  1339.           
  1340.           BinkleyTerm returns errorlevels in four general cases:
  1341.           
  1342.                Sysop-Initiated
  1343.                     Fx keys, Escape and Alt-X
  1344.           
  1345.                Sysop-Defined
  1346.                     E1=, E2= and E3= exits used with event scheduling, and
  1347.                     external mail program exits
  1348.           
  1349.                Caller-Initiated
  1350.                     A non-mail call returns the baud rate code
  1351.           
  1352.                System-Generated
  1353.                     BinkleyTerm cannot find itself in the nodelist
  1354.           
  1355.           What errorlevels (exit codes) does BinkleyTerm return?
  1356.           
  1357.           Many values are "hard coded" in BinkleyTerm or are provided in
  1358.           the sample files included in the distribution package.  However,
  1359.           only some of the values have "fixed" definitions.
  1360.           
  1361.           
  1362.           
  1363.           
  1364.           
  1365.  
  1366.                BinkleyTerm Version 2.30 - User's Guide - Page 25
  1367.  
  1368.                Error-    
  1369.                Level     Means          Caused By
  1370.                --------- -------------- ----------------------------------
  1371.                  1       Exit           Alt-X Keypress
  1372.                  3       300 bps Call   Non-Mail Call at 300 Baud
  1373.                 10       E1= Exit **    F1 Keypress *
  1374.                 12       1200 bps Call  Non-Mail Call at 1200 Baud
  1375.                 20       E2= Exit **    F2 Keypress *
  1376.                 24       2400 bps Call  Non-Mail Call at 2400 Baud
  1377.                 30       E3= Exit **    F3 Keypress *
  1378.                 40       **             F4 Keypress
  1379.                 48       4800 bps Call  Non-Mail Call at 4800 Baud
  1380.                 50       **             F5 Keypress
  1381.                 60       **             F6 Keypress
  1382.                 70       **             F7 Keypress
  1383.                 80       **             F8 Keypress
  1384.                 90       **             F9 Keypress
  1385.                 96       9600 bps Call  Non-Mail Call at 9600 Baud
  1386.                 99       ExtrnMail      External Mail String Received *****
  1387.                100       **             F10 Keypress
  1388.                128       38400 bps Call Non-Mail Call at 38,400 Baud ****
  1389.                192       19200 bps Call Non-Mail Call at 19,200 Baud
  1390.                254       Error          Address Not Found in Nodelist ***
  1391.                255       Error          Microsoft C Produced Error
  1392.           
  1393.                * As shipped; the sample BINKLEY.EVT event file included in
  1394.                the distribution package uses errorlevels 10, 20 and 30 for
  1395.                E1=, E2= and E3= exits respectively.  Thus pressing F1, F2
  1396.                or F3 has the same effect as BinkleyTerm making an E1=, E2=
  1397.                or E3= exit.  Exits are defined as:
  1398.                
  1399.                     E1=  Beginning of Event
  1400.                     E2=  Mail Received
  1401.                     E3=  Compressed Mail Received
  1402.           
  1403.                ** All F-key exits have user-defined functionality.
  1404.           
  1405.                *** BinkleyTerm will exit with errorlevel 254 when it cannot
  1406.                find its own address in the nodelist.  Other conditions
  1407.                checked are: 
  1408.                     
  1409.                     - Non-Zero Zone Number Designated
  1410.                     - Non-Zero Net Number Designated
  1411.                     - System Name Designated
  1412.                     - Sysop Name Designated
  1413.                     - Outbound (Hold) Area Designated
  1414.                     - Inbound Area Designated
  1415.           
  1416.                If any of these parameters are not designated or are
  1417.                improperly designated as noted, then an errorlevel 254 exit
  1418.                is performed.  These parameters are designated in the
  1419.                configuration file.
  1420.           
  1421.                **** Errorlevel values allowed by DOS are from 0 to 255. 
  1422.  
  1423.                BinkleyTerm Version 2.30 - User's Guide - Page 26
  1424.  
  1425.                Therefore, the value of a 38,400 baud exit "wraps" around to
  1426.                equal 128, instead of 384.
  1427.           
  1428.                ***** The external mail program functionality features
  1429.                configurable exit values, but the default value is 99.
  1430.                   
  1431.                            Making Errorlevels Work For You
  1432.           
  1433.           You, the user, define ALL errorlevels associated with the E1=,
  1434.           E2= and E3= exits, setting them in BINKLEY.EVT.  You 'program' a
  1435.           specific task to occur at the beginning of a selected BinkleyTerm
  1436.           "event" (time interval) by selecting a unique "E1=" code for that
  1437.           task.
  1438.              
  1439.           The task can be set to occur periodically throughout each day,
  1440.           once-per-day, once-a-week or on selected days within the week;
  1441.           further, you may execute a given task at different times on
  1442.           different days, if so desired, depending on the way a particular
  1443.           event is configured.  Similarly, by having a variety of E2= and
  1444.           E3= codes, you can use different mail unpacking routines
  1445.           throughout the day or week.  Refer to the section "Scheduling
  1446.           Events" in the Reference Guide for details.
  1447.              
  1448.           You customize the operation of your BBS or Point to meet your
  1449.           specific needs and those of your "customers".
  1450.           
  1451.                        Errorlevels, Batch Files and ExtrnMail
  1452.           
  1453.           This BinkleyTerm option is intended for invocation of an external
  1454.           mail handling program, possibly an alternate mailer, upon
  1455.           reception of a user-defined string of characters.  It can also be
  1456.           used to set-up multiple BBS installations, allowing a user to
  1457.           specify which BBS he or she wants.  This is covered in detail in
  1458.           the sections "External Mail Programs" and "User-Selected BBS
  1459.           Functionality" elsewhere in this manual.
  1460.           
  1461.                       Errorlevels, Batch Files and Housekeeping
  1462.           
  1463.           Another common application of exits and exit values is for
  1464.           housekeeping.  For example, the author set up his Point system to 
  1465.           do daily housekeeping (deleting and renumbering of the message
  1466.           base) daily at 8:00am.  Twice a day, at 4:00am and 11:00pm, his
  1467.           Point polls his BossNode.  Each Saturday, the Point requests the
  1468.           current NODEDIFF from the BossNode and, then, on Sunday,
  1469.           processes the weekly NODELIST.  A distinct E1= errorlevel handles
  1470.           each task.
  1471.                   
  1472.           Thus, only you can prevent chaos and create an orderly
  1473.           functioning batch file for your BBS or Point.  Be vigilant, and
  1474.           avoid re-using the same errorlevel for several different tasks.
  1475.           
  1476.                                    DOS Shell Keys
  1477.              
  1478.           There are also 9 programmable DOS shell exits which are invoked
  1479.  
  1480.                BinkleyTerm Version 2.30 - User's Guide - Page 27
  1481.  
  1482.           by using Alt-Fx key combinations.  You enable and set these up in
  1483.           the configuration file.  Look for 'Shell' near the end of the
  1484.           sample BINKLEY.CFG file included with BinkleyTerm, and refer to
  1485.           the section "Configuration File," the command 'Shell' in the
  1486.           Reference Guide.  
  1487.           
  1488.           These shells produce NO errorlevels but are mentioned because
  1489.           they are an alternate and/or additional solution to creating
  1490.           Sysop controllable exit/task options.  When configured, these
  1491.           shell keys invoke a new copy of the command processor,
  1492.           COMMAND.COM.  You may not want to use these as they consume extra
  1493.           memory for the 2nd copy of COMMAND.COM.
  1494.           
  1495.                                   Using Errorlevels
  1496.            
  1497.           How do you use errorlevels?  By testing for their existence with
  1498.           the batch file statement:
  1499.           
  1500.                IF ERRORLEVEL n GOTO xxx
  1501.           
  1502.           Where:
  1503.           
  1504.                n    is a numeric value
  1505.                xxx  is a label within the batch file
  1506.           
  1507.           Bear in mind the following Rules:
  1508.           
  1509.                The "IF ERRORLEVEL ... " statements must follow immediately
  1510.                after the program they test.
  1511.           
  1512.                "IF ERRORLEVEL n" returns true for any value GREATER THAN or
  1513.                EQUAL TO "n", therefore,
  1514.              
  1515.                Test errorlevels in descending numerical sequence, and,
  1516.                
  1517.                Trap unwanted exit codes so that a step will be executed if,
  1518.                and only if, the desired errorlevel is encountered.
  1519.              
  1520.           In this excerpt from a batch file, the "Start_BT" label refers to
  1521.           a section that loads BinkleyTerm:
  1522.           
  1523.                IF ERRORLEVEL 21 GOTO Start_BT  <- Traps 21 to etc. *
  1524.                IF ERRORLEVEL 20 GOTO OpenMail  <- Branch & Open Mail
  1525.                IF ERRORLEVEL 11 GOTO Start_BT  <- Traps 11 to 19 *
  1526.                IF ERRORLEVEL 10 GOTO Start_BT  <- "Non-Event"
  1527.                IF ERRORLEVEL  3 GOTO Start_BT  <- Traps 3 to 9 *
  1528.                IF ERRORLEVEL  2 GOTO Bad_Exit  <- Nodelist Entry Error
  1529.                IF ERRORLEVEL  1 GOTO Exit_BT   <- Branch to 'Exit'
  1530.              
  1531.                * Invalid responses are 'trapped', BinkleyTerm restarts.    
  1532.           
  1533.                                       What Now?
  1534.           
  1535.           Look at some "good" examples which demonstrate automating
  1536.  
  1537.                BinkleyTerm Version 2.30 - User's Guide - Page 28
  1538.  
  1539.           processes using batch files and errorlevels.  In particular, look
  1540.           at the samples provided by Bob Hartman and Alan Applegate for
  1541.           BinkleyTerm (available from 1:104/36), or samples that existing
  1542.           BinkleyTerm Sysops may be able to provide you.  Then, make up
  1543.           your own batch file to control a process.  Or, take one of the
  1544.           samples and modify it for your specific needs.  Have fun!  Hack
  1545.           away!
  1546.              
  1547.           Consult the documentation for each of your application programs,
  1548.           determine whether or not it produces errorlevels, and how you can
  1549.           take advantage of them.
  1550.           
  1551.                       Errorlevel and Batch File Hints and Kinks
  1552.           
  1553.           When looking at sample batch files, note carefully how each
  1554.           author organized the program logic in his batch file.  Here are
  1555.           some reminders.
  1556.           
  1557.           A batch file loses 'control' if it merely invokes another batch
  1558.           file (e.g. you execute a second batch file within the first);
  1559.           instead, "shell out" to DOS from the first batch file by invoking
  1560.           another copy of COMMAND.COM.  Using the /C switch closes that
  1561.           second command processor when the second batch file finishes. 
  1562.           Consult your DOS reference materials for more information on this
  1563.           point.
  1564.              
  1565.           Examples:
  1566.           
  1567.                COMMAND.COM /C Pak_Mail.BAT
  1568.           
  1569.           or:
  1570.           
  1571.                %comspec% /C Pak_Mail.BAT
  1572.           
  1573.           This is true for all MS-DOS versions up to and including 3.2. 
  1574.           MS-DOS/PC-DOS 3.3 introduced the batch command CALL which
  1575.           overcomes this limitation, when it is used.  Refer to your DOS
  1576.           manual.
  1577.           
  1578.           Sometimes, your batch file must "remember" what it is doing.  You
  1579.           can accomplish this by "setting" an environment variable, for
  1580.           example:
  1581.              
  1582.                SET PROC=UNATTENDED
  1583.              
  1584.           Your batch file can then determine its "logic path" or invoke
  1585.           other programs using statements such as:
  1586.              
  1587.                IF %PROC% == UNATTENDED GOTO xxx
  1588.           
  1589.           or:
  1590.           
  1591.                IF %PROC% == UNATTENDED BT UNATTENDED
  1592.           
  1593.  
  1594.                BinkleyTerm Version 2.30 - User's Guide - Page 29
  1595.  
  1596.           or:
  1597.           
  1598.                IF %PROC% == UNATTENDED %comspec% /C Pak_Mail.BAT
  1599.           
  1600.           In the above examples, the program follows a certain logic path
  1601.           and performs specific tasks when it's in the unattended mode.  
  1602.           
  1603.           Verify that you have sufficient environment space for any
  1604.           variables which you want to "store" in it.  Review the section
  1605.           concerning the SHELL entry for CONFIG.SYS in your DOS reference
  1606.           material.  This will explain how to enlarge the environment space
  1607.           if that is needed.  The exact adjustments which you may need to
  1608.           make are dependent upon your version of MS-DOS/PC-DOS, and
  1609.           several other factors such as memory use, size of DOS paths and
  1610.           so on.
  1611.             
  1612.           You can also pass a variable into a batch file when you invoke a
  1613.           program.  For example, the author's POINT.BAT batch file
  1614.           immediately comes up in the Unattended Mode if you invoke it
  1615.           with:
  1616.              
  1617.                POINT -u    (or, POINT -U)
  1618.              
  1619.           POINT.BAT then leapfrogs directly into unattended mode using the
  1620.           following statements:
  1621.              
  1622.                IF %1 == -u SET PROC=UNATTENDED
  1623.                IF %1 == -u GOTO Start_BT
  1624.                ...
  1625.                
  1626.                :Start_BT
  1627.                IF     %PROC% == TERM BT           <-Terminal Mode
  1628.                IF NOT %PROC% == TERM BT %PROC%    <-Other Modes
  1629.              
  1630.           Finally, use of errorlevels is not always necessary.  Some
  1631.           programs provide an alternative which may meet your needs.
  1632.              
  1633.           For example, ConfMail and some editors produce an ".OUT" file
  1634.           containing the name of each EchoMail area for which mail has been
  1635.           received or created.  Thus, test for the existence of the .OUT
  1636.           file rather than testing the errorlevels and, thereby, simplify
  1637.           the logical branching in your batch (.BAT) file.  For example:
  1638.           
  1639.                if exist AREAS.OUT ConfMail Export ... -F AREAS.OUT
  1640.                if exist AREAS.OUT del AREAS.OUT
  1641.           
  1642.           or:
  1643.           
  1644.                if exist ECHO.OUT ConfMail Maint ... -F ECHO.OUT
  1645.                if exist ECHO.OUT ReplyLnk -F ECHO.OUT
  1646.                if exist ECHO.OUT del ECHO.OUT
  1647.           
  1648.           The point here is that such an .OUT file can be used by several
  1649.           programs serially, as in the last example, and thus, avoid using
  1650.  
  1651.                BinkleyTerm Version 2.30 - User's Guide - Page 30
  1652.  
  1653.           errorlevel driven logic.  Further, it can continue working for
  1654.           you after you have "lost" your errorlevel by running another
  1655.           program.
  1656.           
  1657.                                 Environment Variable
  1658.           
  1659.           In environments where multiple drives and paths are used, it is
  1660.           generally a good idea to set a DOS environment variable named
  1661.           BINKLEY.  BinkleyTerm can then use this variable to determine
  1662.           where its configuration file is located, should it not be located
  1663.           in the current directory.
  1664.           
  1665.           Place in your AUTOEXEC.BAT file (or in the batch file that starts
  1666.           BinkleyTerm) the line:
  1667.           
  1668.                SET BINKLEY=C:\PATH
  1669.           
  1670.           Where C:\PATH is the drive designator and complete path name
  1671.           where the configuration file is located.
  1672.           
  1673.           CONFIGURATION FILE
  1674.           
  1675.           Most BinkleyTerm parameters are set through a configuration file. 
  1676.           By default, the configuration file is named BINKLEY.CFG, and is
  1677.           expected to be available unless a different configuration file is
  1678.           specified on the command line.
  1679.           
  1680.           A sample BINKLEY.CFG files is included with the distribution
  1681.           package.  You can edit the file with any plain text editor, such
  1682.           as DOS' own EDLIN.  The Reference Guide contains a complete
  1683.           listing of all BinkleyTerm configuration statements and their
  1684.           proper use.
  1685.           
  1686.           BinkleyTerm directly uses the raw configuration file, and each
  1687.           time the program in invoked, BinkleyTerm will scan and process
  1688.           the file, setting internal values to those that you have
  1689.           selected.
  1690.           
  1691.           When you first install BinkleyTerm, or if you change your address
  1692.           ('Address'), inbound files area ('NetFiles'), outbound files area
  1693.           ('Hold'), or NetMail message area ('NetMail') as specified in the
  1694.           configuration file, you must run a special program included with
  1695.           the distribution package called "BTCTL".
  1696.           
  1697.                                         BTCTL
  1698.           
  1699.           BTCTL is used to create two files based on information in the
  1700.           BinkleyTerm configuration file.  First, it produces MAIL.SYS, a
  1701.           Fido-compatible system file used by many mail processing
  1702.           programs.  Second, it produces BINKLEY.PRM, a file used by oMMM,
  1703.           a mail packer nearly always used with BinkleyTerm.  
  1704.           
  1705.           Note!  BTCTL needs to be run only under the circumstances
  1706.           mentioned above.  BTCTL DOES NOT need to be run for minor changes
  1707.  
  1708.                BinkleyTerm Version 2.30 - User's Guide - Page 31
  1709.  
  1710.           to the file that DO NOT include address, inbound file path,
  1711.           outbound file path or NetMail message path.
  1712.           
  1713.           NODELIST
  1714.           
  1715.           The listing of FidoNet compatible systems in your network is
  1716.           called a 'nodelist.'  Once a current nodelist is obtained, it can
  1717.           be kept up-to-date by using so-called NODEDIFF files that are
  1718.           distributed weekly within the network.
  1719.           
  1720.           The nodelist and update files are distributed in 'raw' form. 
  1721.           Adjunct software must be used to process and compile the raw
  1722.           nodelist and NODEDIFF files into a form usable by BinkleyTerm. 
  1723.           From now on, when we refer to "nodelist" we're referring to the
  1724.           compiled, ready-to-use nodelist data files, not the raw nodelist
  1725.           file as distributed within the network.
  1726.           
  1727.           BinkleyTerm is capable of using a variety of compiled nodelist
  1728.           formats.  If you do not already have a BinkleyTerm-compatible
  1729.           format that you desire to use, the primary formats supported by
  1730.           BinkleyTerm are the Opus 'Version 5' nodelist, used by Opus-CBCS
  1731.           1.03b and below, and the Opus 'Version 6' nodelist, used by Opus
  1732.           1.10 and above.  
  1733.           
  1734.           THE VERSION 5 NODELIST SHOULD BE CONSIDERED OBSOLETE.  THE
  1735.           VERSION 6 FORMAT OR THE QUICKBBS FORMAT (DISCUSSED LATER) ARE THE
  1736.           PREFERRED FORMATS FOR BINKLEYTERM, AS SEVERAL IMPORTANT FEATURES
  1737.           ARE UNAVAILABLE WITHOUT THEM.
  1738.           
  1739.           Point installations do not need a nodelist at all if they don't
  1740.           care to have one, simply by using all of the following
  1741.           configuration file statements:
  1742.           
  1743.                - BossPhone
  1744.                - BossPwd
  1745.                - PrivateNet
  1746.                - Address
  1747.           
  1748.           Of course, this requires establishing a session password with
  1749.           your boss (as designated by the 'BossPwd' statement).  With this
  1750.           method, Terminal Mode must be used to poll the boss using the
  1751.           Alt-Y keystroke, as Unattended Mode will not operate without a
  1752.           nodelist available.  Refer to appropriate sections of the manual
  1753.           for additional information.
  1754.           
  1755.                                     FIDOUSER.LST
  1756.           
  1757.           The nodelist processing software is also used to produce
  1758.           FIDOUSER.LST, a list of Sysop names and node address that
  1759.           BinkleyTerm can use when dialing out.  When this file is
  1760.           available to BinkleyTerm, you can enter a Sysop name in place of
  1761.           a node address whenever prompted to enter a node address.  This
  1762.           applies to both Unattended and Terminal Modes, while polling or
  1763.           dialing a system.
  1764.  
  1765.                BinkleyTerm Version 2.30 - User's Guide - Page 32
  1766.  
  1767.           
  1768.           FIDOUSER.LST should be kept in the same sub-directory as the
  1769.           compiled nodelist files are kept.
  1770.           
  1771.                                  Version 5 Nodelist
  1772.           
  1773.           Although this nodelist format is the BinkleyTerm default (for
  1774.           backward compatibility), it is considered obsolete for use with
  1775.           the current version of BinkleyTerm.  
  1776.           
  1777.           If you are running a Fido 11w or Opus 1.0x system, BinkleyTerm
  1778.           can support this nodelist format, but it is highly recommended
  1779.           that you produce both a Version 5 and a Version 6 nodelist for
  1780.           your system; the former for your BBS software, and the latter for
  1781.           use by BinkleyTerm.  Again, the Version 5 nodelist is considered
  1782.           obsolete, and should not be used unless absolutely necessary.
  1783.           
  1784.                                  Version 6 Nodelist
  1785.           
  1786.           Using the Version 6 nodelist allows BinkleyTerm to have more
  1787.           information at its fingertips, specifically, whether a given node
  1788.           in the nodelist supports 'Continuous Mail.'  Some nodelist
  1789.           processors are also able to put modem type information into a
  1790.           compiled Version 6 nodelist.  The extended information in a
  1791.           Version 6 nodelist allows for automatic determination of this
  1792.           information, resulting in fewer errors that result from attempts
  1793.           to manually compensate for such variables.
  1794.           
  1795.           The Version 6 nodelist is a relatively new format.  Nodelist
  1796.           processor commands mentioned in this section apply only to
  1797.           ParseLst, a commonly available nodelist processing package.  You
  1798.           will be able to locate ParseLst from systems that normally carry
  1799.           Opus or BinkleyTerm.  Other nodelist processors may also support
  1800.           this format, and their specific commands may vary.  
  1801.           
  1802.           Make certain that you also make the necessary changes to your
  1803.           configuration file.  Add the 'NewNodelist' statement, and change
  1804.           your event schedules to be compatible as well.  Refer to the
  1805.           Reference Guide for additional information. 
  1806.           
  1807.           Please note that the index files for the Version 5 and Version 6
  1808.           nodelists ARE IDENTICAL.  Therefore, you may use BOTH lists
  1809.           SIMULTANEOUSLY.  This is helpful in installations where Opus-CBCS
  1810.           1.0x or Fido 11w is used under BinkleyTerm.
  1811.           
  1812.           With ParseLst, you'll need to use the following statements in the
  1813.           ParseLst configuration file in order to process a nodelist for
  1814.           BinkleyTerm's use:  UseZone, Complete, and Version6.  Don't
  1815.           forget to use 'NewNodelist' in BinkleyTerm's configuration file.
  1816.           
  1817.                                   QuickBBS Nodelist
  1818.           
  1819.           BinkleyTerm also supports the QuickBBS Version 2.0x nodelist. 
  1820.           This nodelist format is equivalent in functionality to the
  1821.  
  1822.                BinkleyTerm Version 2.30 - User's Guide - Page 33
  1823.  
  1824.           Version 6 nodelist described above, including automatic
  1825.           determination of whether a node can accept Continuous Mail.
  1826.           
  1827.           In order for the QuickBBS nodelist to be used with BinkleyTerm,
  1828.           it MUST be processed by ParseLst Version 1.01 or higher.  At this
  1829.           writing, Qnode, the nodelist processor included with QuickBBS,
  1830.           does not support the extended information BinkleyTerm requires
  1831.           from the nodelist.  ParseLst will insure that the information is
  1832.           included, as well as provide complete compatibility with
  1833.           QuickBBS.  Other nodelist processors, such as XlaxNode, should
  1834.           also be able to produce a QuickBBS nodelist that contains the
  1835.           necessary information for BinkleyTerm to function properly.
  1836.           
  1837.           To use this format, add the statement 'QuickNodelist' to your
  1838.           configuration file.  Refer to the Reference Guide for additional
  1839.           information.
  1840.           
  1841.                                     TBBS Nodelist
  1842.           
  1843.           BinkleyTerm can use the nodelist format supported by TBBS.  In
  1844.           order to obtain additional information about the various nodes in
  1845.           the list, BinkleyTerm requires an adjunct file, NODELIST.EXT.
  1846.           
  1847.           The nodelist is first processed normally for TBBS.  Then,
  1848.           ParseLst is used to produce NODELIST.EXT and NODELIST.IDX from
  1849.           the raw nodelist.  These files are then used together by
  1850.           BinkleyTerm to provide full functionality as described above for
  1851.           the Version 6 nodelist.  This includes automatic determination of
  1852.           whether a node can accept Continuous Mail.  
  1853.           
  1854.           PLEASE NOTE!  The TBBS format DOES NOT provide sufficient
  1855.           information to allow BinkleyTerm's zone support to be active.  If
  1856.           you use this format, YOU MUST ALSO USE the 'NoZones' statement in
  1857.           your configuration file.  Refer to the section "Zone Support" for
  1858.           additional information.
  1859.           
  1860.           To use this format, add the statement 'TBBSNodelist' to your
  1861.           configuration file.  Refer to the Reference Guide for additional
  1862.           information.  Also refer to the ParseLst documentation for more
  1863.           information about compiling NODELIST.EXT.
  1864.           
  1865.                             Nodelist Support Information
  1866.           
  1867.           The authors of BinkleyTerm are willing to consider supporting
  1868.           additional nodelist formats.  To facilitate the support of your
  1869.           nodelist format, the following information is required: 
  1870.           
  1871.                1.  C language structure definition for the format.  (Pascal
  1872.                is acceptable too, but C is preferred.)
  1873.           
  1874.                2.  Definitions of any of the fields in the format.  In
  1875.                particular, bit fields must be defined, and the contents of
  1876.                any field that is not obvious must be given.  
  1877.           
  1878.  
  1879.                BinkleyTerm Version 2.30 - User's Guide - Page 34
  1880.  
  1881.                3.  Compiler and instructions for generating the given
  1882.                nodelist format.  
  1883.           
  1884.                4.  Examples of C code to look-up a given
  1885.                zone:net/node.point number in the nodelist.  (Note that any
  1886.                code used will be given out for free in source form, so this
  1887.                should not be taken lightly.) 
  1888.           
  1889.                5.  A phone number and hours when the author can be reached
  1890.                if there are issues that need to be resolved.
  1891.           
  1892.                6.  IMPORTANT!  A good reason why we should include the
  1893.                format.  
  1894.           
  1895.                7.  IMPORTANT!  If this is for BinkleyTerm front-ending for
  1896.                a certain type of BBS, the author should include
  1897.                configuration files, batch files, etc. that will be
  1898.                necessary for others to use BinkleyTerm and his BBS.  This
  1899.                will save us a lot of work tracking these things down in the
  1900.                long run.  
  1901.           
  1902.           If all of this information is forwarded to 1:132/101, 1:141/491
  1903.           or 1:104/36 we can get back to the author within a week or two to
  1904.           tell them whether the format will be in the next release.  
  1905.           
  1906.           ZONE SUPPORT
  1907.           
  1908.           Zones are a high-level addressing scheme devised for use within
  1909.           FidoNet.  In a full FidoNet address, such a 1:104/36.0, '1' would
  1910.           be the zone, '104' the net, '36' the node number, and '0' the
  1911.           point number.  Currently, zone addressing is not supported within
  1912.           the FidoNet message or packet structure, allowing software such
  1913.           as BinkleyTerm to provide only "kludged" support of zones. 
  1914.           BinkleyTerm offers such support, and endeavors to make it as
  1915.           seamless as possible.  
  1916.           
  1917.           If for some reason you do not wish zone support to be active,
  1918.           place the statement 'NoZones' in your configuration file.  This
  1919.           will cause BinkleyTerm to essentially "turn off" zone support. 
  1920.           If you intend not to use zone support, then use the 'NoZones'
  1921.           configuration file statement.
  1922.           
  1923.           If you have not used the 'NoZones' statement, BinkleyTerm will
  1924.           assume that a full, zone-based nodelist is available for its use. 
  1925.           For information on how to properly compile a nodelist for
  1926.           BinkleyTerm, refer to the section "Nodelist" for more
  1927.           information.
  1928.           
  1929.           When attempting to send mail to nodes in other zones, BinkleyTerm
  1930.           will assume that mail for other zones will be held in separate
  1931.           outbound areas by zone number.  For example, if your outbound
  1932.           mail directory is C:\BT\OUTBOUND, mail for your zone will be held
  1933.           there.  However, mail for nodes in zone 2 would be expected in
  1934.           C:\BT\OUTBOUND.002, mail for zone 3 would be expected in
  1935.  
  1936.                BinkleyTerm Version 2.30 - User's Guide - Page 35
  1937.  
  1938.           C:\BT\OUTBOUND.003, and so on.  This example is for zone 1.
  1939.           
  1940.           The zone number for which your default outbound directory applies
  1941.           is determined by the FIRST appearance of the 'Address' statement
  1942.           in your configuration file.  Subsequent 'Address' statements
  1943.           identify your alternate identities within other zones (and/or
  1944.           networks).  For example, if the first 'Address' statement
  1945.           designates an address in zone 2, then the outbound area
  1946.           designated by the 'Hold' statement in your configuration file is
  1947.           the default, and mail to other zones would require their own
  1948.           distinct outbound areas with extensions that match the zone
  1949.           number.
  1950.           
  1951.           The multi-zone outbound areas are in hexadecimal.  For example,
  1952.           the outbound area for zone 10 would be C:\BT\OUTBOUND\.00A. 
  1953.           Using this method, it is possible to support up to 4,095 zones.
  1954.           
  1955.           Your mail packer also needs to support the discrete outbound
  1956.           areas for multiple zones.  oMMM versions greater than 1.30
  1957.           support them, as well as the MOOO package.  oMMM is commonly
  1958.           available wherever BinkleyTerm or Opus-CBCS files are available. 
  1959.           MOOO is also available from many such locations.
  1960.           
  1961.           MULTIPLE NETWORK OPERATION
  1962.           
  1963.           Operation of a system within multiple networks is becoming
  1964.           increasingly popular.  Normally, networks such as AlterNet,
  1965.           EggNet, RBBS-Net and so on are implemented as separate zones.  To
  1966.           facilitate operation of a BinkleyTerm system within multiple
  1967.           networks, you may specify a separate system address, each with a
  1968.           different zone.
  1969.           
  1970.           For example, if you wish to use a different address for FidoNet
  1971.           (currently zones 1, 2, 3 and 4) and for two alternative networks,
  1972.           you might have the following in your configuration file:
  1973.           
  1974.                Address 1:1010/89.0
  1975.                Address 9:569/999.0
  1976.                Address 11:334/1.0
  1977.           
  1978.           If your system connects with a system in zone 9, your system will
  1979.           identify itself as 9:569/999.  If connected with a zone 11
  1980.           system, it will identify itself as 11:334/1.  The first 'Address'
  1981.           statement is the default, and callers in zone 1 (and any zones
  1982.           other than 1, 9 and 11 - those specified with 'Address'
  1983.           statements) would find your system identified as 1:1010/89.
  1984.           
  1985.           SECURITY
  1986.           
  1987.           In the ideal world, we would not need locks, police, or jails;
  1988.           there wouldn't be crime.  But we don't live in an ideal world,
  1989.           and for this reason, BinkleyTerm offers a selection of features
  1990.           that are intended to offer your system a certain level of
  1991.           security against "electronic mail crime."
  1992.  
  1993.                BinkleyTerm Version 2.30 - User's Guide - Page 36
  1994.  
  1995.           
  1996.           The existence of security features is not intended to evoke fear. 
  1997.           Chances are excellent that you will have no need for security
  1998.           features in most cases.  But just as high crime areas see more
  1999.           locks and iron gates than low-crime areas, the choice of how much
  2000.           security to put in place is up to you, and is based on your needs
  2001.           and experience.
  2002.           
  2003.           BinkleyTerm's internal security is based on a simple principle. 
  2004.           With the exception of session passwording, for each secured
  2005.           feature (all of which are specified within the configuration
  2006.           file), there is a default statement.  When you implement no
  2007.           security features, the default statement is used to specify a
  2008.           particular feature's configuration.
  2009.           
  2010.                                         Prot
  2011.           
  2012.           When security is implemented, however, two more statements are
  2013.           used in addition to the default.  One type of statement, known as
  2014.           "Prot" for "protected," describes a group of systems with which
  2015.           you have implemented session passwording.  These links are
  2016.           "protected" by passwords.  
  2017.           
  2018.           When session passwording is implemented, unless a password is
  2019.           matched when connecting to a protected system, a mail session is
  2020.           aborted.  
  2021.           
  2022.           "Protected" or "Prot" systems are the top-level, or "most
  2023.           favored" situations, since you generally know the other person at
  2024.           the other end (a pre-requisite to establishing a password).
  2025.           
  2026.                                         Known
  2027.           
  2028.           The second type of statement is called "Known" and describes
  2029.           systems that are listed in the nodelist ("known" to you) but with
  2030.           whom you have not established a session password.  These are
  2031.           links with listed systems, but links that are not password
  2032.           protected.  This group represents the middle-level of security.
  2033.           
  2034.                                        Default
  2035.           
  2036.           When you use a Prot and/or a Known security feature, then the
  2037.           default statements all take on a new meaning - that of unknown
  2038.           systems.  The defaults are used for links that are not in the
  2039.           nodelist, and therefore, cannot have a session password
  2040.           established.  This group of systems represents the lowest-level
  2041.           of security, since you really have no idea who owns such systems,
  2042.           or where they are located.
  2043.           
  2044.                            Security - Session Passwording
  2045.           
  2046.           BinkleyTerm supports session-level password protection.  Using
  2047.           such protection helps prevent situations where someone uses a
  2048.           FidoNet mailer to 'impersonate' a legitimate FidoNet node, and
  2049.  
  2050.                BinkleyTerm Version 2.30 - User's Guide - Page 37
  2051.  
  2052.           pickup mail addressed to the node.  When implemented, both the
  2053.           sending and receiving systems must have it in operation, with the
  2054.           same password on both ends (exceptions noted below).
  2055.           
  2056.           With Point systems, passwording can be automatic.  Simply use the
  2057.           'BossPwd' configuration file option, and choose a password.  Make
  2058.           sure your Boss also uses the same password.
  2059.           
  2060.           For other types of systems, password information is kept in the
  2061.           nodelist data file.  ParseLst (and some other nodelist
  2062.           processors) can easily add a password to a nodelist entry during
  2063.           processing.  Refer to the documentation for your nodelist
  2064.           processor. 
  2065.           
  2066.           When talking with other BinkleyTerm, Opus or compatible systems
  2067.           that use the YooHoo session negotiation method, full, two-way
  2068.           protection is available.  The systems connect and exchange the
  2069.           password when the YooHoo takes place.  If the passwords do not
  2070.           match, the session is terminated, regardless of who initiated the
  2071.           call.  The only exception is when you have a password
  2072.           implemented, but the remote has NO password implemented.  In this
  2073.           case, if YOU placed the call, then a session will still occur. 
  2074.           If the REMOTE placed the call, then the session will be aborted.
  2075.           
  2076.           When connected with SEAdog and compatible systems, password
  2077.           matching takes place only when you are picking up mail from the
  2078.           remote system.  You may send to a SEAdog system without a
  2079.           password match taking place.  (The assumption is that you always
  2080.           know who you're calling, but don't always know who's calling
  2081.           you.)
  2082.           
  2083.           Note that session passwords must not exceed eight (8) characters,
  2084.           and are case insensitive.
  2085.           
  2086.           When BinkleyTerm cannot find a password for a remote system when
  2087.           placing a call, it will not check for a password during the
  2088.           session.  This responsibility is left to the remote system, if
  2089.           the remote chooses to perform checking.
  2090.           
  2091.           BinkleyTerm allows easy implementation of new passwords.  Simply
  2092.           add the agreed upon password as outlined above, and send the
  2093.           remote system a message.  BinkleyTerm will allow an outbound
  2094.           session to take place in cases where you have designated a
  2095.           password, but the remote has not yet implemented it.  This is
  2096.           handy for letting a remote system know that a password was
  2097.           implemented.  Note that in this case, BinkleyTerm will NOT allow
  2098.           the remote to have a successful session when the remote calls
  2099.           your system; only when you place the call (as stated above, the
  2100.           idea is that you know who you're calling, not who's calling you).
  2101.           
  2102.                         Security - Secured Inbound File Areas
  2103.           
  2104.           Another method of securing the flow of mail involves controlling
  2105.           the processing of incoming mail to your system.  In most cases,
  2106.  
  2107.                BinkleyTerm Version 2.30 - User's Guide - Page 38
  2108.  
  2109.           you will want to protect common mail links with session
  2110.           passwording, as outlined in the previous section.  Still, the
  2111.           potential exists for another abusive system to send you rogue
  2112.           mail, or mail "planted" onto your system in hopes that it will be
  2113.           routed to another system at your expense, or find its way into a
  2114.           national EchoMail conference.
  2115.           
  2116.           The following list shows the various security levels and the
  2117.           configuration file statements that define their respective
  2118.           inbound paths:
  2119.           
  2120.                Prot      'ProtInbound'
  2121.           
  2122.                Known     'KnownInbound'
  2123.           
  2124.                Default   'NetFile'
  2125.           
  2126.           In a typical installation secured in this manner, mail will
  2127.           automatically be processed only if received to the 'ProtInbound'
  2128.           area.  Mail received to 'KnownInbound' or 'NetFile' must be
  2129.           examined and processed manually.  Of course, you could choose to
  2130.           configure your system in a such a manner that mail received in
  2131.           any of the three areas is processed automatically to your liking,
  2132.           possibly to special message areas.  
  2133.           
  2134.           The only "hole" in this is with FSC-0001 sessions, such as those
  2135.           with SEAdog or Fido.  Since BinkleyTerm has no way of knowing the
  2136.           address of the sending system until a packet is received, that
  2137.           first packet (.PKT file) will always be placed in the default
  2138.           area specified by the 'NetFile' statement.
  2139.           
  2140.           Secured inbound file areas simply provide another, extra measure
  2141.           of handling potential security problems associated with the
  2142.           reception of "rogue" or "planted" mail.
  2143.           
  2144.                         Security - Controlling File Requests
  2145.           
  2146.           BinkleyTerm offers a method of establishing limitations on file
  2147.           requests received from systems that are not session password
  2148.           protected, or are not found in the nodelist.  This support is
  2149.           optional; if you do not wish to limit file requests in this
  2150.           manner, use only the files and configuration file statements
  2151.           mentioned in the section "File Requests."
  2152.           
  2153.           The following table lists these possibilities, the file types (as
  2154.           described in the section "File Requests") and the respective
  2155.           configuration file statement used:
  2156.           
  2157.                Prot      ABOUT     'ProtAbout'
  2158.                          AVAIL     'ProtAvail'
  2159.                          OKFILE    'ProtReqList'
  2160.                          Maximum   'ProtReqLim'
  2161.           
  2162.                Known     ABOUT     'KnownAbout'
  2163.  
  2164.                BinkleyTerm Version 2.30 - User's Guide - Page 39
  2165.  
  2166.                          AVAIL     'KnownAvail'
  2167.                          OKFILE    'KnownReqList'
  2168.                          Maximum   'KnownReqLim'
  2169.           
  2170.                Default   ABOUT     'About'
  2171.                          AVAIL     'Avail'
  2172.                          OKFILE    'Okfile'
  2173.                          Maximum   'MaxReq'
  2174.           
  2175.           Essentially, the default files and configuration file statements
  2176.           described in the section "File Requests" are used for all file
  2177.           requests by default unless a higher "Known" or "Prot" statement
  2178.           is used. 
  2179.           
  2180.           Note that all file request controls apply to update requests and
  2181.           function requests as well.
  2182.           
  2183.                          Security - Response File Templates
  2184.           
  2185.           Refer to the section "Request Response Files" for information on
  2186.           their operation and use.
  2187.           
  2188.           It is possible to designate separate response file templates for
  2189.           each of the three security levels.  Generally, you won't want or
  2190.           need to do this unless security controls on file requests have
  2191.           been implemented.
  2192.           
  2193.           The security levels and their respective configuration files
  2194.           statements for secured response file templates are:
  2195.           
  2196.                Prot      'ProtReqTpl'
  2197.           
  2198.                Known     'KnownReqTpl'
  2199.           
  2200.                Default   'ReqTemplate'
  2201.           
  2202.           BBS INTERFACE
  2203.           
  2204.           One of the most common uses of BinkleyTerm is as a mail front-end
  2205.           for a bulletin board system, or BBS.  BinkleyTerm offers three
  2206.           different methods for passing control to a BBS.  The method you
  2207.           use is determined by a configuration file statement (refer to the
  2208.           Reference Guide for details).
  2209.           
  2210.                                       BBS Exit
  2211.           
  2212.           The 'BBS Exit' option will cause BinkleyTerm to exit to the
  2213.           start-up batch file with an errorlevel of the baud rate divided
  2214.           by 100 upon receipt of a non-mail call.  For example, a 300 baud
  2215.           caller exits to the batch file with an errorlevel of 3, a 2400
  2216.           baud caller at errorlevel 24. 
  2217.           
  2218.           The batch file then detects the errorlevel, and jumps to a
  2219.           section of the batch file you designate to start the BBS program
  2220.  
  2221.                BinkleyTerm Version 2.30 - User's Guide - Page 40
  2222.  
  2223.           with the required information.  The batch file should recycle and
  2224.           restart BinkleyTerm once BBS use is terminated.
  2225.           
  2226.                                       BBS Spawn
  2227.           
  2228.           The 'BBS Spawn' option causes BinkleyTerm to stay resident when a
  2229.           caller accesses the BBS.  BinkleyTerm will execute the following
  2230.           command as a child process: 
  2231.           
  2232.                spawnbbs <baud> <port> <time> <modem_info>
  2233.           
  2234.           SPAWNBBS.BAT is the name of a batch file you create.  <baud> is
  2235.           the baud rate of the connection, <port> is the communications
  2236.           port number used for the call, and <time> is the number of
  2237.           minutes to the next non-BBS-allowed event (as designated in your
  2238.           configuration file event schedules).  <modem_info> is intended
  2239.           primarily for RBBS-PC installations where extended modem connect
  2240.           information may be desired.  For example, USRobotics HST modems
  2241.           might issue the connect message "CONNECT 9600/ARQ" in which case
  2242.           the <modem_info> parameter would be "/Arq" indicating a
  2243.           "reliable" connection.  Note that in this parameter, only the
  2244.           first letter of each "word" will be capitalized (as shown in the
  2245.           example).  
  2246.           
  2247.           The batch file can use the parameters passed to it with standard
  2248.           DOS conventions.  %1 designates the first parameter (baud rate in
  2249.           this case), %2 the second parameter (port number), and so on. 
  2250.           Opus might be started from SPAWNBBS.BAT with this command line: 
  2251.           
  2252.                opus bbs -b%1 -p%2 -t%3
  2253.                 
  2254.           Refer to the documentation for your particular BBS for the
  2255.           command line information that can be passed to the BBS.
  2256.           
  2257.           The primary disadvantage of the 'BBS Spawn' option is that
  2258.           BinkleyTerm stays memory resident while the BBS operates.  This
  2259.           could cause memory availability problems on some systems.  Be
  2260.           certain to check the memory requirements of your BBS software.
  2261.           
  2262.           If you choose to use the 'SwapDir' configuration file option, the
  2263.           'BBS Spawn' option will be workable.  Using 'SwapDir' causes
  2264.           BinkleyTerm to leave only a small kernel of itself in memory when
  2265.           performing DOS shells, making available substantially more memory
  2266.           than would otherwise be available.  Refer to the Reference Guide
  2267.           section "Configuration File" for additional information.
  2268.           
  2269.                                       BBS Batch
  2270.           
  2271.           The 'BBS Batch' option uses the best of both of 'BBS Exit' and
  2272.           'BBS Spawn.'  
  2273.           
  2274.           BinkleyTerm still exits to the start-up batch file, but prior to
  2275.           exiting, BinkleyTerm physically writes to the disk a batch file
  2276.           named BBSBATCH.BAT, which contains a single line.  An example of
  2277.  
  2278.                BinkleyTerm Version 2.30 - User's Guide - Page 41
  2279.  
  2280.           the contents of this file might be: 
  2281.           
  2282.                spawnbbs 2400 1 47 /Arq
  2283.           
  2284.           The information is the baud rate, port number and time in minutes
  2285.           to the next non-BBS event.  In this case, there is a 2400 baud
  2286.           caller, on COM port 1, with 47 minutes remaining to the next non-
  2287.           BBS event, and a modem information string of /Arq.
  2288.                    
  2289.           After writing this file, BinkleyTerm exits as does the 'BBS Exit'
  2290.           option, with an errorlevel of the baud rate of the caller divided
  2291.           by 100. 
  2292.           
  2293.           The start-up batch file should simply start execution of 
  2294.           BBSBATCH.BAT by adding the line "bbsbatch" to the file, and
  2295.           jumping to the line whenever a human caller is on-line.  In other
  2296.           words, regardless of the baud rate of the caller, BBSBATCH.BAT
  2297.           should be invoked.
  2298.           
  2299.           Once invoked, BBSBATCH.BAT will invoke SPAWNBBS.BAT with the 
  2300.           necessary parameters that include the baud rate, port number, and
  2301.           minute to the next non-BBS event.  SPAWNBBS.BAT would physically
  2302.           invoke the BBS with the proper command lines.  When use of the
  2303.           BBS is complete, this batch file should re-invoke the BinkleyTerm
  2304.           start-up batch file.
  2305.           
  2306.           Using this 'BBS Batch' method of accessing the BBS, BinkleyTerm
  2307.           can still provide all the information of the 'BBS Spawn' method,
  2308.           without the necessity of staying resident.  
  2309.           
  2310.           
  2311.           
  2312.           
  2313.           
  2314.           
  2315.           
  2316.           
  2317.           
  2318.           
  2319.           
  2320.           
  2321.           
  2322.           
  2323.           
  2324.           
  2325.           
  2326.           
  2327.           
  2328.           
  2329.           
  2330.           
  2331.           
  2332.           
  2333.           
  2334.  
  2335.                BinkleyTerm Version 2.30 - User's Guide - Page 42
  2336.  
  2337.                              BBS Batch Method Flowchart
  2338.           
  2339.           The 'BBS Batch' method of accessing BBS software is confusing to
  2340.           many BinkleyTerm users.    
  2341.           
  2342.           For further clarification, a flowchart of this method is shown
  2343.           here: 
  2344.           
  2345.                               +-----------------------+
  2346.                               |     Wait for Call     | <-------------+    
  2347.                               +-----------------------+               |
  2348.                                           |                           | 
  2349.                                           v                           |    
  2350.                           No  +-----------------------+               |    
  2351.                   Mail <------|     Human Caller?     |               |
  2352.                               +-----------------------+               |
  2353.                                       Yes |                           |
  2354.                                           v                           |
  2355.                          300  +-----------------------+  1200         |
  2356.                        +------|       Baud Rate       |------+        |
  2357.                        |      +-----------------------+      |        |
  2358.                        |         2400 |       | 9600         |        |
  2359.                        +--------+     |       |     +--------+        |
  2360.                                 |     |       |     |                 |
  2361.                                 v     v       v     v                 |
  2362.                               +-----------------------+               |
  2363.                               |  Invoke BBSBATCH.BAT  |               |
  2364.                               +-----------------------+               |
  2365.                                           |                           |
  2366.                                           v                           |
  2367.                               +-----------------------+               |
  2368.                               |  Invoke SPAWNBBS.BAT  |               |
  2369.                               |     w/ Parameters     |               |
  2370.                               +-----------------------+               |
  2371.                                           |                           |
  2372.                                           v                           |
  2373.                               +-----------------------+               |
  2374.                               |   Invoke BBS System   |               |
  2375.                               |     w/ Parameters     |               |
  2376.                               +-----------------------+               |
  2377.                                           |                           |
  2378.                                           +---------------------------+
  2379.           
  2380.                                        Banner
  2381.           
  2382.           When a file named BINKLEY.BAN is present in the directory that
  2383.           BinkleyTerm is invoked from, the file will be displayed to
  2384.           callers immediately after the BinkleyTerm identification line.
  2385.           
  2386.           The file is a flat ASCII text file, and may contain extended
  2387.           information for the benefit of callers.  
  2388.           
  2389.           
  2390.           
  2391.  
  2392.                BinkleyTerm Version 2.30 - User's Guide - Page 43
  2393.  
  2394.           EXTERNAL MAIL PROGRAMS
  2395.           
  2396.           BinkleyTerm can be used with external mail programs, such as
  2397.           UUCP.  
  2398.           When an 'ExtrnMail' statement is used in the configuration file,
  2399.           BinkleyTerm will answer the phone and wait for a YooHoo or TSYNC
  2400.           (the start of a mail session) or a string you designate with the
  2401.           'ExtrnMail' option.  When the designated string is received from
  2402.           the remote system, BinkleyTerm will send the string associated
  2403.           with the 'MailNote' configuration file option (if any), then will
  2404.           physically write a batch file called MAILBAT.BAT to the disk, and
  2405.           exit the start-up batch file with an errorlevel as given with the
  2406.           'ExtrnMail' statement, or with errorlevel 99 if none was given. 
  2407.           
  2408.           MAILBAT.BAT contains a single line:
  2409.           
  2410.                EXTMAIL <baud> <port> <time> <errorlevel> <modem_info>
  2411.           
  2412.           Where <baud> is the baud rate of the caller, <port> is the COM
  2413.           port number, and <time> is the time in seconds to the next non-
  2414.           BBS event, <errorlevel> is the errorlevel number used to exit the
  2415.           original batch file, and <modem_info> is extended modem connect
  2416.           information.
  2417.           
  2418.           <errorlevel> will be the same as that given with the 'ExtrnMail'
  2419.           statement in the configuration file, or "99" if none was given. 
  2420.           
  2421.           <modem_info> is intended primarily for RBBS-PC installations
  2422.           where extended modem connect information may be desired.  For
  2423.           example, USRobotics HST modems might issue the connect message
  2424.           "CONNECT 9600/ARQ" in which case the <modem_info> parameter would
  2425.           be "/Arq" indicating a "reliable" connection.  Note that in this
  2426.           parameter, only the first letter of each "word" will be
  2427.           capitalized (as shown in the example).  
  2428.           
  2429.           Notice the similarity in concept between this and the 'BBS Batch'
  2430.           method of invoking a BBS (as described previously).  When
  2431.           BinkleyTerm exits with the previously defined errorlevel, your
  2432.           batch file must capture the errorlevel and invoke MAILBAT.BAT,
  2433.           which will in turn invoke EXTMAIL.BAT with the various command
  2434.           line parameters shown above.
  2435.           
  2436.           EXTMAIL.BAT is then used to invoke the external mail program of
  2437.           your choice, taking the needed command line parameters as
  2438.           supplied by the batch file, and processing and/or using them as
  2439.           needed.  Once the external mail program session has been
  2440.           completed, your original start-up batch file for BinkleyTerm
  2441.           should be invoked to place BinkleyTerm on-line again.
  2442.           
  2443.           USER-SELECTED BBS FUNCTIONALITY
  2444.           
  2445.           An additional use for the external mail functionality described
  2446.           in the previous section would be to allow multiple BBS systems to
  2447.           reside at the same telephone number, and to give BBS users the
  2448.  
  2449.                BinkleyTerm Version 2.30 - User's Guide - Page 44
  2450.  
  2451.           ability to select the desired BBS from a menu.  It would be
  2452.           possible to run completely separate systems, to run the same
  2453.           system with different BBS packages, and so on.  This section will
  2454.           give an overview of the procedure.
  2455.           
  2456.           Basically, 'ExtrnMail' statements in the configuration file are
  2457.           used to build the menu options themselves.  If you want to exit
  2458.           to the batch file when a user presses 'A' on their terminal, then
  2459.           a configuration file entry like this would be needed:
  2460.           
  2461.                ExtrnMail 130 A
  2462.           
  2463.           This would cause BinkleyTerm to write MAILBAT.BAT to the disk,
  2464.           and exit to the batch file with an errorlevel of 130.  As
  2465.           described in the previous section on external mail programs, your
  2466.           batch file should invoke MAILBAT.BAT, which in turn invokes
  2467.           EXTMAIL.BAT.  EXTMAIL.BAT would be the batch file that acts upon
  2468.           the choice, and physically invokes the desired BBS program.
  2469.           
  2470.           If you want the choices to be case-insensitive, then two
  2471.           'ExtrnMail' statements would be needed for each letter, like
  2472.           this:
  2473.           
  2474.                ExtrnMail 130 A
  2475.                ExtrnMail 130 a
  2476.           
  2477.           This would cause BinkleyTerm to use errorlevel 130 when either
  2478.           'a' or 'A' is received from the user.
  2479.           
  2480.           The menu presented to users should be kept in a file called
  2481.           BINKLEY.BAN (refer to the "Banner" section for more information). 
  2482.           This file might look like this:
  2483.           
  2484.                Welcome to Multi-System 100.  Please choose the desired BBS:
  2485.           
  2486.                     A - "Garden Central" Using QuickBBS Software
  2487.                     B - "Margarita Bay" Using Opus-CBCS Software
  2488.                     C - "Margarita Bay" Using Fido 11w Software
  2489.           
  2490.                Make your selection by letter...
  2491.           
  2492.           Such a menu would allow users three options.  Each lettered
  2493.           option would require a separate 'ExtrnMail' statement in the
  2494.           configuration file; two each if case insensitivity is required.
  2495.           
  2496.           The string "Make your selection by letter..." is NOT contained in
  2497.           BINKLEY.BAN, but rather, is added with a 'Banner' statement in
  2498.           the configuration file so that the line is re-displayed each time
  2499.           a user makes an incorrect choice (refer to the Reference Guide
  2500.           section "Configuration File" for information).
  2501.           
  2502.           Once the user has made a selection, and MAILBAT.BAT is invoked
  2503.           and in turn EXTMAIL.BAT is invoked, then the batch file must
  2504.           determine which selection is made and act upon it.
  2505.  
  2506.                BinkleyTerm Version 2.30 - User's Guide - Page 45
  2507.  
  2508.           
  2509.           In EXTMAIL.BAT (where the BBS systems are invoked), the top of
  2510.           the batch file should make a determination as to which choice was
  2511.           given by the user.  One of the parameters on the command line
  2512.           when EXTMAIL.BAT is invoked by MAILBAT.BAT is the errorlevel
  2513.           which corresponds to the choice the user gave (as designated by
  2514.           an 'ExtrnMail' statement in the configuration file).  
  2515.           
  2516.           A section of the batch file might look like this:
  2517.           
  2518.                if %4 == 130 goto bbs1
  2519.                if %4 == 140 goto bbs2
  2520.                if %4 == 150 goto bbs3
  2521.           
  2522.           The fourth parameter given on the command line is the errorlevel
  2523.           value, and is reference by "%4" as shown.  For example, if the
  2524.           errorlevel that corresponds to the choice was 130, then batch
  2525.           file execution would jump to the "bbs1" label, and invoke a
  2526.           particular BBS program.  
  2527.           
  2528.           Please note that the default is for a user to press the "escape"
  2529.           key to enter the BBS.  One of the BBS systems should be setup as
  2530.           the default system as described in the section "BBS Interface." 
  2531.           Should a user press "escape," or if the time limit to make a
  2532.           response should expire, the default BBS would be invoked.  
  2533.           
  2534.           Note also that the configuration file parameter 'Timeout' should
  2535.           be extended to allow a user more time to read and make a
  2536.           selection prior to making a default exit.  A 'Timeout' value of
  2537.           30 to 60 seconds is suggested.  
  2538.           
  2539.           Placing multiple BBS systems on-line at one number takes some
  2540.           work and experimentation in order to operate correctly. 
  2541.           Hopefully the tips given here will point you in the right
  2542.           direction. 
  2543.           
  2544.           FILE REQUESTS
  2545.           
  2546.           BinkleyTerm supports the two popular file request methods 
  2547.           currently in use in FidoNet; "Bark" requests as designed for and
  2548.           used by SEAdog, and "WaZOO" as designed for and used by Opus-
  2549.           CBCS.  Either style can be used on an incoming or outgoing basis.
  2550.           
  2551.           To generate an outgoing file request, use one of the many
  2552.           utilities designed for the purpose, such as AMAX, Please, oGet,
  2553.           tGet, etc.  Any Opus-compatible file request builder can be used
  2554.           with BinkleyTerm.  You may also manually build file requests. 
  2555.           They are a single-line flat ASCII text file, and are named in the
  2556.           same manner as packets (refer to the section "How BinkleyTerm
  2557.           Handles Mail" for information on the naming convention) and have
  2558.           a file extension of .REQ.  Outgoing requests NEVER should have a
  2559.           drive and path designation; only the file name.  The remote
  2560.           system handles the drives and paths.
  2561.                    
  2562.  
  2563.                BinkleyTerm Version 2.30 - User's Guide - Page 46
  2564.  
  2565.           The .REQ file is placed in your outbound holding area. 
  2566.           BinkleyTerm will handle .REQ files in the same manner as it does
  2567.           Normal packets (unless an 'X' flag is applied to an event), but
  2568.           you can also manually poll to send the request immediately. 
  2569.           
  2570.           Incoming requests are controlled and affected by four files, each
  2571.           of which are designated in the configuration file.
  2572.           
  2573.           The first file, OKFILE, is a machine-read listing of files,
  2574.           complete with drive and path, that you will allow to be sent to
  2575.           remote systems via file request.  The file is designated with the
  2576.           'Okfile' statement in the configuration file.  Wildcards are
  2577.           allowed, and nearly always used.  When an incoming request is
  2578.           received, the request is checked against the OKFILE to see if you
  2579.           permit the file to be sent.  
  2580.           
  2581.           The OKFILE also allows you to implement "magic filenames" which
  2582.           are words used to represent a file.  If someone requests
  2583.           "BINKLEY" from you, for example, you could set-up your OKFILE in
  2584.           such a way as to send BEXE_150.ARC in return.  This frees the
  2585.           person making the request from having to know the exact filename
  2586.           of the file he wants.  This is generally used by systems which
  2587.           are software distribution points, hubs, and so on.
  2588.           
  2589.           Password protection may also be implemented with the OKFILE,
  2590.           making a password required in order to receive a particular file
  2591.           or group of files.
  2592.           
  2593.           A sample OKFILE:
  2594.           
  2595.                b:\aprog.ARC
  2596.                c:\file\stuff\*.*
  2597.                c:\file\programs\wlc*.txt
  2598.                c:\file\private\*.* !mypass
  2599.                @BINKLEY c:\file\dist\bexe_150.arc 
  2600.                @MYEDIT !outpass c:\file\private\editmax.arc
  2601.           
  2602.           The first line gives an exact filename.  The second and third    
  2603.           lines show the use of wildcards.  The fourth line shows password
  2604.           protection, with an exclamation point (!) followed by the
  2605.           password.  The fifth line shows a magic filename, an 'at' symbol
  2606.           (@) followed by the magic filename, followed by an exact drive,
  2607.           path and filename designation.  The sixth line shows a magic
  2608.           filename with password protection.
  2609.           
  2610.           Note that in all cases, a password (if any) is always the second
  2611.           argument in an OKFILE entry.
  2612.           
  2613.           The next special file is the AVAIL file, and is designated by the
  2614.           'Avail' statement in the configuration file.  When someone
  2615.           requests the magic filename "FILES" BinkleyTerm will send this
  2616.           file.  It is a list of the files you have available for request,
  2617.           in human readable form.  This is a flat ASCII text file, and
  2618.           should feature the name of the file, and usually its size in
  2619.  
  2620.                BinkleyTerm Version 2.30 - User's Guide - Page 47
  2621.  
  2622.           bytes and a short description of the file.  There are utilities
  2623.           available that can construct this file automatically based on
  2624.           your BBS system's internal listings.  Of course, it could also be
  2625.           manually created.
  2626.           
  2627.           The next special file is called the ABOUT file, and is designated
  2628.           by the 'About' statement in the configuration file.  When someone
  2629.           makes a request for the magic filename "ABOUT" or when someone
  2630.           makes an invalid WaZOO file request, this file is sent by
  2631.           BinkleyTerm.  It normally contains a short advertisement about
  2632.           your system, as well as a notification that the calling system
  2633.           could possibly have made an invalid request.  Again, this is a
  2634.           flat ASCII text file in human-readable form. 
  2635.           
  2636.           The ABOUT file is sent only on failed WaZOO requests.  The file
  2637.           is NOT sent on failed Bark requests. 
  2638.           
  2639.           Finally, the last item that applies to file requests is the
  2640.           'MaxReq' statement contained in the configuration file.  A
  2641.           quantity is given with the statement which allows you to
  2642.           designate the maximum number of files that will be sent during
  2643.           one file request session.  Refer to the Reference Guide section
  2644.           "Configuration File" for more information.
  2645.           
  2646.           It is possible to limit incoming file requests based on some
  2647.           basic criteria.  For information, refer to the section "Security
  2648.           - Controlling File Requests."
  2649.           
  2650.           UPDATE REQUESTS
  2651.           
  2652.           Update requests are a method of obtaining an "update" of a file
  2653.           you already have, from another system you believe to have a newer
  2654.           copy.  They differ from file requests in that when you construct
  2655.           an update request, you include a drive/path/file specification
  2656.           that points to an existing file on your system.  Generally, DOS
  2657.           wildcards are acceptable.  When BinkleyTerm connects with the
  2658.           desired remote, it will compare the date and time stamp on your
  2659.           copy of the file(s) to the date and time stamp of the same-named
  2660.           file(s) on the remote system.  If the remote system has a newer
  2661.           copy of a given file, it will be sent.  If it does not, no file
  2662.           will be sent.  Note that the drive and path specification DO NOT
  2663.           need to be the same on the remote system; the drive and path you
  2664.           give refer only to YOUR copy of the file.  The remote may have
  2665.           any file structure he or she desires.
  2666.           
  2667.           Update requests were originally implemented in SEAdog, a mailer
  2668.           from System Enhancement Associates, Inc.  In addition to
  2669.           supporting update requests with SEAdog systems, BinkleyTerm
  2670.           implements a newly defined WaZOO update request for use other
  2671.           BinkleyTerm systems, or other mailers that support WaZOO update
  2672.           requests.
  2673.           
  2674.           Update requests are most commonly used now to handle GroupMail, a
  2675.           new method of sharing message areas developed by System
  2676.  
  2677.                BinkleyTerm Version 2.30 - User's Guide - Page 48
  2678.  
  2679.           Enhancement Associates, Inc.  GroupMail generally requires update
  2680.           request capability on both ends of the connection.  
  2681.           
  2682.           Like file requests, update requests are kept in .REQ files in
  2683.           your outbound area.  In fact, a combination of update and file
  2684.           requests can be contained in the same physical .REQ file.  An
  2685.           update request entry contains a filename, as well as a date and
  2686.           time code that corresponds to the date and time stamp of the file
  2687.           on your system.  Because the date and time code is in a special
  2688.           format, it is not recommended that you attempt to create an
  2689.           update request entry yourself.
  2690.           
  2691.           At this writing, the oMMM mail packer (version 1.30 or higher)
  2692.           and the AMAX outbound utility (version 2.10 or higher) both
  2693.           support the creation of update requests in the manner that
  2694.           BinkleyTerm requires.  Refer to the documentation for those
  2695.           programs for additional information on creating update requests. 
  2696.           Certainly other utilities will eventually have this ability as
  2697.           well.
  2698.           
  2699.           Please note that in order for update requests to work, the remote
  2700.           system must have the file you want updated available for regular
  2701.           file request.  You cannot update a file that would not otherwise
  2702.           be available for file request from the remote system.
  2703.           
  2704.           REQUEST RESPONSE FILES
  2705.           
  2706.           Incoming file and update requests are not always successful. 
  2707.           BinkleyTerm supports the ability to dynamically generate a
  2708.           "response file."  This file is a plain text file, built "on-the-
  2709.           fly" during a session, and sent in response to a failed (or
  2710.           optionally, a successful) file or update request.  If you choose
  2711.           to implement request response files, the "about" file designated
  2712.           in your configuration file will no longer be sent.  See "File
  2713.           Requests" for more information.
  2714.           
  2715.           Note that when a response file is sent, it is counted against the
  2716.           maximum number of file sent in response to a request, as
  2717.           designated by the 'MaxReq' statement in the configuration file. 
  2718.           See "File Requests" or the Reference Guide section "Configuration
  2719.           File" for more information.
  2720.           
  2721.           The content of the response file is configured by you with a
  2722.           template file.  The template file name is designated by the
  2723.           'ReqTemplate' configuration file statement.  As with file
  2724.           requests, you can also implement security controls with the
  2725.           request templates.  See "Security - Response File Templates" for
  2726.           more details.
  2727.           
  2728.           Normally, the response file contains information such as the date
  2729.           and time the request was made, what file was requested, and why
  2730.           the request failed.  You may wish to include information such as
  2731.           the times your system accepts requests, what magic filenames you
  2732.           support, and so on.
  2733.  
  2734.                BinkleyTerm Version 2.30 - User's Guide - Page 49
  2735.  
  2736.           
  2737.           Response files are named similar to outbound packets or request
  2738.           files.  They are <net><node>.RSP, where <net> is a net number,
  2739.           and <node> is a node number.  Both <net> and <node> are four-
  2740.           digit hexadecimal number with leading zeroes.
  2741.           
  2742.           A sample response file template, SAMPLE.TPL, is included with the
  2743.           BinkleyTerm distribution package.  Use this sample as a starting
  2744.           point for your own response file template.
  2745.           
  2746.           The complete list of possible verbs for use in the response file
  2747.           can be found in the section "Response File Template" in the
  2748.           Reference Guide. 
  2749.           
  2750.           FUNCTION REQUESTS
  2751.           
  2752.           Two additional special entries may be included in the OKFILE that
  2753.           operate similar to magic filenames.  Called "magic" function
  2754.           requests, they allow an incoming request to trigger the operation
  2755.           of a program.
  2756.           
  2757.                                  $ Function Requests
  2758.           
  2759.           The first style uses a dollar sign ($) in the first column of an
  2760.           OKFILE entry, followed by a function request name.  If the name
  2761.           is matched, then the command after the password (if any) is
  2762.           executed.  In addition, two arguments which correspond to the net
  2763.           and node number of the calling system can be sent if desired by
  2764.           adding "%d %d" to the end of the OKFILE entry.  For example:
  2765.           
  2766.                $INFO INFO.BAT %d %d
  2767.           
  2768.           If an incoming file request is for "INFO" then the program
  2769.           INFO.BAT would be executed, and it would receive two command line
  2770.           arguments that correspond to the net and node number
  2771.           respectively.  For instance, if 141/491 requested "INFO" then the
  2772.           following would be issued to DOS for execution:
  2773.           
  2774.                INFO.BAT 141 491
  2775.           
  2776.           Another example of such an OKFILE entry would be:
  2777.           
  2778.                $CLEANUP !mypass CLEANUP.BAT %x %x
  2779.           
  2780.           In this case, a password is included as the second argument of
  2781.           the line, and must be matched by the incoming request in order
  2782.           for the program to be executed.  Note also that in this example,
  2783.           "%x %x" was used, and would cause a hexadecimal representation of
  2784.           the net and node number to be sent as command line arguments to
  2785.           the program being executed.  In our example, if 104/36 requests
  2786.           "CLEANUP" with a password of "mypass" then the following would be
  2787.           sent to DOS for execution:
  2788.           
  2789.                CLEANUP.BAT 68 24
  2790.  
  2791.                BinkleyTerm Version 2.30 - User's Guide - Page 50
  2792.  
  2793.           
  2794.           See "Function Request Notes" below for additional function
  2795.           request information.
  2796.           
  2797.                                  + Function Requests
  2798.           
  2799.           A second type of function request is also supported, and is
  2800.           designated by a plus sign (+) in the first column of an OKFILE
  2801.           entry.  In this case, if the filename and optional password are
  2802.           matched, then the entire line from the incoming .REQ file is
  2803.           passed to DOS for processing, with the <zone>:<net>/<node>
  2804.           address appended as individual arguments to the command line.  An
  2805.           example of an OKFILE entry might be:
  2806.           
  2807.                +GETREV !mypass
  2808.           
  2809.           If an incoming .REQ file from 141/491 contained the line:
  2810.           
  2811.                GETREV !mypass BT 1.50
  2812.           
  2813.           Then the following would be passed to DOS for execution:
  2814.           
  2815.                GETREV !mypass BT 1.50 1 141 491
  2816.           
  2817.           A program called GETREV would be executed, and would need to
  2818.           process or filter the command line as needed.  
  2819.           
  2820.           Function requests are convenient for allowing a remote system to
  2821.           have a batch file or utility of some kind (not included) place a
  2822.           particular file on hold for a node for later pickup, to cause the
  2823.           system to send a particular file, to trigger some other sort of
  2824.           function or activity remotely, etc., etc.
  2825.           
  2826.           If a program called as part of a function request creates a file
  2827.           in the appropriate outbound area called <net><node>.QLO (where
  2828.           <net> and <node> are 4-digit hexadecimal numbers with leading
  2829.           zeroes), BinkleyTerm will treat this file as a legitimate "flow"
  2830.           (file attach) file and send the file(s) listed in it back to the
  2831.           caller as part of the request logic.
  2832.           
  2833.                                Function Request Notes
  2834.           
  2835.           If a function request triggers a program or batch file to build a
  2836.           file attach (flow) file, then BinkleyTerm will process the file
  2837.           attach during the current session.  In other words, if a file
  2838.           attach is generated during a function request, then the file(s)
  2839.           shown in the file attach will be sent during the current session. 
  2840.           
  2841.           Note that the normal logic for the handling of .HLO (Hold file
  2842.           attaches) still applies; i.e., file(s) designated within a .HLO
  2843.           file will be sent only when the destination node polls for pick-
  2844.           up.
  2845.           
  2846.           
  2847.  
  2848.                BinkleyTerm Version 2.30 - User's Guide - Page 51
  2849.  
  2850.           A WORD ABOUT POINT NETWORKS
  2851.           
  2852.           BinkleyTerm is well suited to the task of being a "boss" (or host
  2853.           system) of a point network.  Points are essentially a "system
  2854.           under a system" and allow the point operator to have limited
  2855.           access to the network without the normal requirements of keeping
  2856.           a system on-line at certain hours.
  2857.           
  2858.           Since point addressing is not part of the FidoNet standard at
  2859.           this time, certain "kludges" must be used in order to handle a
  2860.           point network.  
  2861.           
  2862.           Essentially, the process involves using a private network
  2863.           address, and assigning node numbers to the points under the boss. 
  2864.           For example, 1:104/36.17 (point #17 off of node 104/36) might
  2865.           actually be assigned 1052/17 for the purpose of transacting mail
  2866.           with the boss.  For reference purposes the point is 1:104/36.17,
  2867.           but mail is actually held for 1052/17 to pick-up, and the point
  2868.           must call as 1052/17.
  2869.           
  2870.           Often times, private point addresses will make their way into
  2871.           EchoMail "SEEN-BY" lines.  This could cause problems down the
  2872.           line if another system uses the same private address.  For this
  2873.           reason, IT IS RECOMMENDED THAT YOUR PRIVATE NETWORK ADDRESS BE
  2874.           ASSIGNED BY THE INTERNATIONAL COORDINATOR.  The International
  2875.           Coordinator requests that you adhere to this recommendation, and
  2876.           contact him directly for a private network number assignment.  As
  2877.           a boss node, you may then use the network address to assign your
  2878.           points their own node address in the private net for the purpose
  2879.           of transacting mail.
  2880.           
  2881.           The International Coordinator can be reached at 1:1/0.
  2882.           
  2883.           To receive a private net number, the information that follows is
  2884.           needed.  All information will be held in confidence, but is
  2885.           needed in case the International Coordinator needs to get a hold
  2886.           of the private net administrator.  As soon as this information is
  2887.           received, the International Coordinator will issue a private net
  2888.           number:
  2889.           
  2890.                - Name of the Private Network Administrator
  2891.                - Name of the Private Network (if any)
  2892.                - Mailing Address
  2893.                - Voice Phone
  2894.                - Data Phone
  2895.                - FidoNet Node (if any)
  2896.                - Alternate E-Mail Addresses (i.e., Usenet, Bitnet, MCI
  2897.                Mail, Telex, etc., if any)
  2898.           
  2899.           Your cooperation in obtaining an assigned private network number
  2900.           for use on point networks will help ensure network integrity.
  2901.           
  2902.           
  2903.           
  2904.  
  2905.                BinkleyTerm Version 2.30 - User's Guide - Page 52
  2906.  
  2907.           +-------------+
  2908.           | +---------+ |
  2909.           | | Section | |   BinkleyTerm User's Guide
  2910.           | |    4    | |   PROBLEM SOLVING
  2911.           | +---------+ |
  2912.           +-------------+
  2913.           
  2914.           BINKLEYTERM SUPPORT
  2915.           
  2916.           Since BinkleyTerm is a product which is "free for the asking" you
  2917.           cannot expect a toll-free software support line (as much as we
  2918.           may want to provide you with one).  
  2919.           
  2920.           The primary means of support is the BINKLEY EchoMail Conference. 
  2921.           This conference is carried worldwide via FidoNet.  Contact your
  2922.           EchoMail Coordinator or Hub for information on hooking into the
  2923.           conference, or finding a system that you can use to participate
  2924.           in the conference.  The conference is monitored and read by the
  2925.           BinkleyTerm authors and beta testers.
  2926.           
  2927.           A secondary source of support is provided by BinkleyTerm HELP,
  2928.           Shawn Stoddard, at FidoNet 1:1/102.0.  If you have an urgent
  2929.           question, or are unable to hook into the BINKLEY EchoMail
  2930.           Conference, send a NetMail message to BinkleyTerm HELP.  Replies
  2931.           are issued as time and resources allow, so please be patient.
  2932.           
  2933.           TROUBLESHOOTING
  2934.           
  2935.           3,000 pages of documentation would not entirely eliminate the
  2936.           potential for problems with the installation and operation of
  2937.           BinkleyTerm.  Due to the wide variety of hardware and software
  2938.           configurations that BinkleyTerm may be used with, as well as the
  2939.           varying levels of experience of the BinkleyTerm user, problems
  2940.           will sometimes occur.  This section attempts to present common
  2941.           problems and possible solutions.
  2942.           
  2943.           If there is not a solution to your problem presented here, please
  2944.           read over the appropriate sections of the manual again.  If you
  2945.           still are having difficulty, place a message in the BINKLEY
  2946.           EchoMail conference, or contact BinkleyTerm HELP at 1:1/102.
  2947.           
  2948.                               Baud Rate Locking Trouble
  2949.           
  2950.           Do not use BinkleyTerm's 'LockBaud' configuration file statement. 
  2951.           Lock the baud rate of your FOSSIL instead.  
  2952.           
  2953.                                 Outward Dial Aborting
  2954.           
  2955.           Many people installing BinkleyTerm mistakenly use the 'Suffix'
  2956.           option in their configuration file.  Unlike most communications
  2957.           programs, BinkleyTerm by default adds a carriage return to the
  2958.           end of the dial string.  'Suffix' is used to add instructions to
  2959.           the end of the phone number, but BEFORE the carriage return.  By
  2960.           adding a carriage return code (pipe symbol, |) with the 'Suffix'
  2961.  
  2962.                BinkleyTerm Version 2.30 - User's Guide - Page 53
  2963.  
  2964.           statement, you are essentially telling BinkleyTerm to send TWO
  2965.           carriage returns, yours, plus the default.  With most modems,
  2966.           this will immediately abort the dialing process before it even
  2967.           gets started.  
  2968.           
  2969.           In nearly all installations, the 'Suffix' statement WILL BE
  2970.           COMMENTED OUT.  If deleting the 'Suffix' statement does not fix
  2971.           the problem, you may also try adding the 'NoCollide' and/or
  2972.           'SlowModem' statements to the configuration file.  Refer to the
  2973.           Reference Guide section "Configuration File" for more details.
  2974.           
  2975.                             False Call Collision Reports
  2976.           
  2977.           In some installations, BinkleyTerm may abort the dialing process
  2978.           due to an incoming call, even when there is no incoming call. 
  2979.           This is probably due to the modem reporting "RING" on both
  2980.           incoming and outgoing calls.  Use the 'SameRing' configuration
  2981.           file option to partially disable the call collision feature; use
  2982.           the 'NoCollide' option to totally disable the feature.
  2983.           
  2984.                         FOSSIL Driver Compatibility Problems
  2985.           
  2986.           The two most popular FOSSIL drivers in use with BinkleyTerm are
  2987.           Ray Gwinn's X00 and Bob Hartman's OpusComm, both of which are for
  2988.           the IBM PC and close compatibles.  If one of the drivers fails to
  2989.           work correctly in your installation, please try the other.  
  2990.           
  2991.                     BinkleyTerm Will Not Recognize Node Addresses
  2992.           
  2993.           You have not compiled the nodelist correctly.  Use ParseLst to
  2994.           compile a fully-zoned Version 6 nodelist for your system.  To do
  2995.           this, make sure the following statements exist within your
  2996.           ParseLst configuration file:  UseZone, Complete (or Gated), and
  2997.           Version6.
  2998.           
  2999.                     TBBS Difficulty - BinkleyTerm Runtime Errors
  3000.           
  3001.           When used with TBBS, BinkleyTerm must be renamed MAILER.EXE. 
  3002.           Since BT.EXE uses overlays to provide more efficient memory
  3003.           usage, it CANNOT be renamed.  TBBS users should be certain to use
  3004.           BTBIG.EXE, the non-overlay version, on their systems, renaming it
  3005.           to MAILER.EXE before use.  
  3006.           
  3007.           Some TBBS Sysops have patched TBBS.EXE to invoke BT.EXE, which
  3008.           allows them to use the overlaid version.  While if this is done
  3009.           correctly it will probably cause no problems, we cannot recommend
  3010.           this course of action.
  3011.           
  3012.                            DOS Shell Not Working Correctly
  3013.           
  3014.           BinkleyTerm is developed under Microsoft C.  The MSC routines do
  3015.           not use COMSPEC to find COMMAND.COM, which is needed to perform a
  3016.           DOS shell or child process.  COMMAND.COM must be found on the DOS
  3017.           path.  Refer to your DOS documentation for information and
  3018.  
  3019.                BinkleyTerm Version 2.30 - User's Guide - Page 54
  3020.  
  3021.           instructions regarding COMSPEC, and the SET PATH command.
  3022.           
  3023.                        Zone Support Does Not Operate Correctly
  3024.           
  3025.           Chances are excellent that you have not compiled the nodelist
  3026.           correctly.  Although the actual entries for nodes in other zones
  3027.           do not need to be included in the compiled nodelist files, what
  3028.           are called "zone identifiers" DO need to be included in order for
  3029.           zone support to work.  See the section "Nodelist" for more
  3030.           information on correct compilation of a nodelist.  Another item
  3031.           to check is that outbound areas are created for the other zones
  3032.           to which you want to send mail.  See "Zone Support" for
  3033.           information on how outbound areas for other zones are
  3034.           constructed.
  3035.           
  3036.                                 Date Rollover Problem
  3037.           
  3038.           BinkleyTerm keeps schedule information in binary form in a file
  3039.           named BINKLEY.SCD.  If for some reason the file is newer than the
  3040.           current date and time, BinkleyTerm will report "Date Rollover
  3041.           Problem?" as this condition is usually indicative of a problem
  3042.           with DOS rolling the date over at midnight properly.  If there
  3043.           appears to be no difficulty with date rollover, delete the
  3044.           BINKLEY.SCD file, and allow BinkleyTerm to contruct a new one the
  3045.           next time it is invoked.  A date rollover problem sometimes does
  3046.           exist with certain versions of DOS.  If the problem persists, a
  3047.           DOS upgrade may be indicated.
  3048.           
  3049.           GLOSSARY
  3050.           
  3051.           AMAX
  3052.           
  3053.                The name of a BinkleyTerm utility by Alan Applegate that
  3054.                handles various outbound mail manipulation functions.
  3055.           
  3056.           ARCmail
  3057.           
  3058.                Simply archived mail packets, processed with an ARC-
  3059.                compatible utility.  Typically used to forward EchoMail
  3060.                messages due to the file compression inherent in the
  3061.                archiving process.  Naming conventions correspond to a
  3062.                generally accepted method.  See 'Mail Packet.'
  3063.           
  3064.           BBS
  3065.           
  3066.                An electronic bulletin board system.  A method of
  3067.                communicating and sharing files with others by computer. 
  3068.                Typically operated by hobbyists, free-of-charge.  
  3069.           
  3070.           Carrier Detect
  3071.           
  3072.                A serial port line that is brought "high" (raised, given a
  3073.                "true" logical value) when carrier is present on the line,
  3074.                e.g., when the modem is connected to another modem.  
  3075.  
  3076.                BinkleyTerm Version 2.30 - User's Guide - Page 55
  3077.  
  3078.           
  3079.                The modem raises and lowers this line.
  3080.           
  3081.           CD
  3082.           
  3083.                See "Carrier Detect."
  3084.           
  3085.           Compressed Mail
  3086.           
  3087.                Mail that has been compressed or "archived" with any one of
  3088.                several archiving utilities.  Such mail is also known as
  3089.                ARCmail, ZOOmail, PAKmail, etc., depending on which
  3090.                archiving utility was used to compress the mail.
  3091.           
  3092.           ConfMail
  3093.           
  3094.                The name of a mail processing program by Bob Hartman for use
  3095.                in the Opus or Fido environments, or any other environment
  3096.                that uses a compatible message base.
  3097.           
  3098.           Continuous Mail
  3099.           
  3100.                A capability of a particular system to accept mail at any
  3101.                time of day, as opposed to being required to accept it only
  3102.                during certain pre-scheduled times.
  3103.           
  3104.           D'Bridge
  3105.           
  3106.                A commercial FidoNet mailer written by Chris Irwin.
  3107.           
  3108.           Data Terminal Ready
  3109.           
  3110.                A serial port line that is brought "high" (raised, given a
  3111.                "true" logical value) when the local terminal is ready for
  3112.                communications.  A serial device (in our case a modem)
  3113.                connected to the serial port uses this line to detect
  3114.                whether the terminal (your PC and BinkleyTerm) are ready for
  3115.                communications activities.  Normally, bringing the line
  3116.                "low" (lowering, giving a "false" logical value) causes a
  3117.                modem to disconnect from the telephone line.  
  3118.           
  3119.                BinkleyTerm raises and lowers this line.
  3120.                
  3121.           DTR
  3122.           
  3123.                See "Data Terminal Ready."
  3124.           
  3125.           Dutchie
  3126.           
  3127.                A FidoNet mailer written by Henk Wevers.
  3128.           
  3129.           Dynamic Event
  3130.           
  3131.                A system event (see "Event") that stops when particular
  3132.  
  3133.                BinkleyTerm Version 2.30 - User's Guide - Page 56
  3134.  
  3135.                conditions (lack of mail of a certain type to be sent) are
  3136.                met.
  3137.           
  3138.           EchoMail
  3139.           
  3140.                A system devised by Jeff Rush for the automated sharing of
  3141.                message areas between systems, whereby messages are "echoed"
  3142.                from one system to another.  Also known as conferences or
  3143.                EchoMail conferences.  
  3144.           
  3145.           Errorlevel
  3146.           
  3147.                The name of a DOS environment variable; contains a value
  3148.                returned by a program on exit that indicates a certain pre-
  3149.                defined condition.
  3150.           
  3151.           Event
  3152.           
  3153.                A system occurrence at a pre-configured time, day-of-the-
  3154.                week, and/or date.  Normally system limitations such as when
  3155.                to dial long distance are dependent on system events.
  3156.           
  3157.           Fido
  3158.           
  3159.                The original implementation of FidoNet and FidoNet protocol;
  3160.                a BBS software package.
  3161.           
  3162.           FidoNet
  3163.           
  3164.                The name of the original network that used FidoNet protocol,
  3165.                as designed by Tom Jennings.
  3166.           
  3167.           FidoNet Protocol
  3168.           
  3169.                A method of electronic mail transfer designed by Tom
  3170.                Jennings, as documented in the Fido Technical Standards
  3171.                Committee document FSC-0001.
  3172.           
  3173.           File Request
  3174.           
  3175.                The ability and associated methods of using extended FidoNet
  3176.                protocol to obtain a particular file automatically from one
  3177.                FidoNet system to another.
  3178.           
  3179.           FOSSIL Driver
  3180.           
  3181.                FOSSIL is an acronym for Fido/Opus/SEAdog Standard Interface
  3182.                Layer.  Since not all computers capable of running MS-DOS
  3183.                are hardware compatible with the IBM PC, communications
  3184.                software typically written for the IBM PC may not operate on
  3185.                machines such as the DEC Rainbow, Sanyo 555 or Heath/Zenith
  3186.                100. 
  3187.           
  3188.                The FOSSIL provides a consistent manner for a communications
  3189.  
  3190.                BinkleyTerm Version 2.30 - User's Guide - Page 57
  3191.  
  3192.                program to access the communications ports, keyboard and
  3193.                screen.  The FOSSIL is typically installed at boot-time,
  3194.                either as a device driver or as a program.  The driver MUST
  3195.                be installed prior to running any FOSSIL compatible
  3196.                software, BinkleyTerm included, or an error message will be
  3197.                generated, and the program will abort.
  3198.           
  3199.                FOSSIL drivers are normally available from systems that
  3200.                distribute Opus-CBCS and/or BinkleyTerm software.  Examples
  3201.                of FOSSIL drivers are:  OpusComm by Bob Hartman for the IBM
  3202.                PC and close compatibles, X00 by Ray Gwinn for the IBM PC
  3203.                and compatibles, and DECCOMM by Vince Perriello for the DEC
  3204.                Rainbow. 
  3205.           
  3206.           FrontDoor
  3207.           
  3208.                A FidoNet mailer written by Joaquim Homrighausen.
  3209.           
  3210.           FSC001
  3211.           
  3212.                In BinkleyTerm, an abbreviation that indicates that a mail
  3213.                session corresponding to the FSC-0001 standard is in use. 
  3214.                FSC-0001 is a standards document written by the FidoNet
  3215.                Technical Standards Committee. 
  3216.           
  3217.           GroupMail
  3218.           
  3219.                A method of sharing message areas devised by System
  3220.                Enhancement Associates, Inc., similar to EchoMail, except
  3221.                that responsibility for obtaining mail is placed on the
  3222.                receiving system, not the sending system as with EchoMail. 
  3223.                Based on usage of update requests.
  3224.           
  3225.           Hold Area
  3226.           
  3227.                See "Outbound Area."
  3228.           
  3229.           Inbound Area
  3230.           
  3231.                Also known as the "NetFiles" area, this is a special sub-
  3232.                directory set aside for the acceptance of incoming mail or
  3233.                files from other network systems.
  3234.           
  3235.           Mail Packet
  3236.           
  3237.                A unit of mail as defined in the FidoNet Technical Standards
  3238.                Committee document FSC-0001. 
  3239.           
  3240.           Mailer
  3241.           
  3242.                A program that acts as a FidoNet-compatible mail handler,
  3243.                using FidoNet protocol.  Normally, a mailer answers the
  3244.                phone, accepts and/or sends mail, and possibly passes human
  3245.                callers on to a BBS.
  3246.  
  3247.                BinkleyTerm Version 2.30 - User's Guide - Page 58
  3248.  
  3249.           
  3250.           msged
  3251.           
  3252.                An Opus/Fido compatible message reader/editor by Jim Nutt.
  3253.           
  3254.           Net
  3255.           
  3256.                A subset of a FidoNet compatible network, usually a
  3257.                collection of nodes within a metropolitan area.
  3258.           
  3259.           NetFiles
  3260.           
  3261.                Files received from other systems in the network; also a
  3262.                special sub-directory set aside for the reception of such
  3263.                files.
  3264.           
  3265.           NetMail
  3266.           
  3267.                Person-to-person mail sent through the network.
  3268.           
  3269.           Network
  3270.           
  3271.                As it applies to BinkleyTerm, a collection of nodes that are
  3272.                FidoNet compatible, such as the FidoNet network itself, or
  3273.                others such as EggNet, AlterNet, RBBS-Net, etc.
  3274.           
  3275.                Also, a division of a full network.  See "Net" above.
  3276.           
  3277.           Node
  3278.           
  3279.                A FidoNet compatible system, represented by a node address,
  3280.                and listed in a nodelist.
  3281.           
  3282.           Nodelist
  3283.           
  3284.                A listing of FidoNet nodes.
  3285.           
  3286.           oMMM
  3287.                
  3288.                A packing program (packer) originally designed for Opus-
  3289.                CBCS, but now widely used with BinkleyTerm.
  3290.           
  3291.           Opus-CBCS
  3292.           
  3293.                "The Opus Computer Based Conversation System," a BBS
  3294.                designed by Wynn Wagner III.  Uses ".MSG" message base
  3295.                (compatible with Fido BBS program).  Contains built-in
  3296.                FidoNet compatible mailer.
  3297.           
  3298.           Outbound Area
  3299.           
  3300.                Also known as the "Hold Area," this is a special sub-
  3301.                directory set aside specifically for holding mail waiting to
  3302.                be sent to or picked-up by its destination.
  3303.  
  3304.                BinkleyTerm Version 2.30 - User's Guide - Page 59
  3305.  
  3306.           
  3307.           Packer
  3308.           
  3309.                A program that processes mail entered on a system, and
  3310.                prepares it for sending by the mailer.
  3311.           
  3312.           Packet
  3313.           
  3314.                Within FidoNet, a message unit conforming to FSC-0001
  3315.                specifications.
  3316.           
  3317.                With file transfer protocols, a block, or "piece" of the
  3318.                file transfer.  Normally a pre-determined size in bytes.
  3319.           
  3320.           Point
  3321.           
  3322.                A point is an extension of a regular, fully qualified
  3323.                FidoNet node.  The term is derived from the node address
  3324.                format, 1:104/36.2 for example, where 1 is a zone, 104 a
  3325.                net, 36 a node, and 2 is the point.  
  3326.           
  3327.                Primarily, Points are intended to provide an method of
  3328.                participating in EchoMail conferences in an off-line state. 
  3329.                The conferences are packed and held for the Point system by
  3330.                the Boss, a system which carries the desired conference(s)
  3331.                and is willing to route them to the Point.  The Point system
  3332.                'polls' the Boss for the conferences, which are unpacked and
  3333.                read off-line on the Point system.  Responses are packed and
  3334.                sent to Boss in much the same manner as is done by regular
  3335.                FidoNet nodes. 
  3336.           
  3337.                Generally, Points never interact with regular nodes, only
  3338.                with their Boss, since Point systems are not listed in the
  3339.                FidoNet nodelist. 
  3340.           
  3341.           QuickBBS
  3342.           
  3343.                A BBS program designed by Adam Hudson, which uses
  3344.                configurable menuing and a database-style message base. 
  3345.                Requires mail processing software designed specifically for
  3346.                its message format.
  3347.           
  3348.           Region
  3349.           
  3350.                A subset of a FidoNet compatible network, a collection of
  3351.                nodes within a broad geographical area.  With regard to
  3352.                FidoNet addressing, a region is handled the same way as a
  3353.                network.  With regard to operational infrastructure, this is
  3354.                a higher level than a net.
  3355.           
  3356.           Scan
  3357.           
  3358.                Usually associated with EchoMail processing, "scanning" is
  3359.                the process of taking new messages from a form usable by a
  3360.  
  3361.                BinkleyTerm Version 2.30 - User's Guide - Page 60
  3362.  
  3363.                BBS program or message editor and preparing them for sending
  3364.                via the network by placing them in standard packet and/or
  3365.                compressed mail format.
  3366.           
  3367.           SEAdog
  3368.           
  3369.                A commercial FidoNet mailer by System Enhancement
  3370.                Associates, Inc.
  3371.           
  3372.           SEAlink
  3373.           
  3374.                A variant of Xmodem, a robust file transfer protocol
  3375.                featuring sliding windows, good error trapping and extended
  3376.                file information.  Superior to Xmodem for use on difficult
  3377.                or satellite connected links.
  3378.           
  3379.           Sirius
  3380.           
  3381.                An Opus/Fido compatible message reader/editor by Bob Klahn.
  3382.           
  3383.           Sysop
  3384.           
  3385.                System operator; the person who operates a BBS, and/or the
  3386.                operator of a FidoNet node.
  3387.           
  3388.           TBBS
  3389.           
  3390.                A commercial BBS software package by eSoft, Inc.
  3391.           
  3392.           Telink
  3393.           
  3394.                An Xmodem variant, a file transfer protocol that is
  3395.                essentially Xmodem with a file information packet.
  3396.           
  3397.           Terminal Mode
  3398.           
  3399.                A BinkleyTerm mode within which the software may be used for
  3400.                manual, direct connections with remote modem-equipped
  3401.                computers.
  3402.           
  3403.           Toss
  3404.           
  3405.                Usually associated with EchoMail processing, "tossing" is
  3406.                the process of unpacking compressed mail into a form usable
  3407.                by a particular BBS program or message editor.
  3408.           
  3409.           TSYNC
  3410.           
  3411.                A signal sent to a FidoNet system from another FidoNet
  3412.                system attempting to pass mail traffic.  TSYNC is
  3413.                essentially a "handshake" between the sending and receiving
  3414.                systems to synchronize the mail session.
  3415.           
  3416.           
  3417.  
  3418.                BinkleyTerm Version 2.30 - User's Guide - Page 61
  3419.  
  3420.           Unattended Mode
  3421.           
  3422.                A BinkleyTerm mode within which FidoNet electronic mail may
  3423.                be sent or received.
  3424.           
  3425.           Undialable
  3426.           
  3427.                A term for nodes which will no longer be called
  3428.                automatically by the system until manually reset.  The
  3429.                result of excessive unsuccessful connections with the remote
  3430.                system in an attempt to send mail.
  3431.           
  3432.           Unpacker
  3433.           
  3434.                A mail processing program that takes mail as received
  3435.                (compressed mail and/or packets) and places it into a form
  3436.                usable by a given type of BBS program or message editor.
  3437.           
  3438.           Update Request
  3439.           
  3440.                The ability and associated methods of requesting only a
  3441.                newer copy of a file located on one FidoNet system, if a
  3442.                newer copy exists, from another FidoNet system, using
  3443.                extended FidoNet protocol.
  3444.           
  3445.           VFOSSIL (Video FOSSIL Driver)
  3446.           
  3447.                A standard resident driver that allows a software program to
  3448.                access display hardware in a consistent manner regardless of
  3449.                hardware compatibility.  This is an extension of the FOSSIL
  3450.                driver, and may not be supported by all FOSSIL drivers at
  3451.                this time.  A VFOSSIL allows much faster access to the video
  3452.                display hardware than a FOSSIL driver alone would support.
  3453.           
  3454.           WaZOO
  3455.           
  3456.                An open architecture method of electronic mail transfer
  3457.                designed by Wynn Wagner, and originally used with Opus-CBCS. 
  3458.                Various protocols can be used under WaZOO, including ZedZap,
  3459.                a slightly modified Zmodem, and DietIFNA, a SEAlink method. 
  3460.                See 'YooHoo.'
  3461.           
  3462.           Xmodem
  3463.           
  3464.                One of the first of its type, a file transfer protocol
  3465.                designed by Ward Christensen.  Although technologically
  3466.                behind other newer, more robust protocols, Xmodem is the
  3467.                most widely supported and implemented file transfer protocol
  3468.                in dial-up use.
  3469.           
  3470.           YooHoo
  3471.           
  3472.                A method of mail transfer session negotiation which 
  3473.                determines if the remote system is capable of handling
  3474.  
  3475.                BinkleyTerm Version 2.30 - User's Guide - Page 62
  3476.  
  3477.                WaZOO.  FidoNet systems that do not support WaZOO will
  3478.                simply disregard the YooHoo; systems capable of supporting
  3479.                it will answer affirmatively, and a WaZOO session will be
  3480.                initiated.  See 'WaZOO.'  YooHoo is defined in the Fido
  3481.                Technical Standards Committee document FSC-0005.
  3482.           
  3483.           Zmodem
  3484.           
  3485.                A robust streaming file transfer protocol featuring advanced
  3486.                error recovery techniques, variable packet sizing, good
  3487.                error detection and extended file information.  Extremely
  3488.                efficient, yet complex.  Highly effective with difficult
  3489.                connections.
  3490.           
  3491.           Zone
  3492.           
  3493.                A large geographical sub-division in the network, the
  3494.                highest level of the accepted FidoNet addressing scheme. 
  3495.                Broad areas such as continents are given zone designations. 
  3496.                Also used to specify a particular alternate network.
  3497.           
  3498.           ZOOmail
  3499.           
  3500.                Simply archived mail packets, processed with the ZOO
  3501.                utility.  Typically used to forward EchoMail messages due to
  3502.                the file compression inherent in the archiving process. 
  3503.                Naming conventions correspond to a generally accepted
  3504.                method.  See 'Mail Packet.'
  3505.           
  3506.           
  3507.  
  3508.