2.1 Definition and features

4.3 Simple Form Sample

6.1 Common Problems (Quick Tips)

Appendix C: Form Variables Available in CGI Environment

READ THE TERMS AND CONDITIONS OF THIS END-USER LICENSE AGREEMENT (REFERRED TO AS "EULA") CAREFULLY BEFORE OPENING THE PACKAGE CONTAINING THE PROGRAM DISKETTES, THE COMPUTER SOFTWARE THEREIN, PRINTED MATERIALS, AND ‘ONLINE’ OR ELECTRONIC DOCUMENTATION AND THE ACCOMPANYING USER DOCUMENTATION (THE "PROGRAM"). THE PROGRAM IS COPYRIGHTED AND LICENSED (NOT SOLD). BY OPENING THE PACKAGE CONTAINING THE PROGRAM, YOU ARE ACCEPTING AND AGREEING TO THE TERMS OF THIS LICENSE AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY THE TERMS OF THIS LICENSE AGREEMENT, YOU SHOULD PROMPTLY RETURN THE PACKAGE IN UNOPENED FORM, AND YOU WILL RECEIVE A REFUND OF YOUR MONEY. THIS LICENSE AGREEMENT REPRESENTS THE ENTIRE AGREEMENT CONCERNING THE PROGRAM BETWEEN YOU AND GEOCEL INTERNATIONAL, INC (REFERRED TO AS "LICENSOR"), AND IT SUPERSEDES ANY PRIOR PROPOSAL, REPRESENTATION, OR UNDERSTANDING BETWEEN THE PARTIES.

1. License Grant. Licensor hereby grants to you, and you accept, a nonexclusive license to use the Program Diskettes and the computer programs contained therein in machine-readable, object code form only (collectively referred to as the "Software"), and the accompanying User Documentation, only as authorized in this License Agreement. The Software may be used only on a single storage device, such as a computer server, owned, leased, or otherwise controlled by you; or in the event of the inoperability of that computer, on a backup computer selected by you. Neither concurrent use on two or more storage devices (computer servers) nor use in a local area network or other network is permitted without separate authorization and the payment of other license fees. You agree that you will not assign, sublicense, transfer, pledge, lease, rent, or share your rights under this License Agreement. You agree that you may not reverse engineer, decompile, disassemble, reverse compile, or otherwise translate the Software.

Upon loading the Software into your computer, you may retain the Program Diskettes or applications (if delivered without diskette) for backup purposes. In addition, you may make one copy of the Software on a second set of diskettes (or on cassette tape or other storage media) for the purpose of backup in the event the Program Diskettes are damaged or destroyed. You may make one copy of the User's Manual for backup purposes. Any such copies of the Software or the User's Manual shall include Licensor's copyright and other proprietary notices. Except as authorized under this paragraph, no copies of the Program or any portions thereof may be made by you or any person under your authority or control.

2. Licensor's Rights. You acknowledge and agree that the Software and the User's Manual are proprietary products of Licensor protected under U.S. copyright law and international copyright treaties, as well as other intellectual property laws and treaties. You further acknowledge and agree that all right, title, and interest in and to the Program, including associated intellectual property rights, are and shall remain with Licensor. This License Agreement does not convey to you an interest in or to the Program, but only a limited right of use revocable in accordance with the terms of this License Agreement. All title and copyrights in and to the PROGRAM (including but not limited to any images, photographs, animations, video, audio, music, text, and "applets" incorporated into PROGRAM), the accompanying printed materials, and any copies of the PROGRAM are owned by GeoCel or its suppliers.

3. Dual-Media Software. You may receive the PROGRAM in more than one medium. Regardless of the type or size of medium you receive, you may use only one medium that is appropriate for your single computer server/storage device. You may not use or install the other medium on another computer. You may not loan, rent, lease, or otherwise transfer the other medium to another user, except as part of the permanent transfer (as provided above) of the PROGRAM.

4. License Fees. The license fees paid by you are paid in consideration of the licenses granted under this License Agreement.

5. Support Services. GeoCel may provide you with support services related to the PROGRAM. Use ("Support Services"). Use of Support Services is governed by the GeoCel policies and programs described in the user manual, in "online" documentation, and/or in other GeoCel-provided materials. Any supplemental software code provided to you as part of the Support Services shall be considered part of the PROGRAM and subject to the terms and conditions of this EULA. With respect to technical information you provide to GeoCel as part of the Support Services, GeoCel may use such information for its business purposes, including for product support and development. GeoCel will not utilize such technical information in a form that personally identifies you.

6. Upgrades. If the PROGRAM is labeled as an upgrade, you must be properly licensed to use a product identified by GeoCel as being eligible for the upgrade in order to use the PROGRAM. A PROGRAM labeled as an upgrade replaces and/or supplements the product that formed the basis for your eligibility for the upgrade. You may use the resulting upgraded product only in accordance with the terms of this EULA. If the PROGRAM is an upgrade of a component of a package of software programs that you licensed as a single product, the PROGRAM may be used and transferred only as part of that single product package and may not be separated for use on more than one computer.

