home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / bt313a / docs / bt_user.asc < prev    next >
Text File  |  1992-08-27  |  117KB  |  3,301 lines
  1. BinkleyTerm ST 3.00 - User Guide
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. ****   *         *      *             *******                 TM
  10. *   *            *      *                *
  11. *   *  *  * **   *   *  *   ***   *   *  *   ***   * **  *** **
  12. ****   *  **  *  *  *   *  *   *  *   *  *  *   *  **    *  *  *
  13. *   *  *  *   *  ***    *  ****   *   *  *  ****   *     *  *  *
  14. *   *  *  *   *  *  *   *  *      *   *  *  *      *     *  *  *
  15. ****   *  *   *  *   *  *   ****   ****  *   ****  *     *  *  *
  16.                                       *
  17. Version 3.00 ST - User Guide          *       November 30th 1991
  18.                                    ***
  19.  
  20.  
  21.  
  22.  
  23.             A Freely Available FidoNet Compatible Electronic
  24.                 Mail Interface and Dumb Terminal Package
  25.  
  26.  
  27.  
  28.  
  29.           Software Written by Vince Perriello and Bob Hartman
  30.                    Atari-ST version by STeven Green.
  31.                    User Guide written by STeVeN Green
  32.           Based on Documentation Written by Alan D. Applegate
  33.                Documentation Recompiled by Robert Elsinga
  34.  
  35.  
  36.  
  37.             This document Copyright (C) 1991, Steven Green.
  38.   Portions of the documentation (C) 1988,1989 Bit Bucket Software, Co.
  39.   Software Copyright (C) 1988,1989,1990,1991 Bit Bucket Software, Co.
  40.                          A Delaware Corporation
  41.                           All Rights Reserved
  42.           Portions of the software (C) 1990,1991 Steven Green
  43.  
  44.                Terms and Conditions Contained Separately
  45.  
  46.                         Bit Bucket Software, Co.
  47.                       427-3 Amherst St., Suite 232
  48.                             Nashua, NH 03063
  49.  
  50.  
  51.  
  52.  
  53.                   "BinkleyTerm" and "Freely Available"
  54.                are trademarks of Bit Bucket Software, Co.
  55.  
  56.  
  57.  
  58.  
  59.  
  60. User Guide - Page 1
  61.  
  62. BinkleyTerm ST 3.00 - User Guide
  63.  
  64.  
  65.                                 Contents
  66.  
  67. 1. General Information........................................... 4
  68.      1.1  How to use this manual?                                 4
  69.      1.2  Acknowledgements                                        4
  70.      1.3  Background                                              4
  71.      1.4  Forward                                                 5
  72.      1.5  Introduction                                            6
  73.      1.6  Hardware and Software Requirements                      7
  74.           1.6.1 Memory Requirements
  75.           1.6.2 Modem Requirements
  76.  
  77. 2. Operation as a Terminal Communications Program................ 9
  78.      2.1  Terminal Mode Overview                                  9
  79.      2.2  Installation                                            9
  80.  
  81. 3. Operation as an automated Electronic Mailer...................10
  82.      3.1  Unattended Mode Overview                               10
  83.      3.2  Installation                                           11
  84.      3.3  The BinkleyTerm Concept                                12
  85.      3.4  How BinkleyTerm handles mail                           12
  86.      3.5  The Concept of Cost                                    15
  87.      3.6  Windowed Interface                                     15
  88.           3.6.1 Current Settings
  89.           3.6.2 Today at a Glance
  90.           3.6.3 Pending Outbound Mail
  91.           3.6.4 Recent Activity
  92.           3.6.5 Transfer Status
  93.      3.7  Controlling BinkleyTerm with Batch Files               17
  94.           3.7.1 Errorlevels
  95.           3.7.2 What errorlevels BinkleyTerm Produces
  96.           3.7.3 A bit more about errorlevels
  97.           3.7.4 Shell commands
  98.           3.7.5 Environment Variables
  99.      3.8  Configuration File                                     22
  100.      3.9  Nodelist                                               22
  101.      3.10 Fidouser.lst                                           23
  102.      3.11 Multiple Zones and Domains                             23
  103.      3.12 Point Systems                                          24
  104.      3.13 Security                                               25
  105.           3.13.1 Prot
  106.           3.13.2 Known
  107.           3.13.3 Default
  108.           3.13.4 Session Passwording
  109.           3.13.5 Secured Inbound File Areas
  110.           3.13.6 Controlling File Requests
  111.           3.13.7 Response File Templates
  112.      3.14 BBS Interface                                          30
  113.           3.14.1 BBS Exit
  114.           3.14.2 BBS Spawn
  115.           3.14.3 BBS Batch
  116.           3.14.4 What this really means?
  117.  
  118.  
  119.  
  120. User Guide - Page 2
  121.  
  122. BinkleyTerm ST 3.00 - User Guide
  123.  
  124.  
  125.      3.15 External Mail Programs                                 32
  126.      3.16 User Selected BBS Functionality                        33
  127.      3.17 File Requests                                          34
  128.           3.17.1 Update Requests
  129.           3.17.2 Request Response Files
  130.      3.18 Function Requests                                      38
  131.           3.18.1 $ Function Requests
  132.           3.18.2 + Function Requests
  133.           3.18.2 Function Requests Notes
  134.  
  135. 4. Utilities to use with BinkleyTerm-ST..........................41
  136.      4.1  Mail Processing                                        41
  137.      4.2  BinkleyTerm shells                                     42
  138.      4.3  CLI/Shells                                             42
  139.      4.4  BBS Software and Utilities                             42
  140.      4.5  Nodelist Processing                                    43
  141.      4.6  Other Utilities                                        43
  142.  
  143. 5. BinkleyTerm Support and Problem Solving.......................44
  144.      5.1  Trouble Shooting                                       44
  145.           5.1.1 Baud Rate Locking Trouble
  146.           5.1.2 Outward Dial aborting
  147.           5.1.3 False Call Collision Reports
  148.           5.1.4 BinkleyTerm Will Not Recognize Node Addresses
  149.           5.1.5 Zone Support Does Not Operate Correctly
  150.  
  151. 6. Glossary......................................................47
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180. User Guide - Page 3
  181.  
  182. BinkleyTerm ST 3.00 - User Guide
  183.  
  184.  
  185. 1. General Information
  186.  
  187. 1.1 How to use this Manual?
  188.  
  189. The documentation for BinkleyTerm is supplied in two parts:
  190.  
  191.  - The  User's Guide (BT_USER.DOC) explains how to install  BinkleyTerm.
  192.    It also describes basic operational procedures.   New users may  find
  193.    some  concepts  or terminology unfamiliar;  a  glossary  is  provided
  194.    towards the end of the User's Guide.
  195.  - The Reference guide (BT_REF.DOC) is an alphabetically arranged manual
  196.    listing all configuration commands and other information that may  be
  197.    of interest to experienced users and new users alike.
  198.  
  199. For inquiries, questions or comments regarding BinkleyTerm, please refer
  200. to the User's Guide section "BinkleyTerm Support".
  201.  
  202. Some portions of the User's Guide are from the original BinkleyTerm 2.30
  203. User's Guide and are Copyright (C) Bit Bucket Software,  Co. and Alan D.
  204. Applegate.
  205.  
  206. 1.2 Acknowledgements
  207.  
  208. Many trademarks,  registered trademarks and references to other people's
  209. copyrighted  works are referred to in this document.   It would be  very
  210. lengthy and tedious to list them all.   Failure to identify a particular
  211. trademark  in this document is not intended in any way to be a claim  of
  212. rights to the trademark.
  213.  
  214. Please  note  that throughout this documentation,  the  mention  of  any
  215. particular  software  package or system should not be  construed  as  an
  216. endorsement of any kind on the part of the authors.
  217.  
  218. 1.3 Background
  219.  
  220. BinkleyTerm-ST began life in Spring 1990, as a faithful port from the PC
  221. version  of  BinkleyTerm  2.40.   It was well  received  within  the  ST
  222. community  and  became one of the  top two  popular  FidoNet  compatible
  223. mailers  for the ST ("The Box" of course being the  other  one).   Users
  224. soon started suggesting new features that they would like to  see,  many
  225. of  which  have been implemented.   Some of these features  include  the
  226. EMSI protocol,  file requesting limits by time,  multiple point and zone
  227. addressing,  etc.  There are still many more to be implemented in future
  228. versions.
  229.  
  230. As  a result the Atari version is now quite a bit different from the  PC
  231. version and some of its new features are yet to be seen in the latest PC
  232. version (2.50).
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240. User Guide - Page 4
  241.  
  242. BinkleyTerm ST 3.00 - User Guide
  243.  
  244.  
  245. 1.4 Forward
  246.  
  247. There  is  no  question that BinkleyTerm-ST  is  an  extremely  powerful
  248. communications  tool.   We  have also made no secret of  the  fact  that
  249. BinkleyTerm-ST is an extremely complex communications tool.
  250.  
  251. A set of documentation the size of an unabridged dictionary (about 150mm
  252. thick or so) would still not address every possible use of  BinkleyTerm-
  253. ST in every possible environment.   BinkleyTerm-ST will work on  several
  254. models  of  computer and hundred's of  different  modems.   In  addition
  255. BinkleyTerm  is designed with an open architecture,  so it can  be  used
  256. with several BBS packages, nodelist processors, mail processors, editors
  257. and  so on.   BinkleyTerm "ports" have been made for entirely  different
  258. platforms such as the PC, Amiga, Archimedes, Vax, etc.  You begin to get
  259. the scope of what's involved.
  260.  
  261. This  documentation  attempts  to cover  fairly  broad  generalities  in
  262. configuring and operating BinkleyTerm.  It cannot and will not cover all
  263. possibilities or circumstances.   Hopefully it will serve as a  starting
  264. point  - a ground level from which you may grow  and  expand.   Further,
  265. this  documentation  describes  only  the  Atari  ST  version  3.00   of
  266. BinkleyTerm,  earlier versions and those on other hardware platforms are
  267. different and use different configuration options.
  268.  
  269. Most of the enjoyment of the electronic mail hobby comes from trying new
  270. things  - tweaking the system.   Although BinkleyTerm is  a  dependable,
  271. powerful program that is not especially difficult to get going,  it does
  272. provide ample opportunity to experiment and have fun.
  273.  
  274. Still,  if you're looking for something that will meld itself into  your
  275. computer  in  just a few minutes and work without  modification  forever
  276. more, BinkleyTerm should probably not be your first choice.  In exchange
  277. for a little complexity,  we give you power and an incredible amount  of
  278. configurability and compatibility.
  279.  
  280. If you become frustrated with BinkleyTerm,  call on others in your  area
  281. who  are using it and ask them to help you out.   Of  course,  you  will
  282. eventually  become an expert yourself!   Enjoy it,  and delight  in  the
  283. wonder of technology.
  284.  
  285.    Alan D. Applegate
  286.    Vice President,
  287.    Bit Bucket Software, Co.
  288.  
  289.    (With minor editing by STeVeN Green)
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300. User Guide - Page 5
  301.  
  302. BinkleyTerm ST 3.00 - User Guide
  303.  
  304.  
  305. 1.5 Introduction
  306.  
  307. BinkleyTerm-ST is an advanced, state-of the-art telecommunications tool.
  308. It is primarily designed for the semi-automated sending and receiving of
  309. electronic  mail  and files within FidoNet  compatible  electronic  mail
  310. networks.
  311.  
  312. When used as a mailer,  BinkleyTerm is designed to communicate with  any
  313. FidoNet  compatible  mail interface or BBS package.   The  program  uses
  314. standard  FidoNet  protocol,  as  well  as  certain  modified  protocols
  315. supported by programs such as SEAdog, Opus-CBCS, D'Bridge and FrontDoor.
  316. It also offers easy to use event scheduling,  single keystroke  spawning
  317. to  other  programs,  support for high speed  modems,  advanced  session
  318. recovery, inbound call collision detection, and much more.
  319.  
  320. When  used as a dumb terminal,  BinkleyTerm offers a rich  selection  of
  321. file  transfer protocols for exchanging files with a host  system.   The
  322. program also offers keyboard macros,  optional VT-100 emulation, echoing
  323. of on-line session to a text file or printer,  support for baud rates of
  324. 300 to 38,400 (with hardware patch to an ST) and more.
  325.  
  326. BinkleyTerm  can be used as a dumb terminal program  exclusively,  as  a
  327. mail interface for a Point system,  or as a front end mail interface for
  328. an electronic bulletin board system (BBS).
  329.  
  330. Mail  interface and dumb terminal operations can be switched in and  out
  331. with a minimum of effort providing dual functionality.
  332.  
  333. BinkleyTerm  endeavours to provide you with the widest possible  variety
  334. of advanced features, combined with solid and efficient operation.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360. User Guide - Page 6
  361.  
  362. BinkleyTerm ST 3.00 - User Guide
  363.  
  364.  
  365. 1.6 Hardware and Software Requirements
  366.  
  367.  - An  Atari ST/STe/TT/MegaSTe with at least 300K of free RAM (a  1  Meg
  368.    machine (e.g.  1040ST) is really recommended to make full use of it).
  369.  - TOS 1.0 or greater
  370.  - An auto-dial,  auto-answer modem; Hayes compatibility is recommended
  371.    (see section 1.7 "Modem requirements" below).
  372.  - A single sided disk drive (terminal mode)
  373.  - A  double  sided  disk drive (for point systems  that  don't  need  a
  374.    nodelist)
  375.  - A  Hard disk for Nodes and point systems that use  a  nodelist.   The
  376.    bigger the better!!!
  377.  - Basic knowledge of computer based telecommunications.
  378.  - Various utility programs depending on your application, these will be
  379.    described later.
  380.  
  381. 1.6.1 Memory requirements
  382.  
  383. BinkleyTerm requires approximately 200K of RAM in any operational  mode.
  384. When  used in unattended (mailer) mode additional memory  sufficient  to
  385. hold  the  nodelist index file (usually NODELIST.IDX)  is  required.
  386.  
  387. A minimum of a 1 Meg machine is recommended if you are using BinkleyTerm
  388. from  within  a BBS program such as ///Turbo Board,  or if you  wish  to
  389. spawn out to other programs from within BinkleyTerm.
  390.  
  391. When used as a front-end mailer for a BBS system such as QuickBBS-ST, it
  392. is highly recommended that the 'BBS Batch' method of accessing your  BBS
  393. be  implemented for the most efficient use of memory.   Please refer  to
  394. the applicable sections of the documentation for further information.
  395.  
  396. 1.6.2 Modem Requirements
  397.  
  398. A modem that is generally "Hayes compatible" is required for BinkleyTerm
  399. operation.   Most  popular  modems meet  this  requirement.   Since  you
  400. configure the various modem commands,  it does not need to be 100% Hayes
  401. "AT" command set compatible,  but it does need to use the "AT" style  of
  402. issuing modem commands.
  403.  
  404. Most  modems  are capable of returning VERBAL (full  words)  or  NUMERIC
  405. (numbers only) response codes;  the modem must be configured for VERBAL
  406. codes only (typically "AT V1" on most Hayes compatible modems).
  407.  
  408. BinkleyTerm  has  been  programmed to respond  to  the  following  modem
  409. response  strings:  NO ANSWER,  BUSY,  RING,  VOICE,  NO DIAL  TONE,  NO
  410. DIALTONE, ERROR, NO CARRIER, DIAL TONE and DIALLING.  Also the following
  411. are recognised but ignored: RING, RINGING and RING RESPONSE.
  412.  
  413. With the exception of the CONNECT response,  any other data provided  by
  414. the modem after a given response string is ignored.   For  example,  "NO
  415. CARRIER DETECTED" would be handled the same way as "NO CARRIER".
  416.  
  417.  
  418.  
  419.  
  420. User Guide - Page 7
  421.  
  422. BinkleyTerm ST 3.00 - User Guide
  423.  
  424.  
  425. Since  BinkleyTerm uses the CONNECT string to determine connection  baud
  426. rates, the modem should be capable  of sending such strings.  Generally,
  427. CONNECT  is  a default,  and indicates a  300  baud  connection.   Other
  428. possible connections are CONNECT 1200 for a 1200 baud  connection,  etc.
  429. BinkleyTerm  also recognises the responses CONNECT 1275 and  V23.CONNECT
  430. for  split-speed  modems.    In  addition  extra  information  such   as
  431. /Arq, /Hst, /V32, /V42/ etc,  are recognised for use with the modemtrans
  432. feature (see the reference guide).
  433.  
  434. To obtain the correct responses from a Hayes compatible modem, you would
  435. typically use the AT X command, e.g. "AT X4".
  436.  
  437. If  you  are  experiencing  modem difficulties  then  try  some  of  the
  438. following configuration file statements: SlowModem, SameRing, NoCollide.
  439. Also try changing the 'answer' statement.   Refer to the reference guide
  440. to see what these do.  You're best chance though of sorting it out is to
  441. locate  someone else using the same type of modem with  BinkleyTerm  and
  442. ask for help.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480. User Guide - Page 8
  481.  
  482. BinkleyTerm ST 3.00 - User Guide
  483.  
  484.  
  485. 2. Operation as a Terminal Communications Program
  486.  
  487. 2.1 Terminal Mode Overview
  488.  
  489. This section describes the installation and operation of BinkleyTerm  in
  490. Terminal mode.
  491.  
  492. BinkleyTerm's  Terminal  mode  offers  functionality  similar  to  other
  493. programs such as Uniterm,  Flash, Dterm, etc.  You can use your computer
  494. and modem to call out to on-line services and electronic Bulletin  Board
  495. Services (BBS).
  496.  
  497. BinkleyTerm  offers  a  wide selection of file  transfer  protocols  for
  498. exchanging  files  with  remote  systems  (uploading  and  downloading),
  499. including Xmodem,  Ymodem and Zmodem.   This includes Zmodem auto-detect
  500. and Zmodem error-recovery.
  501.  
  502. 2.2 Installation
  503.  
  504.  - Create a new folder on your hard disk or format a blank disk.
  505.  - Copy the following files into the folder or onto the disk:
  506.       BT.TTP
  507.       BINKLEY.CFG
  508.       BINKLEY.LNG
  509.  - Using a text editor (e.g.  Tempus or MicroEmacs) or word processor in
  510.    ASCII mode (e.g.  1st Word), edit BINKLEY.CFG to reflect the way your
  511.    system  is  setup.   Refer to the comments included in  the  provided
  512.    BINKLEY.CFG and the Reference Guide.   In particular you should  make
  513.    sure that the "Unattended" line is deleted or commented out.  You may
  514.    also  need to create a DOWNLOAD directory depending on what  you  set
  515.    the "DownLoad" line to in BINKLEY.CFG.
  516.  - Double click on BT.TTP and press return at the TTP dialogue box.
  517.  - Press the Help key for a brief help screen.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540. User Guide - Page 9
  541.  
  542. BinkleyTerm ST 3.00 - User Guide
  543.  
  544.  
  545. 3. Operation as an automated Electronic Mailer
  546.  
  547. 3.1 Unattended Mode Overview
  548.  
  549. This  section  describes  the installation and  use  of  BinkleyTerm  in
  550. Unattended mode.  This mode is used when BinkleyTerm is to function as a
  551. front-end mail interface,  whether in a BBS or "Point" environment.  The
  552. glossary provides information on BBS and Point systems.
  553.  
  554. BinkleyTerm, in this operational mode, provides functionality similar to
  555. that provided by The Box, and by programs such as FrontDoor and D'Bridge
  556. on the  PC,  and by Trapdoor on the Amiga,  and other FidoNet compatible
  557. mailers.   BinkleyTerm  answers the telephone,  and exchanges mail  with
  558. other  compatible  mail interface packages,  or in the case of  a  human
  559. caller, passes control to a BBS system.
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. User Guide - Page 10
  601.  
  602. BinkleyTerm ST 3.00 - User Guide
  603.  
  604.  
  605. 3.2 Installation
  606.  
  607. Due  to  the complexity and widely varying setups,  only  a  generalised
  608. broad  installation procedure is given here.   For more information  you
  609. will need to read the reference guide and maybe ask for help from  other
  610. systems running BinkleyTerm.
  611.  
  612. The  use  of a BinkleyTerm shell program such as BTS (Part  of  the  ACS
  613. package) or Avalon will simplify the installation.   You should refer to
  614. the  instructions included with these utilities.   These  utilities  and
  615. others that can be used with BinkleyTerm will be described later in this
  616. User Guide.
  617.  
  618.  - Create a new folder on your hard disk or format a blank disk.
  619.  - Copy  all  the files from this distribution into the  new  folder  or
  620.    disk.
  621.  - Using  a text editor (e.g.  Tempus,  MicroEmacs or STedi) or  a  word
  622.    processor in ASCII mode (e.g.  1st Word),  edit the file BINKLEY.CFG.
  623.    Refer  to  the  comments  in the  provided  BINKLEY.CFG  and  to  the
  624.    reference guide for guidance.
  625.  - Create any folders that you have specified in BINKLEY.CFG, these will
  626.    include:
  627.       Netfile
  628.       Hold
  629.       DownLoad
  630.       Nodelist
  631.  - Obtain  and setup any necessary utilities for packing  and  unpacking
  632.    mail.   Install  them  as explained in the  instructions  with  these
  633.    packages.
  634.  - Obtain a current nodelist and process it (e.g.  with ParselST).  This
  635.    is not required if you are a point system and have setup  BINKLEY.CFG
  636.    correctly.
  637.  - Edit BINKLEY.EVT according to how you wish your system to run. (Refer
  638.    to the reference guide for information).
  639.  - Set  up any batch files or shell programs to control how  BinkleyTerm
  640.    is to work.
  641.  - Start your system.  Test a remote call if possible.
  642.  - Pressing  the  Help key will display a brief help  file  of  commands
  643.    available in unattended mode.
  644.  
  645. Setting up can be quite a complex procedure,  it is best if you read all
  646. the  documentation thoroughly,  obtain some example configuration  files
  647. from  someone else with a similar setup,  don't be afraid to  experiment
  648. and set it up a bit at a time.
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660. User Guide - Page 11
  661.  
  662. BinkleyTerm ST 3.00 - User Guide
  663.  
  664.  
  665. 3.3 The BinkleyTerm Concept
  666.  
  667. It is important to remember that BinkleyTerm is a mailer program with  a
  668. completely open architecture.  As such, BinkleyTerm can be operated with
  669. a  tremendous  variety  of  BBS  systems,  mail  packing  and  unpacking
  670. programs, and accessories.
  671.  
  672. BinkleyTerm  will  answer  the telephone and  respond  to  another  mail
  673. program.   Mail will be placed in an incoming files area.  If the caller
  674. is  human,  control  is passed entirely to the BBS program,  if  one  is
  675. installed.   It is the responsibility of third-party software to  unpack
  676. the mail received, and add it to your message base.
  677.  
  678. On the outward side,  BinkleyTerm uses an outbound holding area to  hold
  679. outward mail.   It is the responsibility of third-party packing software
  680. to  pack new messages into the required format,  and place them  in  the
  681. outbound area.
  682.  
  683. BinkleyTerm   neither   packs   nor   unpacks   mail.    Allowing   this
  684. functionality to be provided by other software allows BinkleyTerm to  be
  685. compatible with practically any BBS software, regardless of message base
  686. structure.    Some  of  the  other  utilities  that  can  be  used  with
  687. BinkleyTerm will be described later on in this document.
  688.  
  689. 3.4 How BinkleyTerm handles mail
  690.  
  691. Understanding a bit about how BinkleyTerm handles outbound mail may help
  692. you to understand how to use it better.  It will not matter if you don't
  693. understand  everything in this section,  but reading it quickly now  and
  694. then referring to it later if you have a problem may help you if you get
  695. stuck.
  696.  
  697. The driving forces of outbound traffic are filenames.
  698.  
  699. You will have set up some special folders for outbound packets using the
  700. "Hold" configuration line in BINKLEY.CFG.   If you are using multi-zones
  701. then you will have several folders,  one for each zone,  and if you  are
  702. using Domains then you will also have separate directories for each zone
  703. within each domain.   See the reference guide for information.
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720. User Guide - Page 12
  721.  
  722. BinkleyTerm ST 3.00 - User Guide
  723.  
  724.  
  725. Example, if you are in Zone 2 and in BINKLEY.CFG, you have the lines
  726.   Hold c:\bt\hold
  727.   Domain Fidonet.org FidoNet nodelist
  728.   Domain nest.ftn nest nestlist
  729.   Domain Lifenet.ftn lifenet lifelist
  730.  
  731. Then you will have the folders:
  732.   c:\bt\hold         Default folder for zone 2 (Europe)
  733.   c:\bt\hold.001     Zone 1 (North America)
  734.   c:\bt\hold.003     Zone 3 (Australasia)
  735.   c:\bt\hold.004     Zone 4
  736.   c:\bt\hold.005     Zone 5
  737.   c:\bt\hold.006     Zone 6 (East Asia)
  738.   c:\bt\nest.05a     NeST zone 90 (Note "5A" is 90 in base 16)
  739.   c:\bt\lifenet.04d  LifeNet zone 77 ("4D" is 77 in base 16)
  740.  
  741. Your mail exporting program will place netmail packets,  compressed mail
  742. packets  and  other network files in these folders  for  BinkleyTerm  to
  743. send.
  744.  
  745. The filenames of the packets tell BinkleyTerm how to treat the different
  746. packets.  A typical packet might have the name:
  747.    00FC0019.OUT
  748. This   tells   BinkleyTerm  that  it  is  intended  for   node   252/25.
  749. (00FC/0019  in Hexadecimal).   The ".OUT" extension means that it is  an
  750. uncompressed netmail packet.
  751.  
  752. Packet extensions are:
  753.    .HUT     Uncompressed packet, to be left on Hold for the other system
  754.             to pick up.
  755.    .CUT     Uncompressed packet to be sent to another system using Crash
  756.             or Continuous mail (i.e. it should be sent immediately).
  757.    .DUT     Uncompressed packet to be sent Direct.   Exactly when it can
  758.             be sent  is  controlled  using   BinkleyTerm's   event  file
  759.             BINKLEY.EVT.
  760.    .OUT     Normal uncompressed packet, treated identically to DUT.
  761.  
  762. Some utilities will change the extensions for you at different times  of
  763. the  day so that you only send mail at particular times.   Refer to  the
  764. instructions  about  "Routing"  in  the  documentation  for  your   mail
  765. exporter.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780. User Guide - Page 13
  781.  
  782. BinkleyTerm ST 3.00 - User Guide
  783.  
  784.  
  785. Files  and compressed mail can be sent using File attach or  FLO  files.
  786. These have a similar naming convention to the .OUT files:
  787.    .FLO     Normal flow file
  788.    .HLO     Flow file on Hold
  789.    .CLO     Crash or Continuous flow file
  790.    .DLO     Direct flow file
  791.  
  792. A  flow  file  is an ASCII text file listing the files  to  be  sent  to
  793. another  system.   Each  filename  may also  have  a  special  character
  794. preceding it.  Example,
  795.    #c:\bt\hold\0000fc9c.mo1
  796.    ^c:\myfiles\wizzle.doc
  797.    c:\pascal\notes.doc
  798.  
  799. The  '#' tells BinkleyTerm to truncate the file after it is  sent,  i.e.
  800. set it to zero bytes length.  This option is sometimes used for archived
  801. mail to prevent duplicate filenames.
  802.  
  803. '^' tells BinkleyTerm to delete the file after it is sent.  This is also
  804. used  for compressed mail to avoid filling up your  outbound  areas,  as
  805. well as for temporary files (e.g. TIC files).
  806.  
  807. Other special characters include
  808.    ';'   A comment.  BinkleyTerm ignores the rest of the line.
  809.    '~'   File has already been sent.   BinkleyTerm sets this as it sends
  810.          each file so that if the session is aborted it doesn't send the
  811.          same files on the next call!
  812.  
  813. When using IOS another file-type for compressed mail is used, these are:
  814.    .OAT     Normal Archived Packet
  815.    .HAT     Held Archived packet
  816.    .DAT     Direct Archived packet
  817.    .CAT     Crash/Continuous Archived Packet.
  818.  
  819. The  Archived  mail address is encoded differently to  allow  for  point
  820. addressing.  This takes the form:
  821.    aaabbbcc.OAT
  822. aaa = The Net encoded as base 36.
  823. bbb = Node in base 36
  824. cc = Point in base 36.
  825.  
  826. e.g. a packet for 252/25.10 would be called:
  827.    07000P0A.OAT
  828. (070 = 252 in base 36, 00P = 25, 0A = 10).
  829.  
  830. The  advantages of this format is that it enables points to call  points
  831. from other point networks directly instead of having to go through their
  832. boss.   Another  advantage  is  that you don't need to  use  FLO  files,
  833. resulting  in  less clutter in the outbound folders and  less  time  for
  834. BinkleyTerm to find the files.   Future versions of BinkleyTerm-ST  will
  835. extend this format to include file requests and unarchived mail.
  836.  
  837.  
  838.  
  839.  
  840. User Guide - Page 14
  841.  
  842. BinkleyTerm ST 3.00 - User Guide
  843.  
  844.  
  845. 3.5 The Concept of Cost
  846.  
  847. One of the prime considerations with BinkleyTerm is sending mail for the
  848. least cost.  Cost is, of course, determined by the nodelist entry.  With
  849. a properly compiled nodelist,  local FidoNet nodes have '0' in the  cost
  850. field  for  their  nodelist  entry (assuming local  calls  are  free  of
  851. charge).   Other entries have cost fields that realistically reflect the
  852. actual cost of sending mail to a particular node.
  853.  
  854. In most areas,  it is cheapest to call during the evening or  nighttime.
  855. Therefore,  BinkleyTerm is normally set-up to send such mail only during
  856. nighttime hours.
  857.  
  858. The  'L'  flag  used when scheduling  events  designates  'local  only.'
  859. As  already  mentioned,  nodes with a '0' cost field are assumed  to  be
  860. local.  When the flag is applied to an event, only local calls are made.
  861. The  'L'  flag should be used whenever it costs the most money  to  make
  862. calls,  and  removed for events during which calls are  cheapest.   More
  863. about this is in the Reference Manual section, "Scheduling Events."
  864.  
  865. 3.6 Windowed Interface
  866.  
  867. BinkleyTerm features a windowed user interface.   The windowed interface
  868. provides  "at-a-glance"  convenience  for  watching  mail  sessions   in
  869. progress,  as well as determining what activity has taken place with the
  870. system recently.
  871.  
  872. There are 5 important windows displayed on the screen.
  873.  
  874. 3.6.1 Current Settings
  875.  
  876. This  window contains various information about your  system,  including
  877. the current data and time,  current event, current baud rate, status and
  878. amount of free memory.
  879.  
  880. The current event line features a number and a list of event flags.  The
  881. number  corresponds  to  which  entry  in  the  BinkleyTerm  event  file
  882. BINKLEY.EVT covers the current event.   The flags are letters that are a
  883. subset of those used with event scheduling.   Here is a list of  letters
  884. that may be found in this window:
  885.  
  886.    C  Continuous Mail Only Event
  887.    L  Local Only Event
  888.    N  Do not accept Inbound File Requests
  889.    R  Receive Only Event
  890.    B  BBS Use Allowed
  891.    D  Dynamic Event
  892.    K  Do Not Send Continuous/Crash Mail.
  893.  
  894. See  the  section "Scheduling Events" in the Reference  Guide  for  more
  895. information about these flags.
  896.  
  897.  
  898.  
  899.  
  900. User Guide - Page 15
  901.  
  902. BinkleyTerm ST 3.00 - User Guide
  903.  
  904.  
  905. 3.6.2 Today at a Glance
  906.  
  907. This window contains several lines of information regarding the activity
  908. on your system since midnight.  Note that the totals given apply only to
  909. calls  handled  by BinkleyTerm's Unattended (mailer) mode,  and  do  not
  910. include Terminal Mode totals.
  911.  
  912. The  1st line,  "BBS/Mail",  lists how many BBS calls,  mail  calls  and
  913. external  mailer  calls  have come in separated by  a  slash  '/'.   For
  914. example  2/15/1  would indicate 2 BBS callers,  15 mailer  calls  and  1
  915. external mailer call (an external mailer could be a UUCP mailer, a FoReM
  916. FNET mailer, etc).
  917.  
  918. The 2nd line,  "Calls Out",  lists the number of dial attempts that have
  919. been made by your system, successful or otherwise.
  920.  
  921. The  3rd line,  "Good/Cost",  shows how many successful calls have  been
  922. made  and the cumulative cost of them all.   For  example,  3/100  would
  923. indicate 3 successful calls,  which have cost 100 units (if you have set
  924. up  the cost table correctly [in ParselST.cfg or BINKLEY.CFG] then  this
  925. should  correspond to actual currency,  e.g. cents in America,  pence in
  926. UK).   The cost calculation assumes that the amounts given in your  cost
  927. table are in cost-per-minute.
  928.  
  929. The 4th Line,  "Files I/O", shows how many files have been received and
  930. sent, e.g. 12/3 indicates that you have received 12 files and sent 3.
  931.  
  932. Finally  the  5th line indicates the last session.   If it  was  another
  933. FidoNet  mailer  then  the other system's  address  will  be  displayed,
  934. otherwise it might indicate that it was a BBS caller or external mailer.
  935.  
  936. 3.6.3 Pending Outbound Mail
  937.  
  938. This  window displays a list of systems for whom mail is  waiting  along
  939. with related information.   The window can be scrolled using the  cursor
  940. arrow keys.
  941.    Up       Up one line
  942.    Down     Down one line
  943.    Shift-Up Up a page
  944.    Shift-Dn Down a page
  945.    Home     To top
  946. The nodes are sorted in numerical order, but systems that are waiting to
  947. be called are listed first.
  948.  
  949. The  actual  information  displayed  depends on  whether  you  have  the
  950. "NiceOutbound" configuration command in BINKLEY.CFG (this can be toggled
  951. by pressing Alt-F).
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960. User Guide - Page 16
  961.  
  962. BinkleyTerm ST 3.00 - User Guide
  963.  
  964.  
  965. With NiceOutBound disabled then all you get is the system name and flags
  966. indicating the status of mail for that system:
  967.    C  Crash/Continuous
  968.    H  Hold
  969.    D  Direct
  970.    N  Normal
  971.    R  File Request
  972.    -  System will not be called during this event.
  973. There may instead be a message:
  974.    NoConn   BinkleyTerm could not connect to this system
  975.    Tried    BinkleyTerm has called, but mail is still waiting.
  976.    UnKnown  System is not in NodeList
  977.  
  978. When NiceOutbound is enabled then the number of files,  size and age  of
  979. the files are displayed.   The disadvantage of using this option is that
  980. it  can take BinkleyTerm some time to scan all the outbound folders  for
  981. this information.
  982.  
  983. Pressing Alt-Z zooms the pending Outbound Window to fill up the  screen,
  984. where even more information is displayed,  including the number of calls
  985. made to each system.
  986.  
  987. 3.6.4 Recent Activity
  988.  
  989. This window displays information about what BinkleyTerm is doing,  as it
  990. happens.   This  information  will  also  be written  to  the  log  file
  991. depending on the current "LogLevel" setting.
  992.  
  993. 3.6.5 Transfer Status
  994.  
  995. During  file  transfers,  this  window displays  information  about  the
  996. transfer,  such as the filename and how many bytes have been  sent.
  997.  
  998. 3.7 Controlling BinkleyTerm with Batch Files
  999.  
  1000. Point  systems or mail-only nodes may be able to use a  Graphical  shell
  1001. program such as BTS (part of the ACS package) or Avalon.   These are GEM
  1002. based programs that let you set up and control BinkleyTerm.   You should
  1003. refer  to  the  documentation  provided with  these  programs  for  more
  1004. information and you can probably skip the rest of this section.
  1005.  
  1006. BBS  systems  and  more complex nodes will need to use  batch  files  to
  1007. control  BinkleyTerm's operation.   Typically these will be used to  run
  1008. BinkleyTerm,  load  up the BBS for human callers,  run  mail  processing
  1009. utilities after a call, etc.
  1010.  
  1011. You  will first of all need to find a CLI or shell program.   There  are
  1012. two types of CLIs:  MSDOS style and Unix style.   Some people prefer one
  1013. or  the other.   If you are using FoReM or ///Turbo-board then there  is
  1014. an  MSDOS style shell built into the BBS.   Users of other  BBS  systems
  1015. (e.g.  QuickBBS) must use a separate CLI.  Example CLIs that may be used
  1016. include:
  1017.    Pcommand : Very basic MSDOS style CLI.
  1018.    Craft    : Very good commercial Unix style shell.
  1019.  
  1020. User Guide - Page 17
  1021.  
  1022. BinkleyTerm ST 3.00 - User Guide
  1023.  
  1024.  
  1025. There are others that may possibly be used,  but I don't have experience
  1026. of  using  them with a BBS.   Basically any shell or CLI that  will  run
  1027. batch  or  script  files,  has conditional  flow  control  and  supports
  1028. errorlevels and environment variables should work.   You should probably
  1029. ask someone near you what they use.
  1030.  
  1031. If  you  are  not  familiar  with CLIs and  Shells  then  it  is  highly
  1032. recommended that you find someone nearby to provide you with their batch
  1033. files.
  1034.  
  1035. 3.7.1 Errorlevels
  1036.  
  1037. One of the basic concepts of using batch files to control BinkleyTerm is
  1038. that of errorlevels.   An errorlevel is simply a numerical value that  a
  1039. program may "return" when it terminates.  A better term might be an exit
  1040. code,  as it does not necessarily mean that there has been an error  if
  1041. it set!
  1042.  
  1043. Batch and script files can make use of the errorlevel to decide what  to
  1044. do  next.
  1045.  
  1046. If you are using an MSDOS style shell (e.g. PCOMMAND or ///Turbo board's
  1047. built-in shell) then you can use batch files such as:
  1048. :start
  1049.   myprog -p1
  1050.   IF ERRORLEVEL 2 goto process
  1051.   IF ERRORLEVEL 1 goto start
  1052.   IF ERRORLEVEL 0 goto end
  1053. :process
  1054.   proc -c -d1
  1055.   IF ERRORLEVEL 1 goto start
  1056.   IF ERRORLEVEL 0 goto end
  1057. :end
  1058.  
  1059. I'm sure you can work out what this batch file will do.  If not refer to
  1060. the documentation that came with your CLI or shell.  What will happen is
  1061. that  the program "myprog" is executed,  and then when it exits  control
  1062. will  pass to a different part of the batch file depending on  the  exit
  1063. code.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080. User Guide - Page 18
  1081.  
  1082. BinkleyTerm ST 3.00 - User Guide
  1083.  
  1084.  
  1085. If  you  are  using  a Unix style shell then you  should  refer  to  the
  1086. documentation  that  comes with it.   A typical method  of  getting  the
  1087. errorlevel  is from the variable $status,  e.g.  the above example as  a
  1088. Craft script file might be something like:
  1089.   while ( 1 )
  1090.     myprog -p1
  1091.     switch ( $status )
  1092.       case 2:
  1093.         proc -c -d1
  1094.         if ( $status == 0 ) exit
  1095.         breaksw
  1096.       case 0:
  1097.         exit
  1098.     endsw
  1099.   end
  1100.  
  1101. 3.7.2 What errorlevels BinkleyTerm Produces
  1102.  
  1103. There are 4 general types of errorlevel:
  1104.  
  1105. Sysop-Initiated
  1106.    Function keys and Alt-X.
  1107.  
  1108.    Pressing a function key causes BinkleyTerm to exit with a value of 10
  1109.    times the function key number.   e.g.  F1 returns 10,  F2 return  20,
  1110.    etc, F10 returns 100.
  1111.  
  1112.    Alt-X causes a value of 1 to be returned.
  1113.  
  1114. Sysop-Defined
  1115.    En= exits used with event scheduling (See reference Guide),  external
  1116.    mail exits (see "ExtrnMail" in the reference guide),
  1117.  
  1118. Caller-Initiated
  1119.    A non-mail caller returns the baud rate divided by 100 (e.g. 300 baud
  1120.    returns 3, 2400 baud returns 24, etc).  NOTE: Some MSDOS style shells
  1121.    may  restrict errorlevels to between 0..255 in which case 38400  baud
  1122.    returns 128 (384-256) instead of 384.
  1123.  
  1124. System-Generated
  1125.    BinkleyTerm cannot run for some reason (e.g. it cannot find itself in
  1126.    the nodelist).
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140. User Guide - Page 19
  1141.  
  1142. BinkleyTerm ST 3.00 - User Guide
  1143.  
  1144.  
  1145. The  following  errorlevels are hard coded  into  BinkleyTerm,  but  the
  1146. others may be defined by yourself using the configuration files:
  1147.  
  1148. Error-
  1149. Level    Means             Caused By
  1150. -------- ----------------- -----------------------------------------
  1151.   1      Exit              Alt-X Keypress
  1152.   3      300 bps Call      Non-mail call at 300 Baud
  1153.  10      **                F1 key pressed
  1154.  12      1200 bps Call     Non-mail call at 1200 baud
  1155.  20      **                F2 key pressed
  1156.  24      2400 bps Call     Non-Mail call at 2400 baud
  1157.  30      **                F3 key pressed
  1158.  40      **                F4 key pressed
  1159.  48      4800 bps Call     Non-Mail call at 4800 baud
  1160.  50      **                F5 key pressed
  1161.  60      **                F6 key pressed
  1162.  70      **                F7 key pressed
  1163.  72      7200 bps Call     non-Mail call at 7200 baud
  1164.  80      **                F8 key pressed
  1165.  90      **                F9 key pressed
  1166.  96      9600 bps Call     Non-Mail call at 9600 baud
  1167.  99      ExtrnMail         Default External mailer return code
  1168. 100      **                F10 key pressed
  1169. 120      12000 bps Call    Non-Mail call at 12000 baud
  1170. 128*     38400 bps Call    Non-Mail call at 38400 baud
  1171. 144      14400 bps Call    Non-Mail call at 14400 baud
  1172. 192      19200 bps Call    Non-Mail call at 19200 baud
  1173. 254      Error             Address not found in NodeList
  1174.  -2*     Error             Address not found in NodeList
  1175. 255*     Error             General error
  1176.  -1*     Error             General error
  1177. 384*     38400 bps Call    Non-Mail call at 38400 baud
  1178.  
  1179. *  Some shells may only allow errorlevels between 0 and 255.   In  these
  1180.    cases values greater than 255 will be logically ANDed with 255,  thus
  1181.    -1 becomes 255,  -2 becomes 254 and 384 becomes 128 (384-256).  Refer
  1182.    to your shell's documentation to find out if this happens.  The Craft
  1183.    Shell  will return the full value (i.e.  384 for 38400 baud),  but  I
  1184.    don't know about any others.
  1185. ** The functionality of function keys is entirely up to you.
  1186.  
  1187. 3.7.3 A bit more about errorlevels
  1188.  
  1189. By  using  the  En=  errorlevels  associated  with  BinkleyTerm's  event
  1190. handling,  you can control how your system works.  If you want something
  1191. to  happen a particular time each day,  then select a unique "E1="  exit
  1192. code  for  that  task.   The  task can  be  set  to  occur  periodically
  1193. throughout  each  day,  once-per-day,  once-a-week or on  selected  days
  1194. within  the week.   Similarly by having a variety of E2= and E3=  codes,
  1195. you can use different mail unpacking routines at different times.  Refer
  1196. to the section "Scheduling Events" in the Reference Guide for details.
  1197.  
  1198.  
  1199.  
  1200. User Guide - Page 20
  1201.  
  1202. BinkleyTerm ST 3.00 - User Guide
  1203.  
  1204.  
  1205. The  10  F-keys  errorlevels  can  be quite  handy  to  run  often  used
  1206. utilities, e.g. to run an editor, Binkley-Shell or to load NeoDesk.
  1207.  
  1208. The  external  mailer option is intended for invocation of  an  external
  1209. mail  handling program such as a UUCP mailer or the FoReM  FNET  mailer.
  1210. It  is invoked by receiving a predefined string of characters.   It  can
  1211. also  be used to set up multiple BBS installations,  allowing which  BBS
  1212. is loaded to be selected by the user.  This is covered in more detail in
  1213. the   sections   "External  Mail  Programs"  and  "User   Selected   BBS
  1214. functionality" elsewhere in this document.
  1215.  
  1216. 3.7.4 Shell Commands
  1217.  
  1218. Shell  commands  are programs or batch files that are  run  from  within
  1219. BinkleyTerm.   These include 10 shell commands invoked by pressing  Alt-
  1220. Function keys, and defined using the "Shell" command in BINKLEY.CFG,  as
  1221. well as the "Editor", "Packer", "Aftermail" and "Cleaner" commands.
  1222.  
  1223. The  behaviour of shell commands depends on what type of shell  you  are
  1224. using.   If  the command is the full pathname of an  executable  program
  1225. (i.e.  it ends in .PRG,  .TOS or .TTP) then it will be executed directly
  1226. by  GEMDos.   Otherwise,  if you are using a resident shell that can  be
  1227. called  through the shell_p vector at 0x4f6,  then your command will  be
  1228. executed  directly by the shell (Craft and Gulam will work  like  this).
  1229. If  your shell sets the COMSPEC or SHELL environment variables then  the
  1230. shell will be invoked as either "$COMSPEC /c commandline" or "$SHELL  -c
  1231. commandline".
  1232.  
  1233. Because shell commands are executed from within BinkleyTerm,  there will
  1234. be less memory available than when using errorlevels.
  1235.  
  1236. 3.7.5 Environment Variables
  1237.  
  1238. Environment  variables  should  be set up in your  startup  batch  file.
  1239. Refer to the section about environment variables in the reference guide.
  1240. In  particular  it  is  a good idea to set BINKLEY  to  point  to  where
  1241. BinkleyTerm's  data  files are located and also RXBUF  and  TXBUF.   The
  1242. COMSPEC  and SHELL variables are normally defined by the shell  program,
  1243. so  you shouldn't need to set these yourself.   Different shells  define
  1244. these in different manners, refer to your documentation for more details
  1245. about setting environment variables.
  1246.  
  1247. e.g.
  1248.   set BINKLEY = f:\bt
  1249.   set RXBUF = 8192
  1250.   set TXBUF = 512
  1251. or alternatively:
  1252.   setenv BINKLEY f:\bt
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260. User Guide - Page 21
  1261.  
  1262. BinkleyTerm ST 3.00 - User Guide
  1263.  
  1264.  
  1265. 3.8 Configuration File
  1266.  
  1267. Most  BinkleyTerm  parameters  are set  through  a  configuration  file.
  1268. By default, the configuration file is named BINKLEY.CFG, and is expected
  1269. to  be available unless a different configuration file is  specified  on
  1270. the command line.
  1271.  
  1272. A  sample BINKLEY.CFG files is included with the  distribution  package.
  1273. You  can  edit  the  file with any plain text  editor  such  as  Tempus,
  1274. MicroEmacs or Craft's STedi; or with a word processor in ASCII mode such
  1275. as  1st Word.   The Reference Guide contains a complete listing  of  all
  1276. BinkleyTerm  configuration  statements  and their  proper  use.   It  is
  1277. recommended  that  you  read through each  statement's  description  and
  1278. decide if you need it or not.
  1279.  
  1280. BinkleyTerm directly uses the raw configuration file,  and each time the
  1281. program in invoked,  BinkleyTerm will scan and process the file, setting
  1282. internal values to those that you have selected.
  1283.  
  1284. 3.9 NodeList
  1285.  
  1286. The  FidoNet Nodelist is the glue that holds FidoNet  together.   It  is
  1287. vitally important  that  all  nodes  keep  up  to  date  with the latest
  1288. nodelist.  Most of the  FidoNet coordinator  positions are there for the
  1289. purpose mainly of updating and  distributing  the nodelist.  Because the
  1290. nodelist is very big  (just  over 1 Megabyte with about 12000 systems at
  1291. the time of  writing)  it  is  not  practical  to  distribute the entire
  1292. nodelist every time it is changed,  so  a "NodeDiff" file is distributed
  1293. each week, which  contains  instructions  for  updating from last week's
  1294. list to the current one.  It is the duty of your Net Coordinator to make
  1295. sure that this is available to you every week. It is very important that
  1296. you process the list every week and don't miss out on any of the diff
  1297. files.
  1298.  
  1299. The  nodelist and nodediff's are referred to as "raw" nodelists as  they
  1300. are  simply  ASCII files.   Most mailers and  mail  processing  software
  1301. require  it  to  be processed (or compiled) into  binary  form  so  that
  1302. entries can be accessed more easily.
  1303.  
  1304. BinkleyTerm is capable of using a variety of compiled nodelist  formats,
  1305. but as far as the ST is concerned, the only useful format is the Version
  1306. 6 format.  To select this you must make sure that the line "NewNodeList"
  1307. is  included  in BINKLEY.CFG and that your nodelist  processor  produces
  1308. this  format.   At  the time of  writing,  the only  nodelist  processor
  1309. available  for  the  ST  that  works  with  BinkleyTerm-ST  is ParselST.
  1310. However  in  future versions of BinkleyTerm-ST there will be support for
  1311. other nodelist processors.
  1312.  
  1313. Point  systems do not require a nodelist at all as long as their  bosses
  1314. phone number and password are included in BINKLEY.CFG.   See the section
  1315. on  "Point Systems" later in this document.   There is also a  suite  of
  1316. programs available for points called FIDO24 (because it was designed for
  1317. REGION  24  [Germany]  point systems),  which can  help  points  install
  1318. smaller nodelists.
  1319.  
  1320. User Guide - Page 22
  1321.  
  1322. BinkleyTerm ST 3.00 - User Guide
  1323.  
  1324.  
  1325. 3.10 FidoUser.LST
  1326.  
  1327. The nodelist processor may also be used to produce FIDOUSER.LST,  a list
  1328. of  sysop  names  and node addresses,  that  BinkleyTerm  can  use  when
  1329. dialling  out.   When  this  file is available to  BinkleyTerm  (in  the
  1330. nodelist  folder),  then  at most places where you can type  in  a  node
  1331. number  you can instead type in a sysop's name.   This applies  to  both
  1332. Unattended and Terminal Modes, while polling or dialling a system.
  1333.  
  1334. 3.11 Multiple Zones and Domains
  1335.  
  1336. Zones are a high-level addressing scheme devised for use within FidoNet.
  1337. In  a full FidoNet address,  such a 1:104/36.0,  '1' would be the  zone,
  1338. '104'  the  net,  '36'  the  node number,  and  '0'  the  point  number.
  1339. Currently,  zone addressing is not supported within the FidoNet  message
  1340. or  packet structure,  allowing software such as BinkleyTerm to  provide
  1341. only "kludged" support of zones.   BinkleyTerm offers such support,  and
  1342. endeavours to make it as seamless as possible.
  1343.  
  1344. If for some reason you do not wish zone support to be active,  place the
  1345. statement  'NoZones'  in  your  configuration  file.   This  will  cause
  1346. BinkleyTerm to essentially "turn off" zone support.   If you intend  not
  1347. to  use  zone  support,   then  use  the  'NoZones'  configuration  file
  1348. statement.
  1349.  
  1350. If  you have not used the 'NoZones' statement,  BinkleyTerm will  assume
  1351. that  a  full,  zone-based  nodelist is  available  for  its  use.   For
  1352. information on how to properly compile a nodelist for BinkleyTerm, refer
  1353. to the section "Nodelist" for more information.
  1354.  
  1355. When attempting to send mail to nodes in other zones,  BinkleyTerm  will
  1356. assume that mail for other zones will be held in separate outbound areas
  1357. by  zone  number.   For  example,  if your outbound  mail  directory  is
  1358. C:\BT\OUTBOUND,  mail for your zone will be held there.   However,  mail
  1359. for  nodes in zone 2 would be expected in C:\BT\OUTBOUND.002,  mail  for
  1360. zone 3 would be expected in C:\BT\OUTBOUND.003, and so on.  This example
  1361. is for zone 1.
  1362.  
  1363. The  zone  number for which your default outbound directory  applies  is
  1364. determined  by the FIRST appearance of the 'Address' statement  in  your
  1365. configuration  file.   Subsequent  'Address'  statements  identify  your
  1366. alternate identities within other zones (and/or networks).  For example,
  1367. if the first 'Address' statement designates an address in zone  2,  then
  1368. the   outbound  area  designated  by  the  'Hold'  statement   in   your
  1369. configuration file is the default, and mail to other zones would require
  1370. their  own distinct outbound areas with extensions that match  the  zone
  1371. number.
  1372.  
  1373. The  multi-zone outbound areas are in  hexadecimal.   For  example,  the
  1374. outbound  area  for zone 10 would be  C:\BT\OUTBOUND\.00A.   Using  this
  1375. method, it is possible to support up to 4,095 zones.
  1376.  
  1377.  
  1378.  
  1379.  
  1380. User Guide - Page 23
  1381.  
  1382. BinkleyTerm ST 3.00 - User Guide
  1383.  
  1384.  
  1385. Operation of a system within multiple networks is becoming  increasingly
  1386. popular.   Normally,  networks such as NeST,  LifeNet, ChatNet and so on
  1387. are  implemented  as  separate zones.   To  facilitate  operation  of  a
  1388. BinkleyTerm system within multiple networks,  you may specify a separate
  1389. system address, each with a different zone.
  1390.  
  1391. For  example,  if  you  wish  to use a  different  address  for  FidoNet
  1392. (currently zones 1,  2, 3, 4, 5 and 6) and for two alternative networks,
  1393. you might have the following in your configuration file:
  1394.  
  1395.                Address 1:1010/89.0
  1396.                Address 9:569/999.0
  1397.                Address 11:334/1.0
  1398.  
  1399. If  your  system  connects with a system in zone  9,  your  system  will
  1400. identify itself as 9:569/999.   If connected with a zone 11  system,  it
  1401. will identify itself as 11:334/1.   The first 'Address' statement is the
  1402. default,  and callers in zone 1 (and any zones other than 1,  9 and 11 -
  1403. those  specified  with  'Address' statements)  would  find  your  system
  1404. identified as 1:1010/89.
  1405.  
  1406. Domain  addressing  adds  yet another level  of  addressing  to  specify
  1407. different  networks.   Within each network,  zones and nets can  all  be
  1408. specified  without  conflict  to  identical  zones  and  nets  in  other
  1409. networks.
  1410.  
  1411. Domain  support in BinkleyTerm requires that you use  separate  nodelist
  1412. files  for  different domains.   BinkleyTerm can now be used  much  more
  1413. effectively in multiple network installations, assuming it is configured
  1414. correctly.
  1415.  
  1416. A  full  address with a domain is written  like  1:234/56.7@fidonet.org,
  1417. where "fidonet.org" is the domain. Other FidoNet compatible domains tend
  1418. to have the extension ".ftn", e.g. "alternet.ftn".
  1419.  
  1420. To  use  domains  you must use the "Domain" command  in  BINKLEY.CFG  as
  1421. described  in the reference manual.   To process separate nodelists  you
  1422. will have to patch a copy of  parselST.TOS  to  read and write different
  1423. filenames.   All of the nodelists must be kept in BinkleyTerm's nodelist
  1424. folder and you must create the neccessary outbound folders.
  1425.  
  1426. My advice is to only use Domain's if you have a good reason to.   A  lot
  1427. of mail processing software does not work properly with it,  and it  can
  1428. be quite tricky to set it up.
  1429.  
  1430. 3.12 Point Systems
  1431.  
  1432. Points  are  essentially a "system under a system" and allow  the  point
  1433. operator  to  have  limited access to the  network  without  the  normal
  1434. requirements of keeping a system on-line at certain hours.   Since point
  1435. addressing is not part of the FidoNet standard,  certain "Kludges"  must
  1436. be used in order to handle a point network.
  1437.  
  1438.  
  1439.  
  1440. User Guide - Page 24
  1441.  
  1442. BinkleyTerm ST 3.00 - User Guide
  1443.  
  1444.  
  1445. First of all you must find your "fakenet" address.  Point systems should
  1446. ask  their  boss.   A node should theoretically  ask  the  international
  1447. coordinator  to assign one,  but in practice you can just make  one  up.
  1448. For example I use 25225 (based on my node address of 252/25).   In  fact
  1449. many mailers don't even use fakenet addresses any more and the  complete
  1450. 4D address is passed in the session handshake,  but you will still  need
  1451. to define your fakenet address.
  1452.  
  1453. Once  you  have your fakenet address then you must place it  after  your
  1454. address in BINKLEY.CFG,
  1455. e.g. for a node
  1456.   Address 2:252/25 25225
  1457. and for a point:
  1458.   Address 2:252/25.10 25225
  1459. where 10 is the point number assigned to you.
  1460.  
  1461. What  happens  here is that in some mail sessions the addresses  may  be
  1462. replaced by 25225/10 and 25225/0.
  1463.  
  1464. If  you are a point and you don't want to use a nodelist then  you  must
  1465. also add your boss's phone number after the fakenet address, e.g.
  1466.   Address 2:252/25.10 25225 0793-849044
  1467. and define your session password with the KEY statement, e.g.
  1468.   Key !PASSWORD 2:252/25
  1469.  
  1470. It is possible to be a point in more than one system by simply  defining
  1471. more addresses, e.g.
  1472.   Address 2:252/25.10  25225 0793-849044
  1473.   Address 2:250/123.31 25023 061-429-9803
  1474.   Key !PWD1 2:252/25
  1475.   Key !PWD2 2:250/123
  1476.  
  1477. Actually  a  lot  is  possible using the Key statement  and  it  is  now
  1478. possible for one point to directly poll another point in a different net
  1479. if  required.   Please read about the "Key" statement in  the  Reference
  1480. Guide.
  1481.  
  1482. 3.13 Security
  1483.  
  1484. In the ideal world,  we would not need locks,  police,  or jails;  there
  1485. wouldn't be crime.   But we don't live in an ideal world,  and for  this
  1486. reason,  BinkleyTerm offers a selection of features that are intended to
  1487. offer  your system a certain level of security against "electronic  mail
  1488. crime."
  1489.  
  1490. The  existence  of  security features is not  intended  to  evoke  fear.
  1491. Chances  are excellent that you will have no need for security  features
  1492. in  most cases.   But just as high crime areas see more locks  and  iron
  1493. gates  than low-crime areas,  the choice of how much security to put  in
  1494. place is up to you, and is based on your needs and experience.
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500. User Guide - Page 25
  1501.  
  1502. BinkleyTerm ST 3.00 - User Guide
  1503.  
  1504.  
  1505. BinkleyTerm's  internal  security  is  based  on  a  simple   principle.
  1506. With the exception of session passwording, for each secured feature (all
  1507. of  which  are  specified within the configuration  file),  there  is  a
  1508. default statement.  When you implement no security features, the default
  1509. statement is used to specify a particular feature's configuration.
  1510.  
  1511. 3.13.1 Prot
  1512.  
  1513. When security is implemented,  however,  two more statements are used in
  1514. addition  to the default.   One type of statement,  known as "Prot"  for
  1515. "protected,"   describes  a  group  of  systems  with  which  you   have
  1516. implemented  session  passwording.    These  links  are  "protected"  by
  1517. passwords.
  1518.  
  1519. When  session passwording is implemented,  unless a password is  matched
  1520. when connecting to a protected system, a mail session is aborted.
  1521.  
  1522. "Protected"  or  "Prot" systems are the  top-level,  or  "most favoured"
  1523. situations,  since you generally know the other person at the other  end
  1524. (a prerequisite to establishing a password).
  1525.  
  1526. 3.13.2 Known
  1527.  
  1528. The  second  type of statement is called "Known" and  describes  systems
  1529. that are listed in the nodelist ("known" to you) but with whom you  have
  1530. not  established  a  session password.   These  are  links  with  listed
  1531. systems,  but  links  that  are  not  password  protected.   This  group
  1532. represents the middle-level of security.
  1533.  
  1534. 3.13.3 Default
  1535.  
  1536. When  you use a Prot and/or a Known security feature,  then the  default
  1537. statements  all take on a new meaning - that of  unknown  systems.   The
  1538. defaults are used for links that are not in the nodelist, and therefore,
  1539. cannot  have  a session password established.   This  group  of  systems
  1540. represents the lowest-level of security,  since you really have no  idea
  1541. who owns such systems, or where they are located.
  1542.  
  1543. 3.13.4 Session Passwording
  1544.  
  1545. BinkleyTerm  supports  session-level password  protection.   Using  such
  1546. protection helps prevent situations where someone uses a FidoNet  mailer
  1547. to 'impersonate' a legitimate FidoNet node, and pickup mail addressed to
  1548. the node.  When implemented, both the sending and receiving systems must
  1549. have  it in operation,  with the same password on both ends  (exceptions
  1550. noted below).
  1551.  
  1552. With  Point  systems,  passwording can be  automatic.   Simply  use  the
  1553. 'Key' configuration file option,  and choose a password.  Make sure your
  1554. Boss also uses the same password.
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560. User Guide - Page 26
  1561.  
  1562. BinkleyTerm ST 3.00 - User Guide
  1563.  
  1564.  
  1565. For other types of systems, password information is kept in the nodelist
  1566. data file.  ParseLst (and some other nodelist processors) can easily add
  1567. a  password  to  a  nodelist entry  during  processing.   Refer  to  the
  1568. documentation  for your nodelist processor.   Or you can use  the  'Key'
  1569. configuration option to save having to recompile the nodelist!
  1570.  
  1571. When  talking  with other systems that use the YooHoo  or  EMSI  session
  1572. negotiation methods, full, two-way protection is available.  The systems
  1573. connect and exchange the password when the YooHoo takes place.   If  the
  1574. passwords  do not match,  the session is terminated,  regardless of  who
  1575. initiated  the  call.   The only exception is when you have  a  password
  1576. implemented,  but the remote has NO password implemented.  In this case,
  1577. if YOU placed the call,  then a session will still occur.  If the REMOTE
  1578. placed the call, then the session will be aborted.
  1579.  
  1580. When  connected with SEAdog and compatible  systems,  password  matching
  1581. takes  place only when you are picking up mail from the  remote  system.
  1582. You  may send to a SEAdog system without a password match taking  place.
  1583. (The  assumption is that you always know who you're calling,  but  don't
  1584. always know who's calling you.)
  1585.  
  1586. Note  that session passwords must not exceed eight (8)  characters,  and
  1587. are case insensitive.
  1588.  
  1589. When BinkleyTerm cannot find a password for a remote system when placing
  1590. a  call,  it  will not check for a password during  the  session.   This
  1591. responsibility  is left to the remote system,  if the remote chooses  to
  1592. perform checking.
  1593.  
  1594. BinkleyTerm allows easy implementation of new passwords.  Simply add the
  1595. agreed  upon password as outlined above,  and send the remote  system  a
  1596. message.   BinkleyTerm  will allow an outbound session to take place  in
  1597. cases where you have designated a password,  but the remote has not  yet
  1598. implemented it.   This is handy for letting a remote system know that  a
  1599. password was implemented.   Note that in this case, BinkleyTerm will NOT
  1600. allow the remote to have a successful session when the remote calls your
  1601. system;  only when you place the call (as stated above, the idea is that
  1602. you know who you're calling, not who's calling you).
  1603.  
  1604. 3.13.5 Secured Inbound File Areas
  1605.  
  1606. Another  method  of securing the flow of mail involves  controlling  the
  1607. processing  of incoming mail to your system.   In most cases,  you  will
  1608. want to protect common mail links with session passwording,  as outlined
  1609. in  the  previous section.   Still,  the potential  exists  for  another
  1610. abusive  system  to send you rogue mail,  or mail  "planted"  onto  your
  1611. system  in  hopes  that  it will be routed to  another  system  at  your
  1612. expense, or find its way into a national EchoMail conference.
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620. User Guide - Page 27
  1621.  
  1622. BinkleyTerm ST 3.00 - User Guide
  1623.  
  1624.  
  1625. The   following  list  shows  the  various  security  levels   and   the
  1626. configuration  file  statements  that define  their  respective  inbound
  1627. paths:
  1628.                Prot      'ProtInbound'
  1629.                Known     'KnownInbound'
  1630.                Default   'NetFile'
  1631.  
  1632. In   a  typical  installation  secured  in  this   manner,   mail   will
  1633. automatically  be processed only if received to the 'ProtInbound'  area.
  1634. Mail  received  to  'KnownInbound' or 'NetFile'  must  be  examined  and
  1635. processed  manually.   Of  course,  you could choose to  configure  your
  1636. system  in a such a manner that mail received in any of the three  areas
  1637. is processed automatically to your liking,  possibly to special  message
  1638. areas.
  1639.  
  1640. The  only "hole" in this is with FSC-0001 sessions,  such as those  with
  1641. SEAdog or Fido.   Since BinkleyTerm has no way of knowing the address of
  1642. the sending system until a packet is received,  that first packet  (.PKT
  1643. file)  will  always  be  placed in the default  area  specified  by  the
  1644. 'NetFile' statement.
  1645.  
  1646. Secured  inbound  file areas simply provide another,  extra  measure  of
  1647. handling  potential security problems associated with the  reception  of
  1648. "rogue" or "planted" mail.
  1649.  
  1650. 3.13.6 Controlling File Requests
  1651.  
  1652. BinkleyTerm offers a method of establishing limitations on file requests
  1653. received  from systems that are not session password protected,  or  are
  1654. not found in the nodelist.  This support is optional; if you do not wish
  1655. to  limit  file  requests  in  this  manner,  use  only  the  files  and
  1656. configuration file statements mentioned in the section "File Requests."
  1657.  
  1658. The  following  table  lists these possibilities,  the  file  types  (as
  1659. described   in   the  section  "File  Requests")  and   the   respective
  1660. configuration file statement used:
  1661.  
  1662.                Prot      ABOUT     'ProtAbout'
  1663.                          AVAIL     'ProtAvail'
  1664.                          OKFILE    'ProtReqList'
  1665.                          Maximum   'ProtReqLim'
  1666.                          Maximum   'ProtMaxBytes'
  1667.                          Maximum   'ProtMaxTime'
  1668.  
  1669.                Known     ABOUT     'KnownAbout'
  1670.                          AVAIL     'KnownAvail'
  1671.                          OKFILE    'KnownReqList'
  1672.                          Maximum   'KnownReqLim'
  1673.                          Maximum   'KnowMaxBytes'
  1674.                          Maximum   'KnownMaxTime'
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680. User Guide - Page 28
  1681.  
  1682. BinkleyTerm ST 3.00 - User Guide
  1683.  
  1684.  
  1685.                Default   ABOUT     'About'
  1686.                          AVAIL     'Avail'
  1687.                          OKFILE    'Okfile'
  1688.                          Maximum   'MaxReq'
  1689.                          Maximum   'MaxBytes'
  1690.                          Maximum   'Maxtime'
  1691.  
  1692. Essentially,   the  default  files  and  configuration  file  statements
  1693. described in the section "File Requests" are used for all file  requests
  1694. by  default  unless  a  higher "Known"  or  "Prot"  statement  is  used.
  1695.  
  1696. Note  that  all  file  request controls apply  to  update  requests  and
  1697. function requests as well.
  1698.  
  1699. 3.13.7 Response File Templates
  1700.  
  1701. Refer  to the section "Request Response Files" for information on  their
  1702. operation and use.
  1703.  
  1704. It is possible to designate separate response file templates for each of
  1705. the three security levels.  Generally, you won't want or need to do this
  1706. unless security controls on file requests have been implemented.
  1707.  
  1708. The security levels and their respective configuration files  statements
  1709. for secured response file templates are:
  1710.  
  1711.                Prot      'ProtReqTpl'
  1712.                Known     'KnownReqTpl'
  1713.                Default   'ReqTemplate'
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740. User Guide - Page 29
  1741.  
  1742. BinkleyTerm ST 3.00 - User Guide
  1743.  
  1744.  
  1745. 3.14 BBS Interface
  1746.  
  1747. One of the most common uses of BinkleyTerm is as a mail front-end for  a
  1748. bulletin  board  system,  or BBS.   BinkleyTerm offers  three  different
  1749. methods for passing control to a BBS.   The method you use is determined
  1750. by  a  configuration file statement (refer to the  Reference  Guide  for
  1751. details).
  1752.  
  1753. 3.14.1 BBS Exit
  1754.  
  1755. The  'BBS  Exit' option will cause BinkleyTerm to exit to  the  start-up
  1756. batch  file  with  an errorlevel of the baud rate divided  by  100  upon
  1757. receipt of a non-mail call.  For example, a 300 baud caller exits to the
  1758. batch file with an errorlevel of 3, a 2400 baud caller at errorlevel 24.
  1759.  
  1760. The  batch file then detects the errorlevel,  and jumps to a section  of
  1761. the batch file you designate to start the BBS program with the  required
  1762. information.  The batch file should recycle and restart BinkleyTerm once
  1763. BBS use is terminated.
  1764.  
  1765. 3.14.2 BBS Spawn
  1766.  
  1767. The 'BBS Spawn' option causes BinkleyTerm to stay resident when a caller
  1768. accesses the BBS.   BinkleyTerm will execute the following command as  a
  1769. child  process:
  1770.   spawnbbs <baud> <port> <time> <modem_info>
  1771.  
  1772. This  is  only of use if you have a resident shell and plenty  of  spare
  1773. memory.
  1774.  
  1775. SPAWNBBS
  1776.    is the name of a batch file you create.
  1777. <baud>
  1778.    is the baud rate of the connection,
  1779. <port>
  1780.    is the communications port number used for the call
  1781. <time>
  1782.    is  the  number  of minutes to the  next  non-BBS-allowed  event  (as
  1783.    designated in your configuration file event schedules).
  1784. <modem_info>
  1785.    is intended primarily for RBBS-PC installations where extended  modem
  1786.    connect  information may be desired.   For  example,  USRobotics  HST
  1787.    modems  might issue the connect message "CONNECT 9600/ARQ"  in  which
  1788.    case  the  <modem_info>  parameter  would  be  "/Arq"  indicating   a
  1789.    "reliable" connection.   Note that in this parameter,  only the first
  1790.    letter of each "word" will be capitalized (as shown in the example).
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800. User Guide - Page 30
  1801.  
  1802. BinkleyTerm ST 3.00 - User Guide
  1803.  
  1804.  
  1805. 3.14.3 BBS Batch
  1806.  
  1807. The  'BBS Batch'  option uses the best of both of  'BBS Exit'  and  'BBS
  1808. Spawn.'
  1809.  
  1810. BinkleyTerm  still  exits  to the start-up  batch  file,  but  prior  to
  1811. exiting,  BinkleyTerm  physically writes to the disk a batch file  named
  1812. BBSBATCH.BAT,  which contains a single line.  An example of the contents
  1813. of this file might be:
  1814.    spawnbbs 2400 1 47 /Arq
  1815.  
  1816. The information is the baud rate, port number and time in minutes to the
  1817. next non-BBS event.   In this case,  there is a 2400 baud caller, on COM
  1818. port 1, with 47 minutes remaining to the next non-BBS event, and a modem
  1819. information string of /Arq.
  1820.  
  1821. After  writing  this  file,  BinkleyTerm exits as does  the  'BBS  Exit'
  1822. option,  with  an errorlevel of the baud rate of the caller  divided  by
  1823. 100.
  1824.  
  1825. The   start-up   batch   file   should   simply   start   execution   of
  1826. BBSBATCH.BAT by adding the line "bbsbatch" to the file,  and jumping  to
  1827. the line whenever a human caller is on-line.  In other words, regardless
  1828. of the baud rate of the caller, BBSBATCH.BAT should be invoked.
  1829.  
  1830. Once   invoked,   BBSBATCH.BAT   will  invoke  SPAWNBBS.BAT   with   the
  1831. necessary parameters that include the baud rate, port number, and minute
  1832. to the next non-BBS event.  SPAWNBBS.BAT would physically invoke the BBS
  1833. with the proper command lines.   When use of the BBS is  complete,  this
  1834. batch file should re-invoke the BinkleyTerm start-up batch file.
  1835.  
  1836. Using  this  'BBS Batch' method of accessing the  BBS,  BinkleyTerm  can
  1837. still provide all the information of the 'BBS Spawn' method, without the
  1838. necessity of staying resident.
  1839.  
  1840. When  a  file  named  BINKLEY.BAN  is  present  in  the  directory  that
  1841. BinkleyTerm  is  invoked from,  the file will be  displayed  to  callers
  1842. immediately after the BinkleyTerm identification line.
  1843.  
  1844. The file is a flat ASCII text file, and may contain extended information
  1845. for the benefit of callers.
  1846.  
  1847. 3.14.4 What this really means?
  1848.  
  1849. All these batch files and things were designed with the PC in  mind,  on
  1850. the ST without a standard CLI, things are a little different.
  1851.  
  1852. When using ///Turbo-board,  you should use the 'BBS Batch' method and  a
  1853. batch  file  called FIDOMAIL.BAT.   For errorlevels  representing  human
  1854. callers  you should copy BBSBATCH.BAT that BinkleyTerm writes  out  into
  1855. //Turbo's  own  Batch folder and then simply exit to allow  ///Turbo  to
  1856. take  over.   Example batch files may be found included in the  FidoDoor
  1857. package and probably from the ///Turbo support BBS.
  1858.  
  1859.  
  1860. User Guide - Page 31
  1861.  
  1862. BinkleyTerm ST 3.00 - User Guide
  1863.  
  1864.  
  1865. When  using  QuickBBS-ST you would normally use the 'BBS  Exit'  method.
  1866. More  information and example batch files are included in  the  QuickBBS
  1867. manual.
  1868.  
  1869. 3.15 External Mail Programs
  1870.  
  1871. BinkleyTerm  can  be used with external mail  programs,  such  as  UUCP.
  1872. When  an  'ExtrnMail'  statement  is used  in  the  configuration  file,
  1873. BinkleyTerm will answer the phone and wait for a YooHoo,  TSYNC or  EMSI
  1874. startup sequence (the start of a mail session) or a string you designate
  1875. with  the 'ExtrnMail' option.   When the designated string  is  received
  1876. from the remote system, BinkleyTerm will send the string associated with
  1877. the 'MailNote' configuration file option (if any),  then will physically
  1878. write a batch file called MAILBAT.BAT to the disk, and exit the start-up
  1879. batch  file with an errorlevel as given with the 'ExtrnMail'  statement,
  1880. or with errorlevel 99 if none was given.
  1881.  
  1882.  MAILBAT.BAT contains a single line:
  1883.  
  1884.    EXTMAIL <baud> <port> <time> <errorlevel> <modem_info>
  1885.  
  1886. Where  <baud>  is the baud rate of the caller,  <port> is the  COM  port
  1887. number,  and  <time> is the time in seconds to the next  non-BBS  event,
  1888. <errorlevel>  is the errorlevel number used to exit the  original  batch
  1889. file, and <modem_info> is extended modem connect information.
  1890.  
  1891. <errorlevel>  will  be  the  same as that  given  with  the  'ExtrnMail'
  1892. statement  in  the  configuration  file,  or "99"  if  none  was  given.
  1893.  
  1894. <modem_info>  is  intended  primarily for  RBBS-PC  installations  where
  1895. extended  modem  connect  information  may  be  desired.   For  example,
  1896. USRobotics HST modems might issue the connect message "CONNECT 9600/ARQ"
  1897. in  which case the <modem_info> parameter would be "/Arq"  indicating  a
  1898. "reliable"  connection.   Note that in this parameter,  only  the  first
  1899. letter  of  each "word" will be capitalized (as shown in  the  example).
  1900.  
  1901. Notice the similarity in concept between this and the 'BBS Batch' method
  1902. of  invoking a BBS (as described previously).   When  BinkleyTerm  exits
  1903. with the previously defined errorlevel, your batch file must capture the
  1904. errorlevel and invoke MAILBAT.BAT, which will in turn invoke EXTMAIL.BAT
  1905. with the various command line parameters shown above.
  1906.  
  1907. EXTMAIL.BAT  is  then used to invoke the external mail program  of  your
  1908. choice,  taking  the needed command line parameters as supplied  by  the
  1909. batch  file,  and  processing and/or using them  as  needed.   Once  the
  1910. external mail program session has been completed, your original start-up
  1911. batch  file for BinkleyTerm should be invoked to place  BinkleyTerm  on-
  1912. line again.
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920. User Guide - Page 32
  1921.  
  1922. BinkleyTerm ST 3.00 - User Guide
  1923.  
  1924.  
  1925. 3.16 User Selected BBS Functionality
  1926.  
  1927. An  additional use for the external mail functionality described in  the
  1928. previous section would be to allow multiple BBS systems to reside at the
  1929. same telephone number,  and to give BBS users the ability to select  the
  1930. desired  BBS  from  a menu.   It would be  possible  to  run  completely
  1931. separate  systems,  to run the same system with different BBS  packages,
  1932. and so on.  This section will give an overview of the procedure.
  1933.  
  1934. Basically,  'ExtrnMail' statements in the configuration file are used to
  1935. build  the menu options themselves.   If you want to exit to  the  batch
  1936. file  when a user presses 'A' on their terminal,  then  a  configuration
  1937. file entry like this would be needed:
  1938.  
  1939.                ExtrnMail 130 A
  1940.  
  1941. This would cause BinkleyTerm to write MAILBAT.BAT to the disk,  and exit
  1942. to  the  batch  file with an errorlevel of 130.   As  described  in  the
  1943. previous  section  on external mail programs,  your  batch  file  should
  1944. invoke  MAILBAT.BAT,  which in turn  invokes  EXTMAIL.BAT.   EXTMAIL.BAT
  1945. would  be  the  batch file that acts upon  the  choice,  and  physically
  1946. invokes the desired BBS program.
  1947.  
  1948. If  you want the choices to be case-insensitive,  then  two  'ExtrnMail'
  1949. statements would be needed for each letter, like this:
  1950.  
  1951.                ExtrnMail 130 A
  1952.                ExtrnMail 130 a
  1953.  
  1954. This  would cause BinkleyTerm to use errorlevel 130 when either  'a'  or
  1955. 'A' is received from the user.
  1956.  
  1957. The menu presented to users should be kept in a file called  BINKLEY.BAN
  1958. (refer  to the "Banner" section for  more  information).            This
  1959. file might look like this:
  1960.  
  1961.    Welcome to Multi-System 100.  Please choose the desired BBS:
  1962.  
  1963.       A - "Garden Central" Using QuickBBS Software
  1964.       B - "Margarita Bay" Using Opus-CBCS Software
  1965.       C - "Margarita Bay" Using Fido 11w Software
  1966.  
  1967.    Make your selection by letter...
  1968.  
  1969. Such a menu would allow users three options.  Each lettered option would
  1970. require a separate 'ExtrnMail' statement in the configuration file;  two
  1971. each if case insensitivity is required.
  1972.  
  1973. The  string  "Make  your selection by letter..."  is  NOT  contained  in
  1974. BINKLEY.BAN,  but  rather,  is  added with a 'Banner' statement  in  the
  1975. configuration  file  so that the line is re-displayed each time  a  user
  1976. makes  an  incorrect  choice  (refer  to  the  Reference  Guide  section
  1977. "Configuration File" for information).
  1978.  
  1979.  
  1980. User Guide - Page 33
  1981.  
  1982. BinkleyTerm ST 3.00 - User Guide
  1983.  
  1984.  
  1985. Once  the user has made a selection,  and MAILBAT.BAT is invoked and  in
  1986. turn  EXTMAIL.BAT is invoked,  then the batch file must determine  which
  1987. selection is made and act upon it.
  1988.  
  1989. In EXTMAIL.BAT (where the BBS systems are invoked), the top of the batch
  1990. file  should  make a determination as to which choice was given  by  the
  1991. user.   One  of the parameters on the command line when  EXTMAIL.BAT  is
  1992. invoked by MAILBAT.BAT is the errorlevel which corresponds to the choice
  1993. the  user  gave  (as  designated by  an  'ExtrnMail'  statement  in  the
  1994. configuration  file).
  1995.  
  1996. A section of the batch file (MSDos style) might look like this:
  1997.  
  1998.                if %4 == 130 goto bbs1
  1999.                if %4 == 140 goto bbs2
  2000.                if %4 == 150 goto bbs3
  2001.  
  2002. The fourth parameter given on the command line is the errorlevel  value,
  2003. and is reference by "%4" as shown.   For example, if the errorlevel that
  2004. corresponds to the choice was 130,  then batch file execution would jump
  2005. to the "bbs1" label, and invoke a particular BBS program.
  2006.  
  2007. Please note that the default is for a user to press the "escape" key  to
  2008. enter  the BBS.   One of the BBS systems should be setup as the  default
  2009. system as described in the section "BBS Interface."  Should a user press
  2010. "escape,"  or if the time limit to make a response  should  expire,  the
  2011. default  BBS would be invoked.   Note also that the  configuration  file
  2012. parameter 'Timeout' should be extended to allow a user more time to read
  2013. and make a selection prior to making a default exit.   A 'Timeout' value
  2014. of 30 to 60 seconds is suggested.
  2015.  
  2016. Placing  multiple BBS systems on-line at one number takes some work  and
  2017. experimentation in order to operate correctly.  Hopefully the tips given
  2018. here will point you in the right direction.
  2019.  
  2020. 3.17 File Requests
  2021.  
  2022. BinkleyTerm   supports   the   two   popular   file   request    methods
  2023. currently in use in FidoNet; "Bark" requests as designed for and used by
  2024. SEAdog, and "WaZOO" as designed for and used by Opus-CBCS.  Either style
  2025. can be used on an incoming or outgoing basis.
  2026.  
  2027. To generate an outgoing file request,  use the option from within BTS or
  2028. the LED editor.   You may also generate file requests by pressing  Alt-G
  2029. (Get file) in BinkleyTerm's unattended mode.   Or you may even  manually
  2030. build one yourself.  They are simple ASCII text files named in the  same
  2031. way as for packets with a .REQ extension.   Each line contains the  name
  2032. of the file you want.  Note that outgoing requests should NEVER contain
  2033. the drive and path of the file, only the filename.
  2034.  
  2035. The   .REQ   file   is   placed   in   your   outbound   holding   area.
  2036. BinkleyTerm will handle .REQ files in the same manner as it does  Normal
  2037. packets  (unless an 'X' flag is applied to an event),  but you can  also
  2038. manually poll to send the request immediately.
  2039.  
  2040. User Guide - Page 34
  2041.  
  2042. BinkleyTerm ST 3.00 - User Guide
  2043.  
  2044.  
  2045. Incoming  requests are controlled and affected by four  files,  each  of
  2046. which are designated in the configuration file.
  2047.  
  2048. The first file,  OKFILE,  is a machine-read listing of  files,  complete
  2049. with  drive and path,  that you will allow to be sent to remote  systems
  2050. via file request.  The file is designated with the 'Okfile' statement in
  2051. the configuration file.   Wildcards are allowed, and nearly always used.
  2052. When an incoming request is received, the request is checked against the
  2053. OKFILE to see if you permit the file to be sent.
  2054.  
  2055. The  OKFILE  also allows you to implement "magic  filenames"  which  are
  2056. words used to represent a file.  If someone requests "BINKLEY" from you,
  2057. for  example,  you  could set-up your OKFILE in such a way  as  to  send
  2058. BTST241A.LZH in return.   This frees the person making the request  from
  2059. having  to  know  the exact filename of the  file  he  wants.   This  is
  2060. generally used by systems which are software distribution points,  hubs,
  2061. and so on.
  2062.  
  2063. Password  protection may also be implemented with the OKFILE,  making  a
  2064. password  required  in order to receive a particular file  or  group  of
  2065. files.
  2066.  
  2067. A sample OKFILE:
  2068.  
  2069.                b:\aprog.ARC
  2070.                c:\file\stuff\*.*
  2071.                c:\file\programs\wlc*.txt
  2072.                c:\file\private\*.* !mypass
  2073.                @BINKLEY c:\file\dist\bexe_150.arc
  2074.                @MYEDIT !outpass c:\file\private\editmax.arc
  2075.  
  2076. The  first  line  gives  an  exact  filename.    The  second  and  third
  2077. lines  show  the  use of wildcards.   The  fourth  line  shows  password
  2078. protection, with an exclamation point (!) followed by the password.  The
  2079. fifth  line shows a magic filename,  an 'at' symbol (@) followed by  the
  2080. magic  filename,   followed  by  an  exact  drive,   path  and  filename
  2081. designation.   The  sixth  line  shows a magic  filename  with  password
  2082. protection.
  2083.  
  2084. Note  that  in  all cases,  a password (if any)  is  always  the  second
  2085. argument in an OKFILE entry.
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100. User Guide - Page 35
  2101.  
  2102. BinkleyTerm ST 3.00 - User Guide
  2103.  
  2104.  
  2105. The  next  special  file is the AVAIL file,  and is  designated  by  the
  2106. 'Avail' statement in the configuration file.   When someone requests the
  2107. magic filename "FILES" BinkleyTerm will send this file.  It is a list of
  2108. the files you have available for request,  in human readable form.  This
  2109. is a flat ASCII text file,  and should feature the name of the file, and
  2110. usually  its size in bytes and a short description of the  file.   There
  2111. are utilities available that can construct this file automatically based
  2112. on  your BBS system's internal listings (e.g.  Fibu for QuickBBS-ST  and
  2113. TiNF for ///Turbo).  Of course, it could also be manually created.  Most
  2114. systems  that  have a large selection of Freq'able  files,  archive  the
  2115. AVAIL file rather than send it as ASCII.   I use LHarc and call the file
  2116. 02520025.LZH, other systems use ARC (the only official FidoNet Archiver)
  2117. and   use  the  Hex  naming  convention  used  by  the   packets,   e.g.
  2118. 00FC0019.ARC.   Other people simply send back ALLFILES.ARC or  something
  2119. similar.
  2120.  
  2121. The next special file is called the ABOUT file, and is designated by the
  2122. 'About'  statement  in the configuration file.   When  someone  makes  a
  2123. request for the magic filename "ABOUT" or when someone makes an  invalid
  2124. WaZOO file request (and you haven't set up any Request templates),  this
  2125. file is sent by BinkleyTerm.  It normally contains a short advertisement
  2126. about  your system,  as well as a notification that the  calling  system
  2127. could  possibly have made an invalid request.   Again,  this is  a  flat
  2128. ASCII text file in human-readable form.
  2129.  
  2130. The ABOUT file is sent only on failed WaZOO requests.   The file is  NOT
  2131. sent on failed Bark requests.
  2132.  
  2133. Finally,  the  last items that apply to file requests are the  'MaxReq',
  2134. 'MaxBytes' and 'MaxTime' statements contained in the configuration file.
  2135. A quantity is given with the statements which allow you to designate the
  2136. maximum  number of files,  maximum number of bytes and maximum  time  to
  2137. allow  sending  files during one file request  session.   Refer  to  the
  2138. Reference Guide section "Configuration File" for more information.
  2139.  
  2140. It  is  possible  to limit incoming file requests based  on  some  basic
  2141. criteria.  For information, refer to the section "Security - Controlling
  2142. File Requests."
  2143.  
  2144. 3.17.1 Update Requests
  2145.  
  2146. Update  requests  are a method of obtaining an "update" of  a  file  you
  2147. already  have,  from  another system you believe to have a  newer  copy.
  2148. They  differ  from file requests in that when you  construct  an  update
  2149. request,  you include a drive/path/file specification that points to  an
  2150. existing file on your system.   Generally, DOS wildcards are acceptable.
  2151. When BinkleyTerm connects with the desired remote,  it will compare  the
  2152. date  and  time stamp on your copy of the file(s) to the date  and  time
  2153. stamp  of the same-named file(s) on the remote system.   If  the  remote
  2154. system has a newer copy of a given file,  it will be sent.   If it  does
  2155. not,  no file will be sent.   Note that the drive and path specification
  2156. DO NOT need to be the same on the remote system;  the drive and path you
  2157. give refer only to YOUR copy of the file.   The remote may have any file
  2158. structure he or she desires.
  2159.  
  2160. User Guide - Page 36
  2161.  
  2162. BinkleyTerm ST 3.00 - User Guide
  2163.  
  2164.  
  2165. Update  requests were originally implemented in SEAdog,  a  mailer  from
  2166. System Enhancement Associates,  Inc.   In addition to supporting  update
  2167. requests  with SEAdog systems,  BinkleyTerm implements a  newly  defined
  2168. WaZOO update request for use other BinkleyTerm systems, or other mailers
  2169. that support WaZOO update requests.
  2170.  
  2171. Update  requests are most commonly used now to handle GroupMail,  a  new
  2172. method  of  sharing  message  areas  developed  by  System   Enhancement
  2173. Associates, Inc.  GroupMail generally requires update request capability
  2174. on both ends of the connection.
  2175.  
  2176. Like  file  requests,  update requests are kept in .REQ  files  in  your
  2177. outbound area.   In fact,  a combination of update and file requests can
  2178. be  contained in the same physical .REQ file.   An update request  entry
  2179. contains a filename, as well as a date and time code that corresponds to
  2180. the  date and time stamp of the file on your system.   Because the  date
  2181. and  time code is in a special format,  it is not recommended  that  you
  2182. attempt to create an update request entry yourself.
  2183.  
  2184. At this writing, I don't think there are any Atari packages that support
  2185. update requests.
  2186.  
  2187. Please note that in order for update requests to work, the remote system
  2188. must have the file you want updated available for regular file  request.
  2189. You cannot update a file that would not otherwise be available for  file
  2190. request from the remote system.
  2191.  
  2192. 3.17.2 Request Response Files
  2193.  
  2194. Incoming   file   and  update  requests  are  not   always   successful.
  2195. BinkleyTerm  supports  the ability to dynamically generate  a  "response
  2196. file."   This file is either sent back as a Netmail to the SysOp of  the
  2197. remote system or if you have the line SendRSP as a plain text file  with
  2198. a  .RSP  extension.   The response file is built "on-the-fly"  during  a
  2199. session,  and sent in response to a failed (or optionally, a successful)
  2200. file  or update request.   If you choose to implement  request  response
  2201. files,  the  "about" file designated in your configuration file will  no
  2202. longer be sent.  See "File Requests" for more information.
  2203.  
  2204. Note  that  when  a response file is sent,  it is  counted  against  the
  2205. maximum number of file sent in response to a request,  as designated  by
  2206. the 'MaxReq' statement in the configuration file.   See "File  Requests"
  2207. or   the   Reference  Guide  section  "Configuration  File"   for   more
  2208. information.
  2209.  
  2210. The  content of the response file is configured by you with  a  template
  2211. file.   The  template  file  name is  designated  by  the  'ReqTemplate'
  2212. configuration  file  statement.   As with file requests,  you  can  also
  2213. implement security controls with the request templates.  See "Security -
  2214. Response File Templates" for more details.
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220. User Guide - Page 37
  2221.  
  2222. BinkleyTerm ST 3.00 - User Guide
  2223.  
  2224.  
  2225. Normally,  the  response file contains information such as the date  and
  2226. time the request was made,  what file was requested, and why the request
  2227. failed.   You  may  wish to include information such as the  times  your
  2228. system accepts requests, what magic filenames you support, and so on.
  2229.  
  2230. Response  files are named similar to outbound packets or request  files.
  2231. They are <net><node>.RSP,  where <net> is a net number,  and <node> is a
  2232. node  number.   Both <net> and <node> are four-digit hexadecimal  number
  2233. with leading zeroes.
  2234.  
  2235. A  sample  response file template,  SAMPLE.TPL,  is  included  with  the
  2236. BinkleyTerm distribution package.   Use this sample as a starting  point
  2237. for your own response file template.
  2238.  
  2239. The complete list of possible verbs for use in the response file can  be
  2240. found  in the section "Response File Template" in the  Reference  Guide.
  2241.  
  2242. 3.18 Function Requests
  2243.  
  2244. Two  additional  special  entries may be included  in  the  OKFILE  that
  2245. operate similar to magic filenames.   Called "magic" function  requests,
  2246. they allow an incoming request to trigger the operation of a program.
  2247.  
  2248. 3.18.1 $ Function Requests
  2249.  
  2250. The first style uses a dollar sign ($) in the first column of an  OKFILE
  2251. entry,  followed  by a function request name.   If the name is  matched,
  2252. then the command after the password (if any) is executed.   In addition,
  2253. two arguments which correspond to the net and node number of the calling
  2254. system can be sent if desired by adding "%d %d" to the end of the OKFILE
  2255. entry.  For example:
  2256.  
  2257.                $INFO INFO.BAT %d %d
  2258.  
  2259. If  an  incoming file request is for "INFO" then  the  program  INFO.BAT
  2260. would be executed,  and it would receive two command line arguments that
  2261. correspond to the net and node number respectively.   For  instance,  if
  2262. 141/491  requested "INFO" then the following would be issued to DOS  for
  2263. execution:
  2264.  
  2265.                INFO.BAT 141 491
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280. User Guide - Page 38
  2281.  
  2282. BinkleyTerm ST 3.00 - User Guide
  2283.  
  2284.  
  2285. Another example of such an OKFILE entry would be:
  2286.  
  2287.                $CLEANUP !mypass CLEANUP.BAT %x %x
  2288.  
  2289. In this case, a password is included as the second argument of the line,
  2290. and must be matched by the incoming request in order for the program  to
  2291. be  executed.   Note also that in this example,  "%x %x" was  used,  and
  2292. would  cause a hexadecimal representation of the net and node number  to
  2293. be sent as command line arguments to the program being executed.  In our
  2294. example,  if 104/36 requests "CLEANUP" with a password of "mypass"  then
  2295. the following would be sent to DOS for execution:
  2296.  
  2297.                CLEANUP.BAT 68 24
  2298.  
  2299. See  "Function  Request  Notes" below for  additional  function  request
  2300. information.
  2301.  
  2302. 3.18.2 + Function Requests
  2303.  
  2304. A second type of function request is also supported,  and is  designated
  2305. by  a  plus sign (+) in the first column of an OKFILE  entry.   In  this
  2306. case, if the filename and optional password are matched, then the entire
  2307. line from the incoming .REQ file is passed to DOS for  processing,  with
  2308. the <zone>:<net>/<node> address appended as individual arguments to  the
  2309. command line.  An example of an OKFILE entry might be:
  2310.  
  2311.                +GETREV !mypass
  2312.  
  2313. If an incoming .REQ file from 141/491 contained the line:
  2314.  
  2315.                GETREV !mypass BT 1.50
  2316.  
  2317. Then the following would be passed to DOS for execution:
  2318.  
  2319.                GETREV !mypass BT 1.50 1 141 491
  2320.  
  2321. A program called GETREV would be executed,  and would need to process or
  2322. filter the command line as needed.  Function requests are convenient for
  2323. allowing  a remote system to have a batch file or utility of  some  kind
  2324. (not  included)  place a particular file on hold for a  node  for  later
  2325. pickup,  to cause the system to send a particular file,  to trigger some
  2326. other sort of function or activity remotely, etc., etc.
  2327.  
  2328. If a program called as part of a function request creates a file in  the
  2329. appropriate outbound area called <net><node>.QLO (where <net> and <node>
  2330. are 4-digit hexadecimal numbers with leading zeroes),  BinkleyTerm  will
  2331. treat  this file as a legitimate "flow" (file attach) file and send  the
  2332. file(s) listed in it back to the caller as part of the request logic.
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340. User Guide - Page 39
  2341.  
  2342. BinkleyTerm ST 3.00 - User Guide
  2343.  
  2344.  
  2345. 3.18.3 Function Request Notes
  2346.  
  2347. If  a function request triggers a program or batch file to build a  file
  2348. attach (flow) file, then BinkleyTerm will process the file attach during
  2349. the  current session.   In other words,  if a file attach  is  generated
  2350. during  a function request,  then the file(s) shown in the  file  attach
  2351. will be sent during the current session.
  2352.  
  2353. Note that the normal logic for the handling of .HLO (Hold file attaches)
  2354. still applies;  i.e., file(s) designated within a .HLO file will be sent
  2355. only when the destination node polls for pick-up.
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400. User Guide - Page 40
  2401.  
  2402. BinkleyTerm ST 3.00 - User Guide
  2403.  
  2404.  
  2405. 4. Utilities to use with BinkleyTerm-ST
  2406.  
  2407. I can not hope to list all of the available utilities,  and you would be
  2408. well  advised  to FREQ the files list from one of the  larger  ST  based
  2409. boards  near you and see what is available and also to ask other  SysOps
  2410. what they would recommend.
  2411.  
  2412. Note  that  the  mention of any software here does not mean  that  I  am
  2413. endorsing  the  use of the software.   I am merely trying to  provide  a
  2414. guide to what is available in one place.   If anyone has suggestions for
  2415. other utilities to mention here then please send me a paragraph about it
  2416. (See  BinkleyTerm  support).   The intention is only  to  mention  those
  2417. utilities  that  are  for particular use with  BinkleyTerm  rather  than
  2418. general purpose BBS utilities.
  2419.  
  2420. 4.1 Mail Processing
  2421.    Mail processing can be split into several steps:
  2422.       Import   Takes  incoming  packets from the netfile  folder(s)  and
  2423.                puts them into the appropriate message areas.
  2424.       Scan     Scans  echomail  areas and creates messages for  all  the
  2425.                systems that messages should be sent to.
  2426.       Export   Copies messages from the netmail areas (and extra  export
  2427.                areas) into the outbound folders.   Compressing  echomail
  2428.                is also included in this stage.
  2429.       Pack     Marking old messages as deleted and repacking the message
  2430.                areas.  This is also sometimes called Renumbering
  2431.    Some  packages combine all these into one  operation, whereas  others
  2432.    keep  them  as  separate  utilities.   Some  of  the  available  mail
  2433.    processing utilities for the Atari ST include:
  2434.       ACS (Area Cleaner Software).   This includes 4 separate  programs:
  2435.       come_in,  tidy_up,  go_out and BTS.  Includes AreaFix and FileFix.
  2436.       Can be used for points and nodes.  Shareware.  Contact Roland Bohn
  2437.       2:241/5811
  2438.  
  2439.       IOS (Input/Output/Scan).  This includes all of the mail processing
  2440.       functions  in one program and as a result is very fast as well  as
  2441.       providing  some  advanced features not found in  other  utilities.
  2442.       Can be used by points and nodes.  Contact Johan Ansems 2:280/3.
  2443.  
  2444.       ECU  and  Llegada.    Mail  processing  for  point  systems.   All
  2445.       documentation  is  currently available only  in  German.   Contact
  2446.       Heinz Ozwirk 2:249/6.8
  2447.  
  2448.       The Box Utilities.  These provide a comprehensive set of utilities
  2449.       comprising separate programs (Import,  ComScan,  pack) designed to
  2450.       be used with The Box mailer.   Unfortunately the outbound  folders
  2451.       of the box use different naming  conventions,  so it must be  used
  2452.       with  the conversion programs BINK2TB and  TB2BINK.   Contact  Jac
  2453.       Kersing 2:286/203.
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460. User Guide - Page 41
  2461.  
  2462. BinkleyTerm ST 3.00 - User Guide
  2463.  
  2464.  
  2465. 4.2 BinkleyTerm shells
  2466.  
  2467.    These provide an easy way to edit your configuration,  set up session
  2468.    and  generally  provide  an easy to  use  environment  for  operating
  2469.    BinkleyTerm for Point Systems.  These include:
  2470.       BTS  (part  of  the ACS package described  under  mail  processing
  2471.       utilities)
  2472.       Avalon,  documentation  is  available  only  in  German.   Contact
  2473.       Stephan Slabihoud 2:245/8.13
  2474.  
  2475. 4.3 CLI/Shells
  2476.  
  2477.    Pcommand  is probably the most commonly used.   But it is quite  old,
  2478.    buggy  and lacking in features.   You will not be able to use any  of
  2479.    the shell or spawn commands with this.   Should be available from any
  2480.    ST based system.
  2481.  
  2482.    Craft is a commercial Unix style shell.  Its probably a bit expensive
  2483.    to buy just to run a BBS from,  but if you already have it then it is
  2484.    the best.
  2485.  
  2486.    There are others (Gulam,  GAK-CLI,  Mupfel,  NeoDesk CLI, etc), but I
  2487.    have  not used them with BinkleyTerm.   If anyone has  experience  of
  2488.    using other shells with BinkleyTerm then please write a paragraph and
  2489.    send it to me (see BinkleyTerm support).
  2490.  
  2491. 4.4 BBS software and Utilities
  2492.  
  2493.    QuickBBS-ST, Works well with BinkleyTerm, using the same message base
  2494.    format as most of the mail processing utilities.   Contact Theo Runia
  2495.    2:282/301.
  2496.  
  2497.    ///Turbo-board,  Uses  its own message base format,  but can be  used
  2498.    with BinkleyTerm by using other utilities.   Contact John Miller  +1-
  2499.    416-274-1225.
  2500.  
  2501.    FidoDoor, a doors program to allow users of ///Turbo or FoReM systems
  2502.    access to QuickBBS format message areas.  Contact Bryan Hall
  2503.  
  2504.    PhidoZap, similar to FidoDoor but designed for Express BBS (will work
  2505.    with ///Turbo).
  2506.  
  2507.    FiFo,  converts  messages between ///Turbo format message  areas  and
  2508.    QuickBBS format.  Contact STeVeN Green 2:252/25.
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520. User Guide - Page 42
  2521.  
  2522. BinkleyTerm ST 3.00 - User Guide
  2523.  
  2524.  
  2525. 4.5 Nodelist Processing
  2526.  
  2527.    ParselST  is currently the only choice.   Other processors are  being
  2528.    developed   and  support  will  be  added  to  future   versions   of
  2529.    BinkleyTerm-ST.
  2530.  
  2531.    Fido24, suite of utilities for point systems to help them process cut
  2532.    down nodelists and pointlists.  Contact Guenther Paczia, 2:241/4407.7
  2533.  
  2534.    NLupdate, some of the functionality of Fido24.  Contact Joerg Spilker
  2535.    2:245/52.8.
  2536.  
  2537. 4.6 Other Utilities
  2538.  
  2539.    LED:  Editor  for FidoNet  messages.   Highly  recommended.   Contact
  2540.    Roland Bohn (see ACS above).
  2541.  
  2542.    AreaFix,  for allowing points and other systems to automatically join
  2543.    and leave echomail areas.  Contact ???
  2544.  
  2545.    EchoFix, alternative to AreaFix.  Contact ???
  2546.  
  2547.    Hatch  and  STick,  for implementing  File  Networks.   Contact  Joop
  2548.    Koopman 2:281/202
  2549.  
  2550.    FiBu,   generates  file  lists  for  QuickBBS.   Contact  Theo  Runia
  2551.    2:282/301.
  2552.  
  2553.    TiNF  is  Not  Fibu (and TiNF-T2),  does the same  as  FiBu  but  for
  2554.    ///Turbo-board systems.  Contact STeVeN Green 2:252/25
  2555.  
  2556.    FilesBBS, converts between QuickBBS-ST format FILES.BBS and ///Turbo-
  2557.    board-1's file directories.  Contact Steven Green 2:252/25
  2558.  
  2559.    TNT,  same  as  FilesBBS  but for  ///Turbo-2.   Contact  Iain  Paton
  2560.    2:259/5.
  2561.  
  2562.    FSCAN,  statistics  and log file summaries.   Contact  Daron  Brewood
  2563.    2:250/123.
  2564.  
  2565.    SEE_FIDO,  for  playing  Space Empire  over  FidoNet.   Contact  Phil
  2566.    Gadsby, 2:250/128.
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580. User Guide - Page 43
  2581.  
  2582. BinkleyTerm ST 3.00 - User Guide
  2583.  
  2584.  
  2585. 5. BinkleyTerm Support and Problem Solving
  2586.  
  2587. Since BinkleyTerm is a product which is "free for the asking" you cannot
  2588. expect  a  toll-free software support line (as much as we  may  want  to
  2589. provide you with one).
  2590.  
  2591. The  primary  means of support is the  BINKLEY.ST  EchoMail  Conference.
  2592. This  conference is carried worldwide by Atari ST based  systems  within
  2593. FidoNet.   Contact a nearby ST board for information on hooking into the
  2594. conference,  or finding a system that you can use to participate in  the
  2595. conference.   The  conference is monitored and read by  the  BinkleyTerm
  2596. authors and beta testers.
  2597.  
  2598. If  you  have  any bug reports or suggestions then  you  can  send  them
  2599. directly to me at:
  2600.    STeVeN Green
  2601.    FidoNet 2:252/25
  2602.    NeST 90:1004/1004
  2603.    BBS: +44-793-849044
  2604. But  if you are just having general problems then it will be quicker  to
  2605. ask someone closer to you or in one of the Fido-ST related echoes.
  2606.  
  2607. German Support Node is:
  2608.   Bernd Renzing
  2609.   FidoNet 2:245/52@fidonet.org
  2610.   NeST 90:6000/104
  2611.   BBS: +49-2307-40486
  2612.  
  2613. If anyone would like to volunteer to become a national support help node
  2614. then please contact Steven Green  at 2:252/25.
  2615.  
  2616. 5.1 Trouble Shooting
  2617.  
  2618. 3,000 pages of documentation would not entirely eliminate the  potential
  2619. for problems with the installation and operation of BinkleyTerm.  Due to
  2620. the   wide  variety  of  hardware  and  software   configurations   that
  2621. BinkleyTerm  may  be  used  with,  as well  as  the  varying  levels  of
  2622. experience of the BinkleyTerm user, problems will sometimes occur.  This
  2623. section attempts to present common problems and possible solutions.
  2624.  
  2625. If there is not a solution to your problem presented here,  please  read
  2626. over  the appropriate sections of the manual again.   If you  still  are
  2627. having  difficulty,  place  a message in the BINKLEY.ST  echomail  area,
  2628. contact  another system using BinkleyTerm-ST or netmail Steven Green  at
  2629. 2:252/25.
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640. User Guide - Page 44
  2641.  
  2642. BinkleyTerm ST 3.00 - User Guide
  2643.  
  2644.  
  2645. 5.1.1 Baud Rate Locking Trouble
  2646.  
  2647. Do not use BinkleyTerm's 'LockBaud' configuration file  statement.   Use
  2648. the 'STLockBaud' command instead.  If you have patched you MFP to handle
  2649. 38400  baud then you should add the line 'Hard38400'  into  BINKLEY.CFG.
  2650. To use a high speed modem,  you would usually lock the baud rate  (using
  2651. AT&B1 on a Courier HST/V32) and then use the configuration options:
  2652.    Baud 19200
  2653.    STLockBaud
  2654.  
  2655. 5.1.2 Outward Dial aborting
  2656.  
  2657. Many people installing BinkleyTerm mistakenly use the 'Suffix' option in
  2658. their   configuration  file.    Unlike  most  communications   programs,
  2659. BinkleyTerm  by  default adds a carriage return to the end of  the  dial
  2660. string.   'Suffix'  is used to add instructions to the end of the  phone
  2661. number,  but  BEFORE the carriage return.   By adding a carriage  return
  2662. code (pipe symbol,  |) with the 'Suffix' statement,  you are essentially
  2663. telling  BinkleyTerm  to send TWO  carriage  returns,  yours,  plus  the
  2664. default.   With  most modems,  this will immediately abort the  dialling
  2665. process before it even gets started.
  2666.  
  2667. In  nearly all installations,  the 'Suffix' statement WILL BE  COMMENTED
  2668. OUT.   If deleting the 'Suffix' statement does not fix the problem,  you
  2669. may also try adding the 'NoCollide' and/or 'SlowModem' statements to the
  2670. configuration file.  Refer to the Reference Guide section "Configuration
  2671. File" for more details.
  2672.  
  2673. 5.1.3 False Call Collision Reports
  2674.  
  2675. In some installations, BinkleyTerm may abort the dialling process due to
  2676. an incoming call, even when there is no incoming call.  This is probably
  2677. due  to the modem reporting "RING" on both incoming and outgoing  calls.
  2678. Use  the 'SameRing' configuration file option to partially  disable  the
  2679. call  collision feature;  use the 'NoCollide' option to totally  disable
  2680. the feature.
  2681.  
  2682. 5.1.4 BinkleyTerm Will Not Recognize Node Addresses
  2683.  
  2684. You have not compiled the nodelist correctly.  Use ParseLst to compile a
  2685. fully-zoned Version 6 nodelist for your system.   To do this,  make sure
  2686. the following statements exist within your ParseLst configuration  file:
  2687. UseZone, Complete (or Gated), and Version6.
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700. User Guide - Page 45
  2701.  
  2702. BinkleyTerm ST 3.00 - User Guide
  2703.  
  2704.  
  2705. 5.1.5 Zone Support Does Not Operate Correctly
  2706.  
  2707. Chances are excellent that you have not compiled the nodelist correctly.
  2708. Although  the actual entries for nodes in other zones do not need to  be
  2709. included  in  the  compiled  nodelist  files,   what  are  called  "zone
  2710. identifiers"  DO need to be included in order for zone support to  work.
  2711. See  the section "Nodelist" for more information on correct  compilation
  2712. of a nodelist.  Another item to check is that outbound areas are created
  2713. for the other zones to which you want to send mail.   See "Zone Support"
  2714. for information on how outbound areas for other zones are constructed.
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760. User Guide - Page 46
  2761.  
  2762. BinkleyTerm ST 3.00 - User Guide
  2763.  
  2764.  
  2765. 6. Glossary
  2766.  
  2767.           ACS
  2768.  
  2769.                Area Cleaner Software.  A set of mail processing
  2770.                utilities and BinkleyTerm shell by Roland Bohn.
  2771.  
  2772.           AMAX
  2773.  
  2774.                The name of a BinkleyTerm utility by Alan Applegate that
  2775.                handles various outbound mail manipulation functions.
  2776.  
  2777.           ARCmail
  2778.  
  2779.                Simply archived mail packets, processed with an ARC-
  2780.                compatible utility.  Typically used to forward EchoMail
  2781.                messages due to the file compression inherent in the
  2782.                archiving process.  Naming conventions correspond to a
  2783.                generally accepted method.  See 'Mail Packet.'
  2784.  
  2785.           BBS
  2786.  
  2787.                An electronic bulletin board system.  A method of
  2788.                communicating and sharing files with others by computer.
  2789.                Typically operated by hobbyists, free-of-charge.
  2790.  
  2791.           Carrier Detect
  2792.  
  2793.                A serial port line that is brought "high" (raised, given a
  2794.                "true" logical value) when carrier is present on the line,
  2795.                e.g., when the modem is connected to another modem.
  2796.  
  2797.                The modem raises and lowers this line.
  2798.  
  2799.           CD
  2800.  
  2801.                See "Carrier Detect."
  2802.  
  2803.           Compressed Mail
  2804.  
  2805.                Mail that has been compressed or "archived" with any one of
  2806.                several archiving utilities.  Such mail is also known as
  2807.                ARCmail, ZOOmail, PAKmail, etc., depending on which
  2808.                archiving utility was used to compress the mail.
  2809.  
  2810.           ConfMail
  2811.  
  2812.                The name of a mail processing program by Bob Hartman for use
  2813.                in the Opus or Fido environments, or any other environment
  2814.                that uses a compatible message base.
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820. User Guide - Page 47
  2821.  
  2822. BinkleyTerm ST 3.00 - User Guide
  2823.  
  2824.  
  2825.           Continuous Mail
  2826.  
  2827.                A capability of a particular system to accept mail at any
  2828.                time of day, as opposed to being required to accept it only
  2829.                during certain prescheduled times.
  2830.  
  2831.           D'Bridge
  2832.  
  2833.                A commercial FidoNet mailer written by Chris Irwin.
  2834.  
  2835.           Data Terminal Ready
  2836.  
  2837.                A serial port line that is brought "high" (raised, given a
  2838.                "true" logical value) when the local terminal is ready for
  2839.                communications.  A serial device (in our case a modem)
  2840.                connected to the serial port uses this line to detect
  2841.                whether the terminal (your PC and BinkleyTerm) are ready for
  2842.                communications activities.  Normally, bringing the line
  2843.                "low" (lowering, giving a "false" logical value) causes a
  2844.                modem to disconnect from the telephone line.
  2845.  
  2846.                BinkleyTerm raises and lowers this line.
  2847.  
  2848.           Domain
  2849.  
  2850.                A "layer" of addressing to allow use of alternative
  2851.                networks.
  2852.  
  2853.           DTR
  2854.  
  2855.                See "Data Terminal Ready."
  2856.  
  2857.           Dutchie
  2858.  
  2859.                A FidoNet mailer written by Henk Wevers.
  2860.  
  2861.           Dynamic Event
  2862.  
  2863.                A system event (see "Event") that stops when particular
  2864.                conditions (lack of mail of a certain type to be sent) are
  2865.                met.
  2866.  
  2867.           EchoMail
  2868.  
  2869.                A system devised by Jeff Rush for the automated sharing of
  2870.                message areas between systems, whereby messages are "echoed"
  2871.                from one system to another.  Also known as conferences or
  2872.                EchoMail conferences.
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880. User Guide - Page 48
  2881.  
  2882. BinkleyTerm ST 3.00 - User Guide
  2883.  
  2884.  
  2885.           EMSI
  2886.  
  2887.                A session handshake protocol developed by Johaquim
  2888.                Homrighausen and Chris Irwin.  Amongst its advantages
  2889.                are its ability to send mail for many alternative
  2890.                addresses (aka) in the same session, its machine
  2891.                independence and its expandability.
  2892.  
  2893.          Errorlevel
  2894.  
  2895.                The name of a DOS environment variable; contains a value
  2896.                returned by a program on exit that indicates a certain pre-
  2897.                defined condition.
  2898.  
  2899.           Event
  2900.  
  2901.                A system occurrence at a preconfigured time, day-of-the-
  2902.                week, and/or date.  Normally system limitations such as when
  2903.                to dial long distance are dependent on system events.
  2904.  
  2905.           Fido
  2906.  
  2907.                The original implementation of FidoNet and FidoNet protocol;
  2908.                a BBS software package.
  2909.  
  2910.           FidoNet
  2911.  
  2912.                The name of the original network that used FidoNet protocol,
  2913.                as designed by Tom Jennings.
  2914.  
  2915.           FidoNet Protocol
  2916.  
  2917.                A method of electronic mail transfer designed by Tom
  2918.                Jennings, as documented in the Fido Technical Standards
  2919.                Committee document FSC-0001.
  2920.  
  2921.           File Request
  2922.  
  2923.                The ability and associated methods of using extended FidoNet
  2924.                protocol to obtain a particular file automatically from one
  2925.                FidoNet system to another.
  2926.  
  2927.           FoReM
  2928.  
  2929.                An Atari ST Bulletin Board System created by Matt
  2930.                Singer.  Similar to ///Turbo-board.
  2931.  
  2932.           IOS
  2933.  
  2934.                Input/Output/Scan.  Mail processing software by Rinaldo
  2935.                Visscher.
  2936.  
  2937.  
  2938.  
  2939.  
  2940. User Guide - Page 49
  2941.  
  2942. BinkleyTerm ST 3.00 - User Guide
  2943.  
  2944.  
  2945.           FrontDoor
  2946.  
  2947.                A FidoNet mailer written by Joaquim Homrighausen.
  2948.  
  2949.           FSC001
  2950.  
  2951.                In BinkleyTerm, an abbreviation that indicates that a mail
  2952.                session corresponding to the FSC-0001 standard is in use.
  2953.                FSC-0001 is a standards document written by the FidoNet
  2954.                Technical Standards Committee.
  2955.  
  2956.           GroupMail
  2957.  
  2958.                A method of sharing message areas devised by System
  2959.                Enhancement Associates, Inc., similar to EchoMail, except
  2960.                that responsibility for obtaining mail is placed on the
  2961.                receiving system, not the sending system as with EchoMail.
  2962.                Based on usage of update requests.
  2963.  
  2964.           Hold Area
  2965.  
  2966.                See "Outbound Area."
  2967.  
  2968.           Inbound Area
  2969.  
  2970.                Also known as the "NetFiles" area, this is a special sub-
  2971.                directory set aside for the acceptance of incoming mail or
  2972.                files from other network systems.
  2973.  
  2974.           Janus
  2975.  
  2976.                A Bidirectional file transfer protocol developed for
  2977.                BinkleyTerm 2.40 by Bit Bucket Software, Co.
  2978.  
  2979.           Mail Packet
  2980.  
  2981.                A unit of mail as defined in the FidoNet Technical Standards
  2982.                Committee document FSC-0001.
  2983.  
  2984.           Mailer
  2985.  
  2986.                A program that acts as a FidoNet-compatible mail handler,
  2987.                using FidoNet protocol.  Normally, a mailer answers the
  2988.                phone, accepts and/or sends mail, and possibly passes human
  2989.                callers on to a BBS.
  2990.  
  2991.           Msged
  2992.  
  2993.                An Opus/Fido compatible message reader/editor by Jim Nutt.
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000. User Guide - Page 50
  3001.  
  3002. BinkleyTerm ST 3.00 - User Guide
  3003.  
  3004.  
  3005.           NeST
  3006.  
  3007.                An alternative FidoNet compatible Network for Atari ST
  3008.                based systems.  Contact Daron Brewood at
  3009.                2:250/123@fidonet.org for information.
  3010.  
  3011.           Net
  3012.  
  3013.                A subset of a FidoNet compatible network, usually a
  3014.                collection of nodes within a metropolitan area.
  3015.  
  3016.           NetFiles
  3017.  
  3018.                Files received from other systems in the network; also a
  3019.                special sub-directory set aside for the reception of such
  3020.                files.
  3021.  
  3022.           NetMail
  3023.  
  3024.                Person-to-person mail sent through the network.
  3025.  
  3026.           Network
  3027.  
  3028.                As it applies to BinkleyTerm, a collection of nodes that are
  3029.                FidoNet compatible, such as the FidoNet network itself, or
  3030.                others such as EggNet, AlterNet, RBBS-Net, etc.
  3031.  
  3032.                Also, a division of a full network.  See "Net" above.
  3033.  
  3034.           Node
  3035.  
  3036.                A FidoNet compatible system, represented by a node address,
  3037.                and listed in a nodelist.
  3038.  
  3039.           Nodelist
  3040.  
  3041.                A listing of FidoNet nodes.
  3042.  
  3043.           oMMM
  3044.  
  3045.                A packing program (packer) originally designed for Opus-
  3046.                CBCS, but now widely used with BinkleyTerm.
  3047.  
  3048.           Opus-CBCS
  3049.  
  3050.                "The Opus Computer Based Conversation System," a BBS
  3051.                designed by Wynn Wagner III.  Uses ".MSG" message base
  3052.                (compatible with Fido BBS program).  Contains built-in
  3053.                FidoNet compatible mailer.
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060. User Guide - Page 51
  3061.  
  3062. BinkleyTerm ST 3.00 - User Guide
  3063.  
  3064.  
  3065.           Outbound Area
  3066.  
  3067.                Also known as the "Hold Area," this is a special sub-
  3068.                directory set aside specifically for holding mail waiting to
  3069.                be sent to or picked-up by its destination.
  3070.  
  3071.           Packer
  3072.  
  3073.                A program that processes mail entered on a system, and
  3074.                prepares it for sending by the mailer.
  3075.  
  3076.           Packet
  3077.  
  3078.                Within FidoNet, a message unit conforming to FSC-0001
  3079.                specifications.
  3080.  
  3081.                With file transfer protocols, a block, or "piece" of the
  3082.                file transfer.  Normally a predetermined size in bytes.
  3083.  
  3084.           Point
  3085.  
  3086.                A point is an extension of a regular, fully qualified
  3087.                FidoNet node.  The term is derived from the node address
  3088.                format, 1:104/36.2 for example, where 1 is a zone, 104 a
  3089.                net, 36 a node, and 2 is the point.
  3090.  
  3091.                Primarily, Points are intended to provide an method of
  3092.                participating in EchoMail conferences in an off-line state.
  3093.                The conferences are packed and held for the Point system by
  3094.                the Boss, a system which carries the desired conference(s)
  3095.                and is willing to route them to the Point.  The Point system
  3096.                'polls' the Boss for the conferences, which are unpacked and
  3097.                read off-line on the Point system.  Responses are packed and
  3098.                sent to Boss in much the same manner as is done by regular
  3099.                FidoNet nodes.
  3100.  
  3101.                Generally, Points never interact with regular nodes, only
  3102.                with their Boss, since Point systems are not listed in the
  3103.                FidoNet nodelist.
  3104.  
  3105.           QuickBBS
  3106.  
  3107.                A BBS program designed by Adam Hudson, which uses
  3108.                configurable menuing and a database-style message base.
  3109.                Requires mail processing software designed specifically for
  3110.                its message format.  The Atari ST version is by Jon Webb.
  3111.  
  3112.           Region
  3113.  
  3114.                A subset of a FidoNet compatible network, a collection of
  3115.                nodes within a broad geographical area.  With regard to
  3116.                FidoNet addressing, a region is handled the same way as a
  3117.                network.  With regard to operational infrastructure, this is
  3118.                a higher level than a net.
  3119.  
  3120. User Guide - Page 52
  3121.  
  3122. BinkleyTerm ST 3.00 - User Guide
  3123.  
  3124.  
  3125.           Scan
  3126.  
  3127.                Usually associated with EchoMail processing, "scanning" is
  3128.                the process of taking new messages from a form usable by a
  3129.                BBS program or message editor and preparing them for sending
  3130.                via the network by placing them in standard packet and/or
  3131.                compressed mail format.
  3132.  
  3133.           SEAdog
  3134.  
  3135.                A commercial FidoNet mailer by System Enhancement
  3136.                Associates, Inc.
  3137.  
  3138.           SEAlink
  3139.  
  3140.                A variant of Xmodem, a robust file transfer protocol
  3141.                featuring sliding windows, good error trapping and extended
  3142.                file information.  Superior to Xmodem for use on difficult
  3143.                or satellite connected links.
  3144.  
  3145.           Sirius
  3146.  
  3147.                An Opus/Fido compatible message reader/editor by Bob Klahn.
  3148.  
  3149.           Sysop
  3150.  
  3151.                System operator; the person who operates a BBS, and/or the
  3152.                operator of a FidoNet node.
  3153.  
  3154.           TBBS
  3155.  
  3156.                A commercial BBS software package by eSoft, Inc.
  3157.  
  3158.           Telink
  3159.  
  3160.                An Xmodem variant, a file transfer protocol that is
  3161.                essentially Xmodem with a file information packet.
  3162.  
  3163.           Terminal Mode
  3164.  
  3165.                A BinkleyTerm mode within which the software may be used for
  3166.                manual, direct connections with remote modem-equipped
  3167.                computers.
  3168.  
  3169.           Toss
  3170.  
  3171.                Usually associated with EchoMail processing, "tossing" is
  3172.                the process of unpacking compressed mail into a form usable
  3173.                by a particular BBS program or message editor.
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180. User Guide - Page 53
  3181.  
  3182. BinkleyTerm ST 3.00 - User Guide
  3183.  
  3184.  
  3185.           TSYNC
  3186.  
  3187.                A signal sent to a FidoNet system from another FidoNet
  3188.                system attempting to pass mail traffic.  TSYNC is
  3189.                essentially a "handshake" between the sending and receiving
  3190.                systems to synchronize the mail session.
  3191.  
  3192.           ///Turbo-Board
  3193.  
  3194.                A BBS system created by Bill Miller, based on the FoReM
  3195.                Bulletin Board System.
  3196.  
  3197.           Unattended Mode
  3198.  
  3199.                A BinkleyTerm mode within which FidoNet electronic mail may
  3200.                be sent or received.
  3201.  
  3202.           Undialable
  3203.  
  3204.                A term for nodes which will no longer be called
  3205.                automatically by the system until manually reset.  The
  3206.                result of excessive unsuccessful connections with the remote
  3207.                system in an attempt to send mail.
  3208.  
  3209.           Unpacker
  3210.  
  3211.                A mail processing program that takes mail as received
  3212.                (compressed mail and/or packets) and places it into a form
  3213.                usable by a given type of BBS program or message editor.
  3214.  
  3215.           Update Request
  3216.  
  3217.                The ability and associated methods of requesting only a
  3218.                newer copy of a file located on one FidoNet system, if a
  3219.                newer copy exists, from another FidoNet system, using
  3220.                extended FidoNet protocol.
  3221.  
  3222.           WaZOO
  3223.  
  3224.                An open architecture method of electronic mail transfer
  3225.                designed by Wynn Wagner, and originally used with Opus-CBCS.
  3226.                Various protocols can be used under WaZOO, including ZedZap,
  3227.                a slightly modified Zmodem, and DietIFNA, a SEAlink method.
  3228.                See 'YooHoo.'
  3229.  
  3230.           Xmodem
  3231.  
  3232.                One of the first of its type, a file transfer protocol
  3233.                designed by Ward Christensen.  Although technologically
  3234.                behind other newer, more robust protocols, Xmodem is the
  3235.                most widely supported and implemented file transfer protocol
  3236.                in dial-up use.
  3237.  
  3238.  
  3239.  
  3240. User Guide - Page 54
  3241.  
  3242. BinkleyTerm ST 3.00 - User Guide
  3243.  
  3244.  
  3245.           YooHoo
  3246.  
  3247.                A method of mail transfer session negotiation which
  3248.                determines if the remote system is capable of handling
  3249.                WaZOO.  FidoNet systems that do not support WaZOO will
  3250.                simply disregard the YooHoo; systems capable of supporting
  3251.                it will answer affirmatively, and a WaZOO session will be
  3252.                initiated.  See 'WaZOO.'  YooHoo is defined in the Fido
  3253.                Technical Standards Committee document FSC-0005.
  3254.  
  3255.           Zmodem
  3256.  
  3257.                A robust streaming file transfer protocol featuring advanced
  3258.                error recovery techniques, variable packet sizing, good
  3259.                error detection and extended file information.  Extremely
  3260.                efficient, yet complex.  Highly effective with difficult
  3261.                connections.
  3262.  
  3263.           Zone
  3264.  
  3265.                A large geographical sub-division in the network, the
  3266.                highest level of the accepted FidoNet addressing scheme.
  3267.                Broad areas such as continents are given zone designations.
  3268.                Also used to specify a particular alternate network.
  3269.  
  3270.           ZOOmail
  3271.  
  3272.                Simply archived mail packets, processed with the ZOO
  3273.                utility.  Typically used to forward EchoMail messages due to
  3274.                the file compression inherent in the archiving process.
  3275.                Naming conventions correspond to a generally accepted
  3276.                method.  See 'Mail Packet.'
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300. User Guide - Page 55
  3301.