home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO011.ZIP / QANADOCS.COM / QANALYST.DOC
Text File  |  1989-06-15  |  122KB  |  2,558 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                        QANALYST
  20.  
  21.  
  22.                           The First Professional Phone Bill
  23.                                  Analyzer for Qmodem
  24.  
  25.  
  26.                                      Version 2.0
  27.  
  28.  
  29.  
  30.  
  31.                                   Barn Owl Software
  32.                           P.O. Box #74, O'Fallon, IL  62269
  33.                                 voice: (618) 632-7345
  34.                                   BBS: (618) 398-5703
  35.  
  36.  
  37.  
  38.  
  39.                       Copyright (c) 1988,89 by Barn Owl Software
  40.  
  41.                                     ┌─────────┐(tm)
  42.                               ┌─────┴───┐     │
  43.                             ──│         │o    │──────────────────
  44.                               │   ┌─────┴╨──┐ │  Association of
  45.                               │   │         ├─┘  Shareware
  46.                               └───┤    o    │    Professionals
  47.                             ──────│    ║    │────────────────────
  48.                                   └────╨────┘    MEMBER
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                     Contents
  58.  
  59.  
  60.  
  61.                Legal notices                                         1
  62.                   Qanalyst warranty  · · · · · · · · · · · · · · · · 2
  63.  
  64.                Evaluation copies                                     3
  65.                   Disk vendors · · · · · · · · · · · · · · · · · · · 3
  66.                   Colleges & teachers  · · · · · · · · · · · · · · · 3
  67.  
  68.                Registering Qanalyst                                  4
  69.                   Volume discounts · · · · · · · · · · · · · · · · · 4
  70.  
  71.                Chapter 1  Getting started                            6
  72.                   1.1  Requirements  · · · · · · · · · · · · · · · · 6
  73.                   1.2  Floppy drive users  · · · · · · · · · · · · · 7
  74.                   1.3  A word to the wise  · · · · · · · · · · · · · 7
  75.                      1.3.1  DOS 3.20 users · · · · · · · · · · · · · 7
  76.                   1.4  Setting up Qmodem · · · · · · · · · · · · · · 8
  77.                      1.4.1  Session logging  · · · · · · · · · · · · 8
  78.                      1.4.2  Date/time separators · · · · · · · · · · 8
  79.                   1.5  Setting up Qanalyst · · · · · · · · · · · · · 8
  80.                   1.6  Compatibility · · · · · · · · · · · · · · · · 9
  81.                      1.6.1  Call Data Standard · · · · · · · · · · · 9
  82.                      1.6.2  With other programs  · · · · · · · · · · 9
  83.                      1.6.3  Task/Omni/DESQView · · · · · · · · · · · 9
  84.                      1.6.4  MicroSoft Windows  · · · · · · · · · · · 9
  85.                      1.6.5  DoubleDOS  · · · · · · · · · · · · · · · 9
  86.  
  87.                Chapter 2  Using Qanalyst                            10
  88.                   2.1  Command line summary  · · · · · · · · · · ·  10
  89.                   2.2  Program initialization  · · · · · · · · · ·  11
  90.  
  91.                Chapter 3  Main menu options                         13
  92.                   3.1  Verification mode · · · · · · · · · · · · ·  13
  93.                   3.2  Edit configuration mode · · · · · · · · · ·  14
  94.  
  95.                Chapter 4  Log file maintenance                      16
  96.                   4.1  Condense  · · · · · · · · · · · · · · · · ·  16
  97.                   4.2  Remove  · · · · · · · · · · · · · · · · · ·  17
  98.  
  99.                Chapter 5  Qanalyst reports                          18
  100.                   5.1  Sample reports  · · · · · · · · · · · · · ·  18
  101.  
  102.                Chapter 6  Phone-rate file maintenance               19
  103.                   6.1  Holiday schedule  · · · · · · · · · · · · ·  21
  104.                   6.2  Local rates · · · · · · · · · · · · · · · ·  22
  105.                   6.3  Toll rates  · · · · · · · · · · · · · · · ·  25
  106.                   6.4  Long-distance rates · · · · · · · · · · · ·  26
  107.                   6.5  Other rates · · · · · · · · · · · · · · · ·  26
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                Chapter 7  Utility options                           27
  114.                   7.1  Editing the utility options · · · · · · · ·  28
  115.  
  116.                Appendix A  Error messages                           31
  117.                   A.1  Regular error messages  · · · · · · · · · ·  31
  118.                   A.2  Fatal error messages  · · · · · · · · · · ·  33
  119.                   A.3  Exit codes  · · · · · · · · · · · · · · · ·  35
  120.  
  121.                Appendix B  Qanalyst v1.0 users                      36
  122.  
  123.                Appendix C  Helpful hints                            37
  124.                   C.1  Invoking Qanalyst · · · · · · · · · · · · ·  37
  125.                   C.2  Last call?  One phone number? · · · · · · ·  37
  126.                   C.3  Getting rates from Ma Bell  · · · · · · · ·  38
  127.                   C.4  Get the correct time  · · · · · · · · · · ·  38
  128.                   C.5  Shelling to DOS from Qmodem · · · · · · · ·  39
  129.                   C.6  Special calling problems  · · · · · · · · ·  39
  130.                   C.7  Special phone rates · · · · · · · · · · · ·  40
  131.  
  132.                Appendix D  Troubleshooting                          41
  133.                   D.1  Log file problems · · · · · · · · · · · · ·  41
  134.                   D.2  Qmodem log anomalies  · · · · · · · · · · ·  41
  135.                   D.3  Phone-rate file problems  · · · · · · · · ·  42
  136.                   D.4  Report problems · · · · · · · · · · · · · ·  42
  137.                   D.5  Modem problems  · · · · · · · · · · · · · ·  43
  138.  
  139.                Appendix E  Acknowledgments                          45
  140.                   E.1  Dedication  · · · · · · · · · · · · · · · ·  45
  141.                   E.2  The beta testers  · · · · · · · · · · · · ·  45
  142.                   E.3  Many thanx to · · · · · · · · · · · · · · ·  45
  143.  
  144.                Index                                                46
  145.  
  146.  
  147.                                     Figures
  148.  
  149.  
  150.                Figure 3.1: Configuration screen  · · · · · · · · · ·13
  151.                Figure 4.1: Sample maintenance messages · · · · · · ·16
  152.                Figure 5.1: Analysis status messages  · · · · · · · ·18
  153.                Figure 6.1: Phone-rate menu · · · · · · · · · · · · ·19
  154.                Figure 6.2: Append-records status messages  · · · · ·20
  155.                Figure 6.3: Holiday schedule screen · · · · · · · · ·21
  156.                Figure 6.4: Phone record screen · · · · · · · · · · ·23
  157.                Figure 7.1: Utility options screen  · · · · · · · · ·27
  158.                Figure C.1: Sample QANALYST.SCR SCRipt file · · · · ·39
  159.  
  160.  
  161.                                      Tables
  162.  
  163.  
  164.                Table 1.1: Mandatory Qanalyst files · · · · · · · · · 6
  165.                Table 1.2: Optional Qanalyst files  · · · · · · · · · 6
  166.                Table A.1: Qanalyst exit codes  · · · · · · · · · · ·35
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                                     Legal notices
  176.  
  177.  
  178.                                  QANALYST Version 2.0
  179.  
  180.  
  181.                                   Barn Owl Software
  182.                                      P.O. Box #74
  183.                                  O'Fallon, IL  62269
  184.  
  185.  
  186.                Voice line: (618) 632-7345, regular business hours
  187.  
  188.                Support BBS: (618) 398-5703, three modem lines supporting up
  189.           to 9600 baud (USR HST) modems
  190.  
  191.                CompuServe: send an EasyPlex message to userID 74017,1344
  192.  
  193.                GEnie: leave notes in QMODEM RoundTable, QANALYST subtopic
  194.  
  195.                Telex: send to 3762848.  The first line of your message must
  196.           read as "TO:EASYPLEX:74017,1344"
  197.  
  198.  
  199.                Qanalyst software and documentation copyright (c) 1988,89 by
  200.           Barn Owl Software.  All rights reserved.  Barn Owl Software  is a
  201.           member of the Association of Shareware  Professionals.   Qanalyst
  202.           falls under ASP guidelines for shareware products.
  203.                Barn Owl Software is  in  no  way  connected with The Forbin
  204.           Project, Inc. except  for  being legally registered to use Qmodem
  205.           software.  Some  Qanalyst  versions may be incompatible with some
  206.           Qmodem versions because of this.
  207.                Any specific hardware/software names used in this manual are
  208.           the (registered) trademarks of specific companies.
  209.  
  210.                                     ┌─────────┐(tm)
  211.                               ┌─────┴───┐     │
  212.                             ──│         │o    │──────────────────
  213.                               │   ┌─────┴╨──┐ │  Association of
  214.                               │   │         ├─┘  Shareware
  215.                               └───┤    o    │    Professionals
  216.                             ──────│    ║    │────────────────────
  217.                                   └────╨────┘    MEMBER
  218.  
  219.                "This program is produced by  a member of the Association of
  220.           Shareware Professionals (ASP).  ASP wants to make  sure  that the
  221.           shareware principle works for you.  If you are unable  to resolve
  222.           a shareware-related  problem with an ASP member by contacting the
  223.           member directly, ASP may be able to help.  The ASP  Ombudsman can
  224.           help you resolve  a  dispute  or  problem with an ASP member, but
  225.           does not provide technical support for members' products.  Please
  226.  
  227.           Qanalyst v2.0 User Manual                                       2
  228.  
  229.  
  230.  
  231.           write to the ASP  Ombudsman  at P.O. Box 5786, Bellevue, WA 98006
  232.           or  send  a  Compuserve  message  via easyplex to  ASP  Ombudsman
  233.           70007,3536"
  234.  
  235.  
  236.           Qanalyst warranty
  237.  
  238.  
  239.                Qanalyst software  and documentation are provided AS IS.  It
  240.           is provided to users under  the shareware concept, in which users
  241.           may test the program thoroughly before paying for it.  Because of
  242.           the diversity of conditions, hardware, and  other  software under
  243.           which the program may be used, no warranty of fitness for  a par-
  244.           ticular purpose can be offered.
  245.  
  246.                Materials supplied  by Barn Owl Software are warranted to be
  247.           free of defects in material  and workmanship for thirty (30) days
  248.           from the date of receipt.  Users may  return  defective materials
  249.           during that time for replacement at no charge.  We will reimburse
  250.           you for the return postage as well.
  251.  
  252.           Evaluation copies                                               3
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                   Evaluation copies
  260.  
  261.  
  262.                You may try Qanalyst on a 30-day trial basis to determine if
  263.           this program meets your needs.  You must then either register the
  264.           program or quit using it.
  265.                You may not modify Qanalyst in any way that changes the pro-
  266.           gram's computer instructions unless these methods are approved by
  267.           Barn Owl Software.
  268.                You may give UNMODIFIED copies of Qanalyst to others so they
  269.           can evaluate it for their needs, subject to the same restrictions
  270.           and conditions above.
  271.  
  272.  
  273.           Disk vendors
  274.  
  275.  
  276.                Barn Owl Software keeps a list of disk vendors who have been
  277.           issued a master Qanalyst disk, and we keep vendors up to  date at
  278.           no cost.   Just mail us a copy of your current catalog.  We'll do
  279.           the rest.  (Our address is on page 1.)
  280.                The Association of Shareware Professionals  offers associate
  281.           memberships for disk vendors.  As they say,  "membership  has its
  282.           privileges."  You can get details by writing directly to the ASP,
  283.           Attn: vendor memberships, P.O. Box 5786, Bellevue, WA 98006.
  284.  
  285.  
  286.           Colleges & teachers
  287.  
  288.  
  289.                Barn Owl Software will be happy to help  teachers  who offer
  290.           courses on Qanalyst.  We can supply master  disks  and/or manuals
  291.           as course materials.  Please contact us for details.  Our address
  292.           is on page 1.
  293.  
  294.           Qanalyst v2.0 User Manual                                       4
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                 Registering Qanalyst
  302.  
  303.  
  304.                If you want to keep using Qanalyst after  your  30-day trial
  305.           period, mail  the registration form (page 5) with proper payment.
  306.           Please register your copy of Qmodem before you register your copy
  307.           of Qanalyst.
  308.  
  309.                Your Qanalyst registration will include the following:
  310.  
  311.               ■  No charge for using an upgrade.  Your registration will be
  312.                  valid for ALL future versions of Qanalyst, period.
  313.  
  314.               ■  One year of  BBS  support at (618) 398-5703, voice support
  315.                  at (618) 632-7345, and newsletter support.
  316.  
  317.               ■  The latest version of Qanalyst is sent on disk.
  318.  
  319.               ■  Order disks & manuals anytime at the registered-user rate.
  320.  
  321.               ■  Help "beta  test" future versions of Qanalyst if you wish,
  322.                  before they are publicly marketed.
  323.  
  324.  
  325.           Volume discounts
  326.  
  327.  
  328.                Corporate-wide licenses are available and can be tailored to
  329.           your company's  specific needs.  Please contact Barn Owl Software
  330.           for more details.  Our address & phone numbers are listed on page
  331.           1.  Normal volume discounts are as follows:
  332.  
  333.                           1 -  4 copies       0% discount
  334.                           5 -  9 copies      10% discount
  335.                          10 - 19 copies      20% discount
  336.                          20 - 49 copies      30% discount
  337.                          50 - 99 copies      40% discount
  338.                         100 or more          50% discount
  339.  
  340.           Registering Qanalyst                                            5
  341.  
  342.  
  343.  
  344.           Form                  QANALYST REGISTRATION                 20101
  345.                     (Registration is good for all future versions)
  346.  
  347.  
  348.           Make checks payable to:                         (U.S. funds only)
  349.                                   Barn Owl Software
  350.                           P.O. Box #74, O'Fallon, IL  62269
  351.  
  352.                   or use a credit card!  We take MasterCard & Visa.
  353.  
  354.  
  355.           Registration (disk incl.)          @  $15.00           $_________
  356.                3.5" diskette surcharge       @   $1.65           $_________
  357.                Printed manual                @   $7.50           $_________
  358.  
  359.                                                           Total  $_________
  360.  
  361.  
  362.                Volume discounts  are available if you purchase five or more
  363.           copies.  See page 4 for details.
  364.  
  365.  
  366.  
  367.  
  368.           Name:    _____________________________________  Date: ___________
  369.  
  370.           Company: ________________________________________________________
  371.  
  372.           Address: ________________________________________________________
  373.  
  374.                    ________________________________________________________
  375.  
  376.           Tell us where you
  377.           found Qanalyst! _________________________________________________
  378.  
  379.                           _________________________________________________
  380.  
  381.           If paying by credit card:     MasterCard ____     or Visa ____
  382.  
  383.           Card Nmbr: ______________________________  Expires: _____________
  384.  
  385.           Signature: __________________________________   Date: ___________
  386.  
  387.  
  388.           Any comments?
  389.  
  390.           Qanalyst v2.0 User Manual                                       6
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                                       Chapter 1
  398.  
  399.                                    Getting started
  400.  
  401.  
  402.           1.1  Requirements
  403.  
  404.  
  405.                Qanalyst will run on an IBM PC, XT, AT, PS/2,  or compatible
  406.           computer.   You must use DOS 2.0 or better and have at least 190k
  407.           of free memory.
  408.  
  409.                The following tables describe the necessary and the optional
  410.           files which make up Qanalyst:
  411.  
  412.                          Table 1.1: Mandatory Qanalyst files
  413.           ─────────────────────────────────────────────────────────────────
  414.           QANALYST.EXE  The actual program
  415.           QANALYST.OVR  The program's "overlay" file
  416.           SESSION.LOG   A Qmodem v4.0 log file, but it can be any filename
  417.                         you choose
  418.           ─────────────────────────────────────────────────────────────────
  419.  
  420.  
  421.                          Table 1.2: Optional Qanalyst files
  422.           ─────────────────────────────────────────────────────────────────
  423.           QANALYST.CFG  Qanalyst configuration file, but it can be any
  424.                         filename you choose
  425.           QANALYST.PRF  CDS standard phone-rate file, but it can be any
  426.                         filename you choose
  427.           QMODEM.CNF    Qmodem v4.0 configuration file
  428.           QANALYST.DOC  Contains this documentation
  429.           READ.ME!      Contains late-breaking Qanalyst notes
  430.           SAMPLE.BAT    Runs a sample Qanalyst session
  431.           SAMPLE.*      The various sample files used by SAMPLE.BAT
  432.           VENDOR.DOC    A documentation file specifically for disk vendors
  433.           DISCOUNT.DOC  A documentation file specifically for people who
  434.                         need corporate-wide licenses or volume discounts
  435.           WHATSNEW.DOC  A documentation file telling what's new in Qanalyst
  436.           LOWERIBM.EXE  Changes IBM graphic characters in the QANALYST.DOC
  437.                         file so some Epson printer owners can print out the
  438.                         Qanalyst documentation
  439.           LOWERIBM.DOC  Contains the documentation for LOWERIBM.EXE
  440.           ─────────────────────────────────────────────────────────────────
  441.  
  442.           Chapter 1, "Getting started"                                    7
  443.  
  444.  
  445.  
  446.           1.2  Floppy drive users
  447.  
  448.  
  449.                Qanalyst will work with a floppy drive system.  The analysis
  450.           requires only one sweep of the log file(s) and all data is stored
  451.           in memory, so you won't be slowed too much by floppy drive access
  452.           times.  You may find it difficult to perform maintenance, though.
  453.           Qanalyst will terminate with  an  error message if it runs out of
  454.           room  on the disk.  (The program will warn you if it thinks there
  455.           may not be enough room for it to do its job.)
  456.                Be aware that Qmodem will turn off the log if it runs out of
  457.           disk space.  You may lose some important log entries and  the log
  458.           may become corrupted if this happens.  Make sure you  have enough
  459.           disk space so the log file can grow while you're using Qmodem.
  460.  
  461.  
  462.           1.3  A word to the wise
  463.  
  464.  
  465.                chronology (kra näl'a jee) n.,  ...  2. the arrangement
  466.                of events, dates, etc. in the order of occurrence  3. a
  467.                list or table of dates in their proper sequence ...
  468.                                      ─── New World Dictionary, 2nd ed.
  469.  
  470.                Your  log  file  must (repeat must) be correct if you expect
  471.           Qanalyst  to work right.  This means you have to set the DOS date
  472.           and time whenever you boot up.    If  you don't do this, your log
  473.           file will show you made some calls on 1-1-80 just after midnight.
  474.           That's not right!
  475.                Please, don't change your DOS date or time  while  Qmodem is
  476.           running.  It will be reflected in your log file and that may mean
  477.           trouble when it's Qanalyst's turn to use it.
  478.                Qanalyst can check log files  to make sure they were written
  479.           in chronological order, if you want it to do so.  See chapter 7.
  480.  
  481.           1.3.1  DOS 3.20 users
  482.  
  483.                Some people who use DOS 3.20 may already know about  a weird
  484.           bug which doesn't change the DOS date when the clock strikes mid-
  485.           night.  Qanalyst will attempt to handle phone calls that continue
  486.           past midnight if DOS 3.20 corrupted the log file, but the program
  487.           may still terminate with an error message or  produce  an inaccu-
  488.           rate report.
  489.                We say "some" people may have this bug.  DOS  3.21 corrected
  490.           the problem but, for whatever reason, some DOSs tell applications
  491.           they are operating under DOS 3.20.
  492.  
  493.  
  494.           1.4  Setting up Qmodem
  495.  
  496.  
  497.                Qanalyst v2.0 is compatible ONLY with logs created by Qmodem
  498.           version 4.0.  It will not work properly with any logs produced by
  499.           earlier versions and it may not work properly  with  logs created
  500.  
  501.           Qanalyst v2.0 User Manual                                       8
  502.  
  503.  
  504.  
  505.           by  later  versions.   Caution: if you're upgrading from an older
  506.           Qmodem,  start new log files!  Don't  keep  appending  to  older-
  507.           version logs, it'll just confuse Qanalyst.
  508.                The Qmodem v4.0 log file  format has three major problems in
  509.           it that will affect Qanalyst.  Please read  appendix  section D.2
  510.           for details.  You should take special note if  you  use  Qmodem's
  511.           ALT-D manual dialing or Host Mode security callback features.
  512.  
  513.           1.4.1  Session logging
  514.  
  515.                Qanalyst  can  only  tell you about calls listed in your log
  516.           file.  You can save yourself from a lot of hassle  by configuring
  517.           Qmodem so it begins using the  log  file right when it starts up.
  518.           Every call you make will then be recorded in your  log.   Use the
  519.           Qmodem ALT-N/O/T/U command to  set  the  "aUto start Log" option.
  520.           Consult your Qmodem manual if you are unfamiliar with this.
  521.                WARNING!  Be careful when running Qanalyst from Qmodem's DOS
  522.           shell!    (Consult  your Qmodem manual if you are unfamiliar with
  523.           this.)  Unpredictable things may happen if both  programs  try to
  524.           use the same log file at the same time.  Consult appendix section
  525.           C.5 for details.
  526.  
  527.           1.4.2  Date/time separators
  528.  
  529.                Qmodem v4.0 lets you alter the date/time string format.  You
  530.           can decide if dates will  be written as "xx-xx-xx" or "xx/xx/xx",
  531.           or even "xx█xx█xx".  It's  up to you.  See chapter 7 if you use a
  532.           date separator other than  "/"  or "-", or a time separator other
  533.           than ":".
  534.  
  535.  
  536.           1.5  Setting up Qanalyst
  537.  
  538.  
  539.                Qanalyst is pretty easy to install.  Just copy all the files
  540.           into your Qmodem directory, or create a new directory to hold the
  541.           Qanalyst files.  Data files can be placed in other directories if
  542.           you  wish.  You're good to go if you know where the support files
  543.           will be stored.
  544.                You should check the utility options to make sure everything
  545.           is set up the way you like.  See chapter 7 for details.
  546.  
  547.                You can always get an accurate analysis of your modem usage,
  548.           but you'll need to  create  phone-rate files if you want to study
  549.           your modem expenditures.  This is covered in a later section.
  550.                There are a number of  SAMPLE files included in the Qanalyst
  551.           application.  Feel free to play around!  You can get a feeling of
  552.           how Qanalyst works by entering "SAMPLE" at the DOS prompt.
  553.  
  554.           Chapter 1, "Getting started"                                    9
  555.  
  556.  
  557.  
  558.           1.6  Compatibility
  559.  
  560.  
  561.           1.6.1  Call Data Standard
  562.  
  563.                Qanalyst is compatible with "CDS", the  Call  Data Standard,
  564.           in that it reads & writes CDS phone-rate data files.  However, it
  565.           does not recognize CDS  call  history logs, nor does it work with
  566.           CDS single-call files.
  567.                We expect the Forbin Project will switch to the powerful CDS
  568.           standard  in a future version of Qmodem.  We will then be able to
  569.           provide complete CDS support.
  570.  
  571.           1.6.2  With other programs
  572.  
  573.                At this time, we know of no other program specially designed
  574.           to modify Qmodem v4.0 log files.  However, we recommend  that you
  575.           refrain from using them.   Qanalyst makes a few assumptions about
  576.           Qmodem log files that other  programs may ignore or approach from
  577.           a different angle.
  578.  
  579.           1.6.3  Task/Omni/DESQView
  580.  
  581.                Qanalyst is fully compatible  with  TaskView,  OmniView, and
  582.           DESQView.  It will automatically adjust itself to work in  any of
  583.           these environments.   Load  Qanalyst like any program that writes
  584.           screen data via the BIOS.  (Consult your  multitasking  manual if
  585.           you are unfamiliar with  this.)   Qanalyst needs at least 190k of
  586.           memory to run.  You should give it up to 640k if you can spare it
  587.           because Qanalyst needs to "grow" in memory while it is working.
  588.  
  589.           1.6.4  MicroSoft Windows
  590.  
  591.                When creating your .PIF file, specify that Qanalyst directly
  592.           modifies the screen.  Set the "KB required" value to 190k and set
  593.           the "KB desired" value to 640k.  (Consult your Windows  manual if
  594.           you are unfamiliar with this.)
  595.                You  can, however, declare that Qanalyst writes  information
  596.           to the screen via the BIOS as long as you invoke the program with
  597.           the /B command-line option (see page 10).  This special case lets
  598.           you run Qanalyst as a "background" task while  you're  working on
  599.           other projects in the foreground.
  600.  
  601.           1.6.5  DoubleDOS
  602.  
  603.                Qanalyst is NOT fully compatible with DoubleDOS.  If you try
  604.           to run Qanalyst as the background task, you'll get intense screen
  605.           bleed-thru.  (Consult your DoubleDOS manual if you are unfamiliar
  606.           with this.)  You should run Qanalyst as the foreground task.
  607.                You can, however, run Qanalyst in  the  background partition
  608.           if you use the /B command-line option (see page  10).    Qanalyst
  609.           writes information to the screen via the BIOS  in  this instance,
  610.           letting you work on another project in the foreground.
  611.  
  612.           Qanalyst v2.0 User Manual                                      10
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                                       Chapter 2
  620.  
  621.                                    Using Qanalyst
  622.  
  623.  
  624.           2.1  Command line summary
  625.  
  626.  
  627.                           QANALYST  [cfg-file]  [options...]
  628.  
  629.                Qanalyst begins when you enter "QANALYST" at the DOS prompt.
  630.           There are also quite a few options you can use  to  alter the way
  631.           the program runs, but don't worry.  Some options are for advanced
  632.           concepts, and some may not even apply to you.
  633.  
  634.           cfg-file Qanalyst configuration  filename.    Qanalyst  looks for
  635.                    QANALYST.CFG,  but this option lets you specify  another
  636.                    name.  You can also specify a path if you wish.
  637.  
  638.           /8       Toggle 8x8  font.  This option toggles the EGA/VGA "8x8"
  639.                    font to provide more than 25 lines on a screen.  It only
  640.                    works if an EGA or VGA monitor is present.
  641.  
  642.           /B       Batch file  execution.  Qanalyst asks you to confirm the
  643.                    current configuration before  doing anything else.  This
  644.                    option orders the program to  use  a  configuration file
  645.                    as-is.  Note:  This options requires a cfg-file name, or
  646.                    QANALYST.CFG  must be available where Qanalyst can  find
  647.                    it (see page 11).
  648.  
  649.           /BL      Last-call analysis.  Reports cover  only  the  last call
  650.                    you made.  This  option  implies  batch  file execution.
  651.                    See appendix section C.2 for further details.
  652.  
  653.           /BS[ph#] Single-number  analysis.  Reports cover only a  specific
  654.                    telephone number you declare.  This option implies batch
  655.                    file execution.  See appendix  section  C.2  for further
  656.                    details.
  657.  
  658.           /E       Ignore EMS.  Qanalyst will use expanded (LIM EMS) memory
  659.                    if  there is enough available to store  a  copy  of  its
  660.                    overlay file.  This command tells Qanalyst to ignore EMS
  661.                    memory.
  662.  
  663.           /F[date][:nnn]
  664.                    Default "From" date.  Qanalyst normally  uses  the first
  665.                    date  in  each  log file as the default "From:" date for
  666.                    analysis and maintenance.  This option lets  you specify
  667.                    a different date.  It's  extremely  useful  with  the /B
  668.                    command-line option because it  lets  you  do batch-mode
  669.                    work on specific  dates  in  a  log file.  The syntax is
  670.  
  671.           Chapter 2, "Using Qanalyst"                                    11
  672.  
  673.  
  674.  
  675.                    "/Fxx-xx-xx".  If you  don't  specify  a  date, Qanalyst
  676.                    will  use  today's  date.    ...You can also  specify  a
  677.                    variable /T value  from  the /F parameter by including a
  678.                    ":nnn" at the end.  This tells Qanalyst you want  to set
  679.                    the default "To:" date  to  be  nnn  days forward of the
  680.                    "From:" date.   (See  the  /B  option if you just want a
  681.                    report on the last call you made.)
  682.  
  683.           /I       Ignore Qanalyst configuration files.  Qanalyst is geared
  684.                    to hunt for  its  configuration file.  This option tells
  685.                    the program to use its  internal defaults.  Note: The /B
  686.                    and /I options are mutually exclusive.
  687.  
  688.           /N       Noiseless operation.  This  option  toggles  the program
  689.                    into total silence at startup.
  690.  
  691.           /T[date][:nnn]
  692.                    Default "To" date.  Qanalyst normally uses the last date
  693.                    in each log file as  the default "To:" date for analysis
  694.                    & maintenance.  This option lets you specify a different
  695.                    date.  It's extremely useful  with  the  /B command-line
  696.                    option  because  it  lets  you  do  batch-mode  work  on
  697.                    specific  dates  in  a   log   file.     The  syntax  is
  698.                    "/Txx-xx-xx".  ...You can  also  specify  a  variable /F
  699.                    value from the /T parameter by including a ":nnn" at the
  700.                    end.    This  tells Qanalyst you want to set the default
  701.                    "From:"  date  to  be nnn days back from the "To:" date.
  702.                    (See the /B option if you just want a report on the last
  703.                    call you made.)
  704.  
  705.                Syntax: You must put a  space between each option.  Qanalyst
  706.           accepts parameters in any  order.   And, you may use "-x" instead
  707.           of "/x" if you wish.
  708.                See appendix C for visual aids on starting  Qanalyst  at the
  709.           DOS prompt.
  710.  
  711.  
  712.           2.2  Program initialization
  713.  
  714.  
  715.                When Qanalyst starts up, it displays an  opening "shareware"
  716.           screen which contains the program's copyright  notice.   Qanalyst
  717.           will wait for you to read it and then "PLEASE WAIT"  will appear.
  718.           The program is now initializing itself.
  719.                Qanalyst searches for the configuration file QANALYST.CFG if
  720.           you didn't specify one at start-up.  It searches:
  721.  
  722.              1.  The default directory;
  723.              2.  The directory where the Qanalyst program is kept;
  724.              3.  The directories listed  on  the DOS PATH (consult your DOS
  725.                  manual if you are unfamiliar with this); and,
  726.              4.  The  directory  designated  by  the   QMODEM=  environment
  727.                  variable (consult your Qmodem manual if you are unfamiliar
  728.                  with this).
  729.  
  730.           Qanalyst v2.0 User Manual                                      12
  731.  
  732.  
  733.  
  734.                Qanalyst  searches for QMODEM.CNF, the Qmodem  configuration
  735.           file, like it searches for the Qanalyst configuration  file.   If
  736.           found, Qanalyst will use Qmodem's  screen colors to make you feel
  737.           a bit more "at home" with the program.
  738.                Qanalyst uses  the log and phone-rate files described in the
  739.           configuration file.  If it finds no such file, it will search the
  740.           default directory for a phone-rate data file  called QANALYST.PRF
  741.           and a Qmodem log file  called SESSION.LOG (or whatever you called
  742.           it in the QMODEM.CNF file).
  743.  
  744.           Chapter 3, "Main menu options"                                 13
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.                                       Chapter 3
  752.  
  753.                                   Main menu options
  754.  
  755.  
  756.           3.1  Verification mode
  757.  
  758.  
  759.                The configuration screen will eventually appear:
  760.  
  761.           ─────────────────────────────────────────────────────────────────
  762.                                                       Log file #1
  763. Qmodem Log file: C:\QMODEM\SESSION.LOG
  764. Qanalyst config: C:\QMODEM\QANALYST.CFG
  765. Phone-rate data: C:\QMODEM\QANALYST.PRF
  766.  
  767.    Analyze this log file:  No  YES                  ╒══ Main menu commands ═══╕
  768.            Starting date: 03/22/88                  │ BEGIN WORKING           │
  769.              Ending date: 04/21/88                  │ Next log info           │
  770.                                                     │ Previous log info       │
  771.  Maintain phone log file:  No  CONDENSE  Remove     │ First log info          │
  772.            Starting date: 03/22/88                  │ Add new log info        │
  773.              Ending date: 04/21/88                  │ Drop this log           │
  774.                                                     │ Edit this log info      │
  775.                                                     │ Save configuration      │
  776.                                                     │ Utility options         │
  777.  Phone bill rpt:  None  SUMMARY  Detailed           │ edit phone-Rate data    │
  778.   U/D stats rpt:  NONE  Summary  Detailed           │ prInt registration form │
  779.    Report title:                                    │ Toggle bells & whistles │
  780.  Send report to:  PRINTER  File  Screen             │ eXit to DOS             │
  781.                                                     ╘═════════════════════════╛
  782.                                 Begin!  Analyze/maintain log file(s) as directed
  783.           ─────────────────────────────────────────────────────────────────
  784.                           Figure 3.1: Configuration screen
  785.  
  786.                The options shown above may not be the same as the  ones you
  787.           see on your screen.  Qanalyst modifies the screen to show options
  788.           that are currently active.  If an option is capitalized and high-
  789.           lighted, it means it is the selected option.
  790.                Use  the  cursor  keys to select a command (press ENTER when
  791.           ready), or press any capitalized & highlighted letter.  Both will
  792.           make Qanalyst perform the selected menu function:
  793.  
  794.              BEGIN WORKING.  Qanalyst will proceed with the current config-
  795.              uration.
  796.  
  797.              Next log info.  Displays the configuration for  the  next log.
  798.              The top line of the screen shows which  of  the  log  files is
  799.              displayed.
  800.  
  801.           Qanalyst v2.0 User Manual                                      14
  802.  
  803.  
  804.  
  805.              Previous log info.  This is like the "Next"  command,  but  it
  806.              moves you backward through the log configurations.
  807.  
  808.              First log info.  Displays the configuration for the first log.
  809.  
  810.              Add new log info.  Lets you add another log to  the configura-
  811.              tion.  You can specify up to 20 log files.
  812.  
  813.              Drop  this  log.   Removes the current log from the configura-
  814.              tion.
  815.  
  816.              Edit this configuration.    Lets you change details about what
  817.              Qanalyst should do with the current log.  See section 3.2.
  818.  
  819.              Save  configuration.  Saves all configuration data  (including
  820.              the utility-option data explained  below)  to  a  file.  If no
  821.              filename was specified, QANALYST.CFG will  be  created  in the
  822.              default directory.
  823.  
  824.              edit phone-Rate data.  Lets  you view, edit, & save phone-rate
  825.              data which is used when analyzing  a  log file.  See chapter 6
  826.              for detailed information.
  827.  
  828.              Utility options.  Lets you view & edit  some  advanced options
  829.              available in Qanalyst.  These options are saved  with  the log
  830.              configuration data.  See chapter 7.
  831.  
  832.              prInt registration form.  Sends a  Qanalyst  registration form
  833.              to the printer.
  834.  
  835.              Toggle bells & whistles.  Turns beeps ON and OFF.
  836.  
  837.              eXit to DOS.  Stop the program.  You can also press ALT-X like
  838.              in Qmodem, or plain old CTRL-C.
  839.  
  840.  
  841.           3.2  Edit configuration mode
  842.  
  843.  
  844.                If you  edit the current log's configuration, you can change
  845.           the settings that tell Qanalyst what to do with it.  Options will
  846.           become capitalized and highlighted, meaning you can modify them.
  847.  
  848.                The following lists each option available on  the configura-
  849.           tion screen and the possible settings:
  850.  
  851.              Qmodem Log file: the name of a Qmodem v4.0 log file.
  852.  
  853.              Qanalyst config: the name of a Qanalyst configuration file.
  854.  
  855.              Phone-rate data: the name of a Qanalyst phone-rate data file.
  856.  
  857.              Analyze log file: tells  Qanalyst  whether  to include the log
  858.              file in a report.
  859.  
  860.           Chapter 3, "Main menu options"                                 15
  861.  
  862.  
  863.  
  864.                 Starting date: and Ending date: come up if  you  request an
  865.                 analysis.  They show the  inclusive dates of log entries to
  866.                 be studied for the report.  Note: these dates are not saved
  867.                 as part of  the  configuration  file.   If you want to work
  868.                 with specific dates,  you  have  to  declare  the starting/
  869.                 ending dates each time you use Qanalyst.  (See the /F  & /T
  870.                 options in section 2.1 for more details.)
  871.  
  872.              Maintain Qmodem Log file: is set to the type of maintenance to
  873.              be performed on the log.  See chapter 4.
  874.  
  875.                 Starting date: and Ending date:  come up if you request log
  876.                 maintenance.   They show the inclusive dates of log entries
  877.                 to  be condensed or removed.  Note:  these  dates  are  not
  878.                 saved with the configuration  file.    If  you want to work
  879.                 with specific dates,  you  have  to  declare  the starting/
  880.                 ending dates each time you use Qanalyst.  (See the /F  & /T
  881.                 options in section 2.1 for more details.)
  882.  
  883.              Phone bill rpt: comes up only if a log file will  be analyzed.
  884.              Choose the type of phone bill analysis report you desire.  See
  885.              chapter 5.
  886.  
  887.              U/D stats rpt: comes up only when a log file will be analyzed.
  888.              Choose the type of upload/download analysis report you desire.
  889.              See chapter 5.
  890.  
  891.                 Report title: comes up only if a log file will be analyzed.
  892.                 This text will be printed at the top  of  every  page  of a
  893.                 report.
  894.  
  895.                 Send report to: comes up when you request a report.  Set it
  896.                 to where you want the report to go.
  897.  
  898.                    Output file: comes up when the report will go to a file.
  899.                    Enter the name of a file to hold the report.
  900.  
  901.                    File exists: comes up when the report will go to a file.
  902.                    Set this to Append to attach the report to  the  end  of
  903.                    the file, or set it to Overwrite to erase the old infor-
  904.                    mation in the file.
  905.  
  906.                Press ESC when you're satisfied.  This takes you back to the
  907.           verification mode.  Qanalyst will go to work when you tell  it to
  908.           BEGIN WORKING.
  909.  
  910.           Qanalyst v2.0 User Manual                                      16
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.                                       Chapter 4
  918.  
  919.                                 Log file maintenance
  920.  
  921.  
  922.                Qanalyst  will  maintain  your  log  file  by  condensing or
  923.           removing information from it (if you choose).  This is  useful if
  924.           you want to remove entries that have shown up on a phone bill, or
  925.           if you just want to keep a small log file.
  926.                Qanalyst looks at every  log  entry to see what must be kept
  927.           or deleted.  Retained entries are sent to a temporary file.  When
  928.           finished,  it  gives  the original file a  ".BAL"  extension  and
  929.           renames the temporary file so it is the new log  file.   An older
  930.           backup  file will be deleted if found, even if it is set to read-
  931.           only status.
  932.                Note:  Qanalyst accounts for the fact that a call might con-
  933.           tinue past midnight.  When condensing or deleting log entries, it
  934.           treats all entries for a call as if the entire call took place on
  935.           the day it started.    (DOS 3.20 users should consult section 1.3
  936.           for more information.)
  937.                Qanalyst displays various status messages (shown below) when
  938.           it maintains a log file.  You can  always  stop  the  program and
  939.           return to DOS by pressing ALT-X or CTRL-C.
  940.  
  941.           ─────────────────────────────────────────────────────────────────
  942.           Using C:\QMODEM\SESSION.LOG
  943.           Selected Qmodem log call entries will be condensed.
  944.           Writing new log to temporary file.  Please be patient.
  945.           There may not be enough free space on the disk.
  946.           Deleting backup log file.
  947.           Renaming old log file to SESSION.BAL
  948.           Renaming temp log file to SESSION.LOG
  949.           Condensing resulted in a 71% smaller log file.
  950.           ─────────────────────────────────────────────────────────────────
  951.                        Figure 4.1: Sample maintenance messages
  952.  
  953.  
  954.           4.1  Condense
  955.  
  956.  
  957.                Qanalyst removes unneeded log entries that  fall  within the
  958.           specified "To/From" dates.  A log entry is kept only if:
  959.  
  960.              1.  It is vital to Qanalyst; or,
  961.              2.  It is a STAMP log entry; or,
  962.              3.  It doesn't look like Qmodem created it.
  963.  
  964.                If you choose to condense a log that will also  be analyzed,
  965.           Qanalyst will determine if it  can safely condense the log first.
  966.           This is why you may sometimes see Qanalyst analyzing files before
  967.           condensing them.
  968.  
  969.           Chapter 4, "Log file maintenance"                              17
  970.  
  971.  
  972.  
  973.           4.2  Remove
  974.  
  975.  
  976.                Qanalyst removes all log entries that fall within the speci-
  977.           fied "To/From" dates.  It  still keeps anything that doesn't look
  978.           like Qmodem created it.
  979.                If you specified the log file for an analysis as  well, then
  980.           the analysis will always occur first.  It  is  otherwise possible
  981.           to remove some calls before they're analyzed.
  982.  
  983.           Qanalyst v2.0 User Manual                                      18
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.                                       Chapter 5
  991.  
  992.                                   Qanalyst reports
  993.  
  994.  
  995.                Qanalyst  produces summary and/or detailed analysis  reports
  996.           of  the log file(s) if you so choose.  There are a total of  four
  997.           different analysis reports you can  generate.  You can also print
  998.           a phone-rate data report if you wish (see page 20 for  details on
  999.           that type of report).
  1000.                Qanalyst must first analyze the  log(s) in order to create a
  1001.           report of any kind.  It displays various status messages while it
  1002.           does the analysis:
  1003.  
  1004.           ─────────────────────────────────────────────────────────────────
  1005.           Using C:\QMODEM\SESSION.LOG
  1006.           Searching for the first selected log entry.
  1007.           Now analyzing the selected log entries.
  1008.           Remember, condensed log files operate faster.
  1009.           ─────────────────────────────────────────────────────────────────
  1010.                         Figure 5.1: Analysis status messages
  1011.  
  1012.                The report(s) you specified will be created when analysis is
  1013.           complete.  You can stop the program and return to DOS at any time
  1014.           by pressing ALT-X or CTRL-C.
  1015.  
  1016.  
  1017.           5.1  Sample reports
  1018.  
  1019.  
  1020.                We've included some files that will generate  sample reports
  1021.           so you can see Qanalyst in action.  Feel free  to  print them out
  1022.           or  view them on the screen.  Make sure the SAMPLE.* files are in
  1023.           the current directory and type "SAMPLE" at the DOS prompt.
  1024.  
  1025.           Chapter 6, "Phone-rate file maintenance"                       19
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.                                       Chapter 6
  1033.  
  1034.                              Phone-rate file maintenance
  1035.  
  1036.  
  1037.                The "edit phone-Rate data" command on the main menu lets you
  1038.           view, edit, and save phone-rate  data.  Qanalyst uses this infor-
  1039.           mation when it analyzes  the  log file(s).  The program will work
  1040.           without  phone-rate  data,  but it won't be able to calculate the
  1041.           cost of each phone call.
  1042.                Note to previous Qanalyst v1.0 users: There has been a major
  1043.           addition to the phone-rate data.  Host BBS usage costs can now be
  1044.           specified separately from the actual cost of the phone call.  But
  1045.           don't worry,  Qanalyst will still read your old phone-rate files.
  1046.           See appendix B for details.
  1047.  
  1048.                Setting up a phone-rate data file isn't hard if you keep one
  1049.           thing in mind.  Keep phone-rate data only for numbers that are an
  1050.           EXCEPTION to the defaults.    See  appendix  section D.3 for more
  1051.           details about phone-rate files.
  1052.  
  1053.                The phone-rate menu will  appear  if  you  choose to view or
  1054.           edit the phone-rate data:
  1055.  
  1056.           ─────────────────────────────────────────────────────────────────
  1057.                                                                 Log file #1
  1058.           Qmodem Log file: C:\QMODEM\SESSION.LOG
  1059.           Qanalyst config: C:\QMODEM\QANALYST.CFG
  1060.           Phone-rate data: C:\QMODEM\QANALYST.PRF
  1061.  
  1062.              Analyze this log file:  No  YES
  1063.                      Starting date: ╒════ Phone-rate menu ═════╕
  1064.                        Ending date: │ Return to higher menu    │
  1065.                                     │ Append from these logs   │
  1066.             Maintain this log file: │ Condense phone-rata data │
  1067.                      Starting date: │ Save phone-rate data     │
  1068.                        Ending date: │ Print phone-rate data    │
  1069.                                     │ edit Holiday schedule    │
  1070.            Phone bill rpt:  None  SU│ edit Local phone rates   │
  1071.             U/D stats rpt:  NONE  Su│ Edit toll phone rates    │
  1072.              Report title:          │ edit long-Distance rates │
  1073.            Send report to:  PRINTER │ edit "Odd" number rates  │
  1074.                                     │ Toggle bells & whistles  │
  1075.                                     │ eXit to DOS              │
  1076.                                     ╘══════════════════════════╛
  1077.                                 Return to the next higher menu level
  1078.           ─────────────────────────────────────────────────────────────────
  1079.                              Figure 6.1: Phone-rate menu
  1080.  
  1081.           Qanalyst v2.0 User Manual                                      20
  1082.  
  1083.  
  1084.  
  1085.                The phone-rate menu shows the current  selection  in reverse
  1086.           video.  Use the cursor keys to select a different  command (press
  1087.           ENTER when ready), or press a capitalized and highlighted letter.
  1088.           Both make Qanalyst perform the selected menu function:
  1089.  
  1090.              Return to higher menu.  The phone-rate menu will disappear and
  1091.              the main menu will reappear.  Qanalyst will  check  the phone-
  1092.              rate data before  exiting  and, if it finds redundant records,
  1093.              it will ask you if you  want  to  remove them.  (See below for
  1094.              details about "condensing" the phone-rate data.)
  1095.  
  1096.              Append from these logs.  Qanalyst will study each log, looking
  1097.              for numbers not already stored  as phone-rate data.  New phone
  1098.              numbers will be added  when  they are found.  Prefix and area-
  1099.              code default records will be  created for each phone number if
  1100.              they don't already exist.  ("Default"  phone-rate  records are
  1101.              discussed below.)  Caution: See  appendix  section  D.3 before
  1102.              you use this command.
  1103.                   A window will  open  up  on  the  screen  for  the status
  1104.              messages.    Qanalyst  displays a "." (number is known) or "!"
  1105.              (new number for the phone-rate data) each time it comes across
  1106.              a phone number in the log file(s).
  1107.  
  1108.              ──────────────────────────────────────────────────────────────
  1109.              Using C:\QMODEM\SESSION.LOG
  1110.              Remember, condensed log files operate faster.
  1111.              !....!!.!!!!!....!....!...!.!.!!.............!................
  1112.              .!.............!.......................
  1113.              ──────────────────────────────────────────────────────────────
  1114.                        Figure 6.2: Append-records status messages
  1115.  
  1116.              Condense phone-rate data.  This is pretty much the opposite of
  1117.              the "Append from  logs"  command.  Qanalyst studies the phone-
  1118.              rate data for any redundant records and deletes them.  This is
  1119.              very handy after you make changes to records brought in by the
  1120.              "Append from logs" command, since it removes  redundant phone-
  1121.              rate records.
  1122.  
  1123.              Save phone-rate data.    This command saves the current phone-
  1124.              rate data to a  file.   QANALYST.PRF is created in the default
  1125.              directory if no filename was specified.  If Qanalyst finds any
  1126.              redundant phone-rate records, it will  ask  if  you  want them
  1127.              removed before saving them to a file.  (See above  for details
  1128.              about "condensing" the phone-rate data.)
  1129.  
  1130.              Print phone-rate data.  Sends a special phone-rate data report
  1131.              to the printer.
  1132.  
  1133.              edit Holiday schedule.  Lets you enter specific dates Qanalyst
  1134.              will view as a holiday (instead of a regular day of the week).
  1135.              See section 6.1.
  1136.  
  1137.              edit Local phone rates.  Lets you view and edit the phone-rate
  1138.              information for local numbers.  See section 6.2.
  1139.  
  1140.           Chapter 6, "Phone-rate file maintenance"                       21
  1141.  
  1142.  
  1143.  
  1144.              Edit toll phone rates.  Lets you view and edit  the phone-rate
  1145.              information for toll numbers.  See section 6.3.
  1146.  
  1147.              edit long-Distance rates.  Lets you view & edit the phone-rate
  1148.              information for long-distance numbers.  See section 6.4.
  1149.  
  1150.              edit "Odd" number rates.  Lets you view & edit  the phone-rate
  1151.              information for phone numbers that do not fall under the other
  1152.              three categories.  An overseas phone number is a good example.
  1153.              See section 6.5.
  1154.  
  1155.              Toggle bells & whistles.  Turns beeps ON and OFF.
  1156.  
  1157.              eXit to DOS.  Stop the program.  You can also press ALT-X like
  1158.              in Qmodem, or plain old CTRL-C.
  1159.  
  1160.  
  1161.           6.1  Holiday schedule
  1162.  
  1163.  
  1164.                The "edit Holiday schedule" command on  the  phone-rate menu
  1165.           lets you view and edit information about upcoming holidays.  When
  1166.           Qanalyst is calculating the cost of a call, it checks the holiday
  1167.           schedule to see if any portion of the call fell on a holiday.
  1168.                The following  screen will appear if you choose to view/edit
  1169.           the holiday schedule:
  1170.  
  1171.           ─────────────────────────────────────────────────────────────────
  1172.                          No holidays listed in the schedule.
  1173.  
  1174.  
  1175.  
  1176.            ╒═══ Holiday commands ════╕
  1177.            │ Return to higher menu   │
  1178.            │ Add a holiday           │
  1179.            │ Delete a holiday        │
  1180.            │ Kill all old holidays   │
  1181.            │ Toggle bells & whistles │
  1182.            │ eXit to DOS             │
  1183.            ╘═════════════════════════╛
  1184.           Return to the next higher menu level
  1185.           ─────────────────────────────────────────────────────────────────
  1186.                          Figure 6.3: Holiday schedule screen
  1187.  
  1188.                The holiday menu shows the current menu selection in reverse
  1189.           video.  Use the cursor keys to select a different  command (press
  1190.           ENTER when ready), or press a capitalized and highlighted letter.
  1191.           Both make Qanalyst perform the selected menu function:
  1192.  
  1193.              Return  to  higher  menu.  The holiday menu will disappear and
  1194.              the phone-rate menu will reappear.
  1195.  
  1196.              Add a holiday.  Lets you  add  a date to the holiday schedule.
  1197.              Up to 24 holidays can be entered.
  1198.  
  1199.           Qanalyst v2.0 User Manual                                      22
  1200.  
  1201.  
  1202.  
  1203.              Delete a holiday.  Removes a date from the holiday schedule.
  1204.  
  1205.              Kill all old holidays.    Lets you delete all the old holidays
  1206.              with a single keystroke.
  1207.  
  1208.              Toggle bells & whistles.  Turns beeps ON and OFF.
  1209.  
  1210.              eXit to DOS.  Stop the program.  You can also press ALT-X like
  1211.              in Qmodem, or plain old CTRL-C.
  1212.  
  1213.  
  1214.           6.2  Local rates
  1215.  
  1216.  
  1217.                The "edit  Local phone rates" command on the phone-rate menu
  1218.           lets you view/edit  information  about local phone rates.  First,
  1219.           let's cover some important concepts about phone-rate data.
  1220.  
  1221.           Local numbers  are composed of seven digits.  Dashes, spaces, and
  1222.                          commas are ignored.
  1223.  
  1224.           New phone record
  1225.                          is  created for the phone-rate data when  Qanalyst
  1226.                          discovers  a phone number it doesn't already  know
  1227.                          about.    The program creates  new  phone  records
  1228.                          while it analyzes the  log  files.   You can enter
  1229.                          phone numbers into the phone-rate data that can be
  1230.                          saved  to  a  file  so  a number is  "known"  when
  1231.                          Qanalyst  studies  the log files.    Caution:  see
  1232.                          appendix section D.3 before saving  any phone-rate
  1233.                          data.
  1234.  
  1235.           Root default record
  1236.                          contains  default  data  covering any phone number
  1237.                          which  is  NOT  already  defined in the phone-rate
  1238.                          data.    Root  default  records always exist, they
  1239.                          never have  to  be  created.    Qanalyst  uses the
  1240.                          phone-rate  data  in the root  default  record  to
  1241.                          initialize new records, with some exceptions...
  1242.  
  1243.           Area-code default record
  1244.                          contains data  covering  any  specific  area code.
  1245.                          These are made up  of  a  "1"  followed by an area
  1246.                          code and seven  zeros.   (Spaces and dashes can be
  1247.                          used,  so "1 618 000-0000" is acceptable.)  If  an
  1248.                          area-code default record exists, Qanalyst uses its
  1249.                          data  instead  of   the  root  default  data  when
  1250.                          initializing  records  for  new phone numbers with
  1251.                          that area code.
  1252.  
  1253.           Prefix default record
  1254.                          contains default data covering any  specific tele-
  1255.                          phone prefix.   These  are made of the first three
  1256.                          numbers of a seven-digit phone number, followed by
  1257.  
  1258.           Chapter 6, "Phone-rate file maintenance"                       23
  1259.  
  1260.  
  1261.  
  1262.                          four zeros.   If "398-0000" or "1-618-398-0000" is
  1263.                          included in the phone-rate data, Qanalyst will use
  1264.                          it to initialize a  record  for  a phone number in
  1265.                          the 398 prefix.
  1266.  
  1267.                A window will open up on the screen  where  local phone-rate
  1268.           data will be displayed:
  1269.  
  1270.           ─────────────────────────────────────────────────────────────────
  1271.   DAYTIME PHONE CO. cost info for LOCAL phone records
  1272.   Phone number: ROOT DEFAULT RECORD
  1273.                                                    ╒═══ Phone record menu ════╕
  1274.  Phone Co. charges by the:  MINUTE  Hour           │ Return to higher menu    │
  1275.              First minute:  $0.00                  │ view phOne co. cost data │
  1276.         Subsequent minute:  $0.00                  │ view Host BBS cost data  │
  1277.    Daytime rates start at: 08:00:00  (24hr clock)  │ view Daytime rates       │
  1278.                                                    │ view eVening rates       │
  1279.                                                    │ view nIghttime rates     │
  1280.  DAYTIME PHONE CO. master override-rate schedule:  │ Next phone record        │
  1281.      Sunday rate: Daytime  Evening  NIGHTTIME      │ Prev phone record        │
  1282.      Monday rate: DAYTIME  Evening  Nighttime      │ First phone record       │
  1283.     Tuesday rate: DAYTIME  Evening  Nighttime      │ Specific phone record    │
  1284.   Wednesday rate: DAYTIME  Evening  Nighttime      │ Edit this phone record   │
  1285.    Thursday rate: DAYTIME  Evening  Nighttime      │ Add new phone record     │
  1286.      Friday rate: DAYTIME  Evening  Nighttime      │ Kill this phone record   │
  1287.    Saturday rate: Daytime  Evening  NIGHTTIME      │ Toggle bells & whistles  │
  1288.     Holiday rate: Daytime  EVENING  Nighttime      │ eXit to DOS              │
  1289.                                                    ╘══════════════════════════╛
  1290.                                             Return to the next higher menu level
  1291.           ─────────────────────────────────────────────────────────────────
  1292.                            Figure 6.4: Phone record screen
  1293.  
  1294.                The first two lines show in a glance what phone  number data
  1295.           is being displayed, what section  of rate data is being displayed
  1296.           (phone company rates or host BBS rates), what portion of the data
  1297.           is  displayed (daytime/evening/nighttime), and what category  the
  1298.           number falls under (local/toll/long-distance/"odd").
  1299.                The above screen shows the data connected with daytime local
  1300.           phone company rates.  You can  work  with the data for evening or
  1301.           nighttime rates  by choosing the appropriate menu command, or you
  1302.           can switch over to the host  BBS  daytime/evening/nighttime rates
  1303.           by choosing the appropriate menu commands.
  1304.                Be careful when you modify phone-rate data!   Make  sure you
  1305.           modify only the data you want to modify.  If you make an error in
  1306.           your data entry, say you enter host BBS rates in a  phone company
  1307.           portion of the record, then future reports could  be  thrown off.
  1308.           (See page 20 for  information  about  printing out the phone-rate
  1309.           data.  See Appendix C about problems that can mess up a report.)
  1310.  
  1311.                The phone record menu  shows  the  current menu selection in
  1312.           reverse video.  Use the cursor keys to select a different command
  1313.           (press ENTER  when ready), or press a capitalized and highlighted
  1314.           letter.  Both make Qanalyst perform the selected function:
  1315.  
  1316.           Qanalyst v2.0 User Manual                                      24
  1317.  
  1318.  
  1319.  
  1320.              Return to higher menu.  The phone record  menu  will disappear
  1321.              and the phone-rate menu will reappear.
  1322.  
  1323.              view phOne co. cost data.  Switches the data on the  screen so
  1324.              phone company rates can be viewed & edited.
  1325.  
  1326.              view Host BBS cost data.   Switches  the data on the screen so
  1327.              host BBS rates can be viewed  &  edited.  This data is usually
  1328.              only needed by people who use CompuServe, GEnie, or other "pay
  1329.              as you use them" networks.
  1330.  
  1331.                 view Daytime  rates.  Switches the screen so daytime phone-
  1332.                 rate data can be viewed & edited.   (Phone  company daytime
  1333.                 rates are separate from host BBS daytime rates.)
  1334.  
  1335.                 view eVening  rates.  Switches the screen so evening phone-
  1336.                 rate data can be viewed & edited.   (Phone  company evening
  1337.                 rates are separate from host BBS evening rates.)
  1338.  
  1339.                 view nIghttime  rates.    Switches  the  screen  so nightly
  1340.                 phone-rate data can be viewed  &  edited.    (Phone company
  1341.                 nighttime  rates  are  separate  from  host  BBS  nighttime
  1342.                 rates.)
  1343.  
  1344.              Next phone record.  Displays the next phone record.
  1345.  
  1346.              Prev phone record.  Displays the previous phone record.
  1347.  
  1348.              First phone record.  Displays  the root default record for the
  1349.              local (or toll or long-distance or "odd") phone numbers.
  1350.  
  1351.              Specific phone record.    Displays data for the specific phone
  1352.              number entered by the user.   It's  a quick way to view infor-
  1353.              mation for a given record.  A message appears  if  the  number
  1354.              isn't stored in the  phone-rate  data.  If you specify a phone
  1355.              record in a different category (local/toll/long-distance/odd),
  1356.              Qanalyst will shift over to that category.
  1357.  
  1358.              Edit  this  phone  record.  Lets you change the displayed cost
  1359.              data for the current phone record.  If  daytime  phone company
  1360.              cost  data  is  on the screen, then only daytime phone company
  1361.              data can be altered at this time.  This also goes  for evening
  1362.              & nighttime data, and host BBS cost data, when they  appear on
  1363.              the screen.  (Remember,  each  phone  record has six different
  1364.              data entry  screens!)  The following lists each alterable item
  1365.              on the phone record screen and its possible settings:
  1366.  
  1367.                 Calls are charged by  the:  will be set either to Minute or
  1368.                 Hour, depending if the  costs  are  considered as hourly or
  1369.                 minute-by-minute rates.
  1370.  
  1371.                 First minute:  or First hour: will appear depending how you
  1372.                 set the charge rate above.  Enter a number  in  the  format
  1373.                 "x.xx".  If you pay eight cents per minute  for  the  first
  1374.  
  1375.           Chapter 6, "Phone-rate file maintenance"                       25
  1376.  
  1377.  
  1378.  
  1379.                 minute, enter "0.08".  If you pay $7.55 per  hour  for  the
  1380.                 first  hour,  enter  "7.55".  Note: make sure you enter the
  1381.                 correct value!  Don't enter a minute cost  when  the charge
  1382.                 rate above it says it's an hourly rate.   Reports  will  be
  1383.                 WAY OFF the dollar mark if you mess this up.
  1384.  
  1385.                 Subsequent minute: or Subsequent hour: appears depending on
  1386.                 how you set  the  charge  rate  above.  The value you enter
  1387.                 here will be the cost for subsequent minutes or hours spent
  1388.                 on  a call.  Enter the data just like you did for the first
  1389.                 minute or hour costs.
  1390.  
  1391.                 Uploads are free: comes up only if a charge shows up in the
  1392.                 host BBS cost data for that record.  This tells Qanalyst if
  1393.                 it should suspend host BBS charges during an upload (except
  1394.                 for an ASCII upload).
  1395.  
  1396.                 Daytime rates start  at: (or evening/nighttime rates) shows
  1397.                 the time at which these charges go into effect.   Enter the
  1398.                 starting time in 24-hour (military) format: 1:00pm = 13:00,
  1399.                 2:00pm = 14:00, and so on.  (Hint: "13:00" can be shortened
  1400.                 to "13".)
  1401.  
  1402.                 DAYTIME master override-rate schedule: (evening & nighttime
  1403.                 schedule) determines the rate at which a call is calculated
  1404.                 depending on the day of the week the call is made.  In most
  1405.                 cases, a daytime call made on a weekday will be  charged at
  1406.                 daytime phone company and daytime host BBS rates.    But on
  1407.                 weekends and holidays, daytime calls are usually  billed at
  1408.                 the evening or nighttime rate.  Set each day  of  the  week
  1409.                 (including "holiday") to the rate which is really in effect
  1410.                 at that time.
  1411.  
  1412.              Add new phone record.  Lets you enter a new phone  number into
  1413.              the phone-rate data.
  1414.  
  1415.              Kill this phone record.   Lets you delete the displayed record
  1416.              from the phone-rate data.
  1417.  
  1418.              Toggle bells & whistles.  Turns beeps ON and OFF.
  1419.  
  1420.              eXit to DOS.  Stop the program.  You can also press ALT-X like
  1421.              in Qmodem, or plain old CTRL-C.
  1422.  
  1423.  
  1424.           6.3  Toll rates
  1425.  
  1426.  
  1427.                Toll rate  information is entered like the local rate infor-
  1428.           mation.  (See section 6.2.)  Toll numbers start with  a  "1" or a
  1429.           prefix code and have seven digits after it.
  1430.                Note to Qanalyst v1.0 users:  Qanalyst now handles the ALT-D
  1431.           prefix code capability in  Qmodem  v4.0.  See appendix B for more
  1432.           information.
  1433.  
  1434.           Qanalyst v2.0 User Manual                                      26
  1435.  
  1436.  
  1437.  
  1438.           6.4  Long-distance rates
  1439.  
  1440.  
  1441.                Long-distance rate information is  entered  like  local rate
  1442.           information.  (See  section  6.2.)  Default area-code records can
  1443.           be  created  for long-distance numbers.    Long-distance  numbers
  1444.           start with a "1" or a prefix code and have ten digits after it.
  1445.                Note to Qanalyst v1.0 users:  Qanalyst now handles the ALT-D
  1446.           prefix code capability in  Qmodem  v4.0.  See appendix B for more
  1447.           information.
  1448.  
  1449.  
  1450.           6.5  Other rates
  1451.  
  1452.  
  1453.                "Odd" phone numbers do not  fall under the other three cate-
  1454.           gories.  Office  intercom  systems and overseas phone numbers are
  1455.           good examples.  "Odd" phone  numbers are entered similar to long-
  1456.           distance phone numbers.  (See section 6.4.)
  1457.                Credit card calls ── calls which start with a "0" instead of
  1458.           a  "1" ── are considered "odd".  This lets two sets of records be
  1459.           defined for the same phone number since costs are different for a
  1460.           credit card call.  Users can also create default prefix  and area
  1461.           code records which would apply in these cases.
  1462.                Note to Qanalyst v1.0 users:  Qanalyst now handles the ALT-D
  1463.           prefix code capability in  Qmodem  v4.0.  See appendix B for more
  1464.           information.
  1465.  
  1466.           Chapter 7, "Utility options"                                   27
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.                                       Chapter 7
  1474.  
  1475.                                    Utility options
  1476.  
  1477.  
  1478.                The "Utility options" command on the main menu lets you view
  1479.           and edit some of the more advanced options available in Qanalyst.
  1480.           The following screen will appear if you choose  to  view/edit the
  1481.           utility options:
  1482.  
  1483.           ─────────────────────────────────────────────────────────────────
  1484. ╒══════════════════════════════ Utility options ═══════════════════════════════╕
  1485. │╒═════════════ Reports ══════════════╕  ╒═════════════ Program ══════════════╕│
  1486. ││        Number of copies:  1        │  │         Currency symbol:  $        ││
  1487. ││     Left indent (chars):  1        │  │  Status msg delay (sec):  15       ││
  1488. ││  Hdr/ftr margin (lines):  3        │  │    Return from analysis:  No  YES  ││
  1489. ││          Lines per page:  66       │  │ Round calls to next min:  No  YES  ││
  1490. ││     Printer device name:  PRN:     │  │  Auto-save for PRF data:  NO  Yes  ││
  1491. ││    Sort by BBS identity:  No  YES  │  │    Use EGA/VGA 8x8 font:  NO  Yes  ││
  1492. ││  Always print a summary:  No  YES  │  │     Use growing windows:  NO  Yes  ││
  1493. ││      Single-sheet paper:  NO  Yes  │  ╘════════════════════════════════════╛│
  1494. ││    Eject using formfeed:  No  YES  │                                        │
  1495. │╘════════════════════════════════════╛                                        │
  1496. │                                                   ╒═ Utility options menu ══╕│
  1497. │╒════════════ Log files ═════════════╕             │ Return to higher menu   ││
  1498. ││          Date separator:  /        │             │ Edit these options      ││
  1499. ││          Time separator:  :        │             │ Printer-specific items  ││
  1500. ││   Full chrono log check:  NO  Yes  │             │ Save configuration      ││
  1501. ││      Remove U/D entries:  No  YES  │             │ Toggle bells & whistles ││
  1502. │╘════════════════════════════════════╛             │ eXit to DOS             ││
  1503. │                                                   ╘═════════════════════════╛│
  1504. ╘══════════════════════════════════════════════════════════════════════════════╛
  1505.                                             Return to the next higher menu level
  1506.           ─────────────────────────────────────────────────────────────────
  1507.                          Figure 7.1: Utility options screen
  1508.  
  1509.                The Utility options menu shows the current menu selection in
  1510.           reverse video.  Use the cursor keys to select a different command
  1511.           (press ENTER  when ready), or press a capitalized and highlighted
  1512.           letter.  Both make Qanalyst perform the selected function:
  1513.  
  1514.              Return to higher menu.  The phone record  menu  will disappear
  1515.              and the phone-rate menu will reappear.
  1516.  
  1517.              Edit these options.  Lets you change the  settings  of utility
  1518.              options (see below).
  1519.  
  1520.              Printer-specific items.  Lets you view and change the settings
  1521.              of items that are specific  to a particular printer.  Qanalyst
  1522.              can even be quick-configured for some popular printers.  Press
  1523.              ESC to return to the next higher menu.
  1524.  
  1525.           Qanalyst v2.0 User Manual                                      28
  1526.  
  1527.  
  1528.  
  1529.                 Choose a  printer.  Lets you quickly configure Qanalyst for
  1530.                 some of the many  popular  printers  on  the market.  Check
  1531.                 your printer manual to  see  if  your printer "thinks" like
  1532.                 one of the  printers  listed  on  the screen.  Press ESC to
  1533.                 return to the next higher menu.
  1534.  
  1535.                 Change the printer name.  Lets you enter a new name for the
  1536.                 printer.  This is for your information only.
  1537.  
  1538.                 Printer init string.   This  is the first thing sent to the
  1539.                 printer when a report  is  printed.    One special key, the
  1540.                 CTRL-P key, lets you  put  control codes in the string.  If
  1541.                 you wanted to  insert  a formfeed for example, press CTRL-P
  1542.                 and then press CTRL-L.  (An "L" will appear in  a different
  1543.                 color from the regular text.)
  1544.  
  1545.                 prInter exit string.  This is the last thing  sent  to  the
  1546.                 printer when a report is printed.  See above.
  1547.  
  1548.                 Begin boldface command.  This  is the command you'd send in
  1549.                 order to turn  ON  the boldface printing capability of your
  1550.                 printer.
  1551.  
  1552.                 End  boldface  command.   This is the command you'd send in
  1553.                 order to  turn OFF the boldface printing capability of your
  1554.                 printer.
  1555.  
  1556.              Save  configuration.  Saves all configuration data,  including
  1557.              the utility-option data, in a file.  This command is identical
  1558.              to the one on the main menu.  QANALYST.CFG will be  created in
  1559.              the default directory if no filename was specified.
  1560.  
  1561.              Toggle bells & whistles.  Turns beeps ON and OFF.
  1562.  
  1563.              eXit to DOS.  Stop the program.  You can also press ALT-X like
  1564.              in Qmodem, or plain old CTRL-C.
  1565.  
  1566.  
  1567.           7.1  Editing the utility options
  1568.  
  1569.  
  1570.                If you edit the utility options, you can "tweak" Qanalyst so
  1571.           it does just what you like.  Options will become  capitalized and
  1572.           highlighted, meaning you can modify them.
  1573.                The following  lists each item on the Utility options screen
  1574.           and its possible settings:
  1575.  
  1576.              Date separator.  Qanalyst  assumes  log  entry dates appear in
  1577.              one of two formats: "xx/xx/xx" or "xx-xx-xx".  The "/"  or "-"
  1578.              symbol is called a date separator character.  This option lets
  1579.              you  specify  a  third  separator  character.    Qanalyst will
  1580.              automatically insert the  date separator defined in QMODEM.CNF
  1581.              if it finds the file at startup.  (Qanalyst still looks  for a
  1582.              "/" or "-" date separator, don't worry about that.)
  1583.  
  1584.           Chapter 7, "Utility options"                                   29
  1585.  
  1586.  
  1587.  
  1588.              Time separator.  Qanalyst  assumes  log  entry times appear in
  1589.              one format: "xx:xx:xx".  The ":" symbol is  a  time separator.
  1590.              This option lets you  specify  a  second  separator character.
  1591.              Qanalyst  automatically inserts the time separator defined  in
  1592.              QMODEM.CNF  if  it  finds the file at startup.  (Qanalyst will
  1593.              still  look  for  the ":" time separator,  don't  worry  about
  1594.              that.)
  1595.  
  1596.              Full chrono log check.  Qanalyst assumes a log  file  runs  in
  1597.              chronological order.  But if you want to be certain,  set this
  1598.              option to Yes to make Qanalyst check the  chronology  of every
  1599.              log entry.  NOTE: the initial reading of each  log  file  will
  1600.              take about six times longer  to  complete!    (Everything else
  1601.              runs the same, though.)
  1602.  
  1603.              Remove U/D entries.  Qanalyst removes  log  entries concerning
  1604.              uploads & downloads during a condense if you set this  to Yes.
  1605.              This is useful for people who (1) don't care to see reports on
  1606.              files they transferred and (2) don't call places like GEnie or
  1607.              CompuServe.   Condensed log files will retain  upload/download
  1608.              log entries if you set this to No.
  1609.  
  1610.              Number of copies.   This  dictates how many copies of a report
  1611.              will  be printed.  Use the up & down arrow keys to change this
  1612.              value.
  1613.  
  1614.              Left indent (chars).  The number of spaces Qanalyst will "pad"
  1615.              on the left side before it prints a line.  This  is especially
  1616.              useful for people using wide paper because they can center the
  1617.              report on the page.  Use  the  up  & down arrow keys to change
  1618.              this value.  The centering formula is (x-78)/2, where x is the
  1619.              number of characters you can print on a line.
  1620.  
  1621.              Hdr/ftr margin (lines).   The  number  of blank lines Qanalyst
  1622.              puts at the top &  bottom  of  each  page.   Use the up & down
  1623.              arrow keys to change this value.
  1624.  
  1625.              Lines per page.   The number of lines on a page of paper.  Use
  1626.              the up & down arrow keys to change this value.
  1627.  
  1628.              Printer device name.  If Qanalyst sends a report to a printer,
  1629.              it will send it to this device name.  Many printers are set up
  1630.              to be the "PRN" device,  but some people have different needs.
  1631.              Do NOT put a colon at the end of the device name.
  1632.  
  1633.              Sort by BBS identity.  Set  this  to Yes to make Qanalyst sort
  1634.              the  detailed reports by BBS name.  Set this to No to sort the
  1635.              reports by their phone numbers.
  1636.  
  1637.              Always print a summary.  Set this to Yes if you  want Qanalyst
  1638.              to print a summary report when you choose to print  a detailed
  1639.              report.
  1640.  
  1641.           Qanalyst v2.0 User Manual                                      30
  1642.  
  1643.  
  1644.  
  1645.              Single-sheet paper.  Set  this  to Yes if you want Qanalyst to
  1646.              stop at the end of each page so you can load another sheet.
  1647.  
  1648.              Eject using formfeed.  Set this to Yes if  your  printer  uses
  1649.              the common "formfeed" symbol to  eject a page.  (Most printers
  1650.              will accept this.)
  1651.  
  1652.              Currency  symbol.    America uses "$" to designate money.  Use
  1653.              the up & down arrow keys to change this character if you wish.
  1654.  
  1655.              Status  msg  delay  (sec).    The maximum number of seconds  a
  1656.              status message remains on  the  screen  before  it disappears.
  1657.              Use the up & down arrow keys to change this value.
  1658.  
  1659.              Return  from analysis.  Set this to Yes if you want to go back
  1660.              to the main menu screen when analysis/maintenance is complete.
  1661.              Set it to No if  you want to go back to DOS.  (This is ignored
  1662.              when the /B command-line option is used.)
  1663.  
  1664.              Round calls to next min.  Set this to Yes if the phone company
  1665.              begins charging for a call as soon as the other party picks up
  1666.              the phone.  It takes modems a few seconds to connect with each
  1667.              other, and Qanalyst normally rounds each call up  to  the next
  1668.              higher minute to make up for this.  PC-Pursuit users  may want
  1669.              to  set this to No if calls begin with one free minute.  Note:
  1670.              every call, to every telephone  number,  is  affected  by this
  1671.              option.
  1672.  
  1673.              Auto-save for PRF data.  Qanalyst will  automatically generate
  1674.              a new phone-rate data file  after analyzing the log(s) if this
  1675.              is set to Yes.  It  will  leave the phone-rate data file as-is
  1676.              if it is set to No.  Caution: See appendix section  D.3 before
  1677.              changing this option.
  1678.  
  1679.              Use EGA/VGA 8x8 font.    This works only on computers using an
  1680.              EGA  or  VGA  (or better) monitor.  It is equivalent to the /8
  1681.              option (see page 10 for  details).  Qanalyst switches into the
  1682.              8x8 font when this is set  to  Yes, and will use whatever font
  1683.              is  active when it is set to No.  The switching occurs as soon
  1684.              as you return to the main menu screen.
  1685.  
  1686.              Use growing windows.  This is equal to  the  "Growing Windows"
  1687.              option in Qmodem.  Windows will "grow" as they appear and will
  1688.              "shrink" as they disappear.  Try it, it doesn't hurt anything.
  1689.              Qanalyst automatically uses the growing-windows toggle defined
  1690.              in QMODEM.CNF if it finds the file at startup.   (Hint: choose
  1691.              growing windows, go to the main menu, and then go back  to the
  1692.              utility options.  Windows will grow all over the screen.)
  1693.  
  1694.           Chapter A, "Error messages"                                    31
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.                                      Appendix A
  1702.  
  1703.                                    Error messages
  1704.  
  1705.  
  1706.           A.1  Regular error messages
  1707.  
  1708.  
  1709.                Regular error messages appear for  a few seconds to tell you
  1710.           something is wrong.  The following is a list of such messages and
  1711.           their possible causes.  (We  left out the obvious possible causes
  1712.           like an unformatted disk or an open drive door.)
  1713.  
  1714.           Cannot send report to a read-only file.
  1715.  
  1716.           Cannot send report to an invalid filename.
  1717.  
  1718.           Caution: using a v1.0 config file.
  1719.                Qanalyst determined the configuration file is stored  in the
  1720.           v1.0 format.  Check to make sure the data is what you expect.
  1721.  
  1722.           Caution: using a v1.0 phone-rate file.
  1723.                Qanalyst determined the phone-rate  file  is  stored  in the
  1724.           v1.0 format.  Check to make sure the data is what you expect.
  1725.  
  1726.           Could not find that file.
  1727.  
  1728.           Couldn't find log listed in configuration.
  1729.                One or more log files listed in the configuration file could
  1730.           not be found.
  1731.  
  1732.           Couldn't recognize "xxxxxxxx".
  1733.                Multiple command-line options were specified without a space
  1734.           or tab to separate them.  "/I/N" is not acceptable, you  must say
  1735.           "/I /N".
  1736.                An invalid command-line option was specified.
  1737.                The specified Qanalyst configuration file doesn't exist.
  1738.  
  1739.           DOS says today is Tue 1-1-80!  That's not right!
  1740.                The DOS date is not set properly.  It won't affect Qanalyst,
  1741.           but it could mean a bad log  file.    See  section  1.3  for more
  1742.           information.
  1743.  
  1744.           Qanalyst v2.0 User Manual                                      32
  1745.  
  1746.  
  1747.  
  1748.           Error detected while writing a report to the printer or file.
  1749.                The printer has gone off-line for some unknown reason.
  1750.                The disk has become full.
  1751.                Tried to write a file on a write-protected disk.
  1752.                You declared an  invalid  printer device name in the utility
  1753.           options.  See chapter 7.
  1754.                You declared a printer initialization (or exit) string which
  1755.           somehow shuts down the printer so no more text will  be accepted.
  1756.           See chapter 7.
  1757.                Too many files open at once.  Check your CONFIG.SYS  file to
  1758.           see about increasing the FILES=  entry.  (Consult your DOS manual
  1759.           if  you are unfamiliar with this.)  If you use a program that can
  1760.           remove TSRs from memory, it may not have closed the files used by
  1761.           those TSRs.
  1762.  
  1763.           Error while reading or writing the xxxxxxxx file.
  1764.                The file is not a  valid Qanalyst v2.0 configuration file or
  1765.           phone-rate file, or QMODEM.CNF v4.0 file.  (You  might  be trying
  1766.           to read a file generated by a later version of Qanalyst.)
  1767.                The disk has become full.
  1768.                Tried to write or erase a read-only file.  (Note: This error
  1769.           doesn't occur if Qanalyst tries to erase a backup log file.   The
  1770.           file will be erased whether or not it is read-only.)
  1771.                Tried to write or erase a file on a write-protected disk.
  1772.  
  1773.           Printer is not connected, or is not turned on.
  1774.  
  1775.           Printer is not ready, for some unknown reason.
  1776.  
  1777.           Sorry, that is a backup log file.
  1778.                The log file has a ".BAL" extension.  Rename the file.
  1779.  
  1780.           That file is labeled as "read-only".
  1781.  
  1782.           That is not a valid filename.
  1783.  
  1784.           That phone record already exists.
  1785.                The phone number you tried to add to the phone-rate data has
  1786.           already been entered.  Qanalyst will display the record for you.
  1787.  
  1788.           The DOS PRINT program has control of the printer.
  1789.                Background printing  is being performed on your system.  The
  1790.           program will simply wait for the printing to finish.
  1791.  
  1792.           The log file has no log entries.
  1793.                The file is not a true Qmodem log file.
  1794.                The file exists but is empty.
  1795.                You used  a date separator and/or a time separator character
  1796.           other than the ones specified in Qanalyst.
  1797.  
  1798.           Appendix A, "Error messages"                                   33
  1799.  
  1800.  
  1801.  
  1802.           The log file is corrupted in some way!
  1803.                The computer lost  power  or rebooted while Qmodem was using
  1804.           the log file.  Some log entries were lost before being written to
  1805.           the log file.
  1806.                Qanalyst is executing inside a Qmodem-invoked DOS  shell and
  1807.           is  trying  to  use  the  same log file.  WARNING:  Unpredictable
  1808.           things may happen if you do this!  Be smart ── don't run Qanalyst
  1809.           from a Qmodem DOS shell.  (Consult appendix section C.5  for more
  1810.           details.)
  1811.                The log file was condensed by a program that does not retain
  1812.           vital log entries, or changes them to a different format.
  1813.  
  1814.           The log file is not in chronological order!
  1815.                The DOS date & time weren't set properly each and every time
  1816.           the computer was booted.  See section 1.3 for more information.
  1817.                An internal clock/calendar device failed to roll over to the
  1818.           new year or failed to recognize a leapday.  We know Juko products
  1819.           have this design flaw, among others.
  1820.                You reset the computer time  to make up for Daylight Savings
  1821.           Time just before or after a Qmodem session.
  1822.                The log file was created by a computer using DOS 3.20 but is
  1823.           being  analyzed  by  Qanalyst under a different DOS version.  See
  1824.           section 1.3 for details.
  1825.  
  1826.           There may not be enough free space on the disk.
  1827.                Qanalyst is about to perform maintenance on a  log  file but
  1828.           has noticed the disk is nearly  full.   The program will still do
  1829.           maintenance but will terminate with an error message  if  it runs
  1830.           out of working space.  The  original  log file will not be harmed
  1831.           if this occurs.
  1832.  
  1833.           Warning: a DOS 3.20 bug can corrupt logs!
  1834.                This information message appears whenever Qanalyst runs on a
  1835.           computer using DOS version 3.20.  See section 1.3.
  1836.  
  1837.  
  1838.           A.2  Fatal error messages
  1839.  
  1840.  
  1841.                Fatal errors are errors which force Qanalyst to  come  to an
  1842.           abrupt end.  "QANALYST PROGRAM TERMINATED:" appears on the screen
  1843.           with an explanation message  right  below it.  The following is a
  1844.           list of such messages and their possible causes.
  1845.  
  1846.           Qanalyst v2.0 User Manual                                      34
  1847.  
  1848.  
  1849.  
  1850.           Bad parameter or filename on the MS-DOS command line.
  1851.                Multiple command-line options were specified without a space
  1852.           or tab to separate them.  "/I/N" is not acceptable, you  must say
  1853.           "/I /N".
  1854.                An invalid command-line option was specified.
  1855.                The /B option was specified but the program could not find a
  1856.           configuration file.  Declare a  valid filename on the DOS command
  1857.           line, or put QANALYST.CFG where it can be found.
  1858.                The /B option and /I  option were specified together.  These
  1859.           two options are mutually exclusive.
  1860.                The /F or /T option was not correctly specified.  The format
  1861.           must be "/F" or "/Fxx/xx/xx".  Don't put a space anywhere in it.
  1862.                The date specified for the /F option is later than  the date
  1863.           specified for the /T option.  Swap the dates.
  1864.                The /F or /T option specifies an invalid date.
  1865.  
  1866.           Cannot send report to a read-only file.
  1867.                The /B option was specified and the report was to be sent to
  1868.           a file, but it is designated as a read-only file.
  1869.  
  1870.           Cannot send report to an invalid filename.
  1871.                The /B option was specified and the report was to be sent to
  1872.           a file, but the filename is invalid.  It might now be a directory
  1873.           or a volume label instead of a legitimate filename.
  1874.  
  1875.           Couldn't find log listed in configuration.
  1876.                The /B option was specified but one or more of the log files
  1877.           listed in the configuration file could not be found.
  1878.  
  1879.           Error while reading or writing the xxxxxxxx file.
  1880.                See the reasons listed for this same error message in appen-
  1881.           dix section A.1.
  1882.                The phone-rate file is corrupted.
  1883.  
  1884.           Error detected while writing a report to the printer or file.
  1885.                See the reasons listed for this same error message in appen-
  1886.           dix section A.1.
  1887.  
  1888.           Not enough memory to continue.
  1889.                Qanalyst "grows" while  it  analyzes log files, and grew too
  1890.           large to fit in memory.   Remove memory-resident programs and try
  1891.           it again.   If you use multitasking software, increase Qanalyst's
  1892.           memory allotment or remove other programs from the queue.
  1893.  
  1894.           Qmodem Log file: xxxxxxxx was positioned at line nnnn.
  1895.                An information message showing which log  file  Qanalyst was
  1896.           using and the line  number  it was positioned at when the program
  1897.           terminated.  This message appears  only if the problem involved a
  1898.           log file.
  1899.  
  1900.           Runtime error nnnn at xxxx:yyyy
  1901.                This "catch-all" error message means a problem occurred that
  1902.           Qanalyst wasn't programmed to handle.  Please tell Barn Owl Soft-
  1903.           ware if you get  this  message and give a detailed description of
  1904.  
  1905.           Appendix A, "Error messages"                                   35
  1906.  
  1907.  
  1908.  
  1909.           what you did that led  up to it.  Call the support BBS 24 hours a
  1910.           day at (618) 398-5703.
  1911.  
  1912.           The log file has no log entries.
  1913.                See the reasons listed for this same error message in appen-
  1914.           dix section A.1.
  1915.  
  1916.           The log file is corrupted in some way!
  1917.                See the reasons listed for this same error message in appen-
  1918.           dix section A.1.
  1919.  
  1920.           The log file is not in chronological order!
  1921.                See the reasons listed for this same error message in appen-
  1922.           dix section A.1.
  1923.  
  1924.  
  1925.           A.3  Exit codes
  1926.  
  1927.  
  1928.                Qanalyst generates an exit code when it is  done  that tells
  1929.           how the session went.  The  code  is known as the "ERRORLEVEL" in
  1930.           batch files.  (Consult your DOS manual if you are unfamiliar with
  1931.           this.)  The possible exit codes are:
  1932.  
  1933.                            Table A.1: Qanalyst exit codes
  1934.           ─────────────────────────────────────────────────────────────────
  1935.            0 : Normal termination (or user pressed ALT-X or CTRL-C)
  1936.            1 : Error while reading or writing the configuration file
  1937.            2 : Error while reading or writing the phone-rate file
  1938.            3 : Error while reading the QMODEM.CNF file
  1939.            4 : Error while writing a report to the printer or file
  1940.            5 : Error while reading or writing the log file
  1941.            6 : The log file has no log entries
  1942.            7 : The log file is not in chronological order
  1943.            8 : The log file is corrupted in some way
  1944.            9 : Bad parameter or filename on the MS-DOS command line
  1945.           10 : Couldn't find log file listed in configuration
  1946.           11 : Not enough memory to continue
  1947.           12 : Cannot send report to a read-only file
  1948.           13 : Cannot send report to an invalid filename
  1949.           ─────────────────────────────────────────────────────────────────
  1950.  
  1951.           Qanalyst v2.0 User Manual                                      36
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.                                      Appendix B
  1959.  
  1960.                                  Qanalyst v1.0 users
  1961.  
  1962.  
  1963.                This appendix is for users  upgrading from Qanalyst v1.0.  A
  1964.           number of changes have been made to the program.  This will offer
  1965.           the upgrading Qanalyst user a quick look at what's new.
  1966.  
  1967.                The biggest addition  to  Qanalyst is its ability to analyze
  1968.           your uploads and downloads.  This of course includes the  cost to
  1969.           transfer those files.
  1970.                Qanalyst can now generate a  report based solely on the last
  1971.           call you made or on a specific telephone number.    See  appendix
  1972.           section C.2.
  1973.                Host BBS charges can now be entered separate  from  the cost
  1974.           of the phone call itself.  (This will be a boon to CompuServe and
  1975.           GEnie subscribers.)  You can even specify if a host  BBS suspends
  1976.           charges during uploads, meaning a  more  accurate  cost analysis.
  1977.           See chapter 6.
  1978.                Qanalyst v2.0 automatically reads its v1.0 files.
  1979.                Qanalyst v2.0 isn't compatible with Qmodem v3.x logs.  Don't
  1980.           keep appending to an old Qmodem log file!  Start a  brand-new log
  1981.           when you get Qmodem v4.0.
  1982.                We  no longer call it the "phone log file."  We now refer to
  1983.           it simply as the "log file".  Some users were confusing the phone
  1984.           log file with the phone-rate file.
  1985.                The following command-line options are no longer  valid: /L,
  1986.           /P, /S, and /W.  They are now part of the configuration file data
  1987.           and you can change them on the screen.  See section 7.
  1988.                The following command-line options were added:  /E,  /F, and
  1989.           /T.  See section 2.1.
  1990.                You can now declare  specific  to/from  dates on the command
  1991.           line.  You are no longer forced to analyze/maintain an entire log
  1992.           file when running under the /B command-line option.
  1993.                Qmodem v4.0's ALT-D prefix  codes  are  now reflected in the
  1994.           log file, giving users the power to tailor some phone  numbers so
  1995.           Qanalyst views them  as  toll records instead of long-distance or
  1996.           "odd" records, for example.  (Consult your Qmodem  manual  if you
  1997.           are unfamiliar with this.)  See appendix section D.4.
  1998.                Qanalyst now sorts the detailed report by BBS  name,  not by
  1999.           phone number.  You can still request sorting by the  phone number
  2000.           if you wish.  See chapter 7.
  2001.                The  Append-from-phone-logs menu command has been  augmented
  2002.           by the Condense-phone-rate-data menu  command.    See page 20 and
  2003.           also see appendix section D.3.
  2004.                There is better support for people who use MicroSoft Windows
  2005.           or DoubleDOS multitasking software.  See section 1.6.
  2006.                Qanalyst can now initialize your printer and use boldface to
  2007.           accentuate reports.  See page 27.
  2008.  
  2009.           Appendix C, "Helpful hints"                                    37
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.                                      Appendix C
  2017.  
  2018.                                     Helpful hints
  2019.  
  2020.  
  2021.           C.1  Invoking Qanalyst
  2022.  
  2023.  
  2024.                Here are a few visual aids for Qanalyst's start-up options:
  2025.  
  2026.           QANALYST
  2027.                     Starts the program with no special instructions.
  2028.  
  2029.           QANALYST  /I/N
  2030.                     Wrong!  You must put a space between each option.   The
  2031.           program will only see the /I option in this case.
  2032.  
  2033.           QANALYST  /N
  2034.                     The program starts up in silent mode.  You can turn the
  2035.           bells & whistles on or off at any menu.
  2036.  
  2037.           QANALYST  /B  /F1-1:60  C:\DOS\DATA\MY-DATA.CFG
  2038.                     The program runs automatically, using the configuration
  2039.           information  in  MY-DATA.CFG.   (You could print a report of your
  2040.           calls whenever you boot up, for example.)  The program  will only
  2041.           operate  on log entries that fall between  1-1-89  and  the  date
  2042.           which is 60 days later ── in this case, 3-2-89.
  2043.  
  2044.           QANALYST  /F  /T
  2045.                     The program defaults to log entries falling  on today's
  2046.           date.  It's an easy way to summarize what calls you made and what
  2047.           files you've transferred so far today.
  2048.  
  2049.           QANALYST  /I  /E
  2050.                     Orders the program to use its internal defaults instead
  2051.           of looking for a configuration file.  It will also ignore LIM EMS
  2052.           memory if present.
  2053.  
  2054.           QANALYST  /BL  C:\QMODEM\LASTCALL.CFG
  2055.                     The program runs automatically and generates reports on
  2056.           the very last call you made.  LASTCALL.CFG is a  special Qanalyst
  2057.           configuration file which is set up for last-call analysis.
  2058.  
  2059.  
  2060.           C.2  Last call?  One phone number?
  2061.  
  2062.  
  2063.                Qanalyst v2.0 introduces  the option of "last-call" analysis
  2064.           and "single-number" analysis.  You can now order  the  program to
  2065.           generate reports based solely on the last call you made,  or just
  2066.           on calls to a specific telephone number.
  2067.  
  2068.           Qanalyst v2.0 User Manual                                      38
  2069.  
  2070.  
  2071.  
  2072.                Use the /BL option when you want to generate a report on the
  2073.           last call you made.  Use the /BS option when you want to generate
  2074.           a report for a specific telephone number.  Please become familiar
  2075.           with the /B option first.  (See page 10.)
  2076.                Be sure  to create a special Qanalyst configuration file for
  2077.           each purpose and include the name on the command  line  when  you
  2078.           use the /BL or /BS option.  You can even get Qmodem to do all the
  2079.           work for you in a SCRipt file if you want.  (See appendix section
  2080.           C.5 for hints.)
  2081.                If you use the /BL option,  you  must list only one log file
  2082.           in your configuration file.  If  you  use the /BS option, you may
  2083.           specify all the log files you want (up to 20).
  2084.  
  2085.                You can, of course,  specify  /BL and /BS together.  You can
  2086.           get  a report of the last call you made to a specific BBS whether
  2087.           or not it was the very last call you placed.
  2088.  
  2089.                You're probably thinking that Qmodem might  someday  be able
  2090.           to directly query Qanalyst for phone call costs and pop it  up on
  2091.           the  screen  in  a Qmodem window, right?  We encourage you to bug
  2092.           Forbin Project about it if you'd like to see this capability in a
  2093.           future version of Qmodem.  Tell them they should  switch  to  the
  2094.           powerful new Call Data Standard for communications programs.
  2095.  
  2096.  
  2097.           C.3  Getting rates from Ma Bell
  2098.  
  2099.  
  2100.                Your biggest problem with Qanalyst may be getting phone-rate
  2101.           data out of your phone company.  The following tips  are probably
  2102.           the most important ones you'll find in this manual.
  2103.  
  2104.                Operators usually say long-distance calls are charged by the
  2105.           mileage between you and the other line.  However, if you know the
  2106.           cost for one number in a given area code, you can pretty much use
  2107.           that figure for all numbers in that area code.  Area code default
  2108.           records come in quite handy in Qanalyst.
  2109.                Operators will  usually supply you with two complete sets of
  2110.           phone-rate data for a given area code or toll prefix.  Try not to
  2111.           ask for more data in a single call.  Remember, operators  have to
  2112.           help other customers too.
  2113.                If you use AT&T, call (800) 222-0300 and ask for  the "cheat
  2114.           sheet" for nationwide long-distance rates.  It shows distances to
  2115.           many cities and the rates for various distances.  Their chart can
  2116.           help you calculate phone-rate data on your own.  (The other long-
  2117.           distance services probably have a similar chart.)
  2118.  
  2119.  
  2120.           C.4  Get the correct time
  2121.  
  2122.  
  2123.                One thing you can depend on is the fact that all  phone com-
  2124.           panies set their timing clocks according to an atomic clock.  You
  2125.           can find out the absolute correct time by dialing one.  You might
  2126.  
  2127.           Appendix C, "Helpful hints"                                    39
  2128.  
  2129.  
  2130.  
  2131.           want to call one  occasionally  to make sure your computer is set
  2132.           to the correct time.
  2133.                You can hear  the  correct time from the Naval Observatory's
  2134.           master atomic clock by dialing (900) 410-8463.  There is a fifty-
  2135.           cent charge for each call.
  2136.                You can also get  the  correct time from any ham radio tuner
  2137.           by  tuning to 10.0000MHz.  The time is called out by voice and by
  2138.           Morse code once a minute with an audible tick every second.
  2139.  
  2140.  
  2141.           C.5  Shelling to DOS from Qmodem
  2142.  
  2143.  
  2144.                We've said it before and we'll say it again.  You run a risk
  2145.           of corrupting your log file if you use Qanalyst while you're in a
  2146.           Qmodem DOS shell.  The  problem surfaces when both programs fight
  2147.           for control of the same log file at the same time.
  2148.                This problem can be fixed  if you use Qmodem's ALT-0 command
  2149.           just before you shell to DOS.  You will of  course  have to press
  2150.           ALT-0 again to restart the log when you exit the shell.
  2151.                If you want to use Qanalyst from inside a Qmodem  DOS shell,
  2152.           we recommend you use the following QANALYST.SCR SCRipt file:
  2153.           ─────────────────────────────────────────────────────────────────
  2154.           ; SCRipt to *safely* run Qanalyst from a Qmodem DOS shell.
  2155.           TURNOFF LOG
  2156.           DOS "QANALYST"
  2157.           LOG SESSION.LOG
  2158.           RETURN
  2159.           ─────────────────────────────────────────────────────────────────
  2160.                      Figure C.1: Sample QANALYST.SCR SCRipt file
  2161.  
  2162.           Next, attach this SCRipt to one of your function keys so  you can
  2163.           call it with a single keystroke.  (Consult your Qmodem  manual if
  2164.           you are unfamiliar with this.)  Put "@SCRIPT QANALYST.SCR" in the
  2165.           function key.
  2166.                If you decide to execute Qanalyst from Qmodem, you can press
  2167.           a single  function key.  Qmodem will relinquish SESSION.LOG while
  2168.           you work in the DOS shell.
  2169.  
  2170.                You can modify this SCRipt slightly so Qanalyst reports only
  2171.           on the last phone call you made!  You'll instantly know  how much
  2172.           you spent on your most recent call.  See appendix section C.2 for
  2173.           more details.
  2174.  
  2175.  
  2176.           C.6  Special calling problems
  2177.  
  2178.  
  2179.                There are a number of cases where people dial local  or toll
  2180.           numbers that can confuse Qanalyst.   In Maryland for example, you
  2181.           have to dial your area code to make a toll call.  In Los Angeles,
  2182.           you never dial a "1" prefix to reach a toll number.   Brookville,
  2183.           Indiana residents don't have to dial all seven digits for a local
  2184.           call (they can get away with five).  The list goes on.
  2185.  
  2186.           Qanalyst v2.0 User Manual                                      40
  2187.  
  2188.  
  2189.  
  2190.                Qanalyst has to draw the line at some point: it can't handle
  2191.           every possible dialing anomaly.  But there are a few ways you can
  2192.           fool Qanalyst into handling these cases so the phone numbers show
  2193.           up in the right place on your report.  The methods presented here
  2194.           have  their pros & cons, and this is by no means a complete list.
  2195.           They're here to spur your imagination to find a solution  to your
  2196.           dialing anomaly.
  2197.                Please note that most of these methods involve Qmodem v4.0's
  2198.           enhancements to the  ALT-D  prefix code capability.  See appendix
  2199.           section D.4 and also consult your Qmodem manual  before  you play
  2200.           with prefix codes.
  2201.  
  2202.                If  you have to dial your own area code to make a toll call,
  2203.           you can create a  Qmodem  ALT-D prefix code that contains the "1"
  2204.           prefix and your area code.  Next, change  your  dialing directory
  2205.           entries so they show  the  prefix code instead of your area code.
  2206.           The prefix code will show up  in  your log file and Qanalyst will
  2207.           internally convert it to a "1".  As far as Qanalyst is concerned,
  2208.           it's working with a toll number.
  2209.                Or, you can just create a default area code record  for your
  2210.           area code.  It will act like the toll root  default  record.  The
  2211.           toll-rate function of the program will simply go unused.
  2212.  
  2213.                If you don't need a "1" prefix to call a toll number, create
  2214.           a Qmodem ALT-D prefix code with  no  information in it.  Add this
  2215.           prefix code to the appropriate dialing directory entries.  Qmodem
  2216.           will write it in the log file and Qanalyst will think  you dialed
  2217.           a toll number.
  2218.  
  2219.                If you don't need to dial all seven digits to connect with a
  2220.           local BBS, it's best to put the whole phone number in the dialing
  2221.           directory entry.  Two digits won't make a difference to Qmodem.
  2222.  
  2223.  
  2224.           C.7  Special phone rates
  2225.  
  2226.  
  2227.                If you pay a set rate for calls no matter how long you talk,
  2228.           specify that cost as the daytime/evening/nighttime "first minute"
  2229.           phone company rate.    The "subsequent minute" phone company rate
  2230.           should be set to zero.
  2231.                If you have AT&T's "Reach  Out America" plan, enter the same
  2232.           rate for the first & subsequent hour nighttime  rates.   Qanalyst
  2233.           doesn't calculate calls like AT&T does on this plan.  (Change the
  2234.           nighttime rates  on the long-distance root default record and any
  2235.           long-distance records  you've declared).  And remember to set the
  2236.           nighttime starting time to 22:00.
  2237.                PC-Pursuit users may want to consider setting  the Utilities
  2238.           menu "Round calls to next min" option to No.  This  might improve
  2239.           the  accuracy  of  long-distance reports.  See chapter 7 for more
  2240.           information.
  2241.  
  2242.           Appendix D, "Troubleshooting"                                  41
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.                                      Appendix D
  2250.  
  2251.                                    Troubleshooting
  2252.  
  2253.  
  2254.           D.1  Log file problems
  2255.  
  2256.  
  2257.                Remember to exit  from  Qmodem with the ALT-X command before
  2258.           you shut off your computer!  Failing to do so may corrupt the log
  2259.           file.  Important information will be lost before it is written to
  2260.           disk.  You should ALWAYS terminate Qmodem with the ALT-X command.
  2261.           Be nice to your log file.
  2262.                Be sure to start new log files if you ever change the Qmodem
  2263.           date/time separator characters.  Qanalyst expects these to remain
  2264.           constant in each log file.  You'll confuse Qanalyst if it changes
  2265.           to some other character.
  2266.  
  2267.  
  2268.           D.2  Qmodem log anomalies
  2269.  
  2270.  
  2271.                The Forbin Project made quite a few changes to the  log file
  2272.           format based on our suggestions, but they didn't heed all  of our
  2273.           advice.  Please be aware of the following:
  2274.  
  2275.           18:24:01  01-17-89  MANUAL DIAL > ATDT398-5703^M
  2276.                All MANUAL  DIAL commands are logged regardless of whether a
  2277.           connection is made.  The modem command sequence itself is entered
  2278.           into the log file  (not  just the phone number).  Qanalyst cannot
  2279.           properly extract the phone number in many cases, and it sometimes
  2280.           mishandles a call that fails to connect.  Qanalyst will highlight
  2281.           any MANUAL DIAL entries in its reports because of this.
  2282.                Caution: if  you use Qmodem's Manual Dial capability and you
  2283.           enter a bad number (say you forgot to put a "1" at the start of a
  2284.           long-distance number), your error will show up in the log file.
  2285.                Please avoid Qmodem's manual dialing capability.  We suggest
  2286.           you temporarily place the number in a free phone directory entry,
  2287.           tag it for dialing, and then remove it when you're done.
  2288.  
  2289.           18:32:06  01-19-89  @HOST CALLBACK KAREN MILLER Number > 398-5703
  2290.                All HOST CALLBACK attempts are logged regardless  of whether
  2291.           the remote user establishes a re-connect.  Qanalyst can handle it
  2292.           correctly in most cases, but there are a few exceptions where the
  2293.           program will unknowingly generate an inaccurate report.
  2294.  
  2295.           Qanalyst v2.0 User Manual                                      42
  2296.  
  2297.  
  2298.  
  2299.           D.3  Phone-rate file problems
  2300.  
  2301.  
  2302.                Be  careful  when  you use the "Append from phone logs" menu
  2303.           command or the "Auto-save for PRF data" option!  Both will create
  2304.           records for  specific phone numbers, which can cause big problems
  2305.           later on.
  2306.                These commands let you quickly create a phone-rate data file
  2307.           with records for every phone number in the log(s).  You  can make
  2308.           changes to records without having to create them first.
  2309.                The problem comes along later, when you make more changes to
  2310.           the phone-rate data.  If you change an  area-code  default record
  2311.           and you didn't realize there were still some records for specific
  2312.           numbers, your reports will probably be inaccurate.  Qanalyst will
  2313.           ignore the area-code default record  if it finds a prefix default
  2314.           record or a specific-number record.
  2315.                The "Condense  phone rate data" menu command will remove any
  2316.           redundant phone-rate records.  Be sure to use it when  you finish
  2317.           making changes to the phone-rate data.  You won't have  to change
  2318.           so many records later on if your phone rates go up or down.  (Why
  2319.           keep redundant data?)
  2320.  
  2321.                If you call networks which charge you for  your  online time
  2322.           (CompuServe and GEnie are good examples),  check  your phone-rate
  2323.           files and separate the network's charges from the phone company's
  2324.           charges.  This helps produce more accurate reports.
  2325.  
  2326.  
  2327.           D.4  Report problems
  2328.  
  2329.  
  2330.                If your report cost totals  come out weird, it usually means
  2331.           you supplied bad phone-rate data.  Check the following:
  2332.  
  2333.              1.  Did you specify the proper to/from analysis dates for each
  2334.                  log configuration?    Did  you  accidentally  enter  a log
  2335.                  configuration twice?   (Some  people do this on purpose to
  2336.                  generate reports for a non-contiguous calling period.)
  2337.  
  2338.              2.  Does the phone-rate data file  contain  a  record  for the
  2339.                  specific phone number?  If so, Qanalyst will use that cost
  2340.                  data instead of looking at a default record.  See appendix
  2341.                  section D.3.
  2342.  
  2343.              3.  Did you specify minute or hourly rates?  Costs will  be 60
  2344.                  times larger or smaller if you mix these up.  (If Qanalyst
  2345.                  prints '****' instead of a number, you probably entered an
  2346.                  hourly rate and said the cost was by the minute.)
  2347.  
  2348.              4.  Did  you  specify  when daytime/evening/nighttime rates go
  2349.                  into effect?  Did you enter the times correctly?
  2350.  
  2351.           Appendix D, "Troubleshooting"                                  43
  2352.  
  2353.  
  2354.  
  2355.              5.  Did you specify if uploads are free of  host  BBS charges?
  2356.                  (This only applies if you  entered  host  BBS  cost data.)
  2357.                  Did you use a v1.0 phone-rate file?  Study your phone-rate
  2358.                  data to make sure it's accurate.  It could be that  a host
  2359.                  BBS charge was combined with a phone company charge.
  2360.  
  2361.              6.  Did you set the  master  override-rate  schedules properly
  2362.                  for daytime/evening/nighttime rates?  Did you set them for
  2363.                  phone company costs as well as for host BBS costs?
  2364.  
  2365.                You might find it easier to print the phone-rate data so you
  2366.           can see it on paper.  The "Print phone-rate data" menu command is
  2367.           explained on page 20.
  2368.  
  2369.                Problems may be hidden in  the  Qmodem  ALT-D  prefix codes.
  2370.           (Consult your Qmodem manual if  you  are  unfamiliar  with this.)
  2371.           Qanalyst tries its best  to  handle the prefix codes but it can't
  2372.           account for every possibility.
  2373.                Qanalyst internally strips all  front-end  prefix  codes and
  2374.           appends a "1" to the number unless it is already present.  Prefix
  2375.           codes  at the end of the number will be stripped off.  Any prefix
  2376.           code in the middle of the number will be left where it stands.
  2377.                As you can see, dialing a local number with front-end prefix
  2378.           codes would make Qanalyst think you dialed a toll number.   (This
  2379.           is just one example, of course.)
  2380.  
  2381.  
  2382.           D.5  Modem problems
  2383.  
  2384.  
  2385.                The following bulletin was taken from The Forbin Project BBS
  2386.           (the official support board for Qmodem).  It details some  of the
  2387.           problems which affect log files and thus affect  Qanalyst.   Many
  2388.           thanx go to John Friel for this useful information.
  2389.                Registered Qmodem users can contact the  Forbin  Project BBS
  2390.           at (319) 233-6517 to read many other helpful bulletins.
  2391.  
  2392.           Problem:  When I start up Qmodem, the Online/Offline indicator in
  2393.                     the status line always says ONLINE.  Why?
  2394.  
  2395.           Answer  :  The modem is sending a signal back to Qmodem saying it
  2396.                     is connected to another computer.  On Hayes 2400 modems
  2397.                     &  clones using the '&' (ampersand) extended  commands,
  2398.                     there is usually  a  command to control the CD (carrier
  2399.                     detect) signal.  The  default  mode  (unfortunately) is
  2400.                     for CD to be  on  all the time which makes Qmodem think
  2401.                     it is ONLINE.  To make things right, send the following
  2402.                     command to your modem from Qmodem's terminal mode:
  2403.                                         AT&C1
  2404.  
  2405.           Qanalyst v2.0 User Manual                                      44
  2406.  
  2407.  
  2408.  
  2409.                     You will have to check your modem manual to verify this
  2410.                     command in case it is not quite 100% Hayes compatible.
  2411.  
  2412.                     Modems this is known to cure:
  2413.                               Hayes 2400            (all models)
  2414.                               Hayes V-Series        (all models)
  2415.                               Practical Peripherals (all models)
  2416.                               Anchor Automation Patriot 2400i
  2417.  
  2418.                     Some modems, as in  the  case  of  the Courier HST from
  2419.                     USRobotics, have a switch which by default  has Carrier
  2420.                     forced true.  Switch number  6 is DOWN from the factory
  2421.                     and must be set  to  UP to work correctly.  Running the
  2422.                     HST20.SCR will bring this fact to light.
  2423.  
  2424.           Appendix E, "Acknowledgments"                                  45
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.                                      Appendix E
  2432.  
  2433.                                    Acknowledgments
  2434.  
  2435.  
  2436.                First, a note  of  thanks to every registered Qanalyst user.
  2437.           The shareware concept is based on the honesty & integrity  of the
  2438.           person using  the program.  Registered Qanalyst users have proven
  2439.           there's still a lot of honesty in the world.
  2440.                Please support all the shareware products you use.  And look
  2441.           for the ASP's distinctive three-disk  logo ── you can bet there's
  2442.           a professional standing behind his or her program!
  2443.  
  2444.  
  2445.           E.1  Dedication
  2446.  
  2447.  
  2448.                To my computer-widow wife, Denise, without whom I would have
  2449.           no one to tuck into bed at night.  (Can I say "I love you" in the
  2450.           Qanalyst manual?)  I hope no one will mind that I listed her name
  2451.           in the index.  <grin>
  2452.  
  2453.  
  2454.           E.2  The beta testers
  2455.  
  2456.  
  2457.                Everyone on the beta test  crew is a registered Qmodem user.
  2458.           There were quite a few beta testers since I opened up the testing
  2459.           to all registered users, so forgive me for  not  listing everyone
  2460.           by name.  They know know who they are!  Thanx, guys.
  2461.  
  2462.  
  2463.           E.3  Many thanx to
  2464.  
  2465.  
  2466.                John Friel  III and The Forbin Project, for the all-powerful
  2467.           Qmodem that got me started as a modemer;
  2468.                Karl Brendel, author of QFE (another  great  Qmodem enhance-
  2469.           ment program) and a good friend to have in the ASP;
  2470.                Philippe Kahn and his crew at Borland International, for the
  2471.           Turbo Pascal compiler and every structured program it spawns, and
  2472.           for the Sprint word processor which created this manual;
  2473.                Kim Kokkonen  and his crew at TurboPower Software, for their
  2474.           great Turbo Pascal toolkits & other fantastic products;
  2475.                Jim Button,  for pioneering the concept of shareware and for
  2476.           helping form the Association of Shareware Professionals.
  2477.  
  2478.           Qanalyst v2.0 User Manual                                      46
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.                                         Index
  2486.  
  2487.  
  2488.                  /8 10, 30                   floppy drive 7
  2489.                  /B 9, 10, 11, 30, 34,       Forbin Project 1
  2490.                    36, 38
  2491.                  /E 10                       G
  2492.                  /F 10, 15, 34               GEnie See: networks
  2493.                  /I 11, 34
  2494.                  /N 11                       H
  2495.                  /T 11, 15, 34               hints 25, 30, 37, 38
  2496.                                              holidays 21
  2497.                  A
  2498.                  AT&T                        L
  2499.                    Reach Out America 40      legal notices 1
  2500.                                              license
  2501.                  B                             corporate 4
  2502.                  backup file 16                volume discounts 4
  2503.                  BAL 16, 32
  2504.                  Barn Owl address 1          M
  2505.                  batch mode See: /B          MicroSoft
  2506.                                                Windows 9
  2507.                  C
  2508.                  Call Data Standard 9        N
  2509.                  cautions 8, 20, 22, 30,     networks 1, 24, 42
  2510.                    41, See Also:             notes 6, 8, 10, 11, 15,
  2511.                    warnings                    16, 19, 25, 26, 29,
  2512.                  CDS 9                         30, 32, 40, See Also:
  2513.                  cfg-file 10                   cautions
  2514.                  CompuServe See:
  2515.                    networks                  O
  2516.                  CONFIG.SYS 32               OmniView 9
  2517.                  configuration 10, 11,
  2518.                    12, 13, 14, 28, 31,       P
  2519.                    34, 37                    PC-Pursuit 30, 40
  2520.                                              phone-rate data 19, 22
  2521.                  D                           phone rates 22
  2522.                  Denise 45                   PIF file See: MicroSoft
  2523.                  DESQView 9
  2524.                  disk vendors 3              Q
  2525.                  distributors See: disk      Qanalyst
  2526.                    vendors                     limited license 3
  2527.                  DOS 3.20 7                    registration 5
  2528.                  DoubleDOS 9                   support 4
  2529.                                                syntax 11
  2530.                  E                           QMODEM.CNF See: /B
  2531.                  ERRORLEVEL 35               Qmodem
  2532.                  exit code 35                  DOS shells 33, 39
  2533.                                                log anomalies 41
  2534.                  F
  2535.                  files 6
  2536.  
  2537.           Index                                                          47
  2538.  
  2539.  
  2540.  
  2541.                    prefix code               shareware 1, 2, 11
  2542.                    capability 25, 26,
  2543.                    36, 40, 43                T
  2544.                    versions 8                TaskView 9
  2545.                                              Telex See: networks
  2546.                  R                           The Source See:
  2547.                  registration 4, 5             networks
  2548.                    corporate 4               trademarks 1
  2549.                    volume discounts 4
  2550.                  reports                     V
  2551.                    bad reports 7, 23,        visual aids 37
  2552.                    25, 41, 42
  2553.                    just on last call 37      W
  2554.                                              warnings 8, 33, See
  2555.                  S                             Also: notes
  2556.                  screens                     warranty 2
  2557.                    EGA/VGA 10
  2558.