/////////////////////////////
//      /      //    //    //   Investment Intelligence Systems Corp.
////  /////  ///  ////  /////   WingzPro
////  /////  ////   //  /////   http://www.wingz.com
////  /////  //////  /  /////
//      /      /    ///    //   411 README.TXT
/////////////////////////////

The files within the 411 directory make up a complete Wingz Pro 
runtime application. This particular application is a small example 
of a runtime application using HyperScript and SQL for HyperScript.

The 411-Information application utilizes a database to store
phone and email alias information about a set of individuals.
With this application, you can add, delete, and modify records in 
the 411-Information Database and can use the interface as a 
directory to look up individuals by their first or last names, 
their phone extensions, or their email aliases.  In the 411 
directory, you will find all of the files necessary to run the 
411-Information application. You will also find under the 
411/Source directory, all of the source files used in the creation 
of this application.

The files required to run 411 as a runtime application are:

	411.BRF                 411 Binary Resource File

	The following files are contained within 411.BRF
		 411.SCZ        Initialization script
		 411.GIF        Splash box picture
		 411.RTD        Runtime definition file
		 BEGIN.SCZ	Script called by opening dialog box
		 CONTYPE.SCZ	Script to create opening dialog box
		 MAIN.SCZ       Script containing several functions
				for the application
		 MKTDBPH.SCZ    Script to create the sample database
		 EXTINFO.WKZ    Worksheet used to display a 411
				database record
		 NEWEXT.WKZ     Worksheet used to allow updates to
				a 411 database record
		 PRINT.WKZ      Worksheet to preview a printout of
				the 411 database
		 PHONE.HLP      Help file
		 WELCOME.PFZ    Portfolio for welcome screen

	The names of the files listed above are all supplied 
	using all lowercase letters on Unix.

	Windows only files
		 411.ICO        Windows icon version of application icon

	Motif Only files
		 411.Xdefs      411 Xdefaults
		 411            Shell script to run the application
		 411.bmp        X-bitmap version of the application icon


In addition to the above listed files, all of the files used to create 
the 411 application are provided in the SOURCE subdirectory. In 
the SOURCE subdirectory, you will find the source files for the 
required scripts, as well as the layout (or prototype files) used to 
generate the HyperScript code for the application dialog boxes and 
menubar.

The 411.RTD file listed above is required to define many of the 
properties of the application.  Items such as the application title, 
icon and splash box picture are defined using this file.

For Windows, use the following steps to set up and run the 411 
application:

   1.	Create a new Shortcut

   2.	Within the Create Shortcut dialog box enter the following 
	Command Line:

	"C:\Program Files\IISC\WingzPro\WingzPro.exe" -hsruntime 411.rtd 411.brf

   3.	Click the Next Button; Enter 411 as the name of the Shortcut.

   4.	Click Finish.

   5.	Right click on the new Shortcut Icon on the desktop; select 
	Properties from the menu.

   6.	In the Shortcut tab of the dialog box, change the "Start in" 
	field to the following:
	
	"C:\Program Files\IISC\WingzPro\Runtime\411"	

   7.	Click on the Change Icon button and select the following as 
	the icon:
	
	C:\Program Files\IISC\WingzPro\Runtime\411\411.ICO

   8.	Click Apply and then Ok in the Properties dialog box.

   9.	Double-click on the new shortcut icon to launch the 411
	application.

Keep in mind that the steps outlined above are assuming that WingzPro was 
installed in its default location. If you chose to install it in another 
location then substitute the paths used above with the correct ones for 
your installation.

For Motif, use the following steps to set up and run the 411 
application:

   1.	Create the following shell script, named 411, with permissions 755:

#!/bin/sh
#
# @(#)readme.txt	3.3.1.5 98/09/21
#

fatal()
{
	echo "$*"
	exit 1
}

echo "Thank you for using I-411."

test -n "$WINGZ3" || fatal "Please set the WINGZ3 environment variable."
test -n "$I411" || fatal "Please set the I411 environment variable."

if [ -x $WINGZ3/bin/WingzPro ]
then
	$WINGZ3/bin/WingzPro -hsruntime 411.rtd $I411/411.brf
else
	if [ -x $WINGZ3/bin/WingzProRT ]
	then
		$WINGZ3/bin/WingzProRT -hsruntime 411.rtd $I411/411.brf
	else
		fatal "Sorry, cannot find WingzPro executable."
	fi
fi

exit 0

   2.	Set the environment variable WINGZ3 to point to where
	Wingz Professional is installed. For example,

      setenv WINGZ3 /usr/Wingz3            # C-shell
      WINGZ3=/usr/Wingz3;export WINGZ3     # Bourne, Korn shell

   3.	Set the I411 environment variable to point to the place
	where the 411 scripts are installed.  

      setenv I411 $WINGZ3/Runtime/411      # C-shell
      I411=$WINGZ3/Runtime/411;export I411 # Bourne, Korn shell

   4.	Execute the shell script by entering '411' at a command
	prompt.

This should work provided your WINGZ3 and I411 environment variables
are set correctly.

