home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / wthrv115.zip / WEATHER.DOC < prev    next >
Text File  |  1994-01-24  |  47KB  |  926 lines
  1.      ┌────────────────────────────────────────────────────────────────────┐
  2.      │ ────────────────────────────────────────────────────────────────── │
  3.      │       WEATHER (a la Weather Information Download Service)          │
  4.      │                                                                    │
  5.      │                   by Blaine William Schmidt                        │
  6.      │                at Moobasi Optics, Ink. Software                    │
  7.      │                    Copyright (C) 1993-1994                         │
  8.      │ ────────────────────────────────────────────────────────────────── │
  9.      └────────────────────────────────────────────────────────────────────┘
  10.  
  11.  
  12.                                INTRODUCTION
  13.  
  14.     WEATHER is a full-featured, non-crippled piece of Shareware.  Its
  15.     purpose is to download weather forecasts from a weather service to
  16.     a local system.  It has no key files, no enforced registration, and
  17.     none of the associated techniques that Shareware authors have been
  18.     using of late to turn their Shareware into PurchaseOrLoseItWare.
  19.  
  20.     What this means for you:  As a System Operator (SysOp), you can
  21.     provide up-to-date, accurate weather information for your users,
  22.     making your BBS a more useful, interesting place to call in.  As an
  23.     individual, this allows you to download weather information and have
  24.     it available on a 24-hour basis.
  25.  
  26.     WEATHER is Shareware.  Shareware is a reasonable concept - being that
  27.     you may try out this product for 30 days - decide if you want to keep
  28.     it, and, if you do, then send a check, cash, or other forms of
  29.     payment (and no, I do not accept uncooked chickens <grin>) to the
  30.     author (me).
  31.  
  32.     The cost for WEATHER is $10.  It may be used for personal, business,
  33.     or any other form of use - all for the same low price.  If you want to
  34.     have modifications to the software written especially for you, contact
  35.     the author.
  36.  
  37.     Our policy towards distribution is simple - please do it!  We rely on
  38.     you to distribute WEATHER because we simply do not have the time nor
  39.     resources to transfer WEATHER throughout the United States.  At the
  40.     time of writing this version's docs, WEATHER is being run in:
  41.  
  42.                              *  California
  43.                              *  Connecticut
  44.                              *  Florida
  45.                              *  Minnesota
  46.                              *  New Jersey
  47.                              *  North Carolina
  48.                              *  Pennsylvania
  49.                              *  Texas
  50.                              *  Virginia
  51.                              *  Wisconsin
  52.  
  53.     If you like WEATHER - make sure to send it to another system so that
  54.     they can enjoy the features and functionality of a Shareware package
  55.     that is not crippled in any way...and a package in which you get what
  56.     you pay for.
  57.  
  58.     WEATHER represents more than a few hours of (fun) work that have turned
  59.     into a little larger project than initially planned.  Since starting
  60.     WEATHER, there have been MORE than a FEW requests, comments, gripes,
  61.     suggestions, and just plain good ideas.  Thanks for the interest!
  62.  
  63.     ----------------------  NOTES, CAVEATS, ET AL...  ----------------------
  64.  
  65.     ***  A note here!  We have received a number of requests that RADAR
  66.          maps be added to the capabilities of WEATHER, and although we would
  67.     LOVE to add the functionality into WEATHER, we CANNOT - due to the fact
  68.     that the RADAR screens that are made available through the weather
  69.     service are copyrighted by a company...and are very prominently
  70.     displayed with:
  71.  
  72.                     "UNAUTHORIZED DISTRIBUTION PROHIBITED."
  73.  
  74.     As the programmer's at Moobasi Optics, Ink. are not out to break
  75.     laws, we have to regretfully decline until such a time that we can
  76.     convince the company to release the rights to display the radar maps to
  77.     the general populace.  The weather information itself is public domain
  78.     (to the best of our knowledge).
  79.  
  80.     ***  Another note!  Various people in Canada requested that WEATHER be
  81.          able to generate Canadian weather.  Well, after talking with the
  82.     people at the DUAT weather service, we have discovered that Canadian
  83.     weather is not available EXCEPT for 50-100 miles into Canada that
  84.     affects the United States - sorry folks!  We did try...and if anyone
  85.     knows of a number to call for Canadian weather, please let Blaine
  86.     Schmidt at Moobasi Optics, Ink. know - he will do his best to work it
  87.     into a future revision of WEATHER.
  88.  
  89.     ------------------------------------------------------------------------
  90.  
  91.                                  FEATURES
  92.  
  93.       *  Since WEATHER uses a 1-800 telephone number, it costs you
  94.          nothing in phone charges (other than those normally incurred for
  95.          using the local service)!
  96.  
  97.       *  As a external package, WEATHER can be used with any type of
  98.          BBS software (for BBS packages which do not support doors,
  99.          WEATHER can be included at the beginning/end of the batch file
  100.          that calls the BBS).
  101.  
  102.       *  Uses COM1-COM4.  Also allows users of DIGIboards (4, 8, 16-port)
  103.          to call out - a great feature!
  104.  
  105.       *  Changeable IRQ and Base Address values...for those of you who
  106.          use non-standard values...a non-standard option!  (for DIGI-board
  107.          users, a special version has been written for your systems...)
  108.  
  109.       *  Dials out at speeds of 1200-115200 (if your port can support it).
  110.  
  111.       *  Tone AND Pulse dialing supported.
  112.  
  113.       *  Extended memory is utilized.
  114.  
  115.       *  Allows you to specify a header and footer to be
  116.          appended/prepended to all of the weather information captured.
  117.          This is useful for BBS Sysops, enabling them to set the color of
  118.          the text, clear the screen, or just generally create the right
  119.          "impression" with the weather information that is desired.  The
  120.          header and footer files can be created in an ANSI or RIP draw
  121.          program...because they are added AFTER the fact!
  122.  
  123.          For example, on Moobasi Optics, Ink. (704-541-9842), the header
  124.          is used to set the color of the text, clear the screen, and
  125.          display a textual header "Moobasi Optics, Ink. Weather
  126.          Information Service" and a footer of "Brought to you by Moobasi
  127.          Optics, Ink." and then pauses the screen, using the Wildcat!
  128.          color and cursor codes. Wildcat!, PCBoard, WWIV and other BBS
  129.          softwares allow you to include cursor positioning and pausing
  130.          codes...so take advantage of them...
  131.  
  132.       *  Allows the operator to combine the seperate weather reports for
  133.          each location through the use of a single line in the calling
  134.          batch file.
  135.  
  136.       *  Uses a menu-driven approach to setup, requiring no previous
  137.          knowledge of the system.  Or, as an alternative, command-line
  138.          parameters can be used, allowing quick/temporary changes to the
  139.          normal setup.
  140.  
  141.       *  Allows automatic redial attempts.
  142.  
  143.       *  Returns errorlevel so that a batch file can determine if the
  144.          weather information download was successful.
  145.  
  146.       *  Multiple locations selectable.  Download information for up to
  147.          ten (10) locations at once!
  148.  
  149.       *  Can hold DTR high even upon exit of WEATHER...allows the Sysop
  150.          (or whomever wishes to use WEATHER) to keep the modem line
  151.          "busied-out" so that callers do not think that the line is down
  152.          during WEATHER processing.
  153.  
  154.       *  Is faithfully supported by the author.  Since the program was
  155.          first written, the author has instituted a variety of new
  156.          modifications, with most of them at user request.  To date,
  157.          approximately 30 modifications/requests have been made, with
  158.          only two being uncompleted - both of them for legal/service
  159.          limitations.
  160.  
  161.       *  RIP support.  Two of the users of WEATHER have asked that RIP
  162.          support be added into the header/footer capabilities...a user
  163.          was kind enough to send in a RIP screen that can be used with
  164.          WEATHER...we are including it in this version - enjoy!
  165.          Although this is not directly supporting RIP...it does show
  166.          what can be done...and we are still working towards integrating
  167.          RIP into the WEATHER program!
  168.  
  169.       *  SEVERE WEATHER REPORTS.  Now you can download severe weather
  170.          information when it matters most.
  171.  
  172.       *  ZONE WEATHER REPORTS.  Several users had been asking for both
  173.          the Severe Weather and the Zone Weather reports...so they are now
  174.          made available - just going to show you that we ARE responsive
  175.          to customer demand...   :)
  176.  
  177.  
  178.                                 FUTURE FEATURES
  179.  
  180.       *  Multiple configuration files...allowing you to call out for
  181.          different weather at different times of the day.
  182.  
  183.       *  Log file of communication sessions...allowing the user to
  184.          debug possible causes of hangups when using WEATHER.
  185.  
  186.       *  Individual header/footer files for daily, extended, zone, and
  187.          severe weather forecasts.
  188.  
  189.  
  190.                                  INCLUDED FILES
  191.  
  192.     The files that are in the WEATHER package after configuration and
  193.     first-time operation are:
  194.  
  195.     README  .1ST   -   Notification of changes in version 1.15
  196.                        --->  IMPORTANT!  Please read before continuing.
  197.     WEATHER .CFG   -   Default Configuration file
  198.     WEATHER .DIC   -   Dictionary file for "casing"
  199.     WEATHER .DOC   -   This information file
  200.     WEATHER .FTR   -   Default Footer file
  201.     WEATHER .HDR   -   Default Header file
  202.     WEATHER .EXE   -   Main executable
  203.     WEATHER .LOC   -   Location of aiport codes
  204.     WEATHER .ORD   -   Order form for WEATHER
  205.     WEATHER .SIT   -   Site file - locations to download
  206.     WT-xxxxx.DLY   -   Local/Daily Forecast text
  207.     WT-xxxxx.EXT   -   Extended Forecast text (xxxxx represents the
  208.                        aiport site where the information was downloaded
  209.                        for [i.e. CLT is for Charlotte, etc...])
  210.     WT-xxxxx.ZON   -   Zone report text.
  211.     WT-xxxxx.SEV   -   Severe weather report text.
  212.  
  213.  
  214.                                 OPERATION
  215.  
  216.     To execute WEATHER, simply type in WEATHER at the DOS prompt.  WEATHER
  217.     will build several files during normal operation, so it is a good idea
  218.     (but not necessary) to put WEATHER in a subdirectory of its own.
  219.  
  220.     F10 quits WEATHER at any point in time - whether during download or
  221.     during configuraton.  WEATHER will close it's modem port in a
  222.     proper fashion - even if in the middle of the download.
  223.  
  224.     For use under a BBS, such as Wildcat!, a batch file is also a good
  225.     idea.  A sample batch file could look like:
  226.  
  227.     ┌──────────────────────  SAMPLE BATCH FILE  ─────────────────────────┐
  228.     │  @ECHO OFF                                                         │
  229.     │  C:                                                                │
  230.     │  CD\WEATHER                                                        │
  231.     │  WEATHER                                                           │
  232.     │  COPY WT-CLT.DLY D:\WC30\BULL\BULL6.BBS                            │
  233.     │  COPY WT-CLT.EXT D:\WC30\BULL\BULL7.BBS                            │
  234.     │  CD\                                                               │
  235.     │  D:                                                                │
  236.     └────────────────────────────────────────────────────────────────────┘
  237.  
  238.     WEATHER creates two files upon successful download of the desired
  239.     weather information:  WT-xxxxx.DLY and WT-xxxxx.EXT (where the xxxxx
  240.     is the airport location code [i.e. CLT equals Charlotte]).  If you
  241.     decide to enable the Zone or Severe weather reports, there may also
  242.     be two other files WT-xxxxx.ZON and WT-xxxxx.SEV.
  243.  
  244.     WT-xxxxx.DLY is the daily/local forecast text.  WT-xxxxx.EXT is the
  245.     extended forecast.  If desired, a Sysop could easily copy the two
  246.     files together to create a single bulletin or textfile.  WT-xxxxx.ZON
  247.     is the Zone weather text.  WT-xxxxx.SEV is the Severe weather report
  248.     text.
  249.  
  250.     For those of you who want to use WEATHER in a batch file, catching
  251.     the errorlevel upon exit, here's a sample batch file:
  252.  
  253.     ┌──────────────────────  SAMPLE BATCH FILE  ─────────────────────────┐
  254.     │  @ECHO OFF                                                         │
  255.     │  C:                                                                │
  256.     │  CD\WEATHER                                                        │
  257.     │  WEATHER                                                           │
  258.     │    IF ERRORLEVEL==255 GOTO ERROR                                   │
  259.     │  COPY WT-CLT.DLY D:\WC30\BULL\BULL6.BBS                            │
  260.     │  COPY WT-CLT.EXT D:\WC30\BULL\BULL7.BBS                            │
  261.     │  COPY WT-CLT.ZON D:\WC30\BULL\BULL8.BBS                            │
  262.     │  COPY WT-CLT.SEV D:\WC30\BULL\BULL9.BBS                            │
  263.     │  CD\                                                               │
  264.     │  D:                                                                │
  265.     │  GOTO END                                                          │
  266.     │                                                                    │
  267.     │  :ERROR                                                            │
  268.     │  ECHO Download failed...no copy performed!                         │
  269.     │                                                                    │
  270.     │  :END                                                              │
  271.     └────────────────────────────────────────────────────────────────────┘
  272.  
  273.  
  274.                                    HELP
  275.  
  276.     If WEATHER is run without parameters and there is no WEATHER.CFG file
  277.     in the current subdirectory, a short help screen is displayed.
  278.  
  279.     ┌───────────────────────  WEATHER USAGE  ───────────────────────────┐
  280.     │                                                                   │
  281.     │          WEATHER.EXE [nPort nSpeed nRetries] [CONFIG]             │
  282.     │                                                                   │
  283.     │          Where:  nPort is COM port (1-4)                          │
  284.     │            and   nSpeed is modem speed (1200-115200)              │
  285.     │            and   nRetries is redials   (1-255)                    │
  286.     │             or run WCONFIG to configure WEATHER.EXE               │
  287.     │                                                                   │
  288.     └─────────────────  PRESS ANY KEY TO CONTINUE  ─────────────────────┘
  289.  
  290.  
  291.                               CONFIGURATION
  292.  
  293.     To configure WEATHER, simply run WCONFIG.EXE as shown above:
  294.  
  295.     WCONFIG
  296.  
  297.     WCONFIG will prompt you for the following information:
  298.  
  299.       *  What type of serial port (COM or DIGIboard)
  300.  
  301.       *  COM port (which serial port to dial out on)
  302.          1,2,3,4 are accepted (COM8-COM16 are accepted if it is a 8 or
  303.          16-port DIGIboard)
  304.  
  305.       *  IRQ and Base Address which modem will use.  The defaults are
  306.          provided - so if you don't know or do not understand this, just
  307.          hit ENTER twice to continue.  (IRQ and Base Address are two
  308.          parameters that the system uses to define where the modem port
  309.          [i.e. serial port] is located in memory and how it can be
  310.          controlled - if changed to the wrong values, could easily stop
  311.          modem from successfully dialing out)
  312.  
  313.          (Additionally, for DIGIboard users, you are prompted for extra
  314.          information at this point:  Interrupt Register ID Address,
  315.          MAP Table Array Value, and Type Array Value)
  316.  
  317.       *  BAUD RATE (what speed to dial out at)
  318.          1200,2400,9600,14400,16800,19200,38400,57600,115200 are accepted
  319.          (the weather service currently only has 2400 baud modems...so
  320.          even if you lock your port...don't be surprised by the 2400/ARQ)
  321.  
  322.       *  RETRIES (how many times to try to redial)
  323.          1-255 are accepted  (in some areas, the phone company may limit
  324.          the number of retries you may make...check with your local
  325.          phone service to find out - we recommend something sensible...
  326.          like 15)
  327.  
  328.       *  LOCATION (which AIRPORT location to get weather from)
  329.          Only locations from a scrollbox menu are accepted.  All available
  330.          locations are displayed.  Up to five (5) locations may be tagged
  331.          using the SPACE BAR - at least ONE needs to be tagged to call
  332.          out - IF ONE IS NOT TAGGED WHEN YOU PRESS ENTER, THE WEATHER.SIT
  333.          FILE WILL BE EMPTY AND WILL HANG UP IMMEDIATELY UPON CONNECTING
  334.          WITH THE WEATHER SERVICE.
  335.  
  336.       *  PRE/POST modem setup strings.  These are commands that are
  337.          send to the modem before/after the dialing is started/completed.
  338.          For example - if your modem typically "ignores CD," you may wish
  339.          to type in a command such as ~~AT&C1~~ (for US Robotics Dual
  340.          Standards at least) to ensure that the modem pays attention to
  341.          Carrier Detect - because WEATHER DOES use CD as a method of
  342.          determining whether or not you are still online (although, as
  343.          of version 1.14, you can ignore CD and still call out properly).
  344.  
  345.       *  PRE/POST dialing strings.  Use a "1-" for the pre-dialing string
  346.          if you are in the U.S. and using a home telephone.  The use of a
  347.          ",9" in the post-dial string will be common for those people
  348.          dialing out through a PBX system.
  349.  
  350.       *  EFFECTS - whether or not WEATHER should "explode boxes" and
  351.          make sounds during operation.
  352.  
  353.       *  COMBINE - whether or not WEATHER should take the two reports
  354.          for any given location and format them so that they may be
  355.          combined in the calling batch file.
  356.  
  357.       *  TIMER - how long WEATHER should wait before logging off of
  358.          the weather service in case of problems.
  359.  
  360.       *  ZONE REPORT - whether or not WEATHER should download the
  361.          Zone report when it calls out.  The Zone report is a weather
  362.          report on the area(s) around the locale currently being
  363.          checked on.  For example, when downloading weather information
  364.          for Charlotte, NC and requesting the Zone report, a brief
  365.          weather report is given for Charlotte, Raleigh/Durham,
  366.          Greensboro, etc...
  367.  
  368.       *  SEVERE REPORT - whether or not WEATHER should download
  369.          Severe weather reports.  This was an option requested by many
  370.          of the users of WEATHER - so enjoy!
  371.  
  372.       *  HEADER (text to display at top of weather information)
  373.          Text up to 32,000 bytes (32k) is accepted.  Word wrap is
  374.          automatic.  The header file is now seperated entirely from
  375.          the configuration file...so you can build the header file
  376.          in your favorite ANSI/RIP editor!
  377.  
  378.       *  FOOTER (text to display at bottom of weather information)
  379.          Text up to 32,000 bytes (32k) is accepted.  Word wrap is
  380.          automatic.  The footer file is now seperated entirely from
  381.          the configuration file...so you can build the footer file
  382.          in your favorite ANSI/RIP editor!
  383.  
  384.     After the information is entered, it is automatically saved to
  385.     WEATHER.CFG.  To abort the configuration during entry, simply press
  386.     the ESC (or F10) key.
  387.  
  388.     WEATHER.CFG is a straight ASCII text file, so any text editor can edit
  389.     it.  The layout of the file is:
  390.  
  391.     Line    1:  COM port
  392.     Line    2:  BASE address, IRQ value, [Interrupt Register ID Address,
  393.                                           Map Table Value Address,
  394.                                           Type Array Value]
  395.     Line    3:  BAUD rate
  396.     Line    4:  REDIAL attempts
  397.     Line    5:  TONE or PULSE (T/P) dialing type
  398.     Line    6:  PREDIAL modem initialization string
  399.     Line    7:  POSTDIAL modem initialization string
  400.     Line    8:  ACCESS CODE for telephone number (i.e. the "1-" in the
  401.                 1-800-xxx-xxxx telephone number)
  402.     Line    9:  NUMBER to APPEND to the 1-800-xxx-xxxx (i.e. ",9" in the
  403.                 1-800-xxx-xxxx,9 telephone number)
  404.     Line   10:  EFFECTS status
  405.     Line   11:  COMBINE reports status
  406.     Line   12:  DTR status after logging off of weather service
  407.     Line   13:  DIGIboard type (0=NONE, 4,8,16=DIGIboard types)
  408.     Line   14:  TIMER
  409.     Line   15:  ZONE weather report status
  410.     Line   16:  SEVERE weather report status
  411.  
  412.  
  413.     WEATHER.HDR/WEATHER.FTR are both text files that are able to be
  414.     edited by any text editor capable of saving text in a raw ASCII
  415.     format (for example, WordPerfect in native mode is not, but
  416.     WordPerfect DOES have an ASCII save function...using that WILL
  417.     work).  If you wish to add some color, try using an ANSI or RIP
  418.     editor for the header and footer files.
  419.  
  420.     WEATHER.SIT is also created at CONFIG time.  WEATHER.SIT contains
  421.     the names of the state, city, airport code, and filename for every
  422.     location available to WEATHER.  If anyone has more airport codes,
  423.     or more accurate city/state names, please let us know...always on
  424.     the lookout to improve WEATHER!
  425.  
  426.     The layout of WEATHER.SIT is (this is the exact spacing as well,
  427.     so if you need to create a WEATHER.SIT file, simply copy the line
  428.     containing the WT-CLT and remove all of the leading spaces):
  429.  
  430.     State City                     Airport Code  Filename
  431.     vv    ----v----                    -v-        --vv--
  432.     NC    Charlotte                    CLT        WT-CLT
  433.  
  434.     WEATHER.SIT is an ASCII text file that is able to be edited by
  435.     any text editor capable of saving text in a raw ASCII format
  436.     (for example, WordPerfect in native mode is not, but WordPerfect
  437.     DOES have an ASCII save function...using that WILL work).
  438.  
  439.     WEATHER.DIC is an ASCII dictionary file for WEATHER that can be
  440.     added to/subtracted from to "case" words differently in the weather
  441.     text.  Currently, when a word is put into the dictionary, the word
  442.     will be cased in the EXACT same style as in the dictionary file...so
  443.     beware - if you type something in all UPPERCASE, WEATHER will
  444.     UPPERCASE that word throughout the entire text.  This feature was
  445.     added so that cities, states, and place names could be properly cased.
  446.  
  447.     Use a text editor that saves in PLAIN ASCII mode to modify the .CFG
  448.     and .DIC files.
  449.  
  450.     The PREDIAL and POSTDIAL options were added to accomodate modems
  451.     who did not reset properly after using WEATHER.
  452.  
  453.     The ACCESS CODE and NUMBER APPEND were added for people who wanted
  454.     to dial out from a PBX system (Public Branching System) or from
  455.     outside of the United States (such as Canada).
  456.  
  457.     COMBINE reports status allows the operator to specify that the two
  458.     reports that are generate for a location are to be formatted so that
  459.     they may be combined together via a line in a batch file - such as:
  460.  
  461.     ┌──────────────────────  SAMPLE BATCH FILE  ─────────────────────────┐
  462.     │  @ECHO OFF                                                         │
  463.     │  C:                                                                │
  464.     │  CD\WEATHER                                                        │
  465.     │  WEATHER                                                           │
  466.     │    IF ERRORLEVEL==255 GOTO ERROR                                   │
  467.     │  COPY WT-CLT.DLY+WT-CLT.EXT D:\WC30\BULL\BULL6.BBS                 │
  468.     │  CD\                                                               │
  469.     │  D:                                                                │
  470.     │  GOTO END                                                          │
  471.     │                                                                    │
  472.     │  :ERROR                                                            │
  473.     │  ECHO Download failed...no copy performed!                         │
  474.     │                                                                    │
  475.     │  :END                                                              │
  476.     └────────────────────────────────────────────────────────────────────┘
  477.  
  478.     The header is included in the WT-xxxxx.DLY file and the footer is
  479.     included at the end of the WT-xxxxx.EXT file.  Thus, a Sysop may
  480.     create a single bulletin/news item out of all of the weather
  481.     information.
  482.  
  483.     DTR status allows the operator to specify that WEATHER should hold the
  484.     DTR signal HIGH on the modem when it is processing the received
  485.     weather information AND upon exit.  This is useful if you run a BBS
  486.     and do not wish your users to get a NO ANSWER during weather download
  487.     and processing.  Also useful if you perform more than one task at
  488.     night - say a night-time procedure that has WEATHER as the first task.
  489.  
  490.  
  491.                      TIPS, TECHNIQUES, AND TROUBLESHOOTING
  492.                   (or, how I managed to fix the durn thing...)
  493.  
  494.     This section is being included to help people out with running the
  495.     WEATHER program under various environments.
  496.  
  497.     Problem :  WEATHER calls out, connects, collects the weather
  498.                information, displays the Processing Weather Information
  499.                screen, and then appears to hang.  How can I solve this?
  500.     Solution:  WEATHER 1.15 *should* take care of that problem.  However,
  501.                if you are reading this, it is likely that it did not.
  502.                Try rebooting and calling out to the weather service
  503.                again...if it hangs again, contact us Moobasi Optics, Ink.
  504.                to report the problem and receive personal help.
  505.  
  506.     Problem :  Running WEATHER as an event under FrontDoor, I have had
  507.                occasional problems with WEATHER locking up during the
  508.                the processing of the weather information.  What's the
  509.                problem?
  510.     Solution:  Once again, version 1.15 should take care of this.  There
  511.                have been people reporting that WEATHER locks up when
  512.                used as an event under FrontDoor - possibly due to the
  513.                FOSSIL driver that is being used.  Either try to
  514.                disable the FOSSIL driver (XU for X00.SYS, etc.) or try
  515.                running WEATHER as an event from the BBS instead.  If
  516.                the problem persists under FrontDoor, please contact us
  517.                at Moobasi - we will do our best to remedy the situation!
  518.  
  519.     Problem :  WEATHER calls out, connects, then drops to DOS.
  520.     Solution:  Check the WEATHER.SIT file.  If it is empty, either create
  521.                a new WEATHER.SIT based on the layout detailed in this
  522.                DOC file, or make sure to grab the latest version (as of
  523.                this release...v1.14).
  524.  
  525.     Problem :  When I run WEATHER, I get a message that says something
  526.                like "MEMORY EXHAUSTED" - why?  What can I do to get
  527.                around the problem?
  528.     Solution:  Make sure to use version 1.14 or above of WEATHER.   :)
  529.                Starting with WEATHER v1.14, we made sure to cut down on
  530.                use of conventional memory as much as possible.
  531.  
  532.     Problem :  When I run WEATHER in a Desqview window, it "eats" all of
  533.                the available extended/expanded memory.  What can I do to
  534.                limit the amount of EMS/XMS it uses?
  535.     Solution:  Go into Change Program (under the Open Window option)
  536.                and then go into Advanced Options by pressing F10.  On
  537.                the option that says "Maximum EMS," type in the amount of
  538.                XMS memory to limit WEATHER to.
  539.  
  540.     Problem :  Even after making sure that WEATHER.SIT has information in
  541.                it, WEATHER calls out, connects, then immediately does a
  542.                disconnect.  What can I do this time?
  543.     Solution:  Try forcing your CD (Carrier Detect) signal high when
  544.                calling out.  To do this with a US Robotics Dual Standard,
  545.                you would type in something similar to ~~AT&C0~~ in the
  546.                Pre-Dial Modem Setup String in the CONFIG option for
  547.                WEATHER.
  548.  
  549.     Problem :  Using a DIGIboard, you are calling out at 38400...yet
  550.                the modem is not dialing.  What can be done?
  551.     Solution:  Set the COM port speed a little lower on the DIGIboard
  552.                using the COMSET program that comes with the DIGIboard
  553.                (they recommend using 19200 or below).
  554.  
  555.     Problem :  You decide, after checking out WEATHER, that $10 is not
  556.                enough money to pay for such a well-supported program...
  557.                what can you do?
  558.     Solution:  Just send in the $10 and receive the heart-felt thanks of
  559.                the author...he is trying to keep the price of WEATHER
  560.                down to encourage other Shareware authors to do the same!
  561.                :)
  562.  
  563.  
  564.                            ORDERING INFORMATION
  565.  
  566.     To order WEATHER, send a $10 payment to the author at:
  567.  
  568.     Moobasi Optics, Ink.
  569.     ATTN:  Blaine William Schmidt
  570.     10305-D Plum Creek Lane
  571.     Charlotte, NC  28210-8263
  572.  
  573.     To report problems with WEATHER, or to suggest improvements, contact
  574.     the author at one of the following:
  575.  
  576.     (704-541-9842) Data Line  - Moobasi Optics, Ink. (data line)
  577.     (704-542-3725) Voice Line - Business
  578.     FIDOnet address:   1:379/50
  579.     WGAnet address:    40:113/50
  580.     Internet address:  Selin@char.vnet.net
  581.  
  582.  
  583.     When you pay the $10 registration fee, include an electronic address
  584.     that the registered version can be sent to (i.e. Blaine Schmidt at
  585.     Moobasi Optics, Ink. [704-541-9842]) if available.  If no electronic
  586.     addresses are available, include your address and $1 extra so that it
  587.     can be sent via U.S. Mail.
  588.  
  589.     In addition to receiving the registered version, you will also have an
  590.     account created on Moobasi Optics, Ink. for you (with your real name
  591.     and telephone number).  This will give you access to the public line
  592.     of the BBS for personal pleasure or for reporting problems or
  593.     suggestions.
  594.  
  595.  
  596.                           CREDITS/KUDOS/ET AL...
  597.  
  598.     Credits for the program go out to the following people:
  599.  
  600.       *  The PEOPLE who have registered WEATHER thus far.  Their names
  601.          are not mentioned here to protect them from the hordes of
  602.          Shareware authors who would want them to register all of their
  603.          work too!  :)
  604.  
  605.       *  Jennifer "JABBER" Schmidt - she keeps the projects going that
  606.          would otherwise fall by the side of the road.
  607.  
  608.       *  Steve "Dark Elf" Gilbert - for continuing to share himself in a
  609.          gastrological way, eating out with me weekly and discussing
  610.          computers with me in a way that frustrates many others <grin>.
  611.          Steve runs the Red Room (704)566-9927.  BTW - congratulations
  612.          Steve - I'll be glad to see another join the ranks of the
  613.          married (I need some company)!  :)
  614.  
  615.       *  Ron Alspaugh of the Exchange (704)342-2333 for helping me beta
  616.          test (read that as bug-swat) all of the versions thus far,
  617.          making many astute observations that have led to a more robust
  618.          program.  Ron - keep it up!  I *LIKE* your comments!
  619.  
  620.       *  Mark Williamson and Gordon Malone - two guys who have sent in
  621.          MORE than their share of comments...   :)
  622.  
  623.       *  Rob Rosenhouse for letting me know that Newark, NJ (EWR) exists!
  624.          Thanks also go to him for an excellent suggestion which will be
  625.          included in v1.15...the ability to add weather sites to the
  626.          WEATHER.LOC file.
  627.  
  628.       *  Kevin Day for getting New York back on the map.  :)  He has also
  629.          contributed much in the way of good bug notifications... 
  630.  
  631.       *  Minneapolis/St. Paul, MN and Charlotte, NC BBS communities - for
  632.          providing me with good times, good friends, and great ideas!
  633.  
  634.       *  All of the people who have taken the time to either download
  635.          or FREQ WEATHER from Moobasi Optics, Ink....I sincerely hope
  636.          you enjoy it...or let us know...WE WANT to make YOU HAPPY!
  637.  
  638.       *  Nantucket/Computer Associates - although Clipper has yet to rid
  639.          itself of some pesky problems, Clipper is still one of the best
  640.          products out on the market today.
  641.  
  642.  
  643.                                   REVISIONS
  644.  
  645.     (01/17/94)
  646.  
  647.     -  Added feature where user can specify number of minutes after
  648.        which WEATHER will hangup - regardless of what is happening
  649.        at the time.  Was added to allow users who download more
  650.        locations to extend the timeout feature.  NOTE:  The default
  651.        of 10 minutes IS HIGHLY RECOMMENDED as the one to use.  The
  652.        ten minute limitation previously branded into WEATHER was to
  653.        ensure that the weather service was not tied up with someone
  654.        using the line and not matching a prompt (possibly causing
  655.        a condition where WEATHER could sit on the telephone line
  656.        the entire time specified.)
  657.  
  658.     (01/16/94)
  659.  
  660.     -  Fixed bug which allowed users to only download 5 locations of
  661.        weather information - even though they were able to tag 10
  662.        locations through the CONFIG option.
  663.  
  664.     -  Changed NEW YORK CITY to NEW YORK so that users in New York could
  665.        actually obtain weather information!  :)
  666.  
  667.     -  Added EWR (Newark, NJ) as a valid weather site.
  668.  
  669.     (01/11/94)
  670.  
  671.     -  Added a brief pause after connecting - some modems were not raising
  672.        CD (Carrier Detect) fast enough - and were hanging up immediately
  673.        upon connection.
  674.  
  675.     -  Finished the DIGIboard programming.  The IIRA value was being
  676.        converted to hexadecimal, which led to the DIGIboard looking at
  677.        a location approximately 600 bytes away from where it should.
  678.  
  679.     (01/10/94)
  680.  
  681.     -  Finished DIGIboard support (I think).  No one to really test it out
  682.        for me, so I will have to assume it works for right now.
  683.  
  684.     -  Number of locations to download has been raised to 10, due to the
  685.        fact that we have rarely passed the five minute mark of time on
  686.        the weather service, even with downloading information on 5
  687.        unique sites.
  688.  
  689.     (01/08/94)
  690.  
  691.     -  Added DIGIboard support.  A)  This was a time-consuming, and
  692.        somewhat oblique task as we did not have ready access to a
  693.        DIGIboard of ANY variety!  We will be testing more extensively
  694.        in the near future and we request that if ANYONE sees something
  695.        incorrect in the way that WEATHER uses a DIGIboard...please let
  696.        us know.
  697.  
  698.     -  Seperated the HEADER and FOOTER from the WEATHER.CFG file.  Now
  699.        anyone can design their own headers and footers in their favorite
  700.        editor (whether ASCII/ANSI/RIP or otherwise).
  701.  
  702.     -  Added extended memory support.  WEATHER will now use available
  703.        extended memory to speed up operations.
  704.  
  705.     -  DTR option added so that Sysop(s) can make sure that the line
  706.        calling out and processing using WEATHER is "busied-out" during
  707.        the processing until the return to the BBS.
  708.  
  709.     -  GSO (Greensboro, NC) was added to the Airport Location file
  710.        (WEATHER.LOC)...next release will include a more comprehensive
  711.        listing of valid airport codes.
  712.  
  713.  
  714.     (01/04/94)
  715.  
  716.     -  Wow!  A new year - and new possibilities for WEATHER!
  717.  
  718.     -  Added the option to combine reports.  Now the DLY and EXT file(s)
  719.        can be combined into single reports for any given location...a
  720.        good modification for those people who don't want the weather
  721.        information taking up two bulletins.
  722.  
  723.     -  Added pre/post-dialing string support.  Now people can dial out
  724.        to the weather service from anywhere - within PBXes, outside of
  725.        the country, etc....
  726.  
  727.     -  Improved F10 "breakout" key.  F10 will now behave more responsively
  728.        when WEATHER is dialing or capturing text.
  729.  
  730.     -  Reworked dialing so that WEATHER exits at maximum number of redial
  731.        attempts, rather than locking up (others reported this - we never
  732.        experienced it - but the fix is solid).
  733.  
  734.     -  Updated the revision number to the correct revision :) ...
  735.  
  736.     -  Lengthened the DTR drop/raise time so that the phone company has a
  737.        chance to catch up with WEATHER...
  738.  
  739.     -  Added a absolute dropout time of 12 minutes so that if all goes to
  740.        "bonko," WEATHER will automagically press the F10 key and interrupt
  741.        the running process and hang up...this was done to ensure that no
  742.        one reports WEATHER hanging their system all night attempting to
  743.        answer the same prompt over and over and over and over and over...
  744.  
  745.  
  746.     (12/26/93)
  747.  
  748.     -  WEATHER was sending the airport ID to the weather system when they
  749.        requested a airport code.  This code is used by the FAA to keep
  750.        track of "emergency situation aircraft" (or something similar)...
  751.        so, in order to conform to FAA regulations for the weather
  752.        service, WEATHER has to send a code, starting with an alphabetic
  753.        character, followed by any alpanumeric sequence (up to 7
  754.        characters).
  755.  
  756.        The weather service was consulted on this item - WEATHER was
  757.        calling and being told that the code CLT had been used too many
  758.        times and could not download any more information (due to
  759.        Charlotte using the WEATHER program the most currently).  Now,
  760.        WEATHER uses a code of MWxxxxx (where MW stands for MOOBASI
  761.        WEATHER and the xxxxx is a number between 1 and 99999).  The
  762.        weather service stated that all codes entered are tracked for 15
  763.        days before they are removed from the system...hence, CLT will
  764.        work roughly two weeks after the release of this version of
  765.        WEATHER.  However, due to the new style of requesting weather
  766.        information, you can call now and still receive weather
  767.        information for across the country.
  768.  
  769.        A note of thanks and gratitude to the folks at DUAT - who provide
  770.        the weather service we all use for downloading purposes.  We
  771.        called DUAT late at night when we learned of the error in the
  772.        downloading process - and they were fast, efficient, courteous,
  773.        and EXTREMELY HELPFUL in finding an alternative method of working
  774.        out a download solution.  Once again - thanks to all of the fine
  775.        folks at DUAT!  (BTW - we once again confirmed that the weather
  776.        download information is PUBLIC, and as such, may be freely
  777.        posted on a BBS system - as long as there is no charge for
  778.        viewing the weather information.
  779.  
  780.     (12/22/93)
  781.  
  782.     -  Fixed a problem with WEATHER not converting the first .DLY file
  783.        into capitalized text.  Was capturing the text perfectly, but due
  784.        to a file handle remaining open, WEATHER was never able to access
  785.        it during the capitalization stage.
  786.  
  787.     -  Checked out dialing and connecting - everything working on the
  788.        three seperate modems tested.
  789.  
  790.     (12/21/93)
  791.  
  792.     -  *** NOTE ***
  793.        The structure of the WEATHER.CFG and WEATHER.LOC have changed.
  794.        WEATHER.SIT is new.  Unfortunately, WEATHER v1.10 is NOT
  795.        directly compatible with version v1.03 - if you want to upgrade
  796.        it, simply install it to a different directory, WEATHER CONFIG,
  797.        and then using a text editor, copy over your headers and footers
  798.        from the v1.03 WEATHER.CFG.
  799.  
  800.     -  Information screen is now available for registered users.  All
  801.        the info display is for is to report on the revision level, date
  802.        and name of person who registered the software...not applicable
  803.        to the unregistered version.
  804.  
  805.     (12/20/93)
  806.  
  807.     -  Added changeable IRQ and Base Address values.  Many people were
  808.        calling and saying that WEATHER would not work with COM3 or COM4.
  809.        Strange thing - after investigating, the library being used for
  810.        modem control left COM3 and COM4 with values of 0 for both IRQs
  811.        and Base Addresses - needless to say, the modem WOULD NOT dial
  812.        out under those conditions.  COM3 is now defaulted to IRQ 5, and
  813.        COM4 to IRQ6, with any of the COM port IRQ values being
  814.        changeable through the CONFIG option.
  815.  
  816.     -  Added multiple sites.  A maximum limit of five (5) locations was
  817.        decided on for two reasons.  1)  The weather service that is
  818.        supplying the information only gives a eight minute logon...and
  819.        although the method used by WEATHER bypasses this limitation, we
  820.        felt it was prudent to follow their wishes regarding time logged
  821.        on...we would recommend it to those using WEATHER too.
  822.  
  823.     -  Filename scheme had to be changed to accomodate multiple sites.
  824.        The filenames now are comprised of WT-xxxxx, with the xxxxx
  825.        being the AIRPORT ID for each station downloaded (i.e. when you
  826.        download Charlotte's weather inforamtion, WEATHER creates a file
  827.        titled WT-CLT.DLY and WT-CLT.EXT).
  828.  
  829.     -  Tone OR Pulse methods of dialing are now supported.  One or two
  830.        of the users of WEATHER requested it - they now have it.
  831.  
  832.     -  Changed the reception of characters to string-based versus the
  833.        character-oriented method used previously.  Although it does not
  834.        appear any faster, it is, and results in a more stable approach
  835.        to error-handling.
  836.  
  837.     -  Cut wait time for inter-string delays down to 1 second...should
  838.        speed up processing incrementally.  If anyone experiences WEATHER
  839.        timing out a significant portion of the time, let me know and we
  840.        can change it to a higher value again.
  841.  
  842.     -  Improved recognition of loss of carrier - whether through normal
  843.        termination or otherwise...users should notice a significant
  844.        increase in responsiveness from when the call is complete to when
  845.        the text processing begins.
  846.  
  847.     (12/16/93)
  848.  
  849.     -  Changed the dates in the revision history in WEATHER.DOC.  <grin>
  850.        They were incorrectly reflecting the dates of changes.
  851.  
  852.     -  Changed the fashion in which the results were obtained from the
  853.        modem.  A user stated that when he unplugged the modem from the
  854.        wall (why he did this is anyone's guess :) ), WEATHER was
  855.        incorrectly assuming that it had connected after the number of
  856.        retries had been reached.  A review of the result code capture
  857.        resulted in a significant change in the capture method.
  858.  
  859.     -  Ensured that when number of retries are reached that WEATHER kicks
  860.        out to DOS.
  861.  
  862.     -  Changed the method which the pre/post-dial strings are sent to the
  863.        modem - much more stable.
  864.  
  865.     (12/15/93)
  866.  
  867.     -  Due to a slight miscalculation in eyesight and textual clarity on
  868.        the terminal, the modem port was never being closed.
  869.  
  870.     -  Added ERRORLEVEL support for the people who requested it.  WEATHER
  871.        returns a 0 for normal completion - and a 255 for all errors.
  872.  
  873.     -  Added POSTDIAL string for modems that need to be reset after
  874.        WEATHER completes.
  875.  
  876.     (12/14/93)
  877.  
  878.     -  Added capitalization of text.  Needs a little work - but is nearly
  879.        correct.  If anyone has a good, solid set of rules regarding the
  880.        capitalization of WEATHER text, please let me know!  <grin>
  881.  
  882.     (12/13/93)
  883.  
  884.     -  Initial beta (alpha/zeta too!) release!
  885.  
  886.  
  887.                   OFFICIAL DISCLAIMER OF RESPONSIBILITY
  888.  
  889.     This is the part that we all love to read.  This section is merely
  890.     included to protect ME, the author, from being sued by someone who
  891.     thinks that it is the software company's responsibility to keep their
  892.     software from blowing up another person's hard drive.
  893.  
  894.     ┌────────────────────────────────────────────────────────────────────┐
  895.     │  Moobasi Optics, Ink., or any other agent of Moobasi Optics, Ink.  │
  896.     │  (such as Blaine William Schmidt) assumes no responsibility for    │
  897.     │  the misuse and/or incorrect operation of The Software (hereby     │
  898.     │  known as WEATHER).                                                │
  899.     │                                                                    │
  900.     │  WEATHER, as provided, is in a "as is" state, where the user       │
  901.     │  assumes any and all responsibility for reparation of any damage   │
  902.     │  that may occur through use/misuse/operation/incorrect operation   │
  903.     │  of WEATHER.                                                       │
  904.     │                                                                    │
  905.     │  To the best of our knowledge, the weather information provided    │
  906.     │  and downloaded using WEATHER is public domain, and may be freely  │
  907.     │  dissemenated.                                                     │
  908.     │                                                                    │
  909.     │  In no event will Moobasi Optics, Ink. software be held liable     │
  910.     │  for any damage arising from use of WEATHER.                       │
  911.     └────────────────────────────────────────────────────────────────────┘
  912.  
  913.     Now that that portion is complete, let me personally state that
  914.     WEATHER is an operational program that has no bugs (that I know of)
  915.     that would cause anyone's hard drive to start to whir menacingly, or
  916.     make their printer shoot out reams of paper at the speed of light.
  917.  
  918.     If an "undocumented feature" (i.e. a bug) is discovered, please contact
  919.     me (Blaine William Schmidt).  See the ordering information above...it
  920.     contains my name and address for contacting me regarding errors.  The
  921.     programmers at Moobasi Optics, Ink. strive to make their products
  922.     solid ones...and that can onle be achieved through a lot of hard work
  923.     and testing...which sometimes comes from you...the end user...
  924.  
  925.                          END-OF-INFORMATION-FILE
  926.