home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mail / jet114.zip / JETMAIL.DOC < prev    next >
Text File  |  1992-10-20  |  101KB  |  2,047 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.            ╔═══════════════════════════════════════════════╗
  7.            ║     ██ █████ ██████ ███  ███ ██████ ██ ██     ║
  8.            ║     ██ ██▄▄    ██   ██ ██ ██ ██  ██ ██ ██     ║
  9.            ║     ██ ██▀▀    ██   ██    ██ ██████ ██ ██     ║
  10.            ║ ██████ █████   ██   ██    ██ ██  ██ ██ ██████ ║
  11.            ║  .QWK-Compatible Mail Door for Spitfire 3.2   ║
  12.            ╚═══════════════════════════════════════════════╝
  13.  
  14.                JetMail version 1.14
  15.                Copyright (c) 1991,92 by DJ Chuang
  16.                All Rights Reserved
  17.  
  18.  
  19.  
  20.                        JETMAIL DOCUMENTATION TABLE OF CONTENTS
  21.  
  22.           COPYRIGHT & DISCLAIMER  . . . . . . . . . . . . . . . . . . .   2
  23.  
  24.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   2
  25.  
  26.           HOW DOES JETMAIL & 'QWK' WORK?  . . . . . . . . . . . . . . .   3
  27.  
  28.           SYNTAX  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  29.  
  30.           INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   5
  31.                File transfers . . . . . . . . . . . . . . . . . . . . .  11
  32.  
  33.           JETMAIL SYSTEM FILES  . . . . . . . . . . . . . . . . . . . .  18
  34.  
  35.           USING JETMAIL . . . . . . . . . . . . . . . . . . . . . . . .  18
  36.  
  37.           WHILE ONLINE  . . . . . . . . . . . . . . . . . . . . . . . .  20
  38.  
  39.           JETMAIL AUTO-PILOT  . . . . . . . . . . . . . . . . . . . . .  21
  40.  
  41.           LOCAL JETMAIL USE . . . . . . . . . . . . . . . . . . . . . .  22
  42.  
  43.           COMMAND-LINE USE OF JETMAIL . . . . . . . . . . . . . . . . .  22
  44.  
  45.           MULTI-NODE USE OF JETMAIL . . . . . . . . . . . . . . . . . .  23
  46.  
  47.           JETMAIL SYSTEM MANAGER  . . . . . . . . . . . . . . . . . . .  23
  48.  
  49.           JETMAIL AS A NETWORK HUB  . . . . . . . . . . . . . . . . . .  26
  50.  
  51.           REGISTRATION & SUPPORT  . . . . . . . . . . . . . . . . . . .  27
  52.  
  53.           AUTHOR NOTES & THANKS . . . . . . . . . . . . . . . . . . . .  28
  54.  
  55.           ACKNOWLEDGEMENTS  . . . . . . . . . . . . . . . . . . . . . .  29
  56.  
  57.           QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . .  30
  58.  
  59.           JETMAIL DOCUMENTATION INDEX . . . . . . . . . . . . . . . . .  33
  60.  
  61.  
  62.  
  63.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 1
  64.  
  65.  
  66.           COPYRIGHT & DISCLAIMER
  67.           ----------------------
  68.  
  69.           DJ Chuang shall not be liable to any users of JetMail for any
  70.           damages, including any lost profits, lost savings or other
  71.           incidental or consequential damages arising out of the use or
  72.           inability to use the program, or for any claim by any other
  73.           party. Total responsibility for use herein lies with the user.
  74.  
  75.           This JetMail software is being distributed as "shareware". You
  76.           may freely distribute this program to other sysops, and you are
  77.           encouraged to do so. You may try out JetMail for a trial period
  78.           of 30 (thirty) days. If you continue to use JetMail, fill out the
  79.           REGISTER.JET registration form and mail appropriate payment to
  80.           the author of this software. Registration will remove the extra
  81.           tagline that is attached at the end of each message posted via
  82.           JetMail.
  83.  
  84.           JetMail may not be distributed by software vendors without
  85.           expressed written consent of author.
  86.  
  87.  
  88.           INTRODUCTION
  89.           ------------
  90.  
  91.           JetMail is a DOOR (external program) designed for use with
  92.           SPITFIRE 3.2 BBS software, copyright by Mike Woltz (Buffalo Creek
  93.           Software). JetMail is a .QWK-compatible offline mail door, which
  94.           allows users to conveniently and efficiently read messages and
  95.           reply to messages offline. JetMail uses the .QWK format for mail
  96.           packet transfers. The .QWK format is a popular offline mail
  97.           format introduced by Mark Herring, author of QMail door for
  98.           PCBoard systems. Using this format, the user is able to use an
  99.           offline mail reader of his or her choice. There are many
  100.           different .QWK-format mail readers, each with certain unique
  101.           features to meet the needs of different users. Some .QWK offline
  102.           mail readers include:  EZ-Reader, Session Manager, Jabber, OLX,
  103.           Speed Read, KingQWK, Power-QWK, RoseReader, WinQWK, WinRead,
  104.           AmigaReader, and MegaMail Reader 2.10. NOTE:  MegaMail Reader
  105.           must be version 2.10 release, not a beta version!
  106.  
  107.           The use of offline mail doors will make it much easier for users
  108.           to participate in conferences, allow more users to login to your
  109.           BBS on a daily basis (because they won't tie up the board reading
  110.           messages), make message posting more efficient and fun (taglines
  111.           are a popular and humorous diversion), and assist the sysop to
  112.           keep up with message flow as well.
  113.  
  114.           This documentation is written using WordPerfect 5.1. The .DOC
  115.           file that is distributed with JetMail ZIP is a standard DOS text
  116.           file ready for printing. You may view this document using Vern
  117.           Buerg's LIST or something comparable.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 2
  126.  
  127.  
  128.  
  129.           HOW DOES JETMAIL & 'QWK' WORK?
  130.           ------------------------------
  131.  
  132.           I will now explain how an offline mail system works in the
  133.           JetMail .QWK environment. When you setup JetMail, you will assign
  134.           your BBS an ID code (up to 8 letters). We'll use SPITFIRE as your
  135.           ID code for this illustration. A user logs in to your BBS and
  136.           desires to read messages with her .QWK-format offline reader. She
  137.           finds out that you have JetMail and is elated!  She selects the
  138.           JetMail door from Spitfire, then once she is in JetMail, she uses
  139.           the JetMail Configuration command to select a transfer protocol
  140.           and other parameters for her reader. Then she uses the Select
  141.           Conferences command in JetMail to select conferences she wishes
  142.           to scan for messages.
  143.  
  144.           Then she selects the Download command from JetMail, which will
  145.           scan all her selected conferences for new messages. JetMail will
  146.           prepare a mail packet, which will be named SPITFIRE.QWK,
  147.           containing all the messages she has not read. (This packet
  148.           contains the messages and special pointers iaw [in accordance
  149.           with] the .QWK format.)  She logs off the BBS. Some other users
  150.           can now call your BBS while she reads messages from your BBS
  151.           using her offline mail reader.
  152.  
  153.           She will use her favorite offline mail reader and proceed to read
  154.           all the new messages from your BBS. She replies to a couple of
  155.           messages, in the end resulting a file named SPITFIRE.REP on her
  156.           computer. She calls your BBS, opens JetMail door, and selects the
  157.           Upload command. She uploads her SPITFIRE.REP, JetMail receives it
  158.           and processes the reply packet, posting her reply messages in the
  159.           corresponding conferences.
  160.  
  161.           That's a thumbnail sketch of JetMail in action. It's not much fun
  162.           reading about how all of this works--the fun comes when you get
  163.           to use JetMail and your preferred offline mail reader. Try out
  164.           JetMail, and tinker with the switches that are available, and
  165.           you'll quickly learn how everything works together.
  166.  
  167.           Since JetMail's release and warm reception in the Spitfire
  168.           community, many Sysops have had great ease in setting up JetMail
  169.           by following the instructions printed in this document. However,
  170.           some other Sysops have had some difficulties in setting up
  171.           JetMail to run correctly on their systems. Many problems have
  172.           resulted from not following the instructions, so please do take
  173.           the time to read this documentation in its entirety. Reading the
  174.           manual will insure a successful JetMail installation.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 3
  188.  
  189.  
  190.  
  191.           SYNTAX
  192.           ------
  193.  
  194.           Syntax:  JETMAIL door_sys_file [cnf_file] [PORT:a:x] [EVENT]
  195.  
  196.                     door_sys_file  is path and filename for Spitfire's
  197.                                    DOOR.SYS (required)
  198.                     [cnf_file]     is an optional parameter, which
  199.                                    specifies a JetMail configuration file.
  200.                                    The configuration file must have an
  201.                                    extension of .CNF (optional)
  202.                     PORT:a:x       specify this parameter for non-standard
  203.                                    COM ports, using "a" as the hexadecimal
  204.                                    port address and "x" as the port IRQ
  205.                                    interrupt number. e.g. PORT:03F8:4 for
  206.                                    COM1 (optional- this is NOT needed for
  207.                                    standard COM ports).
  208.                     EVENT          Specify this as the last parameter if
  209.                                    you'd like to run JetMail in its Auto-
  210.                                    pilot mode, which will allow JetMail to
  211.                                    run unattended during a system event so
  212.                                    you as the sysop can scan for new mail.
  213.  
  214.           Examples:  
  215.           JETMAIL \SF\DOOR.SYS
  216.                Open JetMail door using COM port specified in DOOR.SYS, and
  217.                JetMail configuration file named JETMAIL.CNF, which is the
  218.                default filename when no configuration file is specified.
  219.  
  220.           JETMAIL \SF\DOOR.SYS JETMAIL.CNF
  221.                Open JetMail door using COM port specified in DOOR.SYS, and
  222.                use JetMail configuration JETMAIL.CNF. (no different from
  223.                example above, except a longer command line)
  224.  
  225.           JETMAIL \SF\DOOR.SYS JETNODE1.CNF
  226.                Open JetMail door using COM port specified in DOOR.SYS, and
  227.                use JetMail configuration file named JETNODE1.CNF. The
  228.                configuration file contains parameters specifying how
  229.                JetMail operates. The contents of the configuration file are
  230.                explained in the JetMail installation section. 
  231.  
  232.           JETMAIL \SF\DOOR.SYS JETNODE2.CNF PORT:02E8:4
  233.                Open JetMail door using COM port at address 02E8 hex with
  234.                IRQ interrupt 4, and use JetMail configuration file named
  235.                JETNODE2.CNF.
  236.  
  237.           JETMAIL \JET\DOOR.SYS EVENT
  238.                Run JetMail in Auto-pilot mode, which is unattended. JetMail
  239.                will scan for new mail, and place the new .QWK in the
  240.                directory specified by the LOCALDIR= parameter in the .CNF
  241.                configuration. JetMail will also look for an .REP packet in
  242.                the LOCALDIR directory and post any new replies. You need to
  243.                manually (or in your system event batch file) delete the
  244.                .REP packet after it is processed.
  245.  
  246.  
  247.  
  248.  
  249.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 4
  250.  
  251.  
  252.  
  253.           INSTALLATION
  254.           ------------
  255.  
  256.           System Requirements: IBM compatible, running DOS 3.x or later,
  257.           running Spitfire 3.2 (JetMail 1.14 will run on Spitfire 3.3, but
  258.           it will not be able to support over 255 conferences), with at
  259.           least 230K memory free for JetMail, and some more for external
  260.           transfer protocol program and compression utilities.
  261.  
  262.           Introduction:  Spitfire 3.2 generates a DOOR.SYS upon opening a
  263.           door (external program). JetMail uses this file to locate
  264.           Spitfire files, user's name and time remaining, and basic
  265.           communication parameters. JetMail will automatically use Spitfire
  266.           system files for other system information. JetMail is designed to
  267.           work with as much Spitfire dependence as possible so that when
  268.           you make changes to the Spitfire system files, the changes will
  269.           automatically be used by JetMail so you don't have to run a
  270.           special JetMail companion utility program (which you might
  271.           legitimately forget to do if you're running a larger BBS system
  272.           with many doors or other setups). The only exception to this is
  273.           if you use a special short conference names list in CONFLIST.JET
  274.           (more details on this later).
  275.  
  276.           1.   Decide how you want to install JetMail. There are three
  277.                basic options:
  278.  
  279.            a. As a DOOR in the Doors Menu.
  280.            b. As an external command from the Message Section.
  281.  
  282.                What is the difference, you might ask?  Options B will let
  283.                the user enter JetMail more quickly by just using the one
  284.                key command from the Message Menu. However, Spitfire will
  285.                stay in memory, leaving less memory available for JetMail.
  286.                JetMail may be able to run in the memory remaining just
  287.                fine, but JetMail may run into memory problems, depending on
  288.                your computer configuration. Also, Option B will not display
  289.                any messages (like "Loading JetMail, Please Wait..") when
  290.                the user selects JetMail from a main menu, and it also
  291.                eliminates the need of the user to re-enter his password
  292.                when returning to Spitfire (this may or may not be desired;
  293.                JetMail does have carrier detect checking, and will properly
  294.                return to Spitfire should a user logoff abnormally.)
  295.  
  296.                Option A, setting up JetMail as a door from the Doors menu,
  297.                will allow Spitfire to be totally removed from memory during
  298.                JetMail operation. It makes available all possible memory
  299.                for JetMail use. JetMail itself doesn't use a lot of memory,
  300.                but it does shell out to compression utilities to build QWK
  301.                packets and to make file transfers, so depending on what
  302.                utilities you use in conjunction with JetMail, this will
  303.                affect the total memory usage. Running JetMail as a door
  304.                will alleviate your task of trying to figure out if there is
  305.                enough memory to run JetMail and the compression utilities
  306.                together. Option A will display a please-wait message when
  307.                the door is being executed, and it will ask the user to re-
  308.                enter password when control is returned to Spitfire.
  309.  
  310.  
  311.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 5
  312.  
  313.  
  314.                If you can't decide which setup option to use, the
  315.                recommended safer option is to setup JetMail under option A.
  316.                However, if you're comfortable and knowledgeable with DOS
  317.                and Spitfire environment as a sysop, you can install both of
  318.                the above options just as easily. Making JetMail available
  319.                from several places may serve as an added convenience for
  320.                your users, and it doesn't take up much extra space at all
  321.                (just an extra menu item, so all in all maybe 80 bytes).
  322.  
  323.  
  324.           2.   Place all JetMail files in a separate subdirectory (e.g.
  325.                D:\JETMAIL). We will call this directory the "home
  326.                directory" for JetMail. These files are must be placed in
  327.                the home directory for proper operation:
  328.  
  329.                JETMAIL.EXE
  330.                JETMAIL.CNF    (or multiple .CNF files for multi-node use)
  331.                JETTEXT.DAT    * do not modify this *
  332.                JETMAIL.ID     * do not modify this *
  333.                JETXFER.DAT
  334.                JETMENU.BBS
  335.                JETMENU.CLR
  336.                JETHELP.MAI
  337.                JETHELP.USR
  338.                JETHELP.SEL
  339.                NEWUSER
  340.  
  341.  
  342.           3.   Edit the JETMAIL.CNF to contain system information needed
  343.                for JetMail operation. JETMAIL.CNF is a simple ASCII text
  344.                file; use a good text editor to modify the sample .CNF file
  345.                that comes with this ZIP. Syntax for each line is the
  346.                parameter name (in CAPITAL letters) and the equal sign "="
  347.                (no space between parameter name and equal sign). One
  348.                parameter per line.
  349.  
  350.           The JETMAIL.CNF file must contain the first five parameters
  351.           listed here, and it may also contain a number of other optional
  352.           parameters:
  353.  
  354.           BBSNAME=  This is the name of your BBS. You can use up to 70
  355.                     characters. 
  356.                     Ex.: BBSNAME=Generic Computer BBS
  357.  
  358.           BBSCITY=  This is the city and state where your BBS is located.
  359.                     It doesn't matter if you spell out the state name or
  360.                     use a standard 2 letter abbreviation. You could include
  361.                     a country name too.
  362.                     Ex.: BBSCITY=Anytown, California
  363.  
  364.           BBSPHONE= This is the phone number for your BBS. Just list one
  365.                     phone number if you have more than one node. If you do
  366.                     have more than one node, it would probably be most
  367.                     excellent to use that node's phone number in the
  368.                     corresponding .CNF file. 
  369.                     Ex.: BBSPHONE=(714)785-9176
  370.  
  371.  
  372.  
  373.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 6
  374.  
  375.  
  376.           SYSOPNOM= This is your name as the sysop (system operator).
  377.                     Please do use both first and last name.
  378.                     Ex.: SYSOPNOM=Joe Sysop
  379.  
  380.           BBSID=    ID code of BBS (up to 8 capital letters) this will be
  381.                     used to name the mail packet, SPITFIRE.QWK and
  382.                     SPITFIRE.REP in this example. You can use an acronym
  383.                     based on your BBS name, or some related abbreviation.
  384.                     NOTE: If you are also running MegaMail door on your
  385.                     BBS, you may need to use a BBS ID for JetMail that is
  386.                     different from the BBS ID of the MegaMail door, which
  387.                     is needed to distinguish between MegaMail Reader 2.10's
  388.                     QWK/REP or UL/DL modes.
  389.                     Ex.: BBSID=SPITFIRE
  390.  
  391.           THE ABOVE FIVE PARAMETERS MUST BE DEFINED IN THE .CNF FILE. 
  392.           The following parameters are optional.
  393.  
  394.           SPEED=    This parameter is needed by JetMail, depending on how
  395.                     you have Spitfire setup to communicate with the modem.
  396.                     By DEFAULT, JetMail will use SPEED=ACTUAL, which passes
  397.                     the user's actual connect speed as %B% to the JetMail
  398.                     file transfer command line (specified in JETXFER.DAT)
  399.                     during JetMail file transfers. In the ALT+M Modem
  400.                     configuration for Spitfire option <H> is for hardware
  401.                     data flow control. If this is set to YES, you will want
  402.                     to use SPEED=DTE. If this is set to NO, you will want
  403.                     to use SPEED=ACTUAL. 
  404.  
  405.                     Allowable values:
  406.                          DTE    -- Use the 'locked' port speed connection.
  407.                          ACTUAL -- Use caller's actual baud rate connection
  408.                                    speed.
  409.  
  410.           WELCOME=  Specify path and filename to welcome screen. Path is
  411.                     needed, and .BBS extension is changed to .CLR if user
  412.                     is in ANSI graphics mode, automatically. If .CLR file
  413.                     doesn't exist while user is in color graphic mode,
  414.                     JetMail will revert to the .BBS file.
  415.                     Ex.: WELCOME=D:\SF\DISPLAY\WELCOME1.BBS
  416.  
  417.           NEWS=     Specify path and filename to latest system news. This
  418.                     could be your newsletter, if you use the newsletter
  419.                     feature to tell your users the latest happening, or it
  420.                     could be one of the other opening files. Only the .BBS
  421.                     version is packed in the .QWK.
  422.                     Ex.: NEWS=D:\SF\DISPLAY\SFNWSLTR.BBS
  423.  
  424.           GOODBYE=  Specify path and filename to goodbye/logoff screen. The
  425.                     .BBS extension is changed to .CLR if user is in ANSI
  426.                     graphics mode, automatically.
  427.                     Ex.: GOODBYE=D:\SF\DISPLAY\GOODBYE.BBS
  428.  
  429.           ADDNEWS=  This is a flag indicating whether to include the 'news'
  430.                     file (specified by the NEWS= parameter) is put in every
  431.                     .QWK packet, or just when the 'news' file has been
  432.                     changed since the last QWK transfer. The default value,
  433.  
  434.  
  435.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 7
  436.  
  437.  
  438.                     when unspecified, is NEW.
  439.  
  440.                     Allowable values:
  441.                          ALWAYS  -- always include 'news' file in .QWK
  442.                          NEW     -- include 'news' file only when updated.
  443.  
  444.                     Ex.: ADDNEWS=NEW 
  445.  
  446.           WORKDIR=  Specify drive and path to work directory. JetMail will
  447.                     run faster if you can specify a directory on a RAM
  448.                     drive, provided there is sufficient room on the RAM
  449.                     drive to build a .QWK packet. If the work directory
  450.                     doesn't exist, JetMail will make the directory when
  451.                     JetMail is started. This work directory MUST NOT BE
  452.                     SHARED with any other program, and definitely NOT
  453.                     another JetMail node (each node .CNF must have a
  454.                     different WORKDIR specified); This directory must be an
  455.                     empty directory with sufficient disk space to build
  456.                     .QWK packets (which could be up to 1 megabyte in size,
  457.                     or even more). If this parameter is not specified,
  458.                     JetMail will make its own temporary work directory in
  459.                     the JetMail home directory.
  460.                     Ex.: WORKDIR=F:\TMP\
  461.  
  462.           LOCALDIR= Specify a default drive and path for placing mail
  463.                     packets (both .QWK and .REP's). When you use JetMail in
  464.                     Auto-Pilot mode (explained later), JetMail will place
  465.                     .QWK's in this directory. When using JetMail locally,
  466.                     either through Spitfire local login, or via command
  467.                     line, JetMail will not transfer the file remotely, and
  468.                     prompt you for a directory to put .QWK's. This
  469.                     parameter specifies the default directory during local
  470.                     use, or you can always manually type in a different
  471.                     directory. If this parameter is not specified, JetMail
  472.                     defaults to C:\ .
  473.                     Ex.: LOCALDIR=C:\QWK\
  474.  
  475.           FORCED=   A list of conference that must be included for all
  476.                     users' message scan. The user has the option of
  477.                     scanning for all new messages, or the "YA" scan (which
  478.                     scans new messages addressed to the user and to "All
  479.                     Users"). The list comprises of conference numbers,
  480.                     separated by commas. Example forces conferences
  481.                     numbered 1, 3, and 5.
  482.                     Ex.: FORCED=1,3,5
  483.  
  484.           DEFAULT=  Specify a list of conferences as default configuration;
  485.                     so the user doesn't start with a blank conference
  486.                     queue. These may be conferences that you recommend
  487.                     users to scan for messages, but don't want to force it
  488.                     on the users. Forced conferences (specified in FORCED=)
  489.                     will automatically be placed in the users' "default"
  490.                     queue (you don't need to specify forced conferences in
  491.                     this recommended queue list).
  492.                     Ex.: DEFAULT=2,4
  493.  
  494.           LOG=      This allows you to record user activities in JetMail to
  495.  
  496.  
  497.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 8
  498.  
  499.  
  500.                     a different log file. JetMail by default will log
  501.                     JetMail user activity to the Spitfire CALLERS.TMP.
  502.                     Spitfire itself automatically combines the CALLERS.TMP
  503.                     file into the CALLERS.LOG file, so you can view all
  504.                     activities on your BBS in one log file. However, if you
  505.                     would like to have JetMail log activity into a
  506.                     different log file, specify the path and filename here.
  507.                     The path must already exist when using a separate
  508.                     JetMail usage log. Be sure to specify unique log file
  509.                     names for each node, if you're running JetMail in a
  510.                     multi-node environment.
  511.                     Ex.: LOG=D:\JETMAIL\NODE1.LOG
  512.  
  513.           DONTPOST= This is a parameter to determine how JetMail will
  514.                     respond in situations when a user tries to post
  515.                     messages in conferences to which he has no access,
  516.                     invalid conference numbers, or private messages in
  517.                     conferences where only public messages are allowed. By
  518.                     default (or DONTPOST=NO), JetMail will post 'invalid'
  519.                     messages in Conference 1. An invalid message is a
  520.                     message in an uploaded .REP packet which is flagged as
  521.                     a private message, but attempts to be posted in a SF
  522.                     Public_Only Conference; OR, it is a message posted to
  523.                     an invalid conference number (trying to post a message
  524.                     in conference 20 when there are only 12 conferences).
  525.                     In both instances, JetMail will post the suspect
  526.                     message in Conference 1. If this parameter is set to
  527.                     YES, then in both instances, any 'invalid' messages
  528.                     will be skipped and NOT posted anywhere (in other
  529.                     words, discarded). There are no parameter settings
  530.                     which will cause JetMail to allow private message posts
  531.                     in a Public_Only conference (a SF conference that only
  532.                     allows public messages).
  533.                     Ex.: DONTPOST=NO
  534.  
  535.           NOBYE=    Set this to YES to disable the Goodbye command from
  536.                     JetMail, so that users cannot logoff from JetMail and
  537.                     will need to return to Spitfire to logoff. By default,
  538.                     NOBYE=NO, which allows users to logoff from JetMail.
  539.                     You will need to manually edit the JetMail menu text if
  540.                     you set NOBYE=YES. If a user tries to enter 'G' when
  541.                     NOBYE=YES, then the user will be returned to Spitfire.
  542.                     Ex.: NOBYE=YES
  543.  
  544.           SWAP=     JetMail is now able to swap out of memory when JetMail
  545.                     is packing a .QWK packet, unpacking an .REP packet, or
  546.                     when doing file transfer. This parameter needs to be
  547.                     specified, with a directory path to where JetMail will
  548.                     place its memory swap file. DO NOT USE the JetMail work
  549.                     directory (WORKDIR)!
  550.  
  551.                     If this parameter is NOT specified, JetMail will remain
  552.                     in memory when calling compression utilities and
  553.                     transfer programs. This may result 'transfer error' or
  554.                     'unable to compress packet', especially if JetMail is
  555.                     run as a message menu extension, in which case JetMail
  556.                     remains in memory as well as Spitfire, which doesn't
  557.  
  558.  
  559.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire         Page 9
  560.  
  561.  
  562.                     leave much memory left to shell out to do anything
  563.                     else. Another option that is available if you don't
  564.                     want to use the SWAP= parameter in JetMail is to use an
  565.                     utility called SHROOM, which can swap Spitfire to disk
  566.                     prior to running JetMail.
  567.  
  568.                     When this parameter specifies a valid path, JetMail
  569.                     will first try to swap to EMS memory, and then swap to
  570.                     the specified swap path if there is not enough EMS
  571.                     memory (or if there isn't EMS memory to swap to). Now
  572.                     JetMail should be able to run in considerably smaller
  573.                     memory situations, such as a Spitfire message menu
  574.                     extension.
  575.                     Ex.: SWAP=F:\SWAP
  576.  
  577.           AFTER=    This parameter may be used to specify a command line
  578.                     for JetMail to run after it receives an .REP packet.
  579.                     This may be used to run a duplicate-message checker
  580.                     such as KILLQDUP. Be sure to specify the .EXE extension
  581.                     if running an .EXE file; this command line cannot run
  582.                     batch files.
  583.                     Ex.: AFTER=KILLQ.EXE F:\TMP\SPITFIRE.MSG 
  584.  
  585.           PRIORITY= This is a switch that some sysops requested for
  586.                     JetMail. Usually, if you specify a conference's access
  587.                     to be exclusively level 10 users (security level equal
  588.                     to 10 only), then even sysops cannot access that
  589.                     conference. However, some sysops feel that they as
  590.                     sysops should have access to 'exclusive' conferences.
  591.                     An example might be that you have user levels 10, 20,
  592.                     and 30, and sysop level at 100. You want to setup
  593.                     conference 5 for level 20 users only, and exclude 10's
  594.                     and 30's, but not sysop(s). (If you setup the
  595.                     conference access to be security level "equal to or
  596.                     greater than", then both 20's and 30's gets access to
  597.                     the conference, which is undesired). Set PRIORITY=YES
  598.                     to allow sysops to access 'exclusive' conferences
  599.                     through JetMail. Default is PRIORITY=NO.
  600.                     Ex.: PRIORITY=YES
  601.  
  602.           DUPCHECK= JetMail now has a very simple dupe checker built-in. It
  603.                     checks the header of the .REP packet transferred, and
  604.                     records a checksum value for the .REP packet. On the
  605.                     next .REP upload by the same caller, if the checksum
  606.                     values match, that means the caller uploaded the exact
  607.                     same .REP packet twice! This second .REP packet will be
  608.                     automatically rejected when DUPCHECK=YES (default).
  609.                     However, some compression utilities may not generate
  610.                     unique .REP headers, so you may need to turn off
  611.                     JetMail's internal duplicate packet checking. To turn
  612.                     off dupe checking, specify DUPCHECK=NO.
  613.  
  614.           HANGUP=   JetMail usually logs off the caller by lowering the DTR
  615.                     signal on your modem. However, some non-standard modems
  616.                     do not respond this way. You can specify a modem
  617.                     command string here to hang up on your caller, e.g.
  618.                     HANGUP=ATH
  619.  
  620.  
  621.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 10
  622.  
  623.  
  624.           RUNSHARE= For multi-node systems, it is recommended that you load
  625.                     SHARE.EXE in memory. JetMail has two separate internal
  626.                     routines, one that is not SHARE sensitive, and the
  627.                     other one is SHARE sensitive. The SHARE sensitive code
  628.                     will use a standard record locking mechanism. To
  629.                     activate JetMail's code that is SHARE sensitive,
  630.                     specify RUNSHARE=YES. JetMail defaults to RUNSHARE=NO.
  631.  
  632.           XFERDATA= JetMail defaults to XFERDATA=JETXFER.DAT , a text file
  633.                     specifying transfer protocols and corresponding command
  634.                     lines. For multi-node systems, you may need to specify
  635.                     more information for your JetMail file transfer command
  636.                     lines than JetMail provides thru its macros. You may
  637.                     not specify a path with this parameter, this parameter
  638.                     can only specify a file name, and the file must be
  639.                     located in the JetMail home directory.
  640.                     Ex.: XFERDATA=JETXFER1.DAT
  641.  
  642.                If no compression utilities are explicitly specified in the
  643.                JetMail configuration file, JetMail will automatically use
  644.                PKZIP/PKUNZIP to process QWK and REP packets. The following
  645.                parameters are available if you use a non-standard PKZIP.EXE
  646.                filename, or want to use some fancy parameters. JetMail can
  647.                support up to 3 (three) compression utilities, so up to 3
  648.                (three) sets of PACK parameters may be specified. These
  649.                utilities MUST be in the DOS path, or you could explicitly
  650.                specify the path to the compression utility here.
  651.  
  652.           PACK1=    Specify the commonly used extension name for the first
  653.                     compression utility. It may be possible to use more
  654.                     than three letters, but that is an untested feature.
  655.                     Ex.: PACK1=ZIP
  656.  
  657.           PACK1QWK= Specify the command to compress files into a .QWK
  658.                     packet. Use the Add files command of your compression
  659.                     utility.
  660.                     Ex.: PACK1QWK=PKZIP -A
  661.                       or PACK1QWK=C:\UTIL\PKZIP.EXE -A
  662.  
  663.           PACK1REP= Specify the command to uncompress a REP packet. Use the
  664.                     extract command of your compression utility with the
  665.                     overwrite flag set (if possible) for best results.
  666.                     Ex.: PACK1REP=PKUNZIP -O
  667.  
  668.           PACK2=    Specify name for a second compression utility.
  669.                     Corresponding pack/unpack parameters: 
  670.                     PACK2QWK=
  671.                     PACK2REP=
  672.  
  673.           PACK3=    Specify name for a third compression utility.
  674.                     Corresponding pack/unpack parameters: 
  675.                     PACK3QWK=
  676.                     PACK3REP=
  677.  
  678.  
  679.           4.   File transfers in JetMail, uploading REP's and downloading
  680.                QWK's, is facilitated by the use of command lines specified
  681.  
  682.  
  683.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 11
  684.  
  685.  
  686.                in JETXFER.DAT. This is new since JetMail version 1.10, to
  687.                replace the antiquated and often confusing transfer batch
  688.                files in prior JetMail versions.
  689.  
  690.                JETXFER.DAT is a simple text file, placed in your JetMail
  691.                home directory. The format for this .DAT file consists of
  692.                three lines for each transfer protocol:
  693.  
  694.                     <L> Name_of_Protocol
  695.                     Command_line_for_SEND_QWK_packet
  696.                     Command_line_for_RECEIVE_REP_packet
  697.  
  698.                You may add more protocols to JetMail by enter more three-
  699.                line entries for each protocol. Place the letter of the
  700.                protocol between the brackets < >, and follow the example
  701.                JETXFER.DAT included with the JetMail distribution .ZIP .
  702.                The letter used for the protocol can be any capital letter
  703.                from A to Z, or any number from 1 to 9. So this means that
  704.                you could install 35 transfer protocols in JetMail if
  705.                desired.
  706.  
  707.                The first item in the JETXFER.DAT file transfer command line
  708.                is the name of the .EXE or .COM transfer protocol engine
  709.                executable that needs to be run. Then follow it with
  710.                parameters that the transfer protocol needs.
  711.  
  712.                Any of four macro-parameters may be specified on the
  713.                JETXFER.DAT file transfer command line, as needed. These
  714.                macro-parameters will be substituted with the corresponding
  715.                values when JetMail calls the command line to make a file
  716.                transfer:
  717.                          %B%  baud rate
  718.                          %F%  filename to transfer
  719.                          %P%  port number
  720.                          %D%  directory path to JetMail work directory
  721.  
  722.                When JetMail is ready to transfer a file (either to send a
  723.                .QWK packet, or to receive an .REP packet), JetMail will
  724.                replace the above macros specified on the command line with
  725.                the corresponding information. Note that the %B% macro is
  726.                replaced with the baud rate of either the locked port rate
  727.                (if JetMail's .CNF configuration has SPEED=DTE), or the
  728.                caller's actual baud rate (SPEED=ACTUAL).
  729.  
  730.                After calling the transfer protocol engine, JetMail will
  731.                check the error level returned by the transfer program, and
  732.                act accordingly. JetMail expects the transfer program to
  733.                return with exit code 0 upon successful transfer, and exit
  734.                code 1 (or greater) upon unsuccessful transfer (be it lost
  735.                carrier or aborted transfer).
  736.  
  737.                Here's a sample JETXFER.DAT file:
  738.  
  739.                <Z> Zmodem (MobyTurbo)
  740.                DSZ.COM port %P% sz %F%
  741.                DSZ.COM port %P% rz %F%
  742.                <1> Xmodem-1K
  743.  
  744.  
  745.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 12
  746.  
  747.  
  748.                dsz.com port %P% sx -k %F%
  749.                dsz.com port %P% rc %F%
  750.                <G> Ymodem-G (MNP only)
  751.                dsz.com port %P% sb -g %F%
  752.                dsz.com port %P% rb -g %F%
  753.                <C> Xmodem/CRC
  754.                dsz.com port %P% sx %F%
  755.                dsz.com port %P% rc %F%
  756.                <H> HS/Link (bi-directional)
  757.                HSLINK.EXE -E%B% -p%P% -A -u%D% -R -K %F%
  758.                HSLINK.EXE -E%B% -p%P% -A -u%D% -R -K
  759.  
  760.                Suppose a 2400 baud caller is connected to your BBS, and
  761.                selects the HS/Link protocol in his JetMail user
  762.                configuration. After he scans for new mail (using the "D"
  763.                download command), and JetMail is ready to transfer the .QWK
  764.                packet to the user, JetMail will call up the following
  765.                command line (notice the macros values being appropriately
  766.                replaced):
  767.  
  768.                HSLINK.EXE -E2400 -p1 -A -uF:\TMP\ -R -K F:\TMP\SPITFIRE.QWK
  769.  
  770.                (comment: macros were replaced with corresponding .CNF
  771.                values of WORKDIR=F:\TMP, BBSID=SPITFIRE, SPEED=ACTUAL, and
  772.                COM1)
  773.  
  774.                THIS IS VERY IMPORTANT! When adding new transfer protocols
  775.                to JetMail, be sure to specify the .COM or .EXE extension
  776.                for the transfer program, and make sure that transfer
  777.                program is in the DOS path (or specify the entire path to
  778.                the transfer program in the command line, for example,
  779.                C:\COMM\DSZ.COM . . . ) Also be sure to specify the
  780.                protocol's letter, description, and 2 separate command lines
  781.                specifying both send and receive commands.
  782.  
  783.                HS/Link transfers may be bi-directional, and JetMail takes
  784.                full advantage of this. The JetMail user needs to select the
  785.                "D" (Download) command, and while he is downloading
  786.                (receiving) a .QWK packet, he can be uploading (sending) his
  787.                .REP replies packet. After the .QWK transfer, JetMail will
  788.                check the work directory for any .REP's received, and
  789.                process it accordingly.
  790.  
  791.  
  792.           5.   Tell Spitfire you have the door installed. This will differ
  793.                based on the option you've selected. More than one option is
  794.                allowed (if you want to make available JetMail at every menu
  795.                possible, for instance, to encourage its use).
  796.  
  797.  
  798.           ***** Option A: (door menu) *****
  799.  
  800.           A1.  Edit SFDOOR.MNU in your main SF directory. Insert a line
  801.                with the name of the door being "JetMail" (no quotes), and a
  802.                minimum security level you will allow users to access
  803.                JetMail. Remember that the SFDOOR.MNU uses the line number
  804.                of the text to indicate the letter of the door, so for this
  805.  
  806.  
  807.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 13
  808.  
  809.  
  810.                example we'll say that JetMail will go on line 2 (door "B").
  811.                So the text line should look something like:
  812.  
  813.                     JetMail,10
  814.  
  815.                You may want to be a little more elaborate on the door's
  816.                name for this menu to let your user know that JetMail is
  817.                QWK-Compatible. Announcing the arrival of JetMail in your
  818.                newsletter would also be a good way to let your users know
  819.                of this new door. Refer to the section entitled "SPITFIRE
  820.                DOORS" in the Spitfire documentation if you need more
  821.                details.
  822.  
  823.           A2.  Edit your SF.BAT to contain something like:
  824.  
  825.                :door_b
  826.                   rem Place Door B Commands Here
  827.                   D:
  828.                   CD \JETMAIL
  829.                   JETMAIL D:\SF\DOOR.SYS
  830.                   goto loop
  831.  
  832.                I've left the surrounding SF.BAT lines (in lowercase) in to
  833.                show you how the insertion would look. Be sure you give the
  834.                correct path name to the DOOR.SYS file, which will be
  835.                located in your main SF directory. (watch out for drive
  836.                letters if you're running multiple drive partitions!)
  837.  
  838.           A3. That should be it for Option A. Try a local login, and watch
  839.               JetMail appear in your door menu.
  840.  
  841.  
  842.           ***** Option B: (Message Menu command) *****
  843.  
  844.           B1.  Edit SFMSG.MNU in your main SF directory. Modify the line
  845.                with the Command Identifier "@" (the last parameter on each
  846.                line). Change the Command Character (the first parameter)
  847.                line to the letter "J" (for JetMail), modify the command
  848.                description, set a minimum security level you will allow
  849.                users to access JetMail, and leave the "@" sign. So the text
  850.                line should look something like:
  851.  
  852.                     J,<J>..... JetMail QWK Mail,,10,@
  853.  
  854.                [An unaltered menu usually has the "@" Command Identifier
  855.                attached to the "K" Command Character.]  Remember that the
  856.                SFMSG.MNU only allows one "@" Command Identifier to be a
  857.                sysop-configured command. Don't confuse the Command
  858.                Character and Command Identifier.
  859.  
  860.           B2. Edit SFMESS.BAT (in your main Spitfire directory) to: 
  861.  
  862.                D:
  863.                CD \JETMAIL
  864.                JETMAIL D:\SF\DOOR.SYS
  865.  
  866.                Be sure you give the correct path name to the DOOR.SYS file,
  867.  
  868.  
  869.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 14
  870.  
  871.  
  872.                which will be located in your main SF directory. (watch out
  873.                for drive letters if you're running multiple drive
  874.                partitions!)
  875.  
  876.           B3.  That should be it for Option B. Try a local login, and watch
  877.                JetMail appear in your message menu. If you are using
  878.                MSG<x>.BBS/.CLR, don't forget to modify those screens to
  879.                show JetMail as a new external command!
  880.  
  881.  
  882.           6.   It is highly recommended that you make a file that has
  883.                shorter names for the Spitfire message conferences. Although
  884.                Spitfire allows for conference descriptions up to 40
  885.                characters, the QWK format require conference descriptions
  886.                to be no more than 12 characters. HOWEVER, after testing
  887.                several offline readers, it is best to use conference names
  888.                that are 10 characters or less. In other words, some mail
  889.                readers can handle long conference names, but some cannot.
  890.  
  891.                NOTE: By default, JetMail will use the Spitfire conference
  892.                descriptions. During the message scan, you would only see
  893.                the first twelve characters of a conference name, but in the
  894.                CONTROL.DAT generated in the .QWK packet, the full
  895.                conference name would be used.
  896.  
  897.                JetMail will look for a text file named CONFLIST.JET in the
  898.                JetMail home directory. If this file exists, JetMail will
  899.                use the conference names listed in this text file instead of
  900.                the actual Spitfire conference descriptions. This text file
  901.                is just a simple ASCII file, with one conference description
  902.                per line. The line number of each line of text is a
  903.                conference name corresponding to the conference number.
  904.  
  905.                A utility named MAKECONF.EXE comes with the JetMail
  906.                distribution ZIP file to assist you in building the
  907.                CONFLIST.JET file. The syntax for MAKECONF is:
  908.  
  909.                  MAKECONF conf_dat [-][word_number] [length]
  910.  
  911.                   conf_dat    path and name of SFMCONF.DAT,
  912.  
  913.                   word_number specifies the Nth word to use as short name.
  914.                               If word_number is negative, only one word for
  915.                               short name. If word_number is positive,
  916.                               spaces replaced with underscores.
  917.  
  918.                   length      specifies maximum length of conference names.
  919.  
  920.                Example:  
  921.                Spitfire conference names:
  922.                     1 - General Conference
  923.                     2 - Programmers Forum
  924.                     3 - Chit Chat and Small Talk
  925.                     4 - (RIME) Bible Studies
  926.                     5 - (RIME) Common
  927.                     6 - Intelec Net Central
  928.  
  929.  
  930.  
  931.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 15
  932.  
  933.  
  934.                The following examples illustrate how MAKECONF works, if the
  935.                above are the Spitfire conferences' descriptions.
  936.  
  937.                MAKECONF \SF\SFMCONF.DAT      General_Conference
  938.                                              Programmers_Forum
  939.                                              Chit_Chat_and_Small_Talk
  940.                                              (RIME)_Bible_Studies
  941.                                              (RIME)_Common
  942.                                              Intelec_Net_Central
  943.  
  944.                MAKECONF \SF\SFMCONF.DAT 2    Conference
  945.                                              Forum
  946.                                              Chat_and_Small_Talk
  947.                                              Bible_Studies
  948.                                              Common
  949.                                              Net_Central
  950.  
  951.                MAKECONF \SF\SFMCONF.DAT 1 10  General_Co
  952.                                               Programmer
  953.                                               Chit_Chat_
  954.                                               (RIME)_Bib
  955.                                               (RIME)_Com
  956.                                               Intelec_Ne
  957.  
  958.                MAKECONF \SF\SFMCONF.DAT -1   General
  959.                                              Programmers
  960.                                              Chit
  961.                                              (RIME)
  962.                                              (RIME)
  963.                                              Intelec
  964.  
  965.                MAKECONF.EXE will read the Spitfire conference system
  966.                information SFMCONF.DAT and generate a preliminary
  967.                CONFLIST.JET containing your conference descriptions.
  968.                Selecting an appropriate second parameter (the 'word'
  969.                number) when using MAKECONF will help you build a
  970.                CONFLIST.JET that will require less editing.
  971.  
  972.                After you use MAKECONF, you need to edit this preliminary
  973.                CONFLIST.JET and adjust all the conference names to be 10
  974.                characters or less. Perhaps it is difficult to describe
  975.                conferences in just 10 characters, but do the best you can.
  976.                You may want to use acronyms or abbreviations.
  977.  
  978.  
  979.           7.   Make sure DSZ.COM (or DSZ.EXE), PKZIP.EXE, PKUNZIP.EXE are
  980.                in the DOS path. (for example, at the DOS prompt, in the
  981.                JetMail directory, you should be able to type PKZIP and get
  982.                the PKZIP help menu)  Likewise, other transfer protocol
  983.                programs and compression utilities need to be accessible via
  984.                the DOS path (or explicitly specified in JetMail's
  985.                configurations accordingly), if you choose to support them.
  986.  
  987.                This concludes the installation of JetMail. Refer to the
  988.                questions and answers section of this documentation if you
  989.                have other questions. If you have other difficulty in
  990.                running JetMail after you've followed these installation
  991.  
  992.  
  993.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 16
  994.  
  995.  
  996.                instructions carefully, refer to the Q&A section for common
  997.                diagnosis of common symptoms. If that doesn't resolve the
  998.                complications, please contact the author for technical
  999.                support.
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 17
  1056.  
  1057.  
  1058.  
  1059.           JETMAIL SYSTEM FILES
  1060.           --------------------
  1061.  
  1062.           JetMail has several other features. When JetMail is first opened,
  1063.           it will display an ascii text file JETNEWS (notice, no DOS file
  1064.           extension), if it exists in the JetMail home directory. This text
  1065.           file is displayed every time the JetMail door is opened. If
  1066.           JETNEWS does not exist, JetMail will simply go through its
  1067.           initialization routine and go to the JetMail Command prompt.
  1068.  
  1069.           If a new user opens JetMail for the first time, JetMail displays
  1070.           the ascii text file NEWUSER, if it exists in the JetMail home
  1071.           directory. In this text file, you can introduce your users to
  1072.           JetMail door. You may want to tell them how they can download a
  1073.           QWK mail reader, if they don't already have one, and tell them to
  1074.           download the JetMail User's Guide which you can make available to
  1075.           them as a separate file. This text file will also notify the new
  1076.           JetMail user of the default conferences (ones that you've set up
  1077.           in DEFAULT=) configured automatically for them by JetMail.
  1078.  
  1079.           There is help files for three sections of JetMail:  at the main
  1080.           JetMail Command prompt, at the Configuration Setup prompt, and at
  1081.           the Select Conference prompt. The help file is displayed when a
  1082.           question mark (?) is entered. The three files are simple ascii
  1083.           text files located in the JetMail home directory, files are
  1084.           named, respectively, JETHELP.MAI, JETHELP.USR, and JETHELP.SEL.
  1085.           These may be edited if you wish to give more details on certain
  1086.           commands.
  1087.  
  1088.           The JetMail main menu, JETMENU.BBS and JETMENU.CLR may be edited.
  1089.           Don't leave out any commands!  JETMENU.CLR is the ANSI/graphics
  1090.           version, and JETMENU.BBS is the ascii/non-graphics version, same
  1091.           as Spitfire's designation.
  1092.  
  1093.           JETMAIL.ID is a file distributed with JetMail which will be
  1094.           included as the DOOR.ID in the .QWK packets downloaded from
  1095.           JetMail. Some readers will be able to use this file for offline
  1096.           configuration messages.
  1097.  
  1098.  
  1099.           USING JETMAIL
  1100.           -------------
  1101.  
  1102.           JetMail is very easy to use. If you are familiar with using .QWK-
  1103.           compatible doors on PCBoard systems, JetMail should be quite
  1104.           familiar to you. Some Spitfire-specific particulars will be
  1105.           explained here. For a more detailed guide on using JetMail as a
  1106.           user, refer to the JetMail User's Guide.
  1107.  
  1108.           Spitfire's BBS file structures are different than PCBoard's. This
  1109.           comes into play when building a .QWK-format mail packet, which
  1110.           was designed for best fit with PCBoard. PCBoard has only one
  1111.           welcome screen (ascii or color), one NEWS screen (the file
  1112.           displayed after password entry on PCBoard and before Mail scan),
  1113.           and one goodbye screen. Spitfire allows multiple files to be
  1114.           displayed to the user after password entry. The Spitfire sysop
  1115.  
  1116.  
  1117.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 18
  1118.  
  1119.  
  1120.           will need to decide which of these files gets packed into the
  1121.           .QWK packet for the user to keep up with the latest happenings on
  1122.           the BBS. For most Spitfire BBSes, you would want to send your
  1123.           opening screen with your BBS name and information, entering the
  1124.           following line in your JetMail .CNF file:  
  1125.  
  1126.                WELCOME=D:\SF\DISPLAY\WELCOME1.BBS 
  1127.  
  1128.           The purpose of a PCBoard NEWS file is to let the user know what
  1129.           is happening with the BBS daily or periodically; I don't know of
  1130.           the exact equivalent for Spitfire. The Newsletter feature might
  1131.           be similar, but I don't know if many Spitfire sysops update their
  1132.           Newsletter frequently. You have the option of enclosing your
  1133.           Newsletter, one of the daily-updated screens like times of
  1134.           network transfers, or a recent callers list. Whatever file (or
  1135.           files) you want to include in the .QWK packet, just specify it
  1136.           with the NEWS= parameter in the JetMail configuration. To include
  1137.           your Spitfire Newsletter in the .QWK packet, specify in your
  1138.           JetMail .CNF file: NEWS=D:\SF\DISPLAY\SFNWSLTR.BBS. If you have
  1139.           multiple WELCOME<x>.BBS screens which you'd like to put in the
  1140.           .QWK packet, you can use DOS' COPY command to append all the .BBS
  1141.           files together into one file, using:
  1142.  
  1143.                COPY WELCOME2.BBS+WELCOME3.BBS+WELCOME4.BBS WELNEWS
  1144.  
  1145.           The above line can be placed in your JetMail batch file, or in
  1146.           your system event. And specify WELNEWS as your NEWS= parameter
  1147.           (e.g. NEWS=D:\SF\DISPLAY\WELNEWS). However, based on the ADDNEWS=
  1148.           parameter, this 'NEWS' file will be sent with every .QWK packet
  1149.           (if ADDNEWS=ALWAYS), or it will be sent only when the file date
  1150.           on the 'NEWS' file is newer than the user's last QWK packet (when
  1151.           ADDNEWS=NEW). Set these parameters accordingly, so that your
  1152.           users do not have to download excessively large .QWK packets.
  1153.  
  1154.           JetMail does not use the .CLR version of the file specified in
  1155.           the NEWS= parameter.
  1156.  
  1157.           JetMail will only scan messages from the list of conferences
  1158.           selected by in JetMail's Select Conferences menu. JetMail's
  1159.           selection menu allows the user to copy the conference queue from
  1160.           Spitfire for convenient configuration, if desired.
  1161.  
  1162.           JetMail takes into account many Spitfire system configured
  1163.           variables, such as security level to access a conference, sysop
  1164.           security level for a conference, public or private messages, and
  1165.           whether the message is deleted (deleted messages remain in the
  1166.           Spitfire message base; they are only flagged until the next
  1167.           message pack command is executed.)  This assures that only
  1168.           messages that a user is allowed to access will be accessed.
  1169.           Likewise measures are placed on user's reply packet:  public-only
  1170.           conferences, and security level access to a conference. 
  1171.  
  1172.           Based on the DONTPOST= parameter, JetMail responds differently.
  1173.           When DONTPOST=YES, then if a user tries to post a private message
  1174.           in a public-only conference, the message will be ignored and not
  1175.           posted; if a user tries to post a message in a conference to
  1176.           which he has no access, that message will not be posted. However,
  1177.  
  1178.  
  1179.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 19
  1180.  
  1181.  
  1182.           if DONTPOST=NO, invalid messages (private messages attempted in
  1183.           public-only conferences or invalid conference numbers) will be
  1184.           posted in Conference 1.
  1185.  
  1186.           JetMail will also place a copy of the most recent .QWK packet
  1187.           generated into the JetMail home directory, for both local and
  1188.           remote use. If something gets lost during the COPY command during
  1189.           local use, check the JetMail home directory for a .QWK packet.
  1190.           You may delete this .QWK packet in your JetMail batch file if you
  1191.           desire to optimally conserve disk space.
  1192.  
  1193.           JetMail will automatically write to the Spitfire's caller log
  1194.           (CALLERS.TMP in the Spitfire home directory), except if the LOG=
  1195.           parameter is specified. Spitfire will appropriately append
  1196.           CALLERS.TMP into the total CALLERS.LOG in the Spitfire work
  1197.           directory. Messages posted, messages found during new messages
  1198.           scan, and JetMail error messages are all recorded. In the
  1199.           unregistered version of JetMail, a shareware reminder is also
  1200.           recorded in the caller log, reminding you to send in your
  1201.           registration. Upon registration, this reminder will be removed
  1202.           from the caller log, as well as the extra JetMail tagline
  1203.           appended on messages posted through JetMail.
  1204.  
  1205.  
  1206.           WHILE ONLINE
  1207.           ------------
  1208.  
  1209.           While the user is using JetMail, the two bottom lines display his
  1210.           (or her) status. It shows the node number, baud rate, user name
  1211.           in the left half of the first line; the current time and time
  1212.           when door was entered on the right half of the first line. On the
  1213.           second line, it shows the date and user security level. The right
  1214.           half of the second line shows the version number of JetMail.
  1215.  
  1216.           Function keys available to the sysop while in JetMail:
  1217.  
  1218.           ALT-H  Display HELP on status lines at bottom of screen
  1219.                  (toggles between several screens; last screen gives
  1220.                  comm port status)
  1221.           F5     Shell to DOS (when in DOS, be sure to return to the
  1222.                  JetMail directory before EXIT)
  1223.           F8     Return user to BBS (quits JetMail immediately)
  1224.           F9     Toggle display on/off
  1225.           F10    Chat mode (hit ESC to exit chat mode)
  1226.  
  1227.           All other keys are processed by JetMail as 'normal' keystrokes.
  1228.           In the Help status screen (ALT-H), F3, F4, and F7 are labeled
  1229.           with certain functions, however, these functions are only used by
  1230.           the CKIT door-writing toolkit for PCBoard, and I can't remove
  1231.           them even for aesthetic sake.
  1232.  
  1233.  
  1234.           JETMAIL AUTO-PILOT
  1235.           ------------------
  1236.  
  1237.           JetMail has a special feature called Auto-Pilot, which can be
  1238.           used in your system event or from the DOS command line for you to
  1239.  
  1240.  
  1241.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 20
  1242.  
  1243.  
  1244.           quickly post your replies from an .REP packet, if any, and to
  1245.           scan for new messages and put them in a .QWK packet, without
  1246.           logging into Spitfire.
  1247.  
  1248.           To run JetMail Auto-Pilot, you first must login to Spitfire as
  1249.           sysop (yourself) locally, and run JetMail door. When you're in
  1250.           JetMail door, hit F5 to shell to DOS from JetMail, and make a
  1251.           copy of the DOOR.SYS in the Spitfire home directory and keep it
  1252.           for Auto-Pilot use. Use the command line COPY \SF\DOOR.SYS
  1253.           \JETMAIL\AUTOJET.SYS. Notice this command is copying DOOR.SYS
  1254.           from your Spitfire directory into a different filename,
  1255.           AUTOJET.SYS, placing it in your JetMail home directory. Then in
  1256.           your system event, or from the command line, you can invoke
  1257.           JetMail's Auto-Pilot mode:
  1258.  
  1259.                CD \JETMAIL
  1260.                REN AUTOJET.SYS DOOR.SYS
  1261.                JETMAIL DOOR.SYS EVENT
  1262.                REN DOOR.SYS AUTOJET.SYS
  1263.  
  1264.           The above command line will use JETMAIL.CNF in the JetMail home
  1265.           directory; if you need to specify a different JetMail
  1266.           configuration .CNF file, you can do that like this: 
  1267.  
  1268.                CD \JETMAIL
  1269.                COPY AUTOJET.SYS DOOR.SYS
  1270.                JETMAIL DOOR.SYS JETNODE1.CNF EVENT
  1271.                DEL DOOR.SYS
  1272.  
  1273.           When using JetMail Auto-Pilot, JetMail will check if a .REP
  1274.           packet is in the directory specified in the JetMail
  1275.           configuration's LOCALDIR= parameter. If this parameter is not
  1276.           specified, you need to specify the LOCALDIR= parameter in your
  1277.           JetMail .CNF file if you want to use Auto-Pilot mode.
  1278.  
  1279.           If JetMail finds a .REP packet in the LOCALDIR= directory,
  1280.           JetMail will post the messages from that .REP into the
  1281.           corresponding Spitfire conferences. If no .REP is found, JetMail
  1282.           will go straight to the New Messages scan, preparing a .QWK
  1283.           packet.
  1284.  
  1285.           Then JetMail will scan for new messages in the conferences. If
  1286.           there are new messages, JetMail will build a new .QWK packet, and
  1287.           place it in the LOCALDIR= directory. If a BBSID.QWK (where BBSID
  1288.           is your BBS' ID) already exists in the LOCALDIR= directory,
  1289.           JetMail will automatically name the new QWK packet with the
  1290.           extension .QW0. If there is already a .QW0, JetMail will
  1291.           increment the last digit, and try .QW1, then .QW2, until it can
  1292.           find an available filename, up to 9. If JetMail is unable to find
  1293.           an available filename, JetMail should return with an error and
  1294.           not write the new messages in a .QWK packet.
  1295.  
  1296.           After a .QWK containing new messages is placed in the LOCALDIR=
  1297.           directory, JetMail will update the Last Message Read pointers of
  1298.           the conferences with new messages found.
  1299.  
  1300.           JetMail Auto-Pilot concludes and returns to DOS (or the batch
  1301.  
  1302.  
  1303.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 21
  1304.  
  1305.  
  1306.           file that called it, as the case may be).
  1307.  
  1308.  
  1309.           LOCAL JETMAIL USE
  1310.           -----------------
  1311.  
  1312.           Local usage of JetMail is automatically recognized. When the user
  1313.           (or sysop) is ready to transfer a packet, instead of invoking an
  1314.           external protocol, JetMail will prompt the user for a directory
  1315.           where the packet is located (or where to put the newly generated
  1316.           .QWK packet). Just enter the drive and path, and JetMail will
  1317.           place the packet there (or get the packet from the path
  1318.           specified). During local Download, if a .QWK already exists at
  1319.           the destination path, JetMail will prompt "Overwrite? [Y/N/I]".
  1320.           If you answer Yes, JetMail will overwrite the existing .QWK with
  1321.           the newly generated .QWK; if you answer No, JetMail will place
  1322.           the newly generated .QWK in the JetMail home directory; if you
  1323.           answer "I", JetMail will automatically try a new name for the
  1324.           newly generated BBSID.QWK, first trying BBSID.QW0, then
  1325.           BBSID.QW1, up to BBSID.QW9. If JetMail is unable to find an
  1326.           available filename, JetMail doesn't attempt to copy BBSID.QWK to
  1327.           the destination path. It will still leave a copy of the BBSID.QWK
  1328.           in the JetMail home directory.
  1329.  
  1330.  
  1331.           COMMAND-LINE USE OF JETMAIL
  1332.           ---------------------------
  1333.  
  1334.           If you would like to be able to login to JetMail without logging
  1335.           into Spitfire, you can use a similar technique as the auto-pilot
  1336.           described above, except you don't specify the EVENT parameter to
  1337.           JetMail. (you may use the same DOOR.SYS for JetMail auto-pilot as
  1338.           you do for local command-line JetMail).
  1339.  
  1340.           Just login to Spitfire as you normally would, shell to DOS using
  1341.           ALT-J in Spitfire (or F5 in JetMail), make a copy of DOOR.SYS in
  1342.           the Spitfire directory to LOCAL.SYS and place LOCAL.SYS in the
  1343.           JetMail home directory, then logout. Then you can make a batch
  1344.           file, call it JET.BAT, containing:
  1345.  
  1346.                REN LOCAL.SYS DOOR.SYS
  1347.                JETMAIL DOOR.SYS
  1348.                REN DOOR.SYS LOCAL.SYS
  1349.  
  1350.           You can then login to JetMail by typing JET at the DOS prompt,
  1351.           then go directly into JetMail without a Spitfire login. You can
  1352.           get fancy and use a separate .CNF config file with a different
  1353.           LOG= parameter, so that your JetMail activity is redirected to a
  1354.           separate file, if you wish to have your personal JetMail usage to
  1355.           not be logged to the total Spitfire caller log. (or discard this
  1356.           separate log if you don't want to have a record of your
  1357.           activity).
  1358.  
  1359.  
  1360.           MULTI-NODE USE OF JETMAIL
  1361.           -------------------------
  1362.  
  1363.  
  1364.  
  1365.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 22
  1366.  
  1367.  
  1368.           JetMail can work on a multi-node Spitfire system. JetMail can
  1369.           share the JETMAIL.EXE file, the help files, menu screens, and the
  1370.           JetMail users database (USERS.JET). JetMail uses SHARE-compatible
  1371.           routines to access the Spitfire system files and Spitfire
  1372.           messages files - BUT this must be activated by specifying the
  1373.           RUNSHARE= parameter in the JetMail .CNF configuration file. 
  1374.  
  1375.           When RUNSHARE=YES is set, JetMail will run its SHARE-aware code,
  1376.           which means SHARE.EXE must be loaded in memory. There are
  1377.           supposedly some network softwares that manage file sharing
  1378.           without SHARE.EXE, and in those environments you can leave out
  1379.           the RUNSHARE= parameter and rely on the network's file sharing.
  1380.           But it is highly recommended if at all possible in your multi-
  1381.           node environment to run SHARE.EXE with JetMail for the best file
  1382.           sharing management.
  1383.  
  1384.           THIS IS VERY IMPORTANT! To run JetMail on a multi-node system,
  1385.           you must have a SEPARATE JetMail configuration file for each node
  1386.           and a SEPARATE temporary work directory for each node. 
  1387.  
  1388.           To minimize confusion, you can name the configuration files
  1389.           JETNODE1.CNF and JETNODE2.CNF. Be sure to specify the
  1390.           configuration file in the JetMail command line in your door batch
  1391.           file or your sysop configured external command batch file
  1392.           (SFMESS.BAT.)  NOTE: JetMail configuration files must have the
  1393.           .CNF extension!
  1394.  
  1395.           Be sure you have different WORKDIR= specified for each node's
  1396.           JetMail configuration.
  1397.  
  1398.           If you're in a network environment, make sure you have the
  1399.           correct drive letters for the JetMail batch files, and the
  1400.           configuration files WELCOME=, NEWS=, and GOODBYE= parameters.
  1401.  
  1402.  
  1403.           JETMAIL SYSTEM MANAGER
  1404.           ----------------------
  1405.  
  1406.           JETSM.EXE is the system editor which manages many JetMail
  1407.           functions. There are four basic sections: Edit Configuration,
  1408.           Transfer Protocols, User Editor, and Adjust Conferences.
  1409.  
  1410.           The Edit Configuration will edit JETMAIL.CNF in the current
  1411.           directory. This is to assist your editing the .CNF configuration
  1412.           file for JetMail, but it is by no means comprehensive. For
  1413.           initial configuration, this may be very helpful in getting
  1414.           JetMail up and running; however, if you need to adjust JetMail's
  1415.           operation for your particular system, please use a text editor
  1416.           and enter the parameters as described in this documentation.
  1417.           Multi-node systems will also need to be configured manually; but
  1418.           this JETSM feature may still be useful in setting up a
  1419.           preliminary .CNF file from which you can build into .CNF's for
  1420.           each node. (Reminder again, each node of a multi-node system must
  1421.           have its own .CNF configuration file and its own temporary
  1422.           JetMail work directory)
  1423.  
  1424.           The Transfer Protocols editor works in a similar fashion - it is
  1425.  
  1426.  
  1427.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 23
  1428.  
  1429.  
  1430.           designed to let you quickly edit the JETXFER.DAT in an easy-to-
  1431.           understand full screen editor. You should be able to define all
  1432.           your transfer protocols here, but again, use a text editor if you
  1433.           find JETSM's Transfer Protocol editor insufficient.
  1434.  
  1435.           The User Editor portion allows you to edit the user configuration
  1436.           for a JetMail user, give NetSysop access to the conferences if
  1437.           you are running JetMail as a network hub, and allows you to add
  1438.           or delete users. The editor is pretty straight-forward and simple
  1439.           to use.
  1440.  
  1441.           The Adjust Conferences portion allows you to quickly add or drop
  1442.           conferences from all JetMail users' configuration. This would be
  1443.           used when you have added several conferences that you want all
  1444.           users to read from. You may also want to drop (remove users from
  1445.           some conferences) when you change your conferences around.
  1446.  
  1447.           All four portions of the System Manager are full-screen user
  1448.           interfaced, so they should be pretty straight forward to use.
  1449.  
  1450.           The function keys available in JETSM are (as applicable):
  1451.  
  1452.            Tab           moves to next field
  1453.            Shift-Tab     moves to previous field 
  1454.            Alt-A         add a new user record
  1455.            Alt-D         delete a user record
  1456.            F2            toggle between high and low conference numbers
  1457.                          (screen one is 1-128, screen two is 129-255)
  1458.            PgUp          move to previous record
  1459.            PgDn          move to next record
  1460.            F10           save changes and return to main menu
  1461.            Esc           abort program and leave user database unchanged
  1462.  
  1463.            Alt-Z         Jump to "Undo" field, and hitting <~> in this
  1464.                          box zaps (undos) any changes made on that screen
  1465.            Alt-C         Jumps to first conference number field
  1466.            Alt-L         Jumps to last conference number field
  1467.            Alt-U         Jumps to user name field
  1468.  
  1469.            Cursor Up     Moves to the previous field
  1470.            Cursor Down   Moves to next field
  1471.            Insert        Toggle between insert and typeover mode
  1472.            Ctrl-R        Restore field to original value
  1473.            Ctrl-bkspace  Delete word left
  1474.            Ctrl-T        Delete word right
  1475.            Ctrl-U        Delete to end of field
  1476.  
  1477.           A hint bar at the bottom of the User Editor screen may be
  1478.           referenced for available functions. Reminder: the field labeled
  1479.           "Format" refers to the compression format NUMBER, the field
  1480.           labeled "Protocol" refers to the LETTER of the transfer protocol
  1481.           designator, and the field "Max Size" is the maximum number of
  1482.           messages to scan into a .QWK packet.
  1483.  
  1484.           In the lower half of the screen, you can select conferences for
  1485.           the user, overriding any forced and default conferences you've
  1486.           configured for JetMail. You could also override Spitfire security
  1487.  
  1488.  
  1489.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 24
  1490.  
  1491.  
  1492.           level for private conferences, but please do NOT do this as
  1493.           JetMail will have unpredictable results. (You can toggle off
  1494.           scanning forced conferences for NetSysops so they can expedite
  1495.           mail run transfers, when you run JetMail as a network hub).
  1496.  
  1497.           JetMail allows you to setup for up to 20 networks. The field
  1498.           marked "NetSysop" located at the bottom right of the screen can
  1499.           be used for giving the user/sysop NetSysop access. The NetSysop
  1500.           field contains two lines of ten characters, each character
  1501.           corresponding to the network number. An 'X' in the first
  1502.           character of the first line corresponds to network number 1; an
  1503.           'X' in the sixth character first line corresponds to net number
  1504.           6; an 'X' in the first character of the second line corresponds
  1505.           to net number 11; an 'X' in the tenth character of the second
  1506.           line corresponds to net number 20; etc. Spaces in the field mean
  1507.           the user/sysop does not have NetSysop access to that network.
  1508.  
  1509.           For each echo mail network, you need to generate a text file
  1510.           containing the numbers of the conferences which comprise that
  1511.           network; the network conference list should have one number per
  1512.           line. These network lists need to be placed in the JetMail home
  1513.           directory, with filenames NETLIST.<x>, where <x> is the network
  1514.           number (with no leading zeros). For example, if you had two
  1515.           networks, with conferences 20-24 in network 1, and conferences
  1516.           34-37 in network 2, you would have two text files:
  1517.  
  1518.           NETLIST.1                NETLIST.2
  1519.           ---------                ---------
  1520.           20                       34
  1521.           21                       35
  1522.           22                       36
  1523.           23                       37
  1524.           24
  1525.  
  1526.           "Cross-echos", conferences that are shared on multiple networks,
  1527.           may be supported by listing a conference number in more than one
  1528.           network conference list.
  1529.  
  1530.           Here are the differences in JetMail for a user/sysop with
  1531.           NetSysop access:  the JETNEWS is not displayed, JetMail defaults
  1532.           to menu expert mode (no menu, for the most expedient mail runs),
  1533.           .REP files may contain messages from different users and JetMail
  1534.           will post them as such (non-NetSysop users can only post messages
  1535.           from themselves), and NetSysop will scan into the .QWK all new
  1536.           messages in a network conference, regardless of scan flag (Y or
  1537.           YA or ALL), and access any private messages in the network
  1538.           conference.
  1539.  
  1540.           NOTE:  If you configure a JetMail user/sysop for multiple
  1541.           networks (more than one 'X' in the NetSysop field), the network
  1542.           software that the node sysop is using must be able to handle
  1543.           multiple networks. If the network software used to process .QWK's
  1544.           received from JetMail can only process one network at a time, you
  1545.           will need to setup separate accounts for each network mail run.
  1546.  
  1547.  
  1548.           JETMAIL AS A NETWORK HUB
  1549.  
  1550.           
  1551.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 25
  1552.  
  1553.  
  1554.           ------------------------
  1555.  
  1556.           JetMail may be used as a hub for QWK-compatible networks. To be a
  1557.           hub for a network, you do not need to change the JetMail .CNF
  1558.           configuration file. Basically, only two steps are involved:  give
  1559.           the sysop(s) that are running as a node off of your hub Network
  1560.           Sysop (NetSysop) access in JetMail, and define which conferences
  1561.           comprise the network.
  1562.  
  1563.           To give NetSysop access to a user/sysop in JetMail, use the JETSM
  1564.           user editor, setting the appropriate flags under the "NetSysop"
  1565.           field for the corresponding user. Be sure to hit F10 to exit
  1566.           JETSM to save the changes.
  1567.  
  1568.           The node sysop is unable to set his own NetSysop status.
  1569.           Certainly, you don't want any user to be able to toggle on
  1570.           NetSysop status, which have the effects described above. You as a
  1571.           network hub have responsibility to manage your nodes. Please be
  1572.           sure to uphold the regulations of the echo mail network of which
  1573.           you are a member. However, the NetSysop will be able to add/drop
  1574.           conferences (using a JetMail offline config message) in the
  1575.           network to which he has NetSysop access, so he can add/drop
  1576.           network conferences without your intervention.
  1577.  
  1578.           You may want to setup an entirely separate account for each sysop
  1579.           making network transfers via JetMail. This will allow the node
  1580.           sysop to maintain a separate account on your board for reading
  1581.           messages from non-network conferences and keep the records
  1582.           straight between network activity and user activity. A separate
  1583.           account may also let you setup separate caller security levels to
  1584.           let them skip welcome screens and other login excesses.
  1585.  
  1586.           JetMail supports up to 20 distinct networks. You need to list in
  1587.           a simple ASCII file the network conferences, in NETLIST.<x>,
  1588.           where <x> is the network number (no leading zeros).
  1589.  
  1590.           When a Network Sysop logs in to JetMail, he will default to
  1591.           expert mode, so no menus are sent and no JETNEWS is displayed.
  1592.           After JetMail's initialization, the Network Sysop status is shown
  1593.           -- JetMail shows what networks he is configured for.
  1594.  
  1595.           As a Network Sysop, he is given access to "private" messages in
  1596.           the network conferences. He will also be able to post messages
  1597.           from anyone (normally, JetMail will post messages from an .REP as
  1598.           from the logged on user, regardless of what is actually put in
  1599.           the .REP packet, as a security measure).
  1600.  
  1601.           Also, recommend to the NetSysop node sysop to toggle off any
  1602.           unnecessary flags in JetMail. Generally speaking, the node sysop
  1603.           does not need to include Welcome and Goodbye screens in his .QWK
  1604.           packet, doesn't need new files and new bulletins, and depending
  1605.           on the network software they're using, they may not need .NDX
  1606.           index files. Also, set the parameters for the maximum number of
  1607.           messages appropriately. Some network softwares may be able to
  1608.           handle more than 200 messages per conference.
  1609.  
  1610.           As a hub, JetMail does not add network origin taglines. The
  1611.  
  1612.  
  1613.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 26
  1614.  
  1615.  
  1616.           network software must append host taglines appropriately.
  1617.  
  1618.           Details on operating (or starting) an echo mail networks are not
  1619.           explained here. JetMail can facilitate the generation of .QWK's
  1620.           that can be used by QNet-compatible softwares (like QNet, RNet,
  1621.           TNet, CNet, MKNet, TriNet), and this documentation gives you the
  1622.           fundamental details on using JetMail for this purpose.
  1623.           Development of a QWK-compatible network software for Spitfire is
  1624.           currently in progress.
  1625.  
  1626.  
  1627.           REGISTRATION & SUPPORT
  1628.           ----------------------
  1629.  
  1630.           Registration for JetMail is $25.00 (US funds please). This amount
  1631.           may be paid by the sysop using JetMail, or by a user wishing to
  1632.           adopt the door for a sysop. Sysop-fundeded and user-adopted door
  1633.           registrations may download the registration key from the JetMail
  1634.           support BBS, Solid Rock.
  1635.  
  1636.           Registration should be made promptly during the 30-day evaluation
  1637.           period if JetMail performs to your satisfaction. Registration
  1638.           will remove the extra JetMail tagline appended to messages posted
  1639.           in JetMail, and removes the reminder notice in the caller log.
  1640.           There is no extra delays, no crippled features, or gaudy flashing
  1641.           unregistered notices in the unregistered version of JetMail. 
  1642.  
  1643.           If you would like to receive a disk with your registration key,
  1644.           the latest version of the software (which may or may not be the
  1645.           one that you already have), and the documentation in WordPerfect
  1646.           format, please add $5.00 to your payment (totaling $30.00), and I
  1647.           will mail you the latest JetMail software on your choice of media
  1648.           (5¼" or 3½" floppy diskette).
  1649.  
  1650.           This documentation is originally written in WordPerfect 5.1
  1651.           format. The documentation can be obtained in WordPerfect format
  1652.           upon registration if you would like to get it for printing on a
  1653.           laser printer or something. This will be available on Solid Rock
  1654.           BBS, or on above mentioned diskette.
  1655.  
  1656.           Your registration will be promptly processed; after I receive
  1657.           your registration, you will receive access on Solid Rock BBS to
  1658.           download your registration key file, or you will receive a disk
  1659.           with the registratoin key file if you selected this option. 
  1660.  
  1661.           Mail registration form (REGISTER.JET) and payment to:
  1662.                                              DJ Chuang
  1663.                                              3909 Swiss Ave., #264
  1664.                                              Dallas, TX  75204
  1665.  
  1666.           The latest JetMail may be downloaded from:
  1667.           * The Solid Rock, [CircuitNet, RIME, Intelec]
  1668.             sysop Ron Hossack, running Spitfire
  1669.             (714)785-9176 HST/DS
  1670.           * SMCIS, [NewLife, RIME]
  1671.             sysop Buggs Bugnon, running PCBoard 
  1672.             (301)862-3160 HST 14.4, (301)862-1527 HST/DS
  1673.  
  1674.  
  1675.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 27
  1676.  
  1677.  
  1678.           * Sing Sing Sing Studios BBS, [Intelec, FidoNet]
  1679.             sysop Ira Lichtenstein, running Spitfire
  1680.             (914)941-2246 (2400), or FREQ magic name JETMAIL from 1:272/43
  1681.           * The Paradigm, [RIME]
  1682.             sysop Tom Kellen, running Spitfire
  1683.             (404)671-1581 HST/DS
  1684.           * Columbia Spitfire [CircuitNet]
  1685.             sysop Steve Newman, running Spitfire
  1686.             (503)397-5486 HST/DS, (503)397-6040 HST
  1687.           * Bread Board, [RIME, CircuitNet]
  1688.             sysop Paul Staton, running Spitfire
  1689.             (214)617-8259 V.32
  1690.  
  1691.           FidoNet FREQ available from 1:272/43 on a high speed HST/DS
  1692.           modem.
  1693.  
  1694.           Before contacting the author with questions and/or problems, be
  1695.           sure you understand the included documents and have referred to
  1696.           the questions and answers section to try to resolve the problem.
  1697.           If you feel there is a definite bug in JetMail, please contact
  1698.           the author immediately. The best contact is the JetMail support
  1699.           board, Solid Rock BBS. The sysop there (Ron Hossack) will forward
  1700.           all messages to me. Ron Hossack will be able to help you with
  1701.           Spitfire specific questions. I can be contacted via e-mail on the
  1702.           RelayNet/RIME network (Conferences: Mail Doors, Spitfire), ILink
  1703.           (Offline), PlanoNet (Reviews), CircuitNet (Doors), FidoNet
  1704.           (Spitfire echo); address messages to me (DJ CHUANG) directly with
  1705.           your questions and suggestions. You may also write me via Fido
  1706.           net-mail at 1:124/6300, and also on Usenet at
  1707.           dj.chuang@u2u.lonestar.org.
  1708.  
  1709.  
  1710.           AUTHOR NOTES & THANKS
  1711.           ---------------------
  1712.  
  1713.           Special thanks to Buggs Bugnon and Ron Hossack for their faith
  1714.           and support. Also thanks to Ron (again) and John Clawson for
  1715.           suggesting the idea. And thanks to alpha site sysops Ron, Ira,
  1716.           Tom, and Steve.
  1717.  
  1718.           Special thanks to the beta testers that really 'tortured' JetMail
  1719.           to refine it into the product that it is today:
  1720.                Ron Hossack
  1721.                Ira Lichtenstein
  1722.                Tom Kellen
  1723.                Steve Newman
  1724.                Wayne Browning
  1725.                John Clawson
  1726.                Doug Klassen
  1727.                Jose Frias
  1728.  
  1729.           Numerous other names of sysops who have corresponded with me
  1730.           through various echo networks have also contributed to JetMail's
  1731.           development. Their ideas have been valuable in shaping this
  1732.           software.
  1733.  
  1734.           Version 1.10 took considerably more time for development, as now
  1735.  
  1736.  
  1737.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 28
  1738.  
  1739.  
  1740.           I am working part-time (manual labor) and attending school full-
  1741.           time. This version 1.14 is released with new documentation, as it
  1742.           has been long overdue. All information is up-to-date with the way
  1743.           JetMail 1.14 runs.
  1744.  
  1745.           I appreciate the words of encouragement from JetMail users all
  1746.           over the world, and I'm glad that I'm able to serve the Spitfire
  1747.           community in such a manner.
  1748.  
  1749.           Most of all, all praise and glory to God Almighty, the Creator of
  1750.           the heavens and the earth; the triune and eternal One; who has
  1751.           provided eternal life by grace through faith in Jesus Christ
  1752.           (John 3:16; 14:6). [Don't mean to be preachin', but I need the
  1753.           practice, and have to be specific these days]
  1754.  
  1755.  
  1756.           ACKNOWLEDGEMENTS
  1757.           ----------------
  1758.           * CKIT is copyright by Rickie W. Belitz.
  1759.           * TURBO C/C++ is a registered trademark of Borland International
  1760.             Inc.
  1761.           * PCBoard is a registered trademark of Clark Development Company.
  1762.           * SPITFIRE is a trademark of Buffalo Creek Software, copyright by
  1763.             Mike Woltz.
  1764.           * PKZIP/PKUNZIP are copyright PKWare and Phil Katz.
  1765.           * DSZ is copyright by Omen Technology, Inc.
  1766.           * WordPerfect is copyright WordPerfect Corporation.
  1767.           * FATAL and PROECHO are copyright by Samuel H. Smith.
  1768.           * SFUTI is copyright by Bob Browne.
  1769.           * WildFire is copyright by Stephen L. Cox.
  1770.           * QMail Deluxe and QNet are trademarks of Sparkware, copyright by
  1771.             Mark Herring.
  1772.           * EZ-Reader is a trademark of Thumper Technologies, copyright by
  1773.             Eric Cockrell.
  1774.           * RoseMail and RoseReader are copyright by Vic Kass.
  1775.           * Session Manager is copyright by Patrick W. Hart.
  1776.           * MegaMail door and MegaMail Reader is copyright by Kip Compton.
  1777.           * KingQWK is copyright by Mike King.
  1778.           * Speed Read is copyright by Jim Smith.
  1779.           * Power-QWK is copyright by Gale Green.
  1780.           * WinQwk is copyright by Doug Crocker.
  1781.           * WinRead is copyright by Ollivier Civiol.
  1782.           * CNet is copyright by Rollin White.
  1783.           * RNet is copyright by Robert Vostreys.
  1784.           * MKNet is copyright by Mark May.
  1785.           * TriNet is copyright by Mark Goodwin.
  1786.           * JetMail is copyright by DJ Chuang. (obviously)
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 29
  1800.  
  1801.  
  1802.           
  1803.           QUESTIONS AND ANSWERS
  1804.           ---------------------
  1805.  
  1806.           Q:   What is USERS.JET?
  1807.  
  1808.           A:   JetMail makes a USERS.JET users database file in the JetMail
  1809.                home directory to keep the users configuration, which
  1810.                contains information such as selected conferences, transfer
  1811.                protocol, compression utility, and other flags. You may use
  1812.                JETSM.EXE to edit this file.
  1813.  
  1814.           Q:   JetMail "locks up" after a file transfer. The local screen
  1815.                is still normal and active, but the remote user gets a
  1816.                garbled screen and cannot enter commands.
  1817.  
  1818.           A:   You need to check your system's modem configuration. If
  1819.                Spitfire is setup for Software Flow Control, you need to add
  1820.                a parameter in the JetMail .CNF file:  SPEED=ACTUAL. 
  1821.  
  1822.           Q:   JetMail's message scan comes up with tremendously huge
  1823.                message number, like 13837204, when there are only 200
  1824.                messages in the conference.
  1825.  
  1826.           A:   JetMail uses the actual unique message number in scanning
  1827.                messages; JetMail does not 'normalize' message numbers like
  1828.                Spitfire does. (Spitfire will number messages according to
  1829.                how many actually exist, so if there are 20 messages in the
  1830.                conference, Spitfire numbers the messages from 1 to 20; but
  1831.                JetMail numbers the messages according to how many messages
  1832.                had been posted on the BBS). You need to run a utility like
  1833.                RENUMSG to renumber your messages.
  1834.  
  1835.           Q:   I got a "Share Violation" error, or "Error during record-
  1836.                locking mechanism".
  1837.  
  1838.           A:   Is SHARE.EXE loaded?  When you specify RUNSHARE=YES in the
  1839.                JetMail .CNF configuration, JetMail will run its SHARE-aware
  1840.                code to do file sharing in a multi-node environment. The
  1841.                'record-locking' error message will occur if RUNSHARE=YES is
  1842.                specified and SHARE.EXE is not loaded. If you are running
  1843.                JetMail on a single-node system, you need to leave out the
  1844.                RUNSHARE= parameter in your .CNF file. If you are running a
  1845.                multi-node system, and cannot load SHARE.EXE for some reason
  1846.                (conflict with other doors, or running under Windows, or
  1847.                some local area networks), you may specify RUNSHARE=NO and
  1848.                JetMail will not try to do its own file sharing, and JetMail
  1849.                would leave file sharing to your system environment. JetMail
  1850.                was developed with MS-DOS 5.0, and has run successfully on
  1851.                systems with DOS 5.0, DOS 4.x, DOS 3.3, and 4DOS 3.3. A very
  1852.                useful utility, FATAL.COM by Sam Smith, may be loaded on
  1853.                your system to watch out for share violations and keep them
  1854.                from 'hanging up' your system. FATAL detects the "Abort,
  1855.                Retry, Ignore" prompt and handles them so it doesn't 'hang
  1856.                up' your BBS. 
  1857.  
  1858.  
  1859.  
  1860.  
  1861.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 30
  1862.  
  1863.  
  1864.           Q:   I got a JetMail error message. What now?
  1865.  
  1866.           A:   Refer to the JETMAIL.FIX document to see what common
  1867.                solutions might be for JetMail errors. 
  1868.  
  1869.           Q:   JetMail's Goodbye command doesn't work. Users are returned
  1870.                to Spitfire when they select the 'G' command.
  1871.  
  1872.           A:   If you set NOBYE=YES in the JetMail .CNF configuration, then
  1873.                the Goodbye command in JetMail works just like the Quit
  1874.                command. But if NOBYE=NO is set (which is default), the
  1875.                Goodbye command should logoff callers. JetMail logs off
  1876.                callers by lowering the DTR line for one second, which
  1877.                requires your modem to be setup with AT&C1&D2 . However,
  1878.                some modems are not able to do this; there is a parameter
  1879.                HANGUP= which can be set to your hangup string, and JetMail
  1880.                will then use this string to log off the caller. Specify
  1881.                HANGUP=ATH0, and when the Goodbye command is selected,
  1882.                JetMail will send the command mode string +++, wait one
  1883.                second, and then send ATH0 to the modem.
  1884.  
  1885.           Q:   New bulletins are not getting included in the .QWK packet
  1886.                even when the caller has configured all new bulletins to be
  1887.                included.
  1888.  
  1889.           A:   JetMail scans for new bulletins based on the DOS file date
  1890.                and time of each bulletin. Bulletin numbers must be
  1891.                contiguous. So if you have bulletins numbered 1 to 10, and
  1892.                bulletin 8 is missing from the \SF\DISPLAY for some reason,
  1893.                then bulletins 9 and 10 will not be checked by JetMail.
  1894.  
  1895.           Q:   JetMail doesn't seem to be using the parameters specified in
  1896.                the .CNF configuration file which I specified on the command
  1897.                line when calling JetMail.
  1898.  
  1899.           A:   Be sure the .CNF file exists in the JetMail home directory
  1900.                (note: JetMail configuration files must have the extension
  1901.                .CNF)  Be sure parameter names are UPPER case, and no spaces
  1902.                after the = sign.
  1903.  
  1904.           Q:   Running JetMail under DesqView, I get a QEMM exception 13
  1905.                error.
  1906.  
  1907.           A:   This can happen because the .EXE's or .COM's specified in
  1908.                the JETXFER.DAT are not found in the DOS path. JetMail does
  1909.                not check to make sure they exist, and will call the
  1910.                JETXFER.DAT specified command lines to do file transfers.
  1911.                This results in the above exception error if the file
  1912.                transfer program is not found. To fix it, place the
  1913.                corresponding .EXE or .COM in the DOS path, or place the
  1914.                correct filenames in the JETXFER.DAT file.
  1915.  
  1916.           Q:   How can I make sure JetMail .REP uploads are not excessively
  1917.                large, and use up all the disk space?
  1918.  
  1919.           A:   JetMail cannot prevent excessively large uploads. However,
  1920.                using DSZ.COM, you can set the environment variable MAXBYTES
  1921.  
  1922.  
  1923.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 31
  1924.  
  1925.  
  1926.                to limit upload size. SET MAXBYTES=100000 would limit .REP
  1927.                uploads to 100,000 bytes (and all subsequent file transfers
  1928.                too - you may need to SET MAXBYTES= , to remove the
  1929.                constraint after running JetMail, so Spitfire transfers
  1930.                later will make it without problems)
  1931.  
  1932.           Q:   The Spitfire CALLERS.LOG shows "Improper return from door"
  1933.                after JetMail runs. What happened?
  1934.  
  1935.           A:   When callers logoff from JetMail (or any door for that
  1936.                matter), Spitfire will automatically print that error
  1937.                message if the carrier is lost. Refer to JetMail's portion
  1938.                of the log to see if an actual carrier was dropped by the
  1939.                caller, or if the caller selected the Goodbye command and
  1940.                properly logged off.
  1941.  
  1942.           Q:   Why do I have a directory in my JetMail home directory named
  1943.                TMP1.$$$ ?
  1944.  
  1945.           A:   Sometimes when JetMail shuts down due to a fatal error, and  
  1946.                you're not using an explicitly specified work directory
  1947.                (which may be specified by WORKDIR= in the JetMail
  1948.                configuration file) may find subdirectories in the \JETMAIL
  1949.                directory (i.e. \JETMAIL\TMP1.$$$). The files within these
  1950.                directories may be deleted and the directories removed.
  1951.  
  1952.           Q:   What are the funny ! % * symbols that show up in the Select
  1953.                Conferences menu?
  1954.  
  1955.           A:   JetMail allows several different types of message scans: 
  1956.                for conferences setup for "YA" scan, that is, messages
  1957.                addressed to the current JetMail user and to "All Users", a
  1958.                "%" sign shows up next to the conference number. A "*" means
  1959.                scan for all new messages. And a "!" means the conference is
  1960.                being forced by the sysop, so that the user must scan those
  1961.                conferences for messages. 
  1962.  
  1963.           Q:   How do I install JetMail under the WildFire menu manager?
  1964.  
  1965.           A:   JetMail can be installed in WildFire; just add JetMail as a
  1966.                new entry in the WildFire menu system. Run the LSEDIT.EXE
  1967.                program, select "Script Edit" from the menu bar, "Add New
  1968.                Door Script" on the pull down menu, enter JETMAIL as the
  1969.                unique door name, Door Type should be "S" for Spitfire, set
  1970.                the remainder of the door parameters as appropriate, then
  1971.                edit the script for JetMail:  be sure to change directory to
  1972.                the JetMail home directory, and run JetMail with the correct
  1973.                path to DOOR.SYS and correct JetMail .CNF configuration.
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 32
  1986.  
  1987.  
  1988.  
  1989.           JETMAIL DOCUMENTATION INDEX
  1990.  
  1991.           .QWK packet  21                   NEWS=  7, 19
  1992.           .REP packet  21                   NEWUSER  6, 18
  1993.           ADDNEWS=  7                       NOBYE=  9, 31
  1994.           AFTER=  10                        Offline mail reader  2
  1995.           Auto-Pilot  21                    Overwrite  22
  1996.           BBS ID  3                         PACK1=  11
  1997.           BBSCITY=  6                       PACK1QWK=  11
  1998.           BBSID=  7                         PACK1REP=  11
  1999.           BBSNAME=  6                       PACK2=  11
  2000.           BBSPHONE=  6                      PACK2QWK=  11
  2001.           CALLERS.LOG  9, 20, 32            PACK2REP=  11
  2002.           Compression Utilities  11         PACK3=  11
  2003.           Conference names  15              PACK3QWK=  11
  2004.           CONFLIST.JET  5, 15, 16           PACK3REP=  11
  2005.           DEFAULT=  8, 18                   PKUNZIP.EXE  16
  2006.           DONTPOST=  9, 20                  PKZIP.EXE  11, 16
  2007.           DOOR.SYS  5                       PRIORITY=  10
  2008.           DOS path  16                      QEMM  31
  2009.           DUPCHECK=  10                     Registration  27
  2010.           EVENT  21                         RUNSHARE=  11, 23, 30
  2011.           File transfers  11                SF.BAT  14
  2012.           FORCED=  8                        SFDOOR.MNU  13
  2013.           Function keys  20                 SFMAIN.BAT  14
  2014.           GOODBYE=  7                       SFMAIN.MNU  14
  2015.           HANGUP=  10, 31                   SHARE  23, 30
  2016.           Help files  18                    Shareware  2
  2017.           Home directory  6                 Software vendors  2
  2018.           Installation Options  5           SPEED=  7, 12
  2019.           JETHELP.MAI  6, 18                SWAP=  9
  2020.           JETHELP.SEL  6, 18                Syntax  4
  2021.           JETHELP.USR  6, 18                SYSOPNOM=  7
  2022.           JetMail Configuration  6, 23,     TMP1.$$$  32
  2023.               31                            User's Guide  18
  2024.           JetMail home directory  20        USERS.JET  23, 30
  2025.           JetMail Status Line  20           WELCOME=  7, 19
  2026.           JETMAIL.EXE  6                    WildFire  32
  2027.           JETMAIL.FIX  31                   WORKDIR=  8, 23
  2028.           JETMAIL.ID  6, 18                 XFERDATA=  11
  2029.           JETMENU.BBS  6, 18
  2030.           JETMENU.CLR  6, 18
  2031.           JETNEWS  18
  2032.           JETSM  23, 26, 30
  2033.           JETTEXT.DAT  6
  2034.           JETXFER.DAT  6, 12, 31
  2035.           Last Message Read pointers 
  2036.               22
  2037.           Local usage  20
  2038.           LOCALDIR=  8, 21
  2039.           LOG=  8, 20
  2040.           MAKECONF.EXE  15, 16
  2041.           MegaMail  2, 7
  2042.           Message numbers  30
  2043.           Multi-node  23
  2044.           Network Sysop  26
  2045.  
  2046.  
  2047.           JETMAIL.DOC - JetMail - QWK Mail Door for Spitfire        Page 33