Usage:   Accessing

Ok, now you have HAMweather 2.0 installed  you wonder how to use it.  The templates that came with the distribution provide you with a self contained  version of HAMweather.  Basically, a virtual stand alone system.  Ok, but how do you access it?  Easy.  You just link to the main HAMweather script (hamweather.cgi) and HAMweather will start working as a self contained weather center. 

If you link to the script with out any parameters then you will get the default forecast. (see Administration : Defaults & Options on setting the defaults). For Example: if the URL to the HAMweather.cgi script on your system was : http://www.hamweather.com/cgi-bin/hamweather.cgi   then you could just link to this and display the default forecast.

If you want to lead users to a specific forecast then just append the appropriate parameters to the URL.  For Example: to send users directly to the zone and hourly forecast for Roanoke, VA us the URL : http://www.hamweather.com/cgi-bin/hamweather.cgi?forecast=zandh&place=roanoke&state=va
In this example the forecast parameter defines what forecast to display, the place parameter defines what city/county you want forecast fore and finally, the state parameter defines the state in which the place is located. NOTE: See the available parameters chart for other parameters you can use.

If you installed HAMweather Pro then you can point a person directly to the National Summary (National Current conditions) by using the URL : http://www.hamweather.com/cgi-bin/hamweather.cgi?forecast=ns&state=us&map=1
In this example, the forecast parameter is the forecast to display, the state is set to us to indicate we want us info, and the map parameter is set to one to tell HAMweather to update the national summary map if needed.

HAMweather can also be accessed from a form on a web page. To do this just set the form action to point to your HAMweather URL and set the method to either "get" or "post"  Then add the needed parameters as form elements. An example of a simple form asking for the web site user to enter the place and state for their zone forecast could be written as follows:

<form method="POST" action="http://www.hamweather.com/cgi-bin/hamweather.cgi">
  Enter your 'City, State', state or zipcode :
  <input type="text" name="pands" size="20" value="Blacksburg, VA">
  <input type="hidden" name="forecast" value="zandh">
  <input type="submit" value="GO" name="Submit">
</form>

The above example is similar to what you see at the top of  the  pages included in the HAMweather distribution. Also for a full list of the available parameters that can be used with HAMweather refer to the Available parameters page.

For the command line users or for users setting up cron jobs you can also add parameters from the command line. The parameters follow the script name and are separated by a space. For Example: to display the zone and hourly forecast for Roanoke, Virginia you would use the following command line: hamweather.cgi forecast=zandh place=roanoke state=va

Also when entering the parameters in the command line there may be a time when you need to include a space in a place name or such to do this just use a plus sign (+) in place of the needed space. For Example: to display the zone forecast for Newport News, Virginia use then following command line:
hamweather.cgi forecast=zandh place=newport+news state=va

Finally, you should get in the habit of adding the parameters "user" and "theme" to all links you make to the HAMweather scripts.  For these indicate which user and theme configuration files to use. If you do not add them then HAMweather will use the "default.txt" user file and the "default.txt" theme file. For Example: A proper link to display the zone and hourly forecast for Roanoke, Virginia which includes the user and theme parameters would look like:
http://www.hamweather.com/cgi-bin/hamweather.cgi?user=default&theme=default&forecast=zandh&place=roanoke&state=va

Now that you know the general usage its time to review the parameters that are available.

HAMweather copyright 2000 by HAMweather, LLC, all rights reserved