home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / wbo132s.zip / UPGRADE.DOC < prev    next >
Text File  |  1993-12-09  |  6KB  |  162 lines
  1.      Upgrading to Weather Board 1.32
  2.      --------------------------------
  3.  
  4.      This document is only for people that are currently running a version
  5.      of Weather Board prior to 1.32.  New users should refer to the
  6.      installation section of the WB.DOC file.
  7.  
  8.      Due to some rather extensive internal changes, upgrading to Weather
  9.      Board 1.32 is a little more involved than in past releases.  Its not
  10.      difficult, however. If you want to switch to the OS/2 version from an
  11.      old Dos version, follow the Dos upgrade from your current version
  12.      first, then follow the OS/2 upgrade for 1.30.
  13.  
  14.      The main change is to the WB.CFG file.  There are two new lines
  15.      included.  Line 16 is for the Edit Mode feature, and line 17 is for
  16.      the State Summary output file.  Line 18 is for the program modem
  17.      control during the edit process. See the examples in the new docs for
  18.      information on this.
  19.  
  20.      The other change is the inclusion of state summaries for people who
  21.      are running older versions of Weather Board, which did not include
  22.      this feature.  If you are running a version prior to 1.10, and want to
  23.      display the state summary, you will need to modify your Z.BAT file.
  24.  
  25.  
  26.      The Changes Explained
  27.      ----------------------
  28.  
  29.      Four new features have been added to Weather Board 1.30. They are
  30.      1) A customizable output file for the State Summary forecasts,
  31.      2) Multiple city and state forecasts, 3) Jet Edit and 4) Modem Hook
  32.      Control.
  33.  
  34.  
  35.      State Summary File :
  36.  
  37.      This is the easy one. Line 17 is for the full name of the output file
  38.      for State Summary forecasts. It works just like line 4, which is the
  39.      line for the Local Area forecast.
  40.  
  41.  
  42.      Multiple Forecasts :
  43.  
  44.      This lets you do two local city forecasts and two state summary
  45.      forecasts with one run of the program. If you put CMH LAX in line 3 of
  46.      WB.CFG, you'll get the reports for Columbus and Los Angeles in the
  47.      local forecast output file. If you put OH CA in line 8, you'll get the
  48.      state summaries for Ohio and California in the state summary output
  49.      file.
  50.  
  51.      Here's the neat part. If you put OH CA in line 3, you'll get a local
  52.      forecast output file that contains forecasts for most major cities in
  53.      both states. What cities you get will depend on where the National
  54.      Weather Service offices are in that state. Couple this with OH CA in
  55.      line 8, to get the state summaries, and you'll obtain a wealth of
  56.      weather information for a fairly wide area.
  57.  
  58.  
  59.      Unfortunately, a wealth of information brings its own set of problems
  60.      to the table. One of which is very large capture files, which need to
  61.      be edited. In doing tests on the multiple forecast routines, two
  62.      things became obvious. First, I had to add a TON of editing code to
  63.      make these "stacked" forecasts look presentable, and second, all this
  64.      new code was making the edit extremely slow on large files. Small
  65.      files (like just looking for CMH and OH) didn't seem to be a problem.
  66.  
  67.      But putting in AZ CA for both local and state forecasts resulted in
  68.      editing sessions of over 10 minutes on my 386/25. I could imagine what
  69.      a 4.77 mhz PC would be like! So to cut down on this time, I added the
  70.      second feature, called Jet Edit.
  71.  
  72.  
  73.      Jet Edit :
  74.  
  75.      This option is invoked with line 16 of WB.CFG. There are actually two
  76.      possible options for line 16, FULL and JET. FULL edit does what you
  77.      might expect. It does lower case translation, and capitalization all
  78.      over the place, as required. It doesn't get everything all the time,
  79.      but it handles about 98% of the situations it encounters. But this
  80.      takes time. JET bypasses the lower case phase of the editor. It also
  81.      will not add blank lines in quite as many places as FULL does.
  82.      However, the same file size that takes FULL 10 minutes can be done by
  83.      JET in about 25 seconds. I'd say that's worth putting up with upper
  84.      case.
  85.  
  86.      So here's how I'd set things up.  If you are getting forecasts for one
  87.      city and state, or at least not very many cities and one state, use
  88.      FULL. It doesn't take very long on small capture files, and it will
  89.      make your output files look the best. If you need reports for a large
  90.      area, or the reports you ask for tend to generate large capture files,
  91.      use JET. Your output files will be in upper case, and they might not
  92.      look quite as nice as with FULL, but your BBS will come back up a LOT
  93.      faster with JET. You'll just have to experiment and see which option
  94.      is right for you.
  95.  
  96.  
  97.      Modem Hook Control :
  98.  
  99.      This option is invoked with line 18 of WB.CFG. There are two options
  100.      for line 18, YES and NO. YES instructs the program to take the phone
  101.      off the hook at the start of editing and to put it back on hook at edit
  102.      completion, just before the program ends. NO will bypass this part of
  103.      the program and leave the modem onhook while the editing is underway.
  104.  
  105.  
  106.      The Upgrade Procedure
  107.      ----------------------
  108.  
  109.      For version 1.30:
  110.  
  111.  
  112.      DOS Version:
  113.  
  114.      1.  Copy WBDOS.EXE into the \WB directory.
  115.  
  116.      2.  Change the .EXE name in Z.BAT.
  117.  
  118.  
  119.      OS/2 Version:
  120.  
  121.      1.  Copy WBOS2.EXE into the \WB directory.
  122.  
  123.      2.  Rename Z.BAT to Z.CMD.
  124.  
  125.      3.  Change the .EXE name in Z.CMD.
  126.  
  127.  
  128.      For versions 1.25 - 1.29:
  129.  
  130.      1.  Copy WBDOS.EXE into the \WB directory.
  131.  
  132.      2.  Change the .EXE name in Z.BAT.
  133.  
  134.      3.  Add line 18 to WB.CFG as described above.
  135.  
  136.  
  137.      For versions 1.10 - 1.24:
  138.  
  139.      1.  Copy WBDOS.EXE into the \WB directory.
  140.  
  141.      2.  Change the .EXE name in Z.BAT.
  142.  
  143.      3.  Add lines 16, 17 & 18 to WB.CFG as described above.
  144.  
  145.  
  146.      For versions prior to 1.10
  147.  
  148.      1.  Copy WBDOS.EXE into the \WB directory.
  149.  
  150.      2.  Change the .EXE name in Z.BAT.
  151.  
  152.      3.  Add lines 16, 17 & 18 to WB.CFG as described above.
  153.  
  154.      4.  If you want to display the State Summary file, either edit the
  155.      copy statements in your Z.BAT to include the summary output file, or
  156.      use the one provided in the archive. If you don't want the summary
  157.      file displayed, no change to Z.BAT is necessary.
  158.  
  159.  
  160.      That's it. I hope you enjoy this new version of Weather Board!
  161.  
  162.