VisualWorks(R) ISAPI Gateway - readme.txt
Copyright Cincom Systems, Inc. 2003-2009. All rights reserved.

This directory contains a complete Microsoft VisualStudio .NET 2003
(Visual C++ 8.0) project with which to build the VisualWorks ISAPI
Server Extension.

This is a MFC application which contains a CHttpServer-derived extension
which implements the ISAPI required member function callbacks, as well a
CHttpServerContext-derived extension to process the requests on their 
own individual thread.

The class VwWinsock2 wraps connections to VisualWorks through the
WINSOCK2 TCP/IP protocol stack.  Access to the hospmap file explicitly
uses standard C functions rather than the MFC class CStdioFile due to
problems discovered on Windows 2003 Server machines.

The DLLs are compiled to use MFC in a static library to avoid 
complications with various installed versions of the Microsoft MFC 
support.  The internal compile flag, VW_TRACE, is used for the debug
version to redefine the tracing macros to use the VisualWorks generic
tracing services (in vwtrace.cpp) directing output to an explicitly 
named file (unique to each separately named DLL) located in

	%SystemRoot%\VisualWave


TESTING YOUR INSTALLATION:

Use the special query parameter [EchoIsapi2vw] to test for correct
installation of the ISAPI Gateway, and any desired redirecting virtual
directory, without accessing the VisualWorks Application Server.

If IIS is running on machine "localhost", at port "80", using a
redirecting virtual directory "vwtest", test the ISAPI Gateway
installation using the URL

	http://localhost:80/vwtest?EchoIsapi2vw

To test a POST request, this query parameter can also be added to the
action value on a form.  On Submit, the ISAPI Gateway will echo the
request, including any form data from a POST, back to the client.



DEVELOPER NOTES:

Due to the non-standard name for the debug version of the DLL, the 
following compile-time warning is expected:

warning LNK4070: /OUT:ISAPI2VW.dll directive in .EXP differs from 
output filename "debug\isapi2vw-debug.dll"; ignoring directive

The following warnings from the link are also normal:

LINK : warning LNK4089: all references to 'SHELL32.dll' discarded by /OPT:REF
LINK : warning LNK4089: all references to 'comdlg32.dll' discarded by /OPT:REF
LINK : warning LNK4089: all references to 'ole32.dll' discarded by /OPT:REF





12/4/2008 : slm
7/6/2009  : slm