home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / weathr03.zip / readme.txt < prev    next >
Text File  |  1995-06-19  |  7KB  |  188 lines
  1.             PM Weather
  2.                 by
  3.                 
  4.            Mike Kopack  (Mav2)
  5.                   Ed Boykin   (Av8|)
  6.             Stephen Loomis (sophisto)
  7.               
  8.                 Version .03
  9.             
  10.             
  11.     (NOTE: Because this program uses data from another server, only 
  12.            information from US locations is available. If you know of
  13.            some weather server that holds freely accessable data for
  14.            your country, let me know and I'll try to make a version
  15.            for you.... -- Mike )
  16.             
  17.             
  18. What is PM Weather?
  19. -------------------
  20.  
  21. PM Weather is a program I've been thinking of writing for about a year now. My
  22. school has a script on it's main Sun server systems that will
  23. go out to the weather server at the University of Michigan and retrieve the
  24. current weather data for you. One day while working in a Mac cluster I saw a
  25. graphical interface for this server that displayed all the data in
  26. terms of mercury in a thermometer and such. I had just started running OS/2 
  27. and thought it would be a great program for us OS/2 users with Net access to 
  28. have.
  29.  
  30. It took me a while to get into OS/2 enough to learn how to do ANY PM programing.
  31. This is the result so far of my efforts. Stephen and Ed were gracious enough to
  32. code up the sockets interface which does the actual data retrieval for me. I
  33. am in charge of the PM interface and making changes/additions to the data 
  34. retrieval portion. Most of the PM coding I took from Petzold's "Presentation
  35. Manager Programming for OS/2" book. I highly recommend this book to anyone 
  36. trying to learn PM coding....
  37.  
  38.  
  39. Installation
  40. ------------
  41.  
  42. Simply create a new directory and unzip the archive into it. You can associate
  43. a Program template to the program and it will have an icon too. During execution
  44. the program will create a log file. This is for debugging purposes only and will
  45. eventually be removed. Keep in mind that this log file will grow the longer you
  46. have the program running so you might want to shut it down occationally and then
  47. start it back up to restart the log.
  48.  
  49. Once the program starts it will attempt to retrieve the current data for the 
  50. last city that was checked. The archive comes with ATL (atlanta) as teh default.
  51. To change this go into Options-->Location menu and enter in a new 3 letter code
  52. for the airport nearest you and press ok. For now on the program will go to 
  53. that airport code at startup. This feature replaces the older .cfg configuration
  54. files from the previous version.
  55.  
  56. City codes can be found in the aircodes.txt file included in the archive.
  57.  
  58. How to run the program
  59. ----------------------
  60. NOTE: BEFORE running this program you MUST have a connection to the network
  61. working, either through IBM's TCPIP/2.0 or through the Internet Access system
  62. provided in OS/2 Warp. I don't know if it will work through something like
  63. TIA, so experiment at your own risk.... Users have also reported that the system
  64. will not work through firewalls.  I'm talking to Ed about this and we'll see
  65. what we can do, but it probably won't happen for a while yet...
  66.  
  67.  
  68. At the command line the program can be run simply by typing weather, or from
  69. the desktop, click on the PMWeather icon. The program will pop open a window
  70. and immediately attempt to retrieve the current weather stats for the city
  71. with the code you last entered into the Location dialog. Once this data is retrieved
  72. it will be displayed in a textual listing format. The future versions will display
  73. everything graphically. You can update the data at any time by going into the
  74. Options menu and selecting Update. The program currently will access the server
  75. every 1 hour after the program is initially run. Data on the server is *NOT* 
  76. always kept up to the hour, but is usually pretty close.
  77.  
  78.  
  79. NOTE:
  80. ------------------------------------------------
  81. Beta testers with SLIP/PPP connections have reported 30 seconds waits. It is
  82. largely a matter of how fast your net connection is to the rest of the world.
  83. Since I have now put the data retrieval portion of the program into a second
  84. thread, it will no longer lock up your machine until the data is retrieved.
  85. Therefore, if you start the program and it reports that it's updating and the
  86. data isn't immediately on the screen, be patient!!! It will come.... If you get
  87. garbage data back, the server is either down or is flooded by requests. Try
  88. getting the data again in a little while.
  89.  
  90.  
  91.  
  92.  
  93. Future additions / Changes
  94. --------------------------
  95.  
  96. Add in graphical displays of the data!!!
  97. Include on-line help
  98. Possibly retrieve hourly weather maps and display
  99. Get both short and long term forcast to display textually
  100. general debugging
  101. Climate data retrieval
  102. Chart daily conditions over time into spreadsheet readable format.
  103.  
  104.  
  105.  
  106.  
  107. I hope you liked this program. I was writing it mainly as an exercise in PM 
  108. coding. I'm hoping to get it done before the end of the summer since I'll be 
  109. starting work with IBM here in Atlanta and won't have much free time after that.
  110.  
  111.  
  112. If you use this program, please do me a favor and take a second to send me some
  113. e-mail at either of the addresses below. I just want to get an idea of how
  114. wide spread this program gets.
  115.  
  116.  
  117. If you have any questions/problems with the program, or just want to talk, 
  118. send me e-mail at:
  119.  
  120. Buzz@wc162.residence.gatech.edu  (until Sept 1, 1995)
  121.     or
  122. gt6758b@prism.gatech.edu (until December 1995)
  123.  
  124. After that, who knows!
  125.  
  126. I can also be reached a good amount of the time on IRC in the #os/2 channel.
  127.  
  128. PS: Don't bug Ed or Stephen about this... their involvement basically ended when
  129. they finished the socket code... It's become my baby now and my responsibility.
  130.  
  131.  
  132.  
  133. Later!!!
  134.  
  135. --Mike Kopack
  136.  
  137.  
  138. History
  139. ---------
  140. Version 0.1 ----
  141.  
  142. First version. Proof of concept.
  143. Single threaded.
  144. Required .CFG file
  145. Monocolor.
  146.  
  147.  
  148. Version 0.2 ---- (Private beta)
  149.  
  150. Added Multithreaded operation to stop system lockups.
  151. Updating status display added.
  152. More data retrieved from server.
  153. About dialog added
  154. Hourly update timer added
  155.  
  156.  
  157. Version 0.3 ---- (This version)
  158.  
  159. Added Pop-up dialog for entering city code
  160. INI file support replacing .cfg file
  161. General Bugfixes.
  162. Listing of all valid codes included in archive.
  163. Fixed Cuonditions field bug.
  164.  
  165.  
  166.  
  167. Projected features in upcoming versions
  168. ---------------------------------------
  169. Version 0.4 ----
  170.  
  171. saves last run state for window location and size
  172. On-Line Help Implemented
  173. Display of Forcast Data
  174. Spreadsheet readable condition log files
  175.  
  176.  
  177. Version 0.5 ----
  178.  
  179. Beginning Iconic display (will be for current data first)
  180.  
  181.  
  182. Version 1.0 ----
  183.  
  184. Fully Graphical version
  185. Weathermaps
  186. Climate data
  187.  
  188.