home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 67.img / PUMA100.ZIP / PUMA.DOC < prev    next >
Text File  |  1990-01-13  |  77KB  |  2,311 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                              The Puma Protocol(TM) v1.00
  17.  
  18.                                     User's Manual
  19.  
  20.                          Copyright (C)1990 by Matthew Thomas
  21.                                  All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.          The Puma Protocol(TM) v1.00                          User's Manual
  70.  
  71.  
  72.  
  73.          T a b l e   o f    C o n t e n t s
  74.          __________________________________________________________________
  75.  
  76.  
  77.          1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 1
  78.              Features. . . . . . . . . . . . . . . . . . . . . . . . . . 1
  79.              Licensing . . . . . . . . . . . . . . . . . . . . . . . . . 1
  80.              Customer Support. . . . . . . . . . . . . . . . . . . . . . 2
  81.  
  82.          2. Getting Started. . . . . . . . . . . . . . . . . . . . . . . 3
  83.              The Help Screen . . . . . . . . . . . . . . . . . . . . . . 3
  84.              The Setup Program . . . . . . . . . . . . . . . . . . . . . 3
  85.  
  86.          3. The Puma Program . . . . . . . . . . . . . . . . . . . . . . 4
  87.              Running Puma. . . . . . . . . . . . . . . . . . . . . . . . 4
  88.              Program Options . . . . . . . . . . . . . . . . . . . . . . 4
  89.                A+/-  Delete aborted downloads. . . . . . . . . . . . . . 5
  90.                B+/-  Beep upon completion. . . . . . . . . . . . . . . . 5
  91.                CDSx  Log to a CDS file . . . . . . . . . . . . . . . . . 5
  92.                D+/-  Stamp with current date . . . . . . . . . . . . . . 5
  93.                Ex    Effective baud rate . . . . . . . . . . . . . . . . 6
  94.                F+/-  Enable 16550A FIFO buffers. . . . . . . . . . . . . 6
  95.                HF    Handshake fast. . . . . . . . . . . . . . . . . . . 7
  96.                HD    Handshake on disk writes. . . . . . . . . . . . . . 7
  97.                HN    No handshaking. . . . . . . . . . . . . . . . . . . 8
  98.                HS    Handshake slow. . . . . . . . . . . . . . . . . . . 8
  99.                Lx    Log to a DSZ file . . . . . . . . . . . . . . . . . 8
  100.                N+/-  monitor the carrier signal. . . . . . . . . . . . . 9
  101.                O+/-  allow overwriting received files. . . . . . . . . . 9
  102.                Px    COM port number . . . . . . . . . . . . . . . . . . 9
  103.                R+/-  allow resumed transfers . . . . . . . . . . . . . . 9
  104.                Sx    UART baud rate. . . . . . . . . . . . . . . . . . . 10
  105.                M+/-  Hangup modem when finished. . . . . . . . . . . . . 10
  106.                W+/-  Wait for keystroke when finished. . . . . . . . . . 10
  107.                X+/-  Enable RLE compression. . . . . . . . . . . . . . . 10
  108.              Sender File Specifications. . . . . . . . . . . . . . . . . 11
  109.              Receiver File Specifications. . . . . . . . . . . . . . . . 12
  110.              Exit Codes. . . . . . . . . . . . . . . . . . . . . . . . . 12
  111.              Examples. . . . . . . . . . . . . . . . . . . . . . . . . . 13
  112.  
  113.          4. The Puma Display . . . . . . . . . . . . . . . . . . . . . . 14
  114.              Screen Access . . . . . . . . . . . . . . . . . . . . . . . 14
  115.              Colors. . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  116.              The Help Screen . . . . . . . . . . . . . . . . . . . . . . 14
  117.              Batch Status. . . . . . . . . . . . . . . . . . . . . . . . 15
  118.              Current File Status . . . . . . . . . . . . . . . . . . . . 15
  119.              Throughput Efficiency . . . . . . . . . . . . . . . . . . . 15
  120.              UART. . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  121.              Stats . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  122.              Display Footer. . . . . . . . . . . . . . . . . . . . . . . 17
  123.              Messages. . . . . . . . . . . . . . . . . . . . . . . . . . 17
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.          The Puma Protocol(TM) v1.00                          User's Manual
  136.  
  137.  
  138.  
  139.          5. The Setup Program. . . . . . . . . . . . . . . . . . . . . . 21
  140.              Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . 21
  141.              Change Default Options. . . . . . . . . . . . . . . . . . . 21
  142.              Adjust Screen Colors. . . . . . . . . . . . . . . . . . . . 22
  143.              Install Registration Information. . . . . . . . . . . . . . 22
  144.              Quit and Save Settings. . . . . . . . . . . . . . . . . . . 23
  145.  
  146.          6. Acknowledgments. . . . . . . . . . . . . . . . . . . . . . . 24
  147.              Inside. . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  148.              Outside . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  149.              Trademarks and Products . . . . . . . . . . . . . . . . . . 25
  150.  
  151.  
  152.                                    Appendices
  153.  
  154.          A. Log File Formats . . . . . . . . . . . . . . . . . . . . . . 26
  155.              Enhanced DSZ Log Format . . . . . . . . . . . . . . . . . . 26
  156.              CDS Log Format. . . . . . . . . . . . . . . . . . . . . . . 26
  157.  
  158.          B. Benchmarks . . . . . . . . . . . . . . . . . . . . . . . . . 29
  159.  
  160.          C. Puma Auto-Start Receive. . . . . . . . . . . . . . . . . . . 31
  161.  
  162.          D. Suggested Reading. . . . . . . . . . . . . . . . . . . . . . 32
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.          The Puma Protocol(TM) v1.00                          User's Manual
  202.  
  203.  
  204.  
  205.          1  -  I n t r o d u c t i o n
  206.          __________________________________________________________________
  207.  
  208.  
  209.                                       FEATURES
  210.  
  211.          The Puma Protocol(TM) is a powerful tool for getting your data
  212.          from one place to another through a serial link.  Whether
  213.          downloading or uploading files to and from a bulletin board
  214.          system, or moving files between PC compatible computers over a
  215.          serial cable without a modem, you will find that Puma will do the
  216.          job, and will do it quickly and accurately.
  217.  
  218.          Puma offers many advanced features:
  219.  
  220.            ■ Full color screen display of transfer status.
  221.            ■ Standalone setup program for changing default options,
  222.              configuring screen colors, and installing registration
  223.              information.
  224.            ■ UART (serial port) baud rates up to 115200 bps.
  225.            ■ Auto-sensing of 8250, 16450, 16550, and 16550A UARTs.  Full
  226.              support for 16550A FIFO buffers.
  227.            ■ The ability to use COM ports 1 through 4, with each port's IRQ
  228.              and base I/O address fully configurable.
  229.            ■ Call Data Standard (CDS) logging of file transfers.
  230.            ■ Enhanced DSZ compatible logging of file transfers.
  231.            ■ All screen operations use direct video memory access, or
  232.              DESQview, TaskView, OmniView, TopView, Microsoft Windows, and
  233.              IBM 3270 PC multi-tasking video buffers (MTVB), if present.
  234.            ■ Optional auto-start of Puma receiver.
  235.            ■ Optional data compression on a block level using RLE
  236.              techniques.
  237.            ■ Fast and reliable recovery from line and data errors.
  238.            ■ Dynamic block scaling for optimal data throughput.
  239.            ■ Up to 99 files transferred in a batch.
  240.            ■ and many more features...
  241.  
  242.  
  243.                                       LICENSING
  244.  
  245.          The Puma Protocol and its accompanying documentation have been
  246.          released as Shareware.  This gives you the chance to experience
  247.          the performance of the software for a 30 day evaluation period.
  248.          If you continue to use Puma beyond this period, you are required
  249.          to register.  Information on becoming a registered user of the
  250.          Puma Protocol can be found in the file LICENSE.TXT.
  251.  
  252.          The author specifically disclaims all warranties, expressed
  253.          or implied, including but not limited to implied warranties of
  254.          merchantability and fitness for a particular purpose and the
  255.          program license granted herein in particular, and without limiting
  256.          operation of the program license with respect to any particular
  257.          application, use, or purpose.  In no event shall the author be
  258.          liable for any loss of profit, lost savings, commercial damage, or
  259.  
  260.  
  261.  
  262.                                                                 Page 1
  263.  
  264.  
  265.  
  266.  
  267.          The Puma Protocol(TM) v1.00                          User's Manual
  268.  
  269.  
  270.  
  271.          other incidental or consequential damages arising out of the use
  272.          or inability to use Puma even if the author, Matthew Thomas, or an
  273.          authorized distributor of the Puma Protocol has been advised of
  274.          the possibility of such damages, or for any claim by any other
  275.          party.
  276.  
  277.          This agreement shall be governed by the laws of the state of
  278.          Wisconsin.
  279.  
  280.  
  281.                                   CUSTOMER SUPPORT
  282.  
  283.          Full support to users of the Puma Protocol is available through
  284.          three channels.  To contact the author with questions,
  285.          suggestions, problems, or other comments,
  286.  
  287.            1) Call the PC Access BBS at (414) 634-5776, and send E-Mail to
  288.               Matt Thomas.  PC Access supports up to 2400 baud MNP modems.
  289.  
  290.                                          or
  291.  
  292.            2) Call the Exec-PC BBS at (414) 789-4210, and send E-Mail to
  293.               Matt Thomas.
  294.  
  295.                                          or
  296.  
  297.            3) Contact any bulletin board system that carries the MetroLink
  298.               Lynx/Puma conference.  Leave a message to Matt Thomas, and
  299.               make sure to echo the message when you send it.  Messages
  300.               left in this conference will reach the author through the
  301.               message network.
  302.  
  303.                                          or
  304.  
  305.            4) Drop a note via US Mail to:
  306.  
  307.                 Matt Thomas
  308.                 Lynx Development
  309.                 144 Westminster Square
  310.                 Racine, WI 53402
  311.  
  312.  
  313.          The author offers limited support to unregistered users of The
  314.          Puma Protocol, in order to help them get the program installed for
  315.          evaluation.  If you have a problem installing or using Puma, and
  316.          you have read this entire User's Manual (please do read the manual
  317.          before requesting help; many times problems can be cleared up by
  318.          finding the answer in the manual), then feel free to request help
  319.          through any of the channels mentioned above.  The author of Puma
  320.          will make an attempt to answer all mail received, but please be
  321.          aware that registered users have first priority for support.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                 Page 2
  329.  
  330.  
  331.  
  332.  
  333.          The Puma Protocol(TM) v1.00                          User's Manual
  334.  
  335.  
  336.  
  337.          2 - G e t t i n g   S t a r t e d
  338.          __________________________________________________________________
  339.  
  340.  
  341.          For experienced users who wish to get a quick start using the Puma
  342.          Protocol, this brief chapter has been included to help you along.
  343.          For a complete explanation of how to use Puma and the Puma setup
  344.          program, continue reading beyond this chapter.
  345.  
  346.  
  347.                                    THE HELP SCREEN
  348.  
  349.          When you run Puma the first time, try executing PUMA.EXE
  350.          without parameters.  You will see a screen full of information
  351.          about command line options.  This screen is your "quick reference"
  352.          card, so to speak.  It will help you to get Puma running if you
  353.          choose not to read the rest of the documentation right away.
  354.  
  355.  
  356.                                   THE SETUP PROGRAM
  357.  
  358.          Also included with Puma is a file called PUMASET.EXE.  This
  359.          program allows you to change Puma's default options and screen
  360.          colors, and to enter registration information.
  361.  
  362.          In order for the setup program to operate, you must be logged to
  363.          the drive and directory containing the PUMA.EXE file (the Puma
  364.          Protocol program).  Type PUMA, and press enter.  If the setup
  365.          program cannot read the PUMA.EXE file in the current directory, or
  366.          the file has been corrupted, you will be alerted.
  367.  
  368.          Much of the setup program is self-explanatory, but a few things
  369.          might not be obvious without some explanation:
  370.  
  371.            ■ When choosing a baud rate for the UART, the value of "Current"
  372.              will cause Puma to sense and use the current baud rate of the
  373.              UART when PUMA.EXE is executed.
  374.  
  375.            ■ When choosing an "effective" baud rate, the value of "UART"
  376.              will cause Puma to use the UART baud rate (whether specified
  377.              or auto-sensed) as the "effective" baud rate.
  378.  
  379.            ■ In the "Adjust screen colors" mode, pressing the M key will
  380.              cause the color scheme to change to monochrome.  If you use a
  381.              monochrome monitor, you may wish to use this option
  382.              immediately upon entering the color set screen.  To return to
  383.              the default color set, press the C key.  Note that both of
  384.              these keys will destroy any changes you have made to the color
  385.              set before saving!
  386.  
  387.            ■ In the "Change default options" screen, the options that you
  388.              choose will be written to the PUMA.EXE file as defaults.  When
  389.              running Puma, you may override any of these defaults by using
  390.              command line parameters, detailed in Chapter 3.
  391.  
  392.  
  393.  
  394.                                                                 Page 3
  395.  
  396.  
  397.  
  398.  
  399.          The Puma Protocol(TM) v1.00                          User's Manual
  400.  
  401.  
  402.  
  403.          3 - T h e   P u m a   P r o g r a m
  404.          __________________________________________________________________
  405.  
  406.  
  407.          This chapter will familiarize you with the Puma Protocol, and its
  408.          features and command line parameters.
  409.  
  410.  
  411.                                     RUNNING PUMA
  412.  
  413.          To load and run the Puma program, a command line must be given.
  414.          This command line can come from the keyboard, at the MS-DOS
  415.          prompt, from a batch file, or from a calling program, such as a
  416.          BBS, which loads Puma directly without using the DOS command.com
  417.          program.
  418.  
  419.          This command line has a specific syntax.  Here are the three
  420.          general formats for the Puma command line:
  421.  
  422.            puma [options] s filespec [filespec] [filespec] [...]
  423.            puma [options] s @listfile
  424.            puma [options] r [path]
  425.  
  426.          Anything appearing in square brackets is optional, and may not
  427.          need to be specified for proper operation of Puma.
  428.  
  429.          Note that Puma completely ignores the "case" of the command line,
  430.          which means that both upper- and lowercase characters may be mixed
  431.          in any combination.
  432.  
  433.          The word "puma" at the beginning of each command line is required
  434.          in all cases.  This is what tells MS-DOS to load the PUMA.EXE
  435.          program file.
  436.  
  437.          The "options" are outlined below, in the "Program Options"
  438.          section.
  439.  
  440.          The "s" and "r" letters, which follow the options, are required on
  441.          the command line.  The letter "s" tells Puma to send files to
  442.          another computer, while "r" tells Puma to receive files from
  443.          another computer.
  444.  
  445.          The "filespec", "@listfile", and "path" portions of the command
  446.          lines are described below, in the sections entitled "Sender File
  447.          Specifications" and "Receiver File Specifications".
  448.  
  449.  
  450.                                    PROGRAM OPTIONS
  451.  
  452.          The Puma Protocol offers a number of features and settings.  This
  453.          section will explain each command line option, and how each
  454.          affects Puma operation.  Note that a plus (+) in the syntax
  455.          enables an option, while a minus (-) disables it.
  456.  
  457.  
  458.  
  459.  
  460.                                                                 Page 4
  461.  
  462.  
  463.  
  464.  
  465.          The Puma Protocol(TM) v1.00                          User's Manual
  466.  
  467.  
  468.  
  469.          Following is a description of each option:
  470.  
  471.          ------------------------------------
  472.          A+ or A-  (delete aborted downloads)
  473.          ------------------------------------
  474.          If enabled (A+), this setting will cause Puma to delete the
  475.          transferred portion of any files that were not fully received.
  476.  
  477.          If disabled (A-), this setting will cause Puma to leave any
  478.          partially received files on the disk.  This gives the user the
  479.          option of continuing the transfer later, by using the "Allow
  480.          Resumed Transfers" option.
  481.  
  482.          Note:  This parameter has no effect when used in the Puma send
  483.                 mode.
  484.  
  485.  
  486.          --------------------------------
  487.          B+ or B-  (beep upon completion)
  488.          --------------------------------
  489.          Enabling this setting causes Puma to emit a series of beeps to
  490.          alert the user when a transfer is finished.  The beeper will sound
  491.          regardless of whether the transfer was a success.
  492.  
  493.          Disabling this setting causes Puma to remain silent at all times.
  494.  
  495.  
  496.          -------------------------
  497.          CDSx  (log to a CDS file)
  498.          -------------------------
  499.          This option allows the user to specify a log file where Puma will
  500.          create a CDS log entry for each file transferred.  You may replace
  501.          "x" with any valid DOS drive:\path\file combination.  If only
  502.          "CDS" is specified, with no value for "x", a CDS log entry will
  503.          not be written to any file.  For example, the following command
  504.          line will receive files, and each will be logged using CDS to the
  505.          file "c:\logs\pumalog":
  506.  
  507.             puma CDSc:\logs\pumalog r
  508.  
  509.          Whereas, the following receiver command line will not log the
  510.          files in CDS format:
  511.  
  512.             puma CDS r
  513.  
  514.          For information on the CDS log format, see Appendix A, "Log File
  515.          Formats".
  516.  
  517.  
  518.          -----------------------------------
  519.          D+ or D-  (stamp with current date)
  520.          -----------------------------------
  521.          This setting, when enabled, will cause Puma to stamp each received
  522.          file with the current time and date of the transfer.
  523.  
  524.  
  525.  
  526.                                                                 Page 5
  527.  
  528.  
  529.  
  530.  
  531.          The Puma Protocol(TM) v1.00                          User's Manual
  532.  
  533.  
  534.  
  535.          When this setting is disabled, Puma will stamp the file with the
  536.          original time and date that are passed in a header packet at the
  537.          beginning of each file transfer.
  538.  
  539.          This is a useful setting for BBS SysOps who wish to date-stamp
  540.          their files according to when they were uploaded.
  541.  
  542.          Note:  The D+/- option has no effect when used in the Puma send
  543.                 mode.
  544.  
  545.  
  546.          -------------------------
  547.          Ex  (effective baud rate)
  548.          -------------------------
  549.          When using this option, the "x" may be replaced by a numeric value
  550.          between 0 and 115200, inclusive.  A non-zero value will adjust the
  551.          effective baud rate to the specified value.  A value of zero will
  552.          cause Puma to set the effective baud rate to the same value as the
  553.          UART baud rate.  See the section below entitled, "Sx (UART baud
  554.          rate)" for information on UART baud rates.
  555.  
  556.          * * * * * * * * * * * Effective Baud Rates  * * * * * * * * * * *
  557.          Typically, the baud rate of the UART (serial port) is displayed
  558.          and logged by communications programs as the baud rate used during
  559.          the session.  However, many modems communicate with the computer
  560.          at one baud rate, while communicating over the phone line at a
  561.          different baud rate.
  562.          For example, the USRobotics Courier 14400 HST modem can
  563.          communicate with another Courier HST modem at an effective baud
  564.          rate of 14400 bits per second.  However, the modem is actually
  565.          communicating with the UART at 19200 bps.
  566.  
  567.          Because of this difference in UART baud rate and effective baud
  568.          rate, Puma allows each to be specified separately.  Puma will use
  569.          the effective baud rate to calculate estimated transfer times and
  570.          efficiency percentages which are displayed during a transfer.
  571.          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  572.  
  573.  
  574.          --------------------------------------
  575.          F+ or F-  (enable 16550A FIFO buffers)
  576.          --------------------------------------
  577.          This option is only effective when the COM port in use has a
  578.          16550A UART installed.  When enabled, this setting allows Puma to
  579.          enable the FIFO buffers on the 16550A, and to use them during the
  580.          transfer.  When this setting is disabled, the FIFO buffers will be
  581.          disabled during the transfer.
  582.  
  583.          Puma will always return the UART to the state it was in when Puma
  584.          began.
  585.  
  586.          In almost all cases, this setting should remain enabled.  The
  587.          disable option is provided for users who wish to emulate the 16450
  588.          UART with a 16550A UART during Puma transfers.
  589.  
  590.  
  591.  
  592.                                                                 Page 6
  593.  
  594.  
  595.  
  596.  
  597.          The Puma Protocol(TM) v1.00                          User's Manual
  598.  
  599.  
  600.  
  601.          --------------------
  602.          HF  (handshake fast)
  603.          --------------------
  604.          This setting enables fast hardware handshaking during Puma file
  605.          transfers.
  606.  
  607.          If you are unsure whether to use hardware handshaking, it is a
  608.          good idea to consult your modem manual.  Most 300, 1200, and 2400
  609.          baud modems do not use hardware handshaking.  However, MNP modems
  610.          do, as do high-speed modems, such as the USR Courier 14400 HST,
  611.          and the USR HST/Dual Standard.
  612.  
  613.          When using Puma to transfer files over a direct-connect link
  614.          between two computers, hardware handshaking may not be necessary,
  615.          but should be enabled in case one computer sends faster than the
  616.          other can receive.
  617.  
  618.          * * * * * * * * * * * Hardware Handshaking * * * * * * * * * * *
  619.          Hardware handshaking uses two pins on the serial port, called CTS
  620.          (an input), and RTS (an output) to arbitrate data flow to and from
  621.          the serial port.
  622.  
  623.          The rules of CTS/RTS handshaking are fairly easy to understand:
  624.  
  625.          1) Data may be sent to a serial port as long as the CTS line is
  626.             high.  If the CTS line goes low, the sender must stop
  627.             transmitting data until CTS again goes high.
  628.  
  629.          2) When ready to receive data, the receiver must raise the RTS
  630.             line.  If, at some point, the receiver cannot receive data, it
  631.             must lower the RTS line until data can be received again.
  632.          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  633.  
  634.  
  635.          ------------------------------
  636.          HD  (handshake on disk writes)
  637.          ------------------------------
  638.          This setting enables fast hardware handshaking and disk write
  639.          handshaking.
  640.  
  641.          Disk write handshaking causes Puma to lower the RTS line whenever
  642.          data is being written to disk.
  643.  
  644.          This setting is useful for computers that have BIOS or DOS disk
  645.          drivers that cause hardware interrupts to be disabled for extended
  646.          periods of time.  Puma can not read data from the UART while
  647.          interrupts are disabled.  As a result, it is not uncommon at baud
  648.          rates of 9600 or more, to get "overrun errors".  If the disk
  649.          drivers are the cause of this problem, then this setting will very
  650.          likely solve the problem.  If overrun errors are continually
  651.          occurring, you may need to use the HS parameter (detailed below).
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                                                 Page 7
  659.  
  660.  
  661.  
  662.  
  663.          The Puma Protocol(TM) v1.00                          User's Manual
  664.  
  665.  
  666.  
  667.          Note:  The HD parameter is typically used by the receiver (where
  668.                 disk writes occur).  However, the sender may use this
  669.                 setting to force the receiver (on the other end) to use
  670.                 disk write handshaking.
  671.  
  672.  
  673.          --------------------
  674.          HN  (no handshaking)
  675.          --------------------
  676.          This option completely disables CTS/RTS handshaking.
  677.  
  678.  
  679.          --------------------
  680.          HS  (handshake slow)
  681.          --------------------
  682.          This setting enables slow hardware handshaking and disk write
  683.          handshaking.
  684.  
  685.          Slow handshaking is useful for receiving files on a computer that
  686.          is too slow to process received characters at the UART baud rate.
  687.          In this situation, the RTS line is toggled to pace the sender to a
  688.          speed suitable for the slow machine to process the data.
  689.  
  690.          If you are experiencing overrun errors while receiving files with
  691.          Puma, try using the HD parameter (detailed above), or the HS
  692.          parameter.  If the errors continue, another possible solution is
  693.          to install a 16550A UART in your serial port or internal modem.
  694.          Puma supports the 16550A UART's provisions for buffering received
  695.          data, which takes part of the load off of the CPU.
  696.  
  697.          Note:  The HS parameter is typically used by the receiver.
  698.                 However, the sender may use this setting to force the
  699.                 receiver (on the other end) to use slow handshaking.
  700.  
  701.  
  702.          -----------------------
  703.          Lx  (log to a DSZ file)
  704.          -----------------------
  705.          This option allows the user to specify a log file where Puma will
  706.          create a DSZ log entry for each file transferred.  You may replace
  707.          "x" with any valid DOS drive:\path\file combination.  If only "L"
  708.          is specified, with no value for "x", a DSZ log entry will not be
  709.          written to any file.  For example, the following command line will
  710.          receive files, and each will be logged using the DSZ format to the
  711.          file "c:\logs\pumalog":
  712.  
  713.             puma Lc:\logs\pumalog r
  714.  
  715.          Whereas, the following receiver command line will not log the
  716.          files in DSZ format:
  717.  
  718.             puma L r
  719.  
  720.          For information on the DSZ log format, see Appendix A.
  721.  
  722.  
  723.  
  724.                                                                 Page 8
  725.  
  726.  
  727.  
  728.  
  729.          The Puma Protocol(TM) v1.00                          User's Manual
  730.  
  731.  
  732.  
  733.          --------------------------------------
  734.          N+ or N-  (monitor the carrier signal)
  735.          --------------------------------------
  736.          This setting, when enabled, will cause Puma to end if the DCD
  737.          signal (carrier) is lost during a transfer.
  738.  
  739.          When this setting is disabled, Puma will ignore the state of the
  740.          DCD signal.
  741.  
  742.          Note:  BBS SysOps should enable this setting, so if a user drops
  743.                 carrier during a transfer, Puma will end, and control will
  744.                 be immediately restored to the BBS software.
  745.  
  746.  
  747.          --------------------------------------------
  748.          O+ or O-  (allow overwriting received files)
  749.          --------------------------------------------
  750.          This setting, when enabled, allows Puma to overwrite existing
  751.          files.  For example, if a file header is received for "foo.bar",
  752.          and a file of the same name already exists in the receive path,
  753.          Puma will delete the old file and write the new one under the same
  754.          name.
  755.  
  756.          If this setting is disabled, Puma will not allow a received file
  757.          to overwrite another file.
  758.  
  759.  
  760.          ---------------------
  761.          Px  (COM port number)
  762.          ---------------------
  763.          This setting tells Puma which COM port to use.  The "x" may be
  764.          replaced by a value between 1 and 4, inclusive.  If the specified
  765.          COM port is not installed, Puma will not attempt to use it.  For
  766.          information on COM port configurations, see Chapter 5, "The Puma
  767.          Setup Program".
  768.  
  769.  
  770.          -----------------------------------
  771.          R+ or R-  (allow resumed transfers)
  772.          -----------------------------------
  773.          This setting, when enabled, allows the Puma receiver to request a
  774.          resumed transfer.  For example, if a file header is received for
  775.          "foo.bar", and a file of the same name already exists in the
  776.          receive path, Puma will check to see if it is shorter than the
  777.          expected length.  If it is, a resume request will be sent, which
  778.          will cause the transmitter to only send the remaining portion of
  779.          the file.  This feature is useful for recovering from a lost
  780.          carrier signal, or an abnormal amount of line noise.
  781.  
  782.          When this setting is disabled, Puma will not attempt to resume any
  783.          transfers.  In this case, if a header for an existing file is
  784.          received, Puma will check the "allow overwriting received files"
  785.          setting before writing the new file to disk.
  786.  
  787.  
  788.  
  789.  
  790.                                                                 Page 9
  791.  
  792.  
  793.  
  794.  
  795.          The Puma Protocol(TM) v1.00                          User's Manual
  796.  
  797.  
  798.  
  799.          --------------------
  800.          Sx  (UART baud rate)
  801.          --------------------
  802.          When using this option, the "x" may be replaced by a numeric value
  803.          between 0 and 115200, inclusive.  A non-zero value will adjust the
  804.          UART baud rate to the specified value.  A value of zero will cause
  805.          Puma to auto-detect and use the current UART baud rate when the
  806.          Puma program is executed.
  807.  
  808.          * * * * * * * * * * * * UART Baud Rates * * * * * * * * * * * * *
  809.          The UART is an integrated circuit that resides in a serial adaptor
  810.          card, internal modem, or sometimes on the motherboard of your
  811.          computer.  UART is an acronym for Universal Asynchronous Receiver-
  812.          Transmitter.  This is a complicated way of saying "serial port".
  813.          The serial port can communicate with external devices at various
  814.          speeds, or baud rates.  The UART baud rate setting of Puma adjusts
  815.          this speed.  If you're unsure about which value to use for the
  816.          UART baud rate, try using the auto-detect value (0).  You may wish
  817.          to consult your modem manual for more information about which baud
  818.          rates can be used to communicate with your modem.
  819.          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  820.  
  821.  
  822.          --------------------------------------
  823.          M+ or M-  (hangup modem when finished)
  824.          --------------------------------------
  825.          When this setting is enabled, Puma will lower the RTS and DTR
  826.          signals at the end of the session.  Most modems can be configured
  827.          to "hang up" when the DTR signal is lowered.
  828.  
  829.          When this setting is disabled, Puma will end with the RTS and DTR
  830.          signals set high.
  831.  
  832.  
  833.          --------------------------------------------
  834.          W+ or W-  (wait for keystroke when finished)
  835.          --------------------------------------------
  836.          This setting, when enabled, causes Puma to wait for a keystroke at
  837.          the end of a transfer before returning to DOS.  If this setting is
  838.          disabled, Puma will return control to DOS immediately after the
  839.          session ends.
  840.  
  841.  
  842.          ----------------------------------
  843.          X+ or X-  (enable RLE compression)
  844.          ----------------------------------
  845.          This setting, when enabled, allows Puma to use RLE compression
  846.          where possible when transferring data.
  847.  
  848.          If either end of the Puma connection (sender or receiver) disables
  849.          this parameter, RLE compression will not be used.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                                                Page 10
  857.  
  858.  
  859.  
  860.  
  861.          The Puma Protocol(TM) v1.00                          User's Manual
  862.  
  863.  
  864.  
  865.          * * * * * * * * * * * * * RLE Compression * * * * * * * * * * * *
  866.          Puma uses RLE compression techniques in an attempt to shorten
  867.          blocks of data before they are transferred.  Puma will never
  868.          transmit a compressed block of data unless the compressed block is
  869.          shorter than the original block.
  870.  
  871.          The compression routines in Puma are written in Turbo Assembler,
  872.          and are quite efficient.  However, at very high baud rates, when
  873.          transferring pre-compressed files (such as those created by PKZIP)
  874.          the overhead that is caused by Puma analyzing each block for
  875.          compressibility can slow throughput slightly (especially on slower
  876.          machines).  Therefore, RLE compression can be disabled to allow
  877.          for the greatest possible throughput on compressed files at high
  878.          baud rates.  Note that disabling RLE compression is typically only
  879.          beneficial at baud rates above 9600 baud.  Even most slow machines
  880.          are fast enough to analyze and output data with compression
  881.          enabled at baud rates up to 9600 baud very efficiently.
  882.          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  883.  
  884.  
  885.                              SENDER FILE SPECIFICATIONS
  886.  
  887.          This version of the Puma Protocol is capable of sending
  888.          up to 99 individual files in a single batch.  Each file which is
  889.          transmitted by Puma is preceded by a header packet which contains
  890.          the name of the file, its length, the original time and date
  891.          stamp, and other control information.  The receiver reads these
  892.          header packets to determine what the sender is transmitting.
  893.  
  894.          When invoking the sender command line, there are two distinct
  895.          syntaxes for specifying files to transmit:
  896.  
  897.            puma [options] s filespec [filespec] [filespec] [...]
  898.            puma [options] s @listfile
  899.  
  900.          In the first syntax, at least one file specification must be
  901.          placed on the command line.  Additional file specifications may be
  902.          placed after the first.  These file specifications may be actual
  903.          filenames, including drive letter, and sub-directories, or may
  904.          include wildcard characters (ie. *.*).  Puma will parse each
  905.          wildcard specification into individual file names.  If more than
  906.          99 files are specified, Puma will send the first 99 files found.
  907.  
  908.          In the second syntax, a single absolute file specification (no
  909.          wildcards) is specified on the Puma command line, immediately
  910.          preceded by the @ symbol.  Puma will read this file, expecting to
  911.          find that it contains a list of file specifications (which may
  912.          contain wildcard characters) each separated by CR/LF characters.
  913.          For example, for the command line,
  914.  
  915.            puma s @c:\file.lst
  916.  
  917.          A file named "file.lst" must be placed in the root directory of
  918.          drive C, which contains a list of file specifications to send.
  919.  
  920.  
  921.  
  922.                                                                Page 11
  923.  
  924.  
  925.  
  926.  
  927.          The Puma Protocol(TM) v1.00                          User's Manual
  928.  
  929.  
  930.  
  931.                             RECEIVER FILE SPECIFICATIONS
  932.  
  933.          When receiving files with Puma, the syntax for the command line is
  934.          as follows:
  935.  
  936.            puma [options] r [path]
  937.  
  938.          The "path" portion is optional, and may be any single
  939.          drive:\path\filename combination.
  940.  
  941.          The purpose of the "path" is to tell Puma where to place all the
  942.          files it receives.  If a file name is specified in the "path"
  943.          parameter, the file name portion will be ignored, because Puma
  944.          determines file names from the information packet it receives for
  945.          each file from the sender.  Therefore, when specifying only a path
  946.          (no filename), this parameter MUST end with a backslash character
  947.          (\).  For example, both of the following command lines are valid,
  948.          and will cause the same result:
  949.  
  950.            puma r c:\download\myfile.ext
  951.            puma r c:\download\
  952.  
  953.          Because the first command line has no terminating backslash on the
  954.          path parameter, the "myfile.ext" portion will be ignored, and all
  955.          received files will be placed in the "c:\download\" directory.
  956.  
  957.          Puma allows a file name to be specified only because certain
  958.          calling programs insist on passing it along with the receive path.
  959.  
  960.          If more than one path specification appears on the Puma command
  961.          line in receive mode, the first one following the "r" parameter
  962.          will be used.  The remainder of the command line will be ignored.
  963.  
  964.  
  965.                                      EXIT CODES
  966.  
  967.          When the Puma Protocol returns control to DOS at the end of a
  968.          transfer, it will return a DOS exit code to the calling program.
  969.          The following codes are returned by Puma:
  970.  
  971.            0  Transfer was completed successfully
  972.            1  Transfer began, but ended without completing
  973.            2  Session ended before transfer began
  974.            3  Puma detected invalid registration information
  975.            4  Puma was invoked without any command line parameters
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                                                Page 12
  989.  
  990.  
  991.  
  992.  
  993.          The Puma Protocol(TM) v1.00                          User's Manual
  994.  
  995.  
  996.  
  997.                                       EXAMPLES
  998.  
  999.          Following are some examples of command line syntaxes:
  1000.  
  1001.          puma s c:\file1.txt      (send a file using default options)
  1002.  
  1003.          puma hf s p1.exe p2.exe  (send two files, use fast handshaking)
  1004.  
  1005.          puma s d:\*.*            (send all files in root dir of d:)
  1006.  
  1007.          puma x+ s *.txt          (send text files, allow compression)
  1008.  
  1009.          puma x- s *.zip          (send ZIP files, don't try to compress)
  1010.  
  1011.          puma n- s @files.lst     (send files in a list, ignore carrier)
  1012.  
  1013.          puma s9600 e2400 s *.*   (send at 9600 bps, effective 2400 bps)
  1014.  
  1015.          puma p3 cdspuma.log r    (receive files from COM3, log with CDS)
  1016.  
  1017.          puma r c:\files\         (receive into "c:\files\" directory)
  1018.  
  1019.          puma r \                 (receive into root of current drive)
  1020.  
  1021.          puma a+ r                (receive files, delete aborted downloads)
  1022.  
  1023.          puma ldsz.log r          (receive with DSZ logging)
  1024.  
  1025.          puma r+ o+ r             (receive, allow resume and overwriting)
  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.                                                                Page 13
  1055.  
  1056.  
  1057.  
  1058.  
  1059.          The Puma Protocol(TM) v1.00                          User's Manual
  1060.  
  1061.  
  1062.  
  1063.          4 - T h e   P u m a   D i s p l a y
  1064.          __________________________________________________________________
  1065.  
  1066.  
  1067.          This chapter will familiarize you with the Puma display, and the
  1068.          meaning of each item shown during a Puma session.
  1069.  
  1070.  
  1071.                                     SCREEN ACCESS
  1072.  
  1073.          When Puma is executed, the first thing it does is to put up a full
  1074.          screen display.  If Puma is run under normal DOS conditions, all
  1075.          accesses to the screen will use direct memory access.  In other
  1076.          words, Puma will put updated screen information directly into the
  1077.          memory on board the resident display adaptor, bypassing the slow
  1078.          BIOS and DOS routines that are the alternatives to this technique.
  1079.  
  1080.          Since protocol programs are often used in multitasking
  1081.          environments, where direct video access can cause conflicts on a
  1082.          "shared" monitor, Puma offers an alternative.  When Puma is
  1083.          executed, the program checks for the presence of one of the
  1084.          following multitasking sub-systems:
  1085.  
  1086.                     DESQview    TaskView     OmniView     TopView
  1087.                           Microsoft Windows    IBM 3270 PC
  1088.  
  1089.          If one of these systems is active, and the Multitasking Video
  1090.          Buffers (MTVB) are enabled for the current process, Puma will
  1091.          direct all video access to the corresponding MTVB, instead of the
  1092.          physical memory on the display adaptor.  This technique allows for
  1093.          complete display compatibility with the above list of multitasking
  1094.          sub-systems.
  1095.  
  1096.  
  1097.                                        COLORS
  1098.  
  1099.          The color scheme of the Puma display can be easily customized for
  1100.          color or monochrome displays by using the Puma Setup program.  See
  1101.          Chapter 5, "The Setup Program", for more details.
  1102.  
  1103.  
  1104.                                    THE HELP SCREEN
  1105.  
  1106.          The help screen will appear when Puma is executed without any
  1107.          command line parameters.  It is always available for quick
  1108.          reference to command line syntaxes.  For detailed information
  1109.          about the options shown on the help screen, see Chapter 3, "The
  1110.          Puma Program".
  1111.  
  1112.  
  1113.                                      *    *    *
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                                                                Page 14
  1121.  
  1122.  
  1123.  
  1124.  
  1125.          The Puma Protocol(TM) v1.00                          User's Manual
  1126.  
  1127.  
  1128.  
  1129.          When Puma is executed with command line parameters, a status
  1130.          display will appear, filling the screen with information
  1131.          concerning the status of each transfer.
  1132.  
  1133.          The next few sections will explain the contents of each area of
  1134.          the display.
  1135.  
  1136.  
  1137.                                     BATCH STATUS
  1138.  
  1139.          This display area contains information on the entire batch
  1140.          transfer at hand.  On the left side of the Batch status window are
  1141.          totals for the batch, and an estimated time of transfer.  This is,
  1142.          as are all other estimates, based on the "effective baud rate",
  1143.          not the "UART baud rate".  See Chapter 3, "The Puma Program", for
  1144.          more information on baud rates.
  1145.  
  1146.          On the right side of the window are current values for the
  1147.          progress of the batch.  The Batch progress meter at the bottom
  1148.          reflects the percentage of completion for the entire batch.
  1149.  
  1150.  
  1151.                                  CURRENT FILE STATUS
  1152.  
  1153.          This display window contains information on the file which is
  1154.          currently being transferred.  Of particular interest in this
  1155.          window is the "Last message" item.  This is where all verbal
  1156.          messages are shown regarding Puma status.  Message descriptions
  1157.          are discussed below, in the section entitled, "Messages".
  1158.  
  1159.  
  1160.                                 THROUGHPUT EFFICIENCY
  1161.  
  1162.          This window shows information concerning the estimated efficiency
  1163.          of the file transfer in progress.  The "Compression" item shows
  1164.          "RLE" if the current block of data is compressed, or "none" if it
  1165.          is a normal block of data.  This item may also show "disabled" if
  1166.          either end of the connection has specified the "X-" option on the
  1167.          command line, or disabled RLE compression using the setup program.
  1168.  
  1169.          The "Block size" meter reflects the length of the current block,
  1170.          from 64 bytes to 1024 (1K) bytes.
  1171.  
  1172.          Also shown in this window are average speed in characters per
  1173.          second, and an estimated efficiency in percentage of theoretical
  1174.          "maximum" efficiency.
  1175.  
  1176.  
  1177.                                         UART
  1178.  
  1179.          The UART status, or "modem light" display, gives the status of the
  1180.          signals that Puma uses on the serial port.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                                                                Page 15
  1187.  
  1188.  
  1189.  
  1190.  
  1191.          The Puma Protocol(TM) v1.00                          User's Manual
  1192.  
  1193.  
  1194.  
  1195.          At the top of the UART window is shown the type of UART that is
  1196.          installed in the COM port that Puma is using.  The recognized
  1197.          UARTs are:
  1198.  
  1199.            8250B  (INS8250 or INS8250-B)
  1200.            16450  (NS16450, NS16C450, NS8250A, or INS82C50A)
  1201.            16550  (NS16550)
  1202.            16550A (NS16550A, NS16550AF)
  1203.  
  1204.          Puma will optionally use FIFO buffers, if the "enable 16550A FIFO
  1205.          buffers" option is enabled, and the UART type is 16550A.
  1206.          See Chapter 3, "The Puma Program", for more information on using
  1207.          the FIFO buffers.
  1208.  
  1209.          The remainder of the UART display shows the status of the transmit
  1210.          line (TXD), the receive line (RXD), the carrier detect line (DCD),
  1211.          the clear to send line (CTS), and the request to send line (RTS).
  1212.          The indicator next to each item will light when the corresponding
  1213.          signal is high or active.
  1214.  
  1215.  
  1216.                                         STATS
  1217.  
  1218.          The stats window shows some miscellaneous information about
  1219.          options.  The indicator beside each item will normally be lit if
  1220.          the item is enabled, unless otherwise noted.  Following is a brief
  1221.          description of each item:
  1222.  
  1223.          Beep - status of the "beep upon completion (B+/-)" option.
  1224.  
  1225.          Date - status of the "stamp with current date (D+/-)" option.
  1226.  
  1227.          DCD  - status of the "monitor the carrier signal (N+/-)" option.
  1228.  
  1229.          Dele - status of the "delete aborted downloads (A+/-)" option.
  1230.  
  1231.          Hang - status of the "hangup modem when finished (M+/-)" option.
  1232.  
  1233.          FIFO - this indicator will be lit when FIFO buffers are used.
  1234.  
  1235.          Over - this indicator will be lit when the "allow overwriting
  1236.                 received files (O+/-)" option is enabled.  If the Puma
  1237.                 receiver actually overwrites a file, this indicator will
  1238.                 blink for the remainder of the transfer of that particular
  1239.                 file.
  1240.  
  1241.          Resu - this indicator will be lit when the "allow resumed
  1242.                 transfers (R+/-)" option is enabled.  If the Puma receiver
  1243.                 actually resumes a file, this indicator will blink for the
  1244.                 remainder of the transfer of that particular file.
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.                                                                Page 16
  1253.  
  1254.  
  1255.  
  1256.  
  1257.          The Puma Protocol(TM) v1.00                          User's Manual
  1258.  
  1259.  
  1260.  
  1261.          Virt - this indicator will be lit if Puma is using an MTVB
  1262.                 (virtual screen) for display access.  For more information
  1263.                 on this item, see the section entitled, "Screen Access"
  1264.                 near the beginning of this chapter.
  1265.  
  1266.          Wait - status of the "wait for keystroke when finished
  1267.                 (W+/-)" option.
  1268.  
  1269.  
  1270.                                    DISPLAY FOOTER
  1271.  
  1272.          The footer line of the Puma display indicates miscellaneous items
  1273.          of interest.  We'll cover them from left to right, as displayed on
  1274.          the screen:
  1275.  
  1276.          The far left section will contain "S" or "R", to indicate send or
  1277.          receive mode.
  1278.  
  1279.          Next is the COM port which Puma is using.
  1280.  
  1281.          The following two items are UART baud rate, labeled Ubps, and
  1282.          effective baud rate, labeled Ebps.  These values are shown in bits
  1283.          per second.
  1284.  
  1285.          Next is the handshaking indicator.  This will show the type of
  1286.          handshaking in use:
  1287.  
  1288.            N = None
  1289.            S = handshake slow
  1290.            D = handshake disk
  1291.            F = handshake fast
  1292.  
  1293.          Finally, on the far right, is the version number and User ID of
  1294.          the remote Puma Protocol driver.  This item will show "unknown"
  1295.          until synchronization has been established with the remote
  1296.          protocol.
  1297.  
  1298.  
  1299.                                       MESSAGES
  1300.  
  1301.          There are a number of messages which may be conveyed to the user
  1302.          by the Puma Protocol.  This section gives the most important
  1303.          messages and their meanings:
  1304.  
  1305.          SYNCHRONIZING
  1306.            Puma is attempting to communicate control information with the
  1307.            connecting protocol.  This occurs at the beginning of each file
  1308.            being transferred.
  1309.  
  1310.          SYNCHRONIZATION FAILED
  1311.            Puma was unable to synchronize with the connecting protocol.
  1312.  
  1313.          SENDING/RECEIVING FILE
  1314.            Puma is synchronized and has begun the file transfer.
  1315.  
  1316.  
  1317.  
  1318.                                                                Page 17
  1319.  
  1320.  
  1321.  
  1322.  
  1323.          The Puma Protocol(TM) v1.00                          User's Manual
  1324.  
  1325.  
  1326.  
  1327.          filename.ext DONE
  1328.            Transfer of "filename.ext" has completed successfully.
  1329.  
  1330.          filename.ext DELETED
  1331.            The partially received file, "filename.ext" has been deleted.
  1332.            This will only occur if the "delete aborted downloads" option is
  1333.            enabled.
  1334.  
  1335.          ERROR WRITING CDS/DSZ LOG FILE
  1336.            Puma had problems writing to a log file.
  1337.  
  1338.          ERROR AT BYTE xxxx: errortype
  1339.            This message indicates that Puma is attempting to recover from
  1340.            some type of line error.  The value of xxxx shows the byte
  1341.            position in the current file where the error occurred.  The
  1342.            errortype indicates what caused the error.  There are seven
  1343.            causes for line errors:
  1344.  
  1345.              CRC       - Puma detected an error when comparing CRCs.  This
  1346.                          is usually causes by line noise on a bad
  1347.                          connection.
  1348.  
  1349.              Long      - The Puma receiver received a block longer than 1K
  1350.                          in length.  This is typically a result of line
  1351.                          noise "adding" spurious garbage characters into
  1352.                          the bit stream.
  1353.  
  1354.              Short     - The Puma receiver got a partial block, which was
  1355.                          not complete.
  1356.  
  1357.              Duplicate - The Puma receiver received a block of data that
  1358.                          had already been received successfully.
  1359.  
  1360.              Waiting -   The Puma receiver is waiting for the next logical
  1361.                          block in the sequence.
  1362.  
  1363.              Timeout -   The receiver has not received a block of data
  1364.                          within a reasonable time frame.
  1365.  
  1366.              Overrun -   The Puma receiver has experienced a UART buffer
  1367.                          overrun error.  This is usually caused by slow
  1368.                          receiver CPU's at high baud rates, slow disk BIOS
  1369.                          or drivers, or multitasking receiving computers
  1370.                          without a 16550A UART.  For information on
  1371.                          correcting this problem, see Chapter 3.
  1372.  
  1373.          ERROR READING FILE: filename.ext
  1374.            The Puma sender could not read the current file from disk.
  1375.  
  1376.          CANCELLED BY SENDER/RECEIVER
  1377.            The transfer was cancelled by the other end of the connection.
  1378.  
  1379.          CANCELLED
  1380.            The transfer has been cancelled locally by pressing the ESC key.
  1381.  
  1382.  
  1383.  
  1384.                                                                Page 18
  1385.  
  1386.  
  1387.  
  1388.  
  1389.          The Puma Protocol(TM) v1.00                          User's Manual
  1390.  
  1391.  
  1392.  
  1393.          CARRIER LOST
  1394.            The DCD signal was lowered during the transfer.  This will only
  1395.            be reported if the "monitor the carrier signal" option is
  1396.            enabled.
  1397.  
  1398.          FATAL TIMEOUT
  1399.            The sender received no response from the receiver within a
  1400.            reasonable amount of time.
  1401.  
  1402.          TOO MANY ERRORS
  1403.            More than twenty consecutive line errors occurred during the
  1404.            transfer.
  1405.  
  1406.          NOT ALLOWED TO OVERWRITE FILE
  1407.            The receiver got a file header for an existing file, and the
  1408.            "allow overwriting received files" option is disabled.
  1409.  
  1410.          CAN'T CREATE FILE
  1411.            The receiver can't create the file to be received.
  1412.  
  1413.          CAN'T WRITE TO DISK
  1414.            The receiver can't write received information to the disk file.
  1415.  
  1416.                                   *       *       *
  1417.  
  1418.          The following messages can occur only before the transfer begins,
  1419.          and will cause an ERRORLEVEL 2 to be returned to DOS.
  1420.  
  1421.          INVALID REGISTRATION INFORMATION
  1422.            The PUMA.EXE file contains an invalid UserID/Serial number
  1423.            combination.
  1424.  
  1425.          INVALID PARAMETER: xx
  1426.            An invalid parameter (xx) has been given on the command line.
  1427.  
  1428.          INVALID SPEED: xxxxx
  1429.            An invalid speed (baud rate) has been specified.
  1430.  
  1431.          INVALID HANDSHAKING
  1432.            An invalid handshaking option has been specified.
  1433.  
  1434.          INVALID PORT: x
  1435.            An invalid COM port has been specified.  This will occur if Puma
  1436.            cannot identify an active UART in the specified port.
  1437.  
  1438.          SEND/RECEIVE NOT SPECIFIED
  1439.            The "s" or "r" parameter was not given on the command line.
  1440.  
  1441.          ERROR READING LIST FILE
  1442.            The Puma sender could not read the specified list file
  1443.            (@listfile).
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.                                                                Page 19
  1451.  
  1452.  
  1453.  
  1454.  
  1455.          The Puma Protocol(TM) v1.00                          User's Manual
  1456.  
  1457.  
  1458.  
  1459.          FILE NOT FOUND: filename.ext
  1460.            Puma could not locate the file filename.ext as specified in a
  1461.            list file, or on the command line.
  1462.  
  1463.          NO FILES SPECIFIED
  1464.            The Puma sender found no file specifications on the command line
  1465.            or in a list file.
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                                                                Page 20
  1517.  
  1518.  
  1519.  
  1520.  
  1521.          The Puma Protocol(TM) v1.00                          User's Manual
  1522.  
  1523.  
  1524.  
  1525.          5 - T h e   S e t u p   P r o g r a m
  1526.          __________________________________________________________________
  1527.  
  1528.  
  1529.          Accompanying the Puma Protocol program is a setup program called
  1530.          PUMASET.EXE, which allows the user to customize the PUMA.EXE file.
  1531.          The setup program accomplishes this by reading the PUMA.EXE file,
  1532.          which must reside in the default directory, and updating it with
  1533.          the custom setup information.
  1534.  
  1535.          Using the PUMASET program is easy.  First, log to the directory
  1536.          where the PUMA.EXE file resides.  This can be done in DOS by
  1537.          using the "chdir" or "cd" command.
  1538.  
  1539.          Next, execute the PUMASET.EXE program.  This program can reside
  1540.          anywhere on your hard disk, or on a floppy disk.
  1541.  
  1542.          The setup program will first attempt to read the PUMA.EXE file.
  1543.          If it is not present in the current directory, or is somehow
  1544.          corrupted, you will be alerted.
  1545.  
  1546.          When the PUMA.EXE file has been found and read successfully, you
  1547.          will be presented with the setup program's main menu.
  1548.  
  1549.  
  1550.                                       MAIN MENU
  1551.  
  1552.          The main menu contains the following information:
  1553.  
  1554.            -> Change default options
  1555.               Adjust screen colors
  1556.               Install registration information
  1557.               Quit and save settings
  1558.  
  1559.          From here, you have four options from which to choose.  You may
  1560.          select an option by moving the arrow that is shown on the screen
  1561.          to point at the option you wish to select.  The up and down arrow
  1562.          key move the arrow.  Press Enter to choose the selected item.
  1563.          From the main menu, you may also press the ESC key.  The results
  1564.          of this action are the same as selecting the "Quit and save
  1565.          settings" option.
  1566.  
  1567.  
  1568.                                CHANGE DEFAULT OPTIONS
  1569.  
  1570.          After selecting this item, you will be presented with a screen
  1571.          showing a number of options and their current defaults, as they
  1572.          are currently set in the PUMA.EXE file.
  1573.  
  1574.          An explanation of each of these options is detailed in Chapter 3,
  1575.          so we won't repeat ourselves in this section.
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.                                                                Page 21
  1583.  
  1584.  
  1585.  
  1586.  
  1587.          The Puma Protocol(TM) v1.00                          User's Manual
  1588.  
  1589.  
  1590.  
  1591.  
  1592.          A few things to note about setting options:
  1593.  
  1594.            The UART baud rate - When choosing a UART baud rate, the setting
  1595.            "Current" will cause Puma to use the baud rate at which the UART
  1596.            is operating when the program is executed.
  1597.  
  1598.            The Effective baud rate - The setting "UART" will cause Puma to
  1599.            match the effective baud rate to the UART baud rate when Puma is
  1600.            executed.
  1601.  
  1602.            IRQs and Base addresses - The IRQ settings adjust the hardware
  1603.            interrupt for each COM port.  The base address settings adjust
  1604.            the base I/O address where the UART is mapped for each COM port.
  1605.            Base addresses must be entered in hex format.  These settings
  1606.            allow customization of non-standard COM ports.  See your
  1607.            internal modem or serial port manual for more information on
  1608.            IRQs and Base address settings.
  1609.  
  1610.            The CDS and DSZ log files - These settings allow default log
  1611.            files to be specified.
  1612.  
  1613.          All default settings except for COM port base addresses and IRQs
  1614.          can be overrided by using command line parameters when executing
  1615.          Puma.
  1616.  
  1617.  
  1618.                                 ADJUST SCREEN COLORS
  1619.  
  1620.          Selecting this item causes a portion of the Puma Status screen to
  1621.          be shown, along with a menu of items that can be colorized.  Using
  1622.          the up and down arrow keys, you can position the arrow to point to
  1623.          an item to be adjusted.  The following keys affect the "selected"
  1624.          item:
  1625.  
  1626.            Enter - changes the foreground color
  1627.            Space - changes the background color
  1628.            ESC   - return to main menu
  1629.  
  1630.          The following two keys affect the entire display:
  1631.  
  1632.            C     - select default color scheme
  1633.            M     - select monochrome scheme
  1634.  
  1635.  
  1636.                           INSTALL REGISTRATION INFORMATION
  1637.  
  1638.          This item allows registered Puma users to install their User ID
  1639.          and serial number.  For information on registering, please read
  1640.          the file, LICENSE.TXT.
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.                                                                Page 22
  1649.  
  1650.  
  1651.  
  1652.  
  1653.          The Puma Protocol(TM) v1.00                          User's Manual
  1654.  
  1655.  
  1656.  
  1657.          Registered Puma users:
  1658.  
  1659.          When you receive your User ID and serial number in the mail, you
  1660.          can use the "Install registration information" option to install
  1661.          the information into PUMA.EXE.
  1662.  
  1663.          When typing the UserID, you may use mixed upper and lower case
  1664.          letters, all CAPS, or all lower case, whichever you desire.
  1665.  
  1666.          Enter the serial number EXACTLY as it is shown on your
  1667.          registration certificate.  Puma will not run with improper User ID
  1668.          or serial number information.  If you receive the message,
  1669.          "Invalid registration information" when running Puma, double check
  1670.          the ID and serial number on your certificate with the information
  1671.          entered into PUMASET.
  1672.  
  1673.          Registered Lynx Users:
  1674.  
  1675.          You may use the LYNXPUMA.EXE program to extract the registration
  1676.          information from LYNX.EXE for use with The Puma Protocol.
  1677.  
  1678.          You must first place your REGISTERED LYNX.EXE file into the
  1679.          current directory, and then execute the LYNXPUMA.EXE program.
  1680.          Follow screen instructions for more details.
  1681.  
  1682.  
  1683.                                QUIT AND SAVE SETTINGS
  1684.  
  1685.          This option causes PUMASET to prompt you for a response:
  1686.  
  1687.            Save new settings in PUMA.EXE <Y or N> ?
  1688.  
  1689.          Responding with "N" will cause PUMASET to end without updating
  1690.          PUMA.EXE.
  1691.  
  1692.          Responding with "Y" will cause PUMASET to end after writing the
  1693.          new setup information into the PUMA.EXE file.
  1694.  
  1695.  
  1696.                                     *     *     *
  1697.  
  1698.  
  1699.          When running Puma after using PUMASET, note that the "Stats"
  1700.          window will reflect the default settings that you have specified.
  1701.          These defaults can be overrided by command line parameters.
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.                                                                Page 23
  1715.  
  1716.  
  1717.  
  1718.  
  1719.          The Puma Protocol(TM) v1.00                          User's Manual
  1720.  
  1721.  
  1722.  
  1723.          6 - A c k n o w l e d g e m e n t s
  1724.          __________________________________________________________________
  1725.  
  1726.  
  1727.          This chapter is dedicated to the people who made the Puma project
  1728.          possible, including all the users who registered as Lynx Protocol
  1729.          users, all those who helped test Lynx and Puma, and those who
  1730.          contributed in other ways. . .
  1731.  
  1732.  
  1733.                                        INSIDE
  1734.  
  1735.          A large percentage of the development time on Puma was spent
  1736.          coding and tuning the UART interface routines using Turbo
  1737.          Assembler 1.0.  Repeated tests have revealed that Puma operates
  1738.          quite reliably on a 115200 baud direct link between an 8 Mhz 80286
  1739.          and a 12 Mhz 80286, even with a 16450 UART.  Hats off to Borland
  1740.          International for a fine assembler!
  1741.  
  1742.          The remainder of the project was coded in Turbo Pascal 5.5,
  1743.          Borland's award-worthy compiler and development system.
  1744.  
  1745.          The speed of the display in Puma is attributed to the QWIK toolbox
  1746.          from Eagle Performance Software - QWIK is an irreplaceable kit
  1747.          full of goodies that makes programming without the CRT unit a
  1748.          genuine pleasure.  Good work, Eagle!
  1749.  
  1750.          TheDraw from TheSoft Programming Services was used to develop
  1751.          everything visual in the Puma software package.  TheDraw proved to
  1752.          be an invaluable tool for designing the user displays.  Kudos to
  1753.          Mr. Ian Davis for his quality screen design software!
  1754.  
  1755.  
  1756.                                        OUTSIDE
  1757.  
  1758.          Puma has made it to the Shareware marketplace only after very
  1759.          extensive testing by the author, and by these fine people, who
  1760.          kindly volunteered their testing services:
  1761.  
  1762.                                       Nick Anis
  1763.                                      Kevin Bass
  1764.                         Mike Callahan (AKA Dr. File Finder!)
  1765.                                     Chuck Dennis
  1766.                                    Charles Edstrom
  1767.                                      Ken Flower
  1768.                                     Shawn Johnson
  1769.                                   Scott Kuntzelman
  1770.                                      Al Maynard
  1771.                                      Lee Pollard
  1772.                                       Bob Rapp
  1773.                                      John Schuit
  1774.                                     Ken Standard
  1775.  
  1776.                                    Thanks, folks!
  1777.  
  1778.  
  1779.  
  1780.                                                                Page 24
  1781.  
  1782.  
  1783.  
  1784.  
  1785.          The Puma Protocol(TM) v1.00                          User's Manual
  1786.  
  1787.  
  1788.  
  1789.                                TRADEMARKS AND PRODUCTS
  1790.  
  1791.          The Courier HST and HST/Dual Standard are products of USRobotics
  1792.  
  1793.          DESQview is a product of Quarterdeck Office Systems
  1794.  
  1795.          DSZ is a product of Omen Technology, Inc.
  1796.  
  1797.          IBM 3270 PC and Topview are trademarks of International Business
  1798.          Machines
  1799.  
  1800.          MS-DOS and Microsoft Windows are registered trademarks of
  1801.          Microsoft Corporation
  1802.  
  1803.          PC Access is a trademark of PCA Systems
  1804.  
  1805.          PKZIP is a registered trademark of PKWARE, Inc.
  1806.  
  1807.          QWIK is a product of Eagle Performance Software
  1808.  
  1809.          SuperK is a product of Crater Rim Software
  1810.  
  1811.          Taskview is a product of Sunny Hill Software
  1812.  
  1813.          TheDraw is a trademark of TheSoft Programming Services
  1814.  
  1815.          The Puma Protocol is a trademark of Matthew Thomas
  1816.  
  1817.          Turbo Assembler and Turbo Pascal are registered trademarks of
  1818.          Borland International, Inc.
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.                                                                Page 25
  1847.  
  1848.  
  1849.  
  1850.  
  1851.          The Puma Protocol(TM) v1.00                          User's Manual
  1852.  
  1853.  
  1854.  
  1855.          Appendix A - L o g   F i l e   F o r m a t s
  1856.          __________________________________________________________________
  1857.  
  1858.  
  1859.                                ENHANCED DSZ LOG FORMAT
  1860.  
  1861.          The Enhanced DSZ logging that Puma uses is provided for some
  1862.          compatibility with programs that recognize this type of logging.
  1863.  
  1864.          The log file consists of a single line of text for each file
  1865.          transferred.  Following is a sample entry:
  1866.  
  1867.          S 217837 57600 bps 5050 cps   0 errors     0 1024 PUMA100.ZIP Puma
  1868.  
  1869.          The format of this each field in this entry is as follows,
  1870.          beginning with the leftmost field:
  1871.  
  1872.            - 'S' for send, 'R' for receive, 'E' for aborted transfer, or
  1873.              'L' for lost carrier.
  1874.  
  1875.            - The length of the file, in bytes.
  1876.  
  1877.            - The effective baud rate.  Puma follows the DSZ format of using
  1878.              '65535' to represent an actual baud rate of 115200.
  1879.  
  1880.            - The average transfer rate, in characters per second.
  1881.  
  1882.            - The total number of errors which occurred during transmission.
  1883.  
  1884.            - The number of flow control restrictions, as specified in the
  1885.              DSZ documentation.  Puma does not record this value, so this
  1886.              field will always contain a zero.
  1887.  
  1888.            - The length of the last block transferred in the file.
  1889.  
  1890.            - The name of the file which was transferred.
  1891.  
  1892.            -*The name of the protocol used.
  1893.  
  1894.            -*The last field is either empty, or contains '(resumed)' to
  1895.              signify that the file was resumed.
  1896.  
  1897.          * These fields are not part of the original DSZ specification.
  1898.  
  1899.  
  1900.                                  CDS LOG FORMAT
  1901.  
  1902.          CDS logging is a standard of recording online activities of all
  1903.          types.  It was developed in an attempt to standardize the
  1904.          interface between various communication utilities, such as
  1905.          terminal emulators, BBS software, external protocols (such as
  1906.          Puma), and phone bill analyzers.
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.                                                                Page 26
  1913.  
  1914.  
  1915.  
  1916.  
  1917.          The Puma Protocol(TM) v1.00                          User's Manual
  1918.  
  1919.  
  1920.  
  1921.          By supporting CDS logging, Puma's activities can be tracked by any
  1922.          utility that will read a CDS file.
  1923.  
  1924.          Following is an example of a CDS log entry made by Puma:
  1925.  
  1926.  
  1927.          90-01-04 00:46:11 020 Puma
  1928.                  COM port 1
  1929.                  Comm parameters 2400 8 N 1
  1930.                  Sent file AUTOEXEC.BAT
  1931.                  File size 142
  1932.                  Protocol Puma
  1933.                  Ended 90-01-04 00:46:11 (call ended abruptly)
  1934.                  Transfer Errors 1
  1935.                  Efficiency 0.0 %
  1936.                  Average CPS 0
  1937.  
  1938.  
  1939.          The first line is the record header, which gives the date and time
  1940.          the transfer began, the record number (020), which identifies the
  1941.          record as a file transfer entry, and 'Puma', the name of the
  1942.          program that created the entry.
  1943.  
  1944.          Following the header are single-line entries describing the
  1945.          transfer:
  1946.  
  1947.          COM port N
  1948.  
  1949.            The communications port used for the transfer.  N will have a
  1950.            value from 1 to 4.
  1951.  
  1952.          Comm parameters 2400 8 N 1
  1953.  
  1954.            Designates the effective baud rate, data bits, parity check, and
  1955.            stop bits during a transfer.  Each parameter is separated by a
  1956.            space.  Puma always uses '8 N 1' for data type.
  1957.  
  1958.          Sent file FILENAME
  1959.          Rcvd file FILENAME
  1960.  
  1961.            The name of the transferred file.
  1962.  
  1963.          File size NNN
  1964.  
  1965.            The size of the transferred file.  NNN is the size in bytes (not
  1966.            kilobytes).
  1967.  
  1968.          Protocol Puma
  1969.  
  1970.            The file transfer protocol used.
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.                                                                Page 27
  1979.  
  1980.  
  1981.  
  1982.  
  1983.          The Puma Protocol(TM) v1.00                          User's Manual
  1984.  
  1985.  
  1986.  
  1987.          Ended YY-MM-DD HH:MM:SS
  1988.          Ended YY-MM-DD HH:MM:SS (aborted by sender)
  1989.          Ended YY-MM-DD HH:MM:SS (aborted by receiver)
  1990.          Ended YY-MM-DD HH:MM:SS (call ended abruptly)
  1991.  
  1992.            Tells when the transfer terminated, and shows if the sender or
  1993.            receiver aborted the transfer, or if the carrier signal was
  1994.            lost (call ended abruptly).
  1995.  
  1996.          Transfer Errors NNN
  1997.  
  1998.            Provides the total number of errors encountered during the
  1999.            transfer.  If the entry is missing, no errors occurred during
  2000.            the transfer.
  2001.  
  2002.          Efficiency NNN %
  2003.  
  2004.            Provides the efficiency of the  file transfer.  "NNN" is the
  2005.            efficiency as a percentage ("96.2 %" for example).
  2006.  
  2007.          Average CPS NNNN
  2008.  
  2009.            Provides  the average characters transmitted per second for the
  2010.            file.  "NNNN" is the CPS average as a whole number, "239" for
  2011.            example.
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.                                                                Page 28
  2045.  
  2046.  
  2047.  
  2048.  
  2049.          The Puma Protocol(TM) v1.00                          User's Manual
  2050.  
  2051.  
  2052.  
  2053.          Appendix B - B e n c h m a r k s
  2054.          __________________________________________________________________
  2055.  
  2056.  
  2057.          Following are benchmark results comparing Puma to some of the
  2058.          other protocols in use today.  Please note that these results were
  2059.          obtained under a direct serial cable link, where line noise was
  2060.          not a factor.  The performance of these protocols may vary widely
  2061.          when tested over various modem connections, baud rates, and CPU
  2062.          speeds.
  2063.  
  2064.          File transferred: A file created with PKZIP, all contents
  2065.          imploded, 217837 bytes in length
  2066.  
  2067.          All readings are in characters per second as reported by the
  2068.          receiver protocol.
  2069.  
  2070.          RLE Compression was disabled in Zmodem and Puma.  Jmodem and Lynx
  2071.          do not offer provision to disable their RLE compression.
  2072.  
  2073.          The following programs were used for benchmark testing:
  2074.  
  2075.          Puma 1.00    (Puma)
  2076.          Lynx 3.02    (Lynx)
  2077.          DSZ 12-14-89 (Zmodem, True Ymodem, Xmodem)
  2078.          SuperK R4.47 (Jmodem, Super8K)
  2079.  
  2080.          --------
  2081.          Test #1
  2082.          --------
  2083.  
  2084.          Sender:                  Receiver:
  2085.            8 MHz Tandy 1000TX       12.5 MHz Western Digital WDM2
  2086.            Internal 16450 UART      Internal 16450 UART
  2087.  
  2088.          Protocol  9600bps  19200bps  57600bps  115200bps
  2089.          --------  -------  --------  --------  ---------
  2090.            Puma        935      1858      5050    7851
  2091.            Lynx        931       N/A      1034     N/A
  2092.           Zmodem       927      1846      3514    3961
  2093.           Ymodem       896      1676      3458    4538
  2094.           Xmodem       734      1217      2075    2075
  2095.           Jmodem       923      1771       N/A     N/A
  2096.           Super8K      963*     1898*     4130*   4054*
  2097.           Super8K      947      1862      4034    4111 <-Timed by hand
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.                                                                Page 29
  2111.  
  2112.  
  2113.  
  2114.  
  2115.          The Puma Protocol(TM) v1.00                          User's Manual
  2116.  
  2117.  
  2118.  
  2119.          -------
  2120.          Test #2
  2121.          -------
  2122.  
  2123.          Receiver:                Sender:
  2124.            8 MHz Tandy 1000TX       12.5 MHz Western Digital WDM2
  2125.            Internal 16450 UART      Internal 16450 UART
  2126.  
  2127.          Protocol  9600bps  19200bps  57600bps  115200bps
  2128.          --------  -------  --------  --------  ---------
  2129.            Puma        938      1867      3661    5102
  2130.            Lynx        N/A       N/A       N/A     N/A
  2131.           Zmodem       927      1846      3068    3756
  2132.           Ymodem       919      1786      3157    3961
  2133.           Xmodem       801      1353      1729    1928
  2134.           Jmodem       N/A       N/A       N/A     N/A
  2135.           Super8K      967*     1914*     2440    2135
  2136.           Super8K      947      1894      2421    2135 <-Timed by hand
  2137.  
  2138.  
  2139.          Test results marked "N/A" were not available due to one of the
  2140.          following situations:
  2141.            - The transfer failed
  2142.            - The baud rate for the test was not supported
  2143.  
  2144.  
  2145.          * When timing Super8K transfers with a stopwatch, actual transfer
  2146.            times did not match reported cps rates.  For reported cps rates
  2147.            to be considered valid, they must be derived from the following
  2148.            formula:
  2149.  
  2150.            cps = bytes / seconds
  2151.  
  2152.            In this formula, "bytes" must be equal to the actual number of
  2153.            bytes in the transferred file, and "seconds" must be equal to
  2154.            the total number of seconds which elapsed from the time that the
  2155.            first byte of file data was received to the time that the last
  2156.            byte of file data was received and accepted by the receiver
  2157.            protocol.  If these criteria are met, "cps" will return the
  2158.            actual throughput of the file transfer.
  2159.  
  2160.            The transfers in question were repeated, and timed by hand with
  2161.            a stopwatch.  The resulting cps rates are provided in the above
  2162.            chart.
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.                                                                Page 30
  2177.  
  2178.  
  2179.  
  2180.  
  2181.          The Puma Protocol(TM) v1.00                          User's Manual
  2182.  
  2183.  
  2184.  
  2185.          Appendix C - P u m a   A u t o - S t a r t   R e c e i v e
  2186.          __________________________________________________________________
  2187.  
  2188.  
  2189.          Puma has a feature that allows the sending protocol to alert the
  2190.          receiver to start download synchronization.  This can decrease the
  2191.          number of required keystrokes to start a download.
  2192.  
  2193.          At this time, none of the terminal programs that were evaluated by
  2194.          the author directly support any type of auto-receive mode for
  2195.          external protocols, other than Zmodem.
  2196.  
  2197.          It may be possible for some terminals to support Puma auto-
  2198.          receive by using their built-in script language to wait for the
  2199.          Puma auto-packet, and then beginning the external Puma receiver
  2200.          protocol.
  2201.  
  2202.          Following is the format of the Puma auto-packet, which the Puma
  2203.          sender transmits at one-second intervals at the beginning of a
  2204.          batch transfer:
  2205.  
  2206.          Turbo Pascal format:
  2207.            #24#8#24#8#24'Puma'#24#8#24#8#24
  2208.  
  2209.          Hex format:
  2210.            24 08 24 08 24 50 75 6D 61 24 08 24 08 24
  2211.  
  2212.  
  2213.          When this string of characters is received during a terminal
  2214.          session, the Puma receive protocol should be initiated.
  2215.  
  2216.          Perhaps we will see this type of feature supported in future
  2217.          releases of the popular terminal programs.  But for now, it has to
  2218.          be done using scripts.
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.                                                                Page 31
  2243.  
  2244.  
  2245.  
  2246.  
  2247.          The Puma Protocol(TM) v1.00                          User's Manual
  2248.  
  2249.  
  2250.  
  2251.          Appendix D - S u g g e s t e d   R e a d i n g
  2252.          __________________________________________________________________
  2253.  
  2254.  
  2255.          For in-depth information on all aspects of computer
  2256.          telecommunications, the author recommends the following book:
  2257.  
  2258.                       "Dvorak's Guide to PC Telecommunications"
  2259.                            By John C. Dvorak and Nick Anis
  2260.                        Published by Osborne/McGraw-Hill, 1989
  2261.  
  2262.          This book has over 1000 pages, and contains two 5.25" floppy
  2263.          disks.  Included on the first disk is "Telix SE", a complete and
  2264.          powerful communication package, along with a Modem Tutor Program.
  2265.          The second disk is packed (zipped, actually) with a number of very
  2266.          useful shareware programs.
  2267.  
  2268.          Suggested retail price is $49.95.  Check your local computer or
  2269.          book store for this excellent source of information!
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.                                                                Page 32
  2309.  
  2310.  
  2311.