7. Term. This License Agreement is effective upon your opening of this package and shall continue until terminated. You may terminate this License Agreement at any time by returning the Program and all copies thereof and extracts therefrom to Licensor. Licensor may terminate this License Agreement upon the breach by you of any term hereof. Upon such termination by Licensor, you agree to return to Licensor the Program and all copies and portions thereof.

8. Limited Warranty. Licensor warrants, for your benefit alone, for a period of 90 days from the date of commencement of this License Agreement (referred to as the "Warranty Period") that the Program Diskettes in which the Software is contained are free from defects in material and workmanship. Licensor further warrants, for your benefit alone, that during the Warranty Period the Program shall operate substantially in accordance with the functional specifications in the User's Manual. If during the Warranty Period, a defect in the Program appears, you may return the Program to Licensor for either replacement or, if so elected by Licensor, refund of amounts paid by you under this License Agreement. You agree that the foregoing constitutes your sole and exclusive remedy for breach by Licensor of any warranties made under this Agreement. EXCEPT FOR THE WARRANTIES SET FORTH ABOVE, THE PROGRAM, AND THE SOFTWARE CONTAINED THEREIN, ARE LICENSED "AS IS," AND LICENSOR DISCLAIMS ANY AND ALL OTHER WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

9. Limitation of Liability. Licensor's cumulative liability to you or any other party for any loss or damages resulting from any claims, demands, or actions arising out of or relating to this Agreement shall not exceed the license fee paid to Licensor for the use of the Program. In no event shall Licensor be liable for any indirect, incidental, consequential, special, or exemplary damages (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE PRODUCT, even if Licensor has been advised of the possibility of such damages. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.

10. Trademark. GeoCel International, Inc. is a trademark of Licensor. No right, license, or interest to such trademark is granted hereunder, and you agree that no such right, license, or interest shall be asserted by you with respect to such trademark.

11. Governing Law. This License Agreement shall be construed and governed in accordance with the laws of the State of Texas.

12. Costs of Litigation. If any action is brought by either party to this License Agreement against the other party regarding the subject matter hereof, the prevailing party shall be entitled to recover, in addition to any other relief granted, reasonable attorney fees and expenses of litigation.

13. Severability. Should any term of this License Agreement be declared void or unenforceable by any court of competent jurisdiction, such declaration shall have no effect on the remaining terms hereof.

14. No Waiver. The failure of either party to enforce any rights granted hereunder or to take action against the other party in the event of any breach hereunder shall not be deemed a waiver by that party as to subsequent enforcement of rights or subsequent actions in the event of future breaches.

WebMailer Pro is a form-to-e-mail Common Gateway Interface (CGI ) application that processes HTML form data and sends it in a customizable format to a standard Internet e-mail account. Popular applications are guestbook forms and user feedback forms, and other applications that require that form data be sent to an e-mail account.

WebMailer Pro does not require any programming knowledge other than an understanding of basic HTML to quickly implement form generation and processing on a Web site. WebMailer Pro supports queuing of failed messages and customization of all e-mail and Web pages displayed after the form has been submitted.

• Supports required fields that must be filled in by the user
• E-mails HTML form results to you immediately after confirming that all required fields have been filled in
• Supports multiple e-mail recipients
• Ability to e-mail customized receipt / "thank you" messages to user
• Customizable web page displayed on the user’s browser following processing
• Optional redirection to another HTML page following processing
• Supports message queuing in case of mail server errors
• Easily customizable e-mail formatting - allows you to customize the format or results of an e-mail based upon conditions that you set up.

WebMailer Pro is a Common Gateway Interface (CGI) application that runs on your Web server. Form data is sent to WebMailer Pro by the server software when the user submits the form, and WebMailer Pro returns any results to the web server, which displays them on the user’s browser.

Following is a more detailed general flow of WebMailer Pro operations.

• Multiple recipients are allowed.
• The message body contains a standard form dump of all form variables or a custom message created from a template file.

• Multiple recipients are allowed.
• The message body contains a standard form dump of all form variables or a custom message created from a template file.

• This is a web page created on the fly by WebMailer Pro that lists form data sent, a web page created from a web template file, or the user can be redirected to another URL.

WebMailer Pro requires a Web server running on Windows 95 or NT 4.0 on the Intel platform. This product has not yet been tested for compatibility with FX!32 translation software on the Alpha platform.

1. Insert the diskette into the disk drive.
2. From the Start Menu, choose Run…
3. In the Run dialog box, type A:\SETUP.EXE and then click OK. If A: is not your floppy drive, then replace A: with the appropriate drive letter.
4. The installation program will ask if you want to unarchive WebMailer Pro, display the license agreement, and then guide you through the installation procedure.

The installation program will ask you to choose a directory for the executable and documentation. The installation program will always create a directory named WMPRO in the directory you have selected. This is where the program itself (WMPRO.EXE), configuration file, and template files will be installed.

