;
; ./cgi-bin/calweb/isapi_readme.htm
;
;-------------------------------------------------------------------------
; Copyright (c) 1999, 2001 by Great Hill Corporation.
; All Rights Reserved.
;
; Calendars for the Web - Server Version
;-------------------------------------------------------------------------

Introduction
=================
Under MS Windows one may take advantage of a technology called
ISAPI to speed the performance of CGI programs.  ISAPI allows
a CGI program to be repeatedly called without causing the
executable to be loaded each time (a potential performance
issue when the program is hit many times per second).  Under 
ISAPI the executable is loaded only the first time it is 
used and remains in memory from then on.

This has a couple of implications:

	1) It is faster than CGI particularly if the executable is 
	   being accessed frequently.

	2) If there are any problems in the executable (such as memory loss
	   or crashes) the web server will lose memory or crash (since
	   under ISAPI the executable is run as part of the web server).

	3) You may not delete the file after it has been used until you
	   stop the web server (this may require a re-boot).  This is 
	   because the .dll file is in use and you may not delete
	   a file that is in use.

One alternative is to isolate the ISAPI .dll into it's own process.  In
this way any potential problems will not crash your server.  This is an
option from within your web site administration tool.

Support for ISAPI
====================
The ISAPI version of Calendars for the Web has been tested and
debugged since version 1.0.2 and is fully supported.

You may access the ISAPI version in exactly the same way as you 
access the CGI version -- just point your browser at it (use 
./calweb.dll instead of ./calweb.exe).

You may use the ISAPI version and the regular (CGI, .exe) version
interchangeably - by this we mean that the data formats are identical,
so you can use the ISAPI version one day and then return to the
CGI version the next day without losing data.

Reporting Errors
================
As is true of all aspects of our software, if you find errors,
omissions or confusing information in this file please send
a note to bugs@greathill.com.  Your comments will be greatly
appreciated and we do actually listen - so it may just be
worthwhile.

===========================================================
Last modified: Tuesday, May 15, 2001