home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / WB116S.ZIP / WB.DOC < prev    next >
Text File  |  1993-09-08  |  25KB  |  607 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.         ************************************************************
  29.         *                                                          *
  30.         *  The Weather Board (R) Weather Forecast Retrieval System *
  31.         *                                                          *
  32.         *                                                          *
  33.         *            Copyright (c) 1993 By Rhino Ware              *
  34.         *                                                          *
  35.         ************************************************************
  36.     The Weather Board Weather Forecast Retrieval System                  1
  37.  
  38.  
  39.  
  40.  
  41.                         TABLE OF CONTENTS
  42.                         -----------------
  43.  
  44.  
  45.      TABLE OF CONTENTS ................................  1
  46.  
  47.      COPYRIGHT NOTICE .................................  2
  48.  
  49.      WARRANTY .........................................  2
  50.  
  51.      TRADEMARKS .......................................  2
  52.  
  53.      INTRODUCTION .....................................  2
  54.          Feature Summary ..............................  3
  55.  
  56.      HARDWARE REQUIREMENTS ............................  4
  57.  
  58.      INSTALLATION .....................................  4
  59.         Basic Setup for Weather Board .................  4
  60.         The Configuration File ........................  5
  61.         Color Codes ...................................  5
  62.         About Modem Settings ..........................  6
  63.  
  64.      HOW IT WORKS .....................................  6
  65.  
  66.      REGISTRATION INFORMATION .........................  7
  67.         How to obtain your Registered Version .........  8
  68.         Registration Policy ...........................  8
  69.  
  70.      WEATHERMATION NUMBERS ............................  A-1
  71.  
  72.      REGISTRATION FORM ................................  A-2
  73.  
  74.     The Weather Board Weather Forecast Retrieval System                  2
  75.  
  76.  
  77.      COPYRIGHT NOTICE
  78.      ----------------
  79.  
  80.      Weather Board is a copyrighted program being distributed under the
  81.      shareware concept.  As such, you may operate Weather Board for a
  82.      period of 30 days without registering the software.  After the 30 day
  83.      evaluation period, you must register your copy of Weather Board or you
  84.      will be in violation of United States and International copyright
  85.      laws.
  86.  
  87.      As a shareware program, Weather Board may be freely distributed
  88.      through a BBS.  Shareware distributors may distribute copies of
  89.      Weather Board on disk for a modest disk duplication charge not to
  90.      exceed $6 per disk.
  91.  
  92.      It is a violation of the Weather Board license agreement to modify the
  93.      EXE file in any way.
  94.  
  95.  
  96.      WARRANTY
  97.      --------
  98.  
  99.      Weather Board is distributed without warranty.  In no event will Joe
  100.      Rhinehart or Rhino Ware be liable to you for damages, including any
  101.      loss of profits, lost savings, or other incidental or consequential
  102.      damages arising out of your use of or inability to use the program,
  103.      even if Joe Rhinehart, Rhino Ware or an authorized representative has
  104.      been advised of the possibility of such damages.  Joe Rhinehart or
  105.      Rhino Ware will not be liable for any such claim by any other party.
  106.  
  107.  
  108.      TRADEMARKS
  109.      ----------
  110.  
  111.      Weather Board is a registered trademark of Joe Rhinehart and Rhino
  112.      Ware.  All other brand and product names mentioned in this manual are
  113.      trademarks or registered trademarks of their respective companies.
  114.  
  115.  
  116.      INTRODUCTION
  117.      ------------
  118.  
  119.      Welcome to Weather Board!  To many people's surprise, a BBS Sysop can
  120.      provide callers with the local weather forecast.  The whole process is
  121.      very low cost, possibly free!  Many airports around the country run a
  122.      system which provides weather information to pilots, called
  123.      Weathermation.  Although the service is mainly for pilots, to assist
  124.      them in filing flight plans, etc., anyone is permitted to access the
  125.      information.
  126.  
  127.      The Weathermation system has many options, one of which is called
  128.      Metro Weather.  This option produces a plain English weather forecast
  129.      for any area of the country, based on the three letter airport ID that
  130.      you supply.  Weather Board will call the airport's Weathermation
  131.      number, select the Metro option and write an editied text file
  132.      containing your local area's forecast.
  133.  
  134.     The Weather Board Weather Forecast Retrieval System                  3
  135.  
  136.  
  137.      The National Weather Service updates the forecast about every six
  138.      hours.  The appoximate times are 9:00 am, 3:00 pm, 9:00 pm and 3:00
  139.      am.  This varies, up to plus or minus 45 minutes.  Of course, if the
  140.      weather changes profoundly between normal update times, the NWS will
  141.      issue "updated" or "corrected" reports.  These can become available at
  142.      any time.
  143.  
  144.      You'll have to call the closest airport to get your local
  145.      Weathermation number, if its not in the list that is presented later
  146.      in this document.  Ask for their airport ID also, if you don't already
  147.      know it.  Bear in mind that the closest Weathermation system may still
  148.      be a long distance call for you.  That's why I said it is very low
  149.      cost and POSSIBLY free.  There is no charge for the service, but you
  150.      may have to pay long distance telephone charges.  Typically, you can
  151.      capture the forecast in less than a minute, so even if you do have to
  152.      call long distance, your cost for providing this service should be
  153.      minimal.
  154.  
  155.      One of Weather Board's chief design goals is ease of installation and
  156.      use.  It is designed specifically to be run from a batch file, called
  157.      as an event from a BBS program or front end mailer.  Thus, it can run
  158.      completely unattended.  If desired, it can also be run manually from
  159.      the Dos prompt, or under a multi tasker.
  160.  
  161.  
  162.      Feature Summary
  163.      ---------------
  164.  
  165.      Although Weather Board is a relatively new program, it comes equipped
  166.      with many powerful features.
  167.  
  168.      Error level support for batch files:
  169.  
  170.      0 - Normal Completion. The weather information was retrieved.
  171.      3 - Minor Error: Weather Information not retrieved. Program restart
  172.          is possible, depending on the batch file setup.
  173.      5 - Major Error: Weather Information not retrieved. Program restart
  174.          is not possible.
  175.  
  176.      The program transforms the output file into upper / lower case, and
  177.      removes many of the unnecessary or unsightly items from the raw
  178.      Weathermation capture file.  It also checks for incomplete and garbled
  179.      weather reports.  Some blank lines are added for improved readability
  180.      of the output file.
  181.  
  182.      Weather Board can make use of "primary" and "secondary" telephone
  183.      numbers.  The primary number is the number you perfer to call most
  184.      often.  The secondary number is a "backup" number, in case the primary
  185.      number is down, busy, etc.  The program will automatically switch to
  186.      the secondary number if the forecast can't be obtained from the
  187.      primary Weathermation site.  You can disable this feature if you wish.
  188.  
  189.      You can customize screen colors, the modem initialization string, Tone
  190.      or Pulse dialing, communications port and baud rate, Weathermation
  191.      phone numbers, number of busy retries and sound.  All this is done in
  192.      a plain text configuration file, which is similar in layout to one
  193.      used in a BBS door.
  194.  
  195.     The Weather Board Weather Forecast Retrieval System                  4
  196.  
  197.  
  198.      There is a log file so you can see what went on during a batch run.
  199.      You can turn logging off if you don't want it.
  200.  
  201.      Most Dos error codes are handled by name, and clear error messages are
  202.      printed, explaining what went wrong.  If an error code pops up that
  203.      isn't recognized, it is printed also.
  204.  
  205.      The program will check for the modem responses of CONNECT, BUSY,
  206.      ERROR, NO DIAL TONE, NO CARRIER, VOICE and RING.
  207.  
  208.      Weather Board should run under any operating system that supports
  209.      MS-Dos applications.  I developed it under Windows.  Other multi
  210.      taskers should not have any trouble running the program as a Dos
  211.      application, but its only been tested with Desqview, Windows and
  212.      MS-Dos.
  213.  
  214.  
  215.      HARDWARE REQUIREMENTS
  216.      ----------------------
  217.  
  218.      Weather Board has very small hardware requirements.  It will run on an
  219.      IBM PC or compatible computer with at least 384K of memory, a Hayes
  220.      compatible modem, monochrome monitor and a 360k floppy drive.
  221.  
  222.  
  223.      INSTALLATION
  224.      ------------
  225.  
  226.      The first step in using any computer program is to install it.
  227.      Weather Board was designed with the Sysop in mind.  So, if you've
  228.      ever installed an online door, you should have no difficulty
  229.      installing Weather Board.
  230.  
  231.  
  232.      Basic Setup For Weather Board
  233.      ------------------------------
  234.  
  235.      Typically, Weather Board is set up as an external event to be run from
  236.      a BBS or front end mailer package.  Weather Board should run with any
  237.      program that supports external events.  After step 3 below, you can
  238.      run Weather Board standalone, from a Dos session, by typing Z.  Step 4
  239.      is just for event setup.
  240.  
  241.      1.  Create a directory for Weather Board, usually C:\WB, and move all
  242.      files in the Weather Board archive to it.
  243.  
  244.      2.  Edit the WB.CFG file for the correct com port, and other options.
  245.      The init string should turn off your modem's error correction and put
  246.      the phone back on the hook, if its off hook.  The default
  247.      configuration file is set up to call the Columbus, Ohio number and get
  248.      the forecast for Columbus.  Change it accordingly for your area.  See
  249.      the following sections for more details on this subject.
  250.  
  251.      3.  Edit the copy statements in the Z.BAT file so the program output
  252.      will be copied to one of your BBS's display or bulletin files. The
  253.      default batch file is set up for the Wildcat BBS package.
  254.  
  255.     The Weather Board Weather Forecast Retrieval System                  5
  256.  
  257.  
  258.      4.  Set up an external event in your BBS or front end mailer program
  259.      to run at the appropriate time(s).  Make sure the event is set to
  260.      "forced", "non sliding", "hard" or whetever your package needs to
  261.      ensure that the event runs on time.
  262.  
  263.      To run Weather Board under Windows, copy WB.PIF to your main Windows
  264.      directory, then add a program item for Weather Board to any program
  265.      group that you choose.  See the Windows online help for more
  266.      information on this procedure.
  267.  
  268.      To run Weather Board with Front Door, add the contents of the
  269.      FDBBS.TXT file to your main Front Door batch file, in the proper
  270.      places.  Set up an eXternal event in Front Door to run Weather Board
  271.      at the appropriate time(s).  The default error level in FDBBS.TXT is
  272.      45.
  273.  
  274.  
  275.      The Configuration File
  276.      ----------------------
  277.  
  278.      Weather Board uses a configuration file to govern its appearance and
  279.      operation.  Its name is WB.CFG, and it must exist in the Weather Board
  280.      directory for the program to run.  Below is the format for the file.
  281.      Lines can be in upper or lower case, but all of them must be present.
  282.  
  283.      --------------------------------------------------------------------
  284.       1. The communications port (COM1: or COM2:)
  285.       2. The baud rate (9600 maximum, 1200 - 2400 usually)
  286.       3. The airport ID for the local forecast
  287.       4. Complete file name of the output file for the editied forecast
  288.       5. Phone number of the Primary Weathermation System (no dashes)
  289.       6. Tone / Pulse dialing string (ATDT or ATDP)
  290.       7. Modem init string or NONE
  291.       8. State code of the local Weathermation System (OH)
  292.       9. COLOR or MONO screen attributes
  293.      10. Foreground color (0 - 15)
  294.      11. Background color (0 - 7)
  295.      12. Number of dial retries (0 - 32767)
  296.      13. Log Status - LOG or NOLOG
  297.      14. Sound - BEEP or NOBEEP
  298.      15. Phone number of the Secondary Weathermation System or NONE
  299.     ---------------------------------------------------------------------
  300.  
  301.  
  302.      Color Codes
  303.      -----------
  304.  
  305.      The following is a list of DOS color codes.  The "Blink" background
  306.      means that the foreground character will blink on and off when the
  307.      background is set to one of the background color codes 8 through 15.
  308.      The "Blink" codes are not supported by Weather Board.
  309.  
  310.      Background Color              Foreground Color
  311.      --------------------------------------------------
  312.       0 - Black                     0 - Black
  313.       1 - Blue                      1 - Blue
  314.       2 - Green                     2 - Green
  315.  
  316.     The Weather Board Weather Forecast Retrieval System                  6
  317.  
  318.  
  319.       3 - Cyan                      3 - Cyan
  320.       4 - Red                       4 - Red
  321.       5 - Magenta                   5 - Magenta
  322.       6 - Brown                     6 - Brown
  323.       7 - White                     7 - White
  324.       8 - Black Blink               8 - Dark Grey
  325.       9 - Blue Blink                9 - Light Blue
  326.      10 - Green Blink              10 - Light Green
  327.      11 - Cyan Blink               11 - Light Cyan
  328.      12 - Red Blink                12 - Light Red
  329.      13 - Magenta Blink            13 - Light Magenta
  330.      14 - Brown Blink              14 - Yellow
  331.      15 - White Blink              15 - Bright White
  332.     ----------------------------------------------------
  333.  
  334.      To add color to your display file or bulletin, edit the WTOP.ASC and
  335.      WBOT.ASC files.  Add whatever codes are recognized by your BBS package
  336.      to activate color.  For Wildcat 3.x, it would be something like this:
  337.  
  338.      @06@ at the beginning of the bar in WTOP
  339.      @0B@ at the end of the bar in WTOP
  340.      @06@ at the beginning of the bar in WBOT
  341.      @0F@ at the end of the bar in WBOT
  342.  
  343.      B and F are Wildcat's codes for 11 and 15.
  344.  
  345.      For BBS packages that use straight Ascii to generate color, you would
  346.      need to add the Ansi escape sequences manually, with a text editor, or
  347.      with an Ansi editor, such as The Draw.
  348.  
  349.  
  350.      About Modem Settings
  351.      ---------------------
  352.  
  353.      Weather Board will run only on com port 1 or 2.  Its maximum connect
  354.      rate is 9600 baud.  Standard IRQ settings should be used.  Also, the
  355.      Weathermation software does not get along with error correcting
  356.      modems.  In order for these modems to connect and retrieve the weather
  357.      forecast properly, you need to temporarily disable your modem's error
  358.      correcting feature.  This is done with the Init String option in the
  359.      WB.CFG file.  The string must start with the letters AT followed by
  360.      whatever command disables the feature for your modem.  Here are some
  361.      examples:
  362.  
  363.      USR Sportster   : AT&M0    USR Courier HST : AT&M0
  364.      Cardinal 9600   : AT\N0    Intel 144I      : AT\N0
  365.      Digicom Scout + : AT*E0
  366.  
  367.      Using the above strings will not write the setting into your modem's
  368.      NRAM.  See your modem manual for the setting you need.  It should be
  369.      listed under something like "error control" or "error correction".
  370.      This explanation only applies to error correcting modems.  If you are
  371.      running a modem that does not support /ARQ or /MNP connections, you
  372.      can use the word NONE in the Init String line of WB.CFG, and get a
  373.      proper connection to Weathermation.
  374.  
  375.     The Weather Board Weather Forecast Retrieval System                  7
  376.  
  377.  
  378.      Another use for the Init String is to disable call waiting service, if
  379.      you have it.  If your computer is using a phone line that has this
  380.      service, and a call comes in, your modem will be disconnected.  For
  381.      touch tone telephones, use AT*70, for pulse (rotary) systems, use
  382.      AT1170.  This will disable call waiting for the current call only.
  383.      The service will reactivate when the current call ends.
  384.  
  385.      One other use for the Init String is to increase the intelligence
  386.      level of your modem, by adding an X value.  Most BBS packages set the
  387.      X value to X1, which provides minimum modem capabilities.  For Weather
  388.      Board, you should use the highest X value that your modem supports.
  389.      This is usually between X4 and X7.
  390.  
  391.  
  392.      HOW IT WORKS
  393.      -------------
  394.  
  395.      Here's an overview of Weather Board in operation.  First, it calls the
  396.      Weathermation number listed in the Primary Number line of WB.CFG. If
  397.      there is no answer, the number of busy retries is exceeded, etc., then
  398.      the Secondary number is called. The connection attempt process is
  399.      repeated. If Weather Board still can't connect, it gives up and exits.
  400.  
  401.      If a connection is made to either number, Weather Board attempts to
  402.      get two weather reports: The local Metro forecast, and the State
  403.      Summary forecast. At present, there isn't an option to get one report
  404.      or the other, but provisions have been made to allow the display of
  405.      either or both reports, via the Z.BAT file. Here's how:
  406.  
  407.      The forecasts are stored in files ending in .DAT. For example, the
  408.      Columbus, Ohio raw forecasts are stored in CMH.DAT (local) and OH.DAT
  409.      (state). The editied forecasts are stored in "2" files - CMH2.DAT and
  410.      OH2.DAT. The batch file simply appends these files together with the
  411.      WTOP.ASC, WMID.ASC, and WBOT.ASC files and copies them to the proper
  412.      places. So, depending on how you set up the copy statements in Z.BAT,
  413.      you can dispplay either or both forecast files in one or more
  414.      bulletins or display files.
  415.  
  416.  
  417.      REGISTRATION INFORMATION
  418.      ------------------------
  419.  
  420.      Skeptical about registering Weather Board?  Its understandable.  I
  421.      want to say right up front that I'm not one of those "grab the money &
  422.      run" guys.  Running a BBS and doing PC programming is my main hobby.
  423.      Its the thing that I do with my spare time.  I've been a Sysop since
  424.      1986, and I intend to be one for a long time to come.  I'm no 90 day
  425.      wonder kid either.  As of this writing, I'm closing in on age 39, and
  426.      have been in data processing for 20 years.  So, when I tell you that
  427.      you're going to get certain things in exchange for your money, you can
  428.      believe it!
  429.  
  430.      Registration of Weather Board is $10.00.  Payment must be made in US
  431.      funds, drawn on a US bank.  Check or Money Order is accepted, made
  432.      payable to Joe Rhinehart.  The registration form is on page A-2.
  433.      Mail to:
  434.                       Rhino Ware
  435.                       c/o Joe Rhinehart
  436.                       760 Cherryhurst Drive
  437.                       Columbus, Oh 43228-2795
  438.     The Weather Board Weather Forecast Retrieval System                  8
  439.  
  440.  
  441.      How to obtain your Registered Version
  442.      --------------------------------------
  443.  
  444.      Once you're sent in the completed registration and payment:
  445.  
  446.      1.  Allow a few days for the mail to reach here!
  447.  
  448.      2.  Call The Comm * Port at 1-614-870-6544 (9600)
  449.  
  450.      3.  When you log on, after filling out the new user information,
  451.      you'll receive a message that you have Personal Mail waiting.  Select
  452.      R to read your message.
  453.  
  454.      4.  Your registered copy of Weather Board will be attached to the
  455.      message.  Select D to download it.
  456.  
  457.      That's it.  I think you'll find this a faster, less complicated way to
  458.      get your registered copy.  You won't have to wait to get a return
  459.      package, or have it get lost in the mail.  And I can put your message
  460.      & file online within minutes of receiving your payment.
  461.  
  462.  
  463.      Registration Policy
  464.      --------------------
  465.  
  466.      What do you get when you register?  Ok, let's say you register version
  467.      1.00.  First, you get a registered program that will never expire, or
  468.      display any shareware "nag" messages to you or your users.  Next,
  469.      you'll be entitled to all minor updates (1.01 to 1.xx) free of charge.
  470.      I will start putting the messages / file attaches on the board as soon
  471.      as I'm sure that the new release is working properly.  Stop by every
  472.      so often to see if you have a new message.  You also get access to a
  473.      special Weather Board conference on my BBS so that you can ask
  474.      questions about Weather Board and obtain help on setup or other
  475.      program related matters.
  476.  
  477.      If there is a major update (1.xx to 2.00), then you'll have to pay for
  478.      it.  But, since you are a registered user, your cost is only $5.00 as
  479.      opposed to the $10.00 for a new registration.  Then, any minor updates
  480.      (2.01 to 2.xx) will once again be free.  I'll notify everyone about
  481.      major updates via message in the Weather Board conference.
  482.  
  483.  
  484.  
  485.  
  486.               I hope you enjoy using Weather Board!
  487.  
  488.     The Weather Board Weather Forecast Retrieval System                A-1
  489.  
  490.  
  491.      WEATHERMATION NUMBERS
  492.      ----------------------
  493.  
  494.      The following are all of the WeatherMation numbers I know about.  If
  495.      you find any more numbers, let me know.  I'll update this list ASAP!
  496.  
  497.      The following are the WeatherMation numbers for the state of Illinois.
  498.      This number operates at 1200 baud.
  499.  
  500.      Chicago            (608) 267-9180
  501.      --------------------------------------------------------------------
  502.  
  503.      The following are the WeatherMation numbers for the state of Ohio.
  504.      This number operates at 1200 baud.
  505.  
  506.      Columbus           (614) 889-5803
  507.      --------------------------------------------------------------------
  508.  
  509.      The following are the WeatherMation numbers for the state of Virginia.
  510.      They were provided by the Virginia Department of Aviation and operate
  511.      at 2400 baud.
  512.  
  513.      Abingdon           (703) 628-9764
  514.      Lonesome Pine      (703) 328-8616
  515.      Manassas           (703) 369-7209 or (703) 369-2474
  516.      Mountain Empire    (703) 686-6534 or (703) 783-8114
  517.      New River Valley   (703) 674-1518
  518.      Roanoke            (703) 362-1151
  519.      Shannon            (703) 899-0574
  520.      Shenandoah Valley  (703) 234-9175
  521.      Virginia Tech      (703) 231-5001
  522.      Winchester         (703) 662-5645
  523.  
  524.      Accomack           (804) 787-7301
  525.      Charlottesville    (804) 973-3518
  526.      Chesapeake         (804) 421-4361
  527.      Chesterfield       (804) 271-7139
  528.      Danville           (804) 799-5028
  529.      Emporia            (804) 634-0602
  530.      Hampton Roads      (804) 488-7817
  531.      Lynchburg          (804) 237-5721
  532.      Mecklenburg        (804) 729-2216
  533.      Norfolk            (804) 857-0941
  534.  
  535.      Petersburg         (804) 861-5559
  536.      Richmond           (804) 786-9046
  537.      Suffolk            (804) 539-0827
  538.      Williamsburg       (804) 220-8810
  539.  
  540.      If you have a problem with any Virginia number, call the VA Depertment
  541.      of Aviation at (804) 786-1364.
  542.      --------------------------------------------------------------------
  543.  
  544.     The Weather Board Weather Forecast Retrieval System                A-2
  545.  
  546.  
  547.                       Weather Board Registration Form
  548.  
  549.  
  550.     Name: _______________________________________________________________
  551.  
  552.  
  553.  
  554.     Address: ____________________________________________________________
  555.  
  556.  
  557.  
  558.     City: _______________________ State: _______ Zip: ___________________
  559.  
  560.  
  561.  
  562.     Telephone Number: Day: _________________ Night: _____________________
  563.  
  564.  
  565.  
  566.     BBS Name: ___________________________________________________________
  567.  
  568.  
  569.  
  570.     BBS Phone Number: ___________________________________________________
  571.  
  572.  
  573.  
  574.     Modem: ____________________ Maximum Baud Rate: ______________________
  575.  
  576.  
  577.  
  578.     Did you have to alter the default initialization string? ____________
  579.  
  580.  
  581.  
  582.     If yes, your initialization string: _________________________________
  583.  
  584.  
  585.  
  586.     Did you use a Weathermation number that was not in the list? ________
  587.  
  588.  
  589.  
  590.     If yes, please answer these questions, so I can update the list:
  591.  
  592.  
  593.     City: ____________________________ State: ________
  594.  
  595.  
  596.     Area Code & Telephone Number: ______________________________
  597.  
  598.  
  599.     Comments: ___________________________________________________________
  600.  
  601.  
  602.     _____________________________________________________________________
  603.  
  604.  
  605.                   THANK YOU for registering Weather Board!
  606.  
  607.