home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mail / jet114.zip / JETUSER.DOC < prev    next >
Text File  |  1992-10-19  |  21KB  |  497 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.            ╔═══════════════════════════════════════════════╗
  11.            ║     ██ █████ ██████ ███  ███ ██████ ██ ██     ║
  12.            ║     ██ ██▄▄    ██   ██ ██ ██ ██  ██ ██ ██     ║
  13.            ║     ██ ██▀▀    ██   ██    ██ ██████ ██ ██     ║
  14.            ║ ██████ █████   ██   ██    ██ ██  ██ ██ ██████ ║
  15.            ║  .QWK-Compatible Mail Door for Spitfire 3.2   ║
  16.            ╚═══════════════════════════════════════════════╝
  17.  
  18.                JetMail version 1.14
  19.                User's Guide
  20.                Copyright (c) 1991,92 by DJ Chuang
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                   Table of Contents
  33.  
  34.  
  35.           Introduction to JetMail . . . . . . . . . . . . . . . . . . .   2
  36.  
  37.           Using JetMail . . . . . . . . . . . . . . . . . . . . . . . .   2
  38.  
  39.           JetMail Main Menu . . . . . . . . . . . . . . . . . . . . . .   3
  40.  
  41.           Selecting Conferences in JetMail  . . . . . . . . . . . . . .   5
  42.  
  43.           JetMail Configuration Setup . . . . . . . . . . . . . . . . .   6
  44.  
  45.           Offline Configuration . . . . . . . . . . . . . . . . . . . .   7
  46.  
  47.           Conclusive Notes  . . . . . . . . . . . . . . . . . . . . . .   8
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           JetMail User's Guide                                       Page 1
  64.  
  65.  
  66.  
  67.           Introduction to JetMail
  68.  
  69.           JetMail is a .QWK-compatible offline mail door for SPITFIRE,
  70.           copyright by Mike Woltz and Buffalo Creek Software. 
  71.  
  72.           'QWK' is a popular offline mail format introduced by Mark Herring
  73.           for PCBoard.  Its popularity is evident from the number of BBSes
  74.           and 'doors' that now support the QWK mail format and the many QWK
  75.           mail readers.  Offline mail avails to you the opportunity to make
  76.           the most of your online time.  No longer are you confined to
  77.           using only one reader, but you're free to choose a mail reader
  78.           which has a user interface with which you are comfortable.  Some
  79.           readers that may be used with JetMail include:  SLMR, QMail
  80.           Reader, OLX, QDeluxe, EZ-Reader, Session Manager, KingQWK, Speed
  81.           Read, Jabber, Power QWK, WinQWK (for Windows 3.0), AmigaReader
  82.           (for Amiga computers), and MegaMail Reader v2.10. [copyrights and
  83.           trademarks respectively]  MegaMail Reader users must use 2.10
  84.           release version, not a beta version.
  85.  
  86.  
  87.           Using JetMail
  88.  
  89.           Two things you need to setup before a .QWK packet can be prepared
  90.           for you to download.  You need to use the "C" command to setup
  91.           your configuration, which specifies your transfer protocol and
  92.           other parameters (a separate help file is available from that
  93.           prompt). Second, you need to use the "S" command to select
  94.           conferences from which you wish to scan for new messages (a
  95.           separate help file is available from that prompt also).
  96.  
  97.           JetMail will facilitate offline mail reading and reply by using
  98.           the QWK format.  The Download command starts JetMail scanning the
  99.           selected conferences for new messages that you have not read. 
  100.           You may also optionally scan for new bulletins and new files
  101.           posted on the BBS. When messages are found, JetMail will prompt
  102.           you - whether you wish to download the messages.  If you answer
  103.           Yes (or Goodbye, which will automatically log you off from the
  104.           board when the transfer is completed), JetMail will prepare the
  105.           .QWK packet for transfer.
  106.  
  107.           When JetMail finishes compressing the files that comprise the
  108.           .QWK packet, JetMail will prompt you with "Ready to transfer". 
  109.           Initiate the 'receive file' on your communication program (i.e.
  110.           Telix, Procomm Plus, GT-Comm, Qmodem), using the transfer
  111.           protocol corresponding to the one you selected in JetMail's
  112.           Configuration Setup. Your computer will receive the .QWK file,
  113.           and your choice mail reader will be able to process the .QWK
  114.           packet to let you read and reply to messages.
  115.  
  116.           When you've replied to messages with your mail reader, there will
  117.           be a .REP file on your hard drive.  Next time you logon this BBS,
  118.           use JetMail's "U" command, for upload a packet.  JetMail will
  119.           prompt you with "Ready to transfer", then you use your
  120.           communication program to send the .REP file.  After the file is
  121.           successfully transferred, JetMail will process the packet and
  122.           post messages into the corresponding conferences.
  123.  
  124.  
  125.           JetMail User's Guide                                       Page 2
  126.  
  127.  
  128.  
  129.  
  130.           JetMail Main Menu
  131.  
  132.           The Main Menu of JetMail will contain the following commands:
  133.  
  134.           <C>onfiguration setup   
  135.           <S>elect Conferences    
  136.           <D>ownload a Packet     
  137.           <U>pload a Packet     
  138.           <P>ointers upload     
  139.           <G>oodbye (Logoff)
  140.           <Q>uit JetMail door   
  141.           <X> Expert Mode Toggle
  142.           <?> Help
  143.  
  144.           These commands are pretty common to many QWK-compatible mail
  145.           doors, so if you've used other QWK-compatible mail doors, these
  146.           commands should be familiar to you.
  147.  
  148.  
  149.           <C>onfiguration setup
  150.  
  151.                This invokes the JetMail configuration menu.  It allows you
  152.                to select your transfer protocol, compression utility,
  153.                maximum number of messages to scan, and flags for scanning
  154.                bulletins and files.  Read the section entitled JetMail
  155.                Configuration Setup for more details.
  156.  
  157.           <S>elect Conferences
  158.  
  159.                This allows you to select the conferences that you wish to
  160.                scan for messages.  Read the section entitled Selecting
  161.                Conferences in JetMail for more details.
  162.  
  163.           <D>ownload a Packet
  164.  
  165.                Prepares a .QWK mail packet containing new messages scanned
  166.                from the selected conferences.  During the message scan, you
  167.                may hit <SPACE> to abort the mail scan.  A column labeled
  168.                "Flags" shows you the status of the message scan for that
  169.                conference:
  170.  
  171.                     Public    Only Public Messages allowed in conference
  172.                     Net       NetSysop access in conference
  173.                     Yours     Only scan for Your Mail 
  174.                     Yours/NP  Only scan for Your Mail in Public_Only conf.
  175.                     YAll      Scan for mail to you and to all
  176.                     YAll/NP   Scan for mail to you and to all in
  177.                               Public_Only conference
  178.  
  179.                When new messages are found, then you can will be prompted:
  180.  
  181.                   Download packet?  <Y>es, <N>o, or <G>oodbye when done?
  182.  
  183.                Answer YES, and JetMail will compress the message files into
  184.                a QWK packet for you to download using your selected
  185.  
  186.  
  187.           JetMail User's Guide                                       Page 3
  188.  
  189.  
  190.                transfer protocol.  Answer NO if you don't want to receive
  191.                this packet (if you answer NO, you return to the JetMail
  192.                Main Menu).  Answer GOODBYE for JetMail to logoff
  193.                automatically after the transfer is completed.
  194.  
  195.                You have the option to scan for new bulletins and new files. 
  196.                If you selected to scan for these items in your
  197.                configuration setup, then you will receive new bulletins and
  198.                a list of new files in your QWK also.
  199.  
  200.           <U>pload a Packet
  201.  
  202.                Allows you to upload a .REP packet prepared by your offline
  203.                mail reader.  JetMail will process the packet and post
  204.                messages (your replies) in the corresponding conferences.
  205.  
  206.           <P>ointers upload
  207.  
  208.                With each .QWK you download from JetMail is a pointers file,
  209.                designated with extension .PNT.  This contains the
  210.                conferences' last message read pointers right before you
  211.                downloaded that packet.  You can upload the .PNT file using
  212.                this command to reset the pointers to the way they were
  213.                before you downloaded the .QWK.  What this is used for is in
  214.                case you receive a corrupted Mail Packet, you can upload a
  215.                .PNT file from an older .QWK and reset your pointers for all
  216.                the conferences, much more conveniently than to reset
  217.                pointers for each conference one at a time.
  218.  
  219.           <Q>uit JetMail door
  220.  
  221.                Quit JetMail, and return to SPITFIRE.  If JetMail is being
  222.                run as a door, you will need to re-enter your password to
  223.                return to Spitfire; if JetMail is being run as a sysop
  224.                configured external command from one of the Spitfire main
  225.                menus, you'll return to Spitfire immediately.
  226.  
  227.           <G>oodbye (Logoff)
  228.  
  229.                Invokes automatic logoff from BBS.  JetMail gives you ten
  230.                seconds to abort the logoff.  Hit <ESC> to logoff
  231.                immediately.
  232.  
  233.           <X> Expert Mode Toggle
  234.  
  235.                Toggles on/off the JetMail menu screen.  Once you're
  236.                familiar with the JetMail commands, you can toggle off the
  237.                Main Menu when you open JetMail door to save you time.
  238.                JetMail now remembers your "expert mode" setting from
  239.                session to session.
  240.  
  241.           <?> Help
  242.  
  243.                Display online help file.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.           JetMail User's Guide                                       Page 4
  250.  
  251.  
  252.  
  253.           Selecting Conferences in JetMail
  254.  
  255.           This menu let's you select which conferences you wish to scan for
  256.           new messages to put in your .QWK packet.  It has some unique
  257.           features that differ from other QWK-type doors.
  258.  
  259.           Simply enter the number of the conference you wish to select (or
  260.           deselect) for scanning for new messages.  The sysop has two
  261.           options in conference selection:  he may force certain
  262.           conferences to be selected (perhaps to make sure you receive your
  263.           mail, or to promote a conference).  Forced conferences may not be
  264.           deselected. He may also setup a list of default conference
  265.           selection (perhaps as a suggested list of good conferences in
  266.           which to participate).
  267.  
  268.           There are four 'degrees' of scanning for new messages.  You can
  269.           scan for All new messages, scan for all new messages just
  270.           addressed to you and to All (called "YA", [for Y'all, southern
  271.           accent]), scan for all new messages just addressed to you [called
  272.           Only Yours], and scan for None in a conference [or 'deselect'].
  273.  
  274.           Some 'symbols' used by JetMail in Select Conferences menu:
  275.                !    Forced conference (you must read from this conference)
  276.                *    Scan for all new messages
  277.                %    Scan for messages to YOU and to ALL USERS
  278.                Y    Scan for only new messages addressed to you
  279.                ^    Conference only allows Public Only messages
  280.  
  281.           JetMail messages scan will only pick up public messages, and
  282.           private messages written from you or to you.  You have the option
  283.           of not scanning for messages written by you, which can be toggled
  284.           on/off in the User Configuration Setup ("C" from the main JetMail
  285.           Command prompt). The sysop, and users with sysop security level,
  286.           will receive all private messages.
  287.  
  288.           <S>et All - this selects all conferences.  It will set all
  289.           previously unselected conferences to receive ALL mail, and all
  290.           conferences previously selected for Only Your Mail to "YA" (to
  291.           you and to All) scan.
  292.  
  293.           <R>eset All - resets all previously selected conferences (to
  294.           None).
  295.  
  296.           <C>opy - copies the queue of conferences you selected from the
  297.           Spitfire Message Section into JetMail's selected conferences. 
  298.           This is available if you want to have the same conferences in
  299.           your Spitfire queue as your JetMail selection.
  300.  
  301.           <+> (or PgUp) advance screen to display next 40 conferences.
  302.  
  303.           <-> (or PgDn) scroll screen to display previous 40 conferences.
  304.  
  305.           <Q> returns to the main JetMail Command prompt.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.           JetMail User's Guide                                       Page 5
  312.  
  313.  
  314.  
  315.           JetMail Configuration Setup
  316.  
  317.           The "C" command from the JetMain Main Menu allows you to
  318.           customize the contents of your QWK packet for use with your
  319.           offline mail reader.  A brief explanation of the options
  320.           available are listed below:
  321.  
  322.           <1> Transfer Protocol
  323.  
  324.                You need to select a transfer protocol for JetMail to send a
  325.                .QWK mail packet to you, or for JetMail to receive a .REP
  326.                reply packet from you.  JetMail uses the same transfer
  327.                protocols as those available in Spitfire's external
  328.                protocols list.
  329.  
  330.           <2> Compression Format
  331.  
  332.                Multiple compression utilities may be supported by JetMail. 
  333.                Select the format that you prefer to use with your offline
  334.                mail reader from the list supported by this BBS.
  335.  
  336.           <3> Include Welcome Screen
  337.  
  338.                You can optionally receive the welcome screen from your BBS
  339.                in each mail packet.
  340.  
  341.           <4> Include Goodbye Screen
  342.  
  343.                You can optionally receive the goodbye screen from your BBS.
  344.  
  345.           <5> Include Messages From You
  346.  
  347.                You may skip messages that you wrote by setting this to NO,
  348.                to make your .QWK packet a little smaller.  Besides, you
  349.                probably know what you wrote already, so you can keep
  350.                redundancy down.
  351.  
  352.           <6> Include New Bulletins
  353.  
  354.                JetMail can let you download bulletins updated since the
  355.                last time you used JetMail.  JetMail can scan for all new
  356.                bulletins and put them in your .QWK packet, or scan for
  357.                bulletins updated in the first ten bulletins (in case you
  358.                have games bulletins which are updated daily and you aren't
  359.                interested in).
  360.  
  361.           <7> Include New Files
  362.  
  363.                JetMail can scan for new files in the Files Section and
  364.                include it in your .QWK mail packet.  If you want to scan
  365.                for new files, you can scan all directories or just one
  366.                directory (like the upload directory; this will keep
  367.                scanning time short).
  368.  
  369.           <8> Maximum Number of Messages
  370.  
  371.  
  372.  
  373.           JetMail User's Guide                                       Page 6
  374.  
  375.  
  376.                This parameter limits the number of messages per .QWK
  377.                packet. You may want to set a limit to make sure your
  378.                offline reader is able to handle the mail packet, or to keep
  379.                a .QWK size is manageable. 
  380.  
  381.           <9> Maximum Messages Per Conference
  382.  
  383.                JetMail by default limits the number of messages per
  384.                conference to 200, because this is a general limitation of
  385.                some offline readers.  However, if you are using a QWK
  386.                reader that is able to process more than 200 messages per
  387.                conference, adjust this parameter appropriately.
  388.  
  389.           <A> Include .NDX Files
  390.  
  391.                Some readers may be able to generate its own index files. 
  392.                You may toggle this flag off to make your .QWK packets a
  393.                little smaller, and JetMail can scan for new messages a
  394.                little faster.
  395.  
  396.           <B> Include User Information
  397.  
  398.                Some .QWK mail readers support a User Statistics screen,
  399.                which contains information of your BBS activities (like how
  400.                many downloads you've made, last login, etc.).  You may
  401.                toggle this option to YES to have JetMail generate this
  402.                information in your .QWK.  Your user information will be
  403.                included in the next (and subsequent) JetMail sessions.
  404.  
  405.  
  406.           Offline Configuration
  407.  
  408.           JetMail supports offline configuration, where you can add or
  409.           delete conferences from your offline mail reader.  Some offline
  410.           readers have support for offline configuration, usually from a
  411.           conference listing.  In the conference listing, you can hit "A"
  412.           to add a conference or "D" to drop a conference, which generates
  413.           a message to MARKMAIL or QMAIL or JETMAIL with the subject line
  414.           of ADD, DROP, or RESET.  JetMail does support this type of
  415.           configuration for your convenience.  Some readers that support
  416.           offline configuration of this format include:  SLMR, OLX,
  417.           MarkMail, MegaMail Reader 2.10, and EZ-Reader.
  418.  
  419.           However, there is another format for offline configuration
  420.           messages, which is the preferred method for JetMail offline
  421.           configuration.  Simply write a message addressed to JETMAIL and
  422.           enter CONFIG in the Subject field:
  423.  
  424.           ------------------------
  425.                TO: JETMAIL
  426.              FROM: YOUR NAME
  427.           SUBJECT: CONFIG
  428.           ------------------------
  429.  
  430.           Then in the body of the message, enter one of the following
  431.           commands, one per line:
  432.  
  433.  
  434.  
  435.           JetMail User's Guide                                       Page 7
  436.  
  437.  
  438.           ADD conf
  439.                     CONF is the conference number you wish to add to your
  440.                     selected conferences queue.
  441.  
  442.           DROP conf
  443.                     CONF is the conference number you wish to drop from
  444.                     your selected conferences queue.
  445.  
  446.           RESET conf num
  447.                     CONF is the conference number you wish to reset your
  448.                     last message read pointer.  NUM is the message number
  449.                     you wish to reset the conference to.  You may use a
  450.                     negative number for NUM, which JetMail will
  451.                     automatically calculate from the end of the message
  452.                     base: so if NUM is -25, JetMail will place the pointer
  453.                     25 from the high message number of the conference,
  454.                     resulting your receiving the last 25 messages of the
  455.                     conference.
  456.  
  457.           BLTS ON|OFF
  458.                     For BLTS ON, JetMail will scan for new bulletins and
  459.                     put them in the QWK packet.  BLTS OFF turns off new
  460.                     bulletins scan.
  461.  
  462.           FILES ON|OFF
  463.                     For FILES ON, JetMail will scan for new files and put a
  464.                     list of the new files in subsequent QWK packets.  FILES
  465.                     OFF turns off new files scan.
  466.  
  467.           MAXNUMBER number
  468.                     If NUMBER is 0, JetMail will scan for an unlimited
  469.                     number of new messages.  Otherwise, NUMBER specifies
  470.                     the maximum number of messages to include in subsequent
  471.                     QWK packets.
  472.  
  473.  
  474.           Conclusive Notes
  475.  
  476.           This concludes the JetMail User's Guide.  I hope you will enjoy
  477.           using JetMail with Spitfire.  
  478.  
  479.           Many reader programs are shareware, so be sure you try out a
  480.           couple of different ones to find one with which you are most
  481.           comfortable.  Don't settle for second best.  Then again, you
  482.           might have difficulty locating several different readers, or have
  483.           trouble switching between different readers because they're all
  484.           so different, or just don't have the time to experiment.  In that
  485.           case, you can stick with the first QWK reader you find, and that
  486.           is okay too.
  487.  
  488.           Should you have any questions or comments on JetMail, feel free
  489.           to pass them along to me via your Spitfire sysop.  Also, I will
  490.           monitor the Spitfire conferences on RIME and Intelec networks, if
  491.           you would be interested in conversing with me directly.
  492.  
  493.           Thank you for using JetMail!
  494.           DJ Chuang, JetMail author
  495.  
  496.  
  497.           JetMail User's Guide                                       Page 8