// ---------------------------------------------------------------
//
// -----------------------------------------------------
// copyright 2000 by voxeo corporation. (see LGPL.txt)
//
// US Postal Codes database, Copyright (c) 2000 CD Light
// All Rights Reserved.
// -----------------------------------------------------
//
// v1.0 Coded in PHP 4.0, ASP, PERL, JSP, Cold Fusion, and as a Java Servlet
// v1.0 Coded by John Higgins, Stephen J. Lewis, and Omi Chandiramani
//
// This application is prompts users over the phone for a 5 digit
// zipcode, then accesses a database containing the US Postal Code
// information for the year 2000 to find cities (and states) that
// match the zipcode. It will read the results to the caller,
// then ask for another zipcode. The same application has been
// written in PHP, JSP, ASP, PERL, Cold Fusion, and as a Java Servlet (q.v.)
// as sample code on how to use CallXML and backend scripting languages.
//
// This zip file contains the following files:
// US Postal Codes.mdb <---- The actual database file itself
// schema.ini <---- Database ini file
// database-win32.inc <---- abstracted ODBC database routines (PHP)
// LGPL.txt <---- opensource license agreement
// readme.txt <---- This file
// zipcode.cfm <---- Cold Fusion version (part 1)
// getzip.cfm <---- Cold Fusion version (part 2)
// zipcode.pl <---- PERL version
// zipcode.php <---- PHP version
// zipcode.asp <---- ASP version
// zipcode.jsp <---- JSP version
// ZipcodeApp.java <---- Java servlet version
//
// Several audio files are associated with this application:
// MainMenu.wav
// Results.wav
// NotFound.wav
// YouHaveTakenTooLong.wav
// MultipleResults.wav
//
// All audio files are PCM format, 8-bit, mono, unsigned.
//
//
// Quick Start Instructions:
//
// 1. Unzip the Zipcode.zip package onto your server.
//
// 2. Connect the database file as an ODBC data source.
//
// 3. Point a community.voxeo.com phone number to the voice
// application.
//
// a. Point your browser to the voxeo community page:
// http://community.voxeo.com/. Click on the "account login"
// button.
//
// b. Click the "log in here" link. (Or create an account if
// you do not already have one by clicking the "you can
// get one here" link.)
//
// c. On the "account administration" page, click the "phone
// number administration and url mapping" link.
//
// d. Fill in the url mapping form:
//
// select a city near you
//
// platform: leave it on the "CallXML" default
// url: point to the zipcode file (ASP, CFM, PL, PHP, JSP, JAVA)
//
// Click the "Add Mapping" button.
//
// e. Edit the pathstring within the code to point to your own webserver:

zipcode.asp: PathString = "http://MyServer.com/MyDirectory/"

zipcode.pl: $PathString = "http://MyServer.com/MyDirectory/";

zipcode.cfm:

zipcode.php: $PathString = "http://MyServer.com/MyDirectory/";

zipcodeapp.java: private static String baseURL = "http://MyServer.com/MyDirectory";
private static String servletURL = baseURL + "/ZipcodeApp";


//
// f. A new number should appear with the URL. Test the URL link
// by clicking it. You should see a XML file that starts with
// the following line:
//
//
//
//----------------------------------------------------------------