You will need to select a directory for the included sample forms. The installation program will always create a directory named SAMPLES in the directory you have selected.

You should choose a directory in your DOCS or WWWROOT tree, or other directory in which HTML pages are accessible through the web server. Do not install the samples in a CGI-BIN or Scripts directory as you cannot typically access HTML files from these directories.

For Netscape servers, you will need to ensure that CGI has been activated as a type on the server, or you will need to add the WMPRO directory to the list of CGI-BIN directories. This is done through the web server administration program.

If you do not activate CGI as a type, then you must add the WMPRO directory to the CGI-BIN directories list because otherwise WebMailer Pro will not be recognized as a CGI by Netscape and will not run.

Activating CGI as a type means that any .EXE file in any accessible directory is assumed to be a CGI. If you do this, then you will not need to add the WMPRO directory to the CGI-BIN directories list.

However, we recommend that you add the WMPRO directory to the CGI-BIN directories list, in any case, and name the URL prefix "/WMPro". This will make it easier to use the included samples, as they refer to this directory. Otherwise, you will need to modify the samples to the correct URL for WMPRO.EXE.

The following apply to Microsoft Internet Information Server for Windows NT Server, Microsoft Peer Web Services for Windows NT Workstation, and Microsoft Peer Web Server for Windows 95.

You will need to create a virtual directory that points to the WMPRO directory. If you are using IIS, this is done from the Internet Service Manager Manager, in the Directories Tab of the Web Service Properties. If you are using PWS, run the Internet Services Administrator, and select the Directories Tab under the WWW Services page.

We recommend that you call this virtual directory /WMPro for compatibility with the included sample forms. Be sure to grant this virtual directory Execute permissions from within the web server administration program.

Note that if even your WMPRO directory is located in your /Scripts directory, you will still need to create a virtual directory specifically for the WMPRO directory. This is due to behavior by IIS and PWS that reports to WebMailer Pro that the current directory

is the /Scripts directory, instead of /Scripts/WMPro.

Because WebMailer Pro looks for the configuration file in the current directory, the current directory reported must be the WMPRO directory. Therefore it is always necessary, in any case, to create a virtual directory specifically for the WMPRO directory.

In general, make sure that WebMailer Pro is installed in a directory from which the web server allows executables to be run. How this is accomplished will vary on your web server.

If you use the services of an Internet Service Provider (ISP) for your web site, then you will need to consult with your ISP for instructions on how they accommodate their users’ CGI programs. How you upload the WebMailer Pro files will also depend on the ISP; usually you will need to use FTP (File Transfer Protocol) to upload HTML files and CGI programs.

You will need to upload WMPRO.EXE and WEBMLR.INI (these files that are created in the WMPRO directory during local installation) to the location your ISP provides for your CGI programs. Depending on your ISP, this may be a central CGI-BIN or Scripts directory where all users’ CGI programs are stored, or it may be a local CGI-BIN or Scripts directory in the directory designated as the home directory for your site.

In any case, you will also need to replicate the entire GEOCEL directory structure and files that were created at installation underneath the WMPRO directory. This is necessary WebMailer Pro expects template files to be found in GEOCEL\TEMPLATES beneath the directory where WMPRO.EXE is located.

Using WebMailer Pro with HTML forms is very easy. Using your favorite HTML editor, create a form as you normally would. The form's action value will need to be set to reflect the directory where the program was installed. For example, the form header might be:

Each of the settings in the previous section can then be included in most cases using the "HIDDEN" HTML input type. The obvious exceptions would be the fields for the visitor's email address as well as the credit card fields which would be specified as the "TEXT" input type in this case.

Please refer to an HTML reference guide for more information about creating forms.

WebMailer Pro uses the contents of the actual form along with default settings from the WEBMLR.INI initialization file (please refer to Appendix B for a description of the entries in this file) to determine which actions to perform once the user has submitted the form. To pass parameters to the program through a form, you will need to specify a 'NAME' and 'VALUE' for each form object. For example, to save a person's name you would use the following tag inside the '<FORM>' tags of your form.

Once the user submits the form, WebMailer Pro will return the value of the 'Last_Name' variable in an e-mail message to webmaster@abc.com.

WebMailer Pro reserves certain values to control form processing. By specifying the value of these variables, you can customize the behavior and output of the program. Most of these variables may be specified as the 'HIDDEN' input type . Many of the variables can also be used to retrieve information from the user within the form. In this case, the input type should be specified as "TEXT" For example:

To set the receipt's subject field yourself so that it is always the same, you could use the following tag within the form:

<INPUT TYPE="HIDDEN" NAME="RECEIPT_SUBJECT" VALUE="Your receipt">

To allow the user to enter this information, so that they can set the subject of the message which they will receive, the following tag should be used within the form:

<INPUT TYPE="TEXT" NAME="SUBJECT" VALUE="">

Notice the difference in the input type.

The following is a list of keywords that the program will recognize: