README.TXT-  Readme file for the SOAP headers sample code
=========================================================

   This sample consists of eight files:  README.TXT, SOAPHeader1a.p,
SOAPHeader2a.p, SOAPHeader3a.p, HeaderExample1_2.asmx.cs, and 
HeaderExample3.asmx.cs.


   The client/SOAPHeader1a.p file demonstrates basic SOAP request and response
header handling where no header manipulation is required.  The p-code
merely sends an "empty" request header to a web service.  The web service
in turn sends a response message back to the client containing a header
with information.  This response message is then sent as a new request
message, using the information in the previous response message header to
gain access to another webservice method.

   The client/SOAPHeader2a.p file is similar to SOAPHeader1a.p, except that it
contains code to attach a Password node to a request message header.  This
would apply to messages following a first message "round trip" described
above.  The password is attached as a child node to the existing SOAP header
entry.

   The client/SOAPHeader3a.p file is an example for SOAP header manipulation where
a SOAP request header is built from scratch.  This is shown in the 
BuildRequestHeader internal procedure.  There is no response header code in
this procedure.

   The server/HeaderExample1_2.asmx.cs file is the C# web service code accompanying
the SOAPHeader1a.p and SOAPHeader2a.p files.  The code is meant to serve as
a model for more sophisticated web service operations.

   The server/HeaderExample3.asmx.cs file is also C# web service code, this is
designed to go with the SOAPHeader3a.p file.

   These C# files for basic web service running under IIS with the .NET 
framework.  To install the service, create a SOAPHeader virtual directory in
IIS as usual. Then deploy one of the .asmx.cs files to 
<drive>:\Inetpub\wwwroot\SOAPHeader.  NOTE that all p-code sample files point
to a HeaderExample.asmx file.  This means that only one .asmx.cs sample file
can be deployed at at time (altering the name accordingly), or the p-code
sample files need to be modified to point to HeaderExample1_2.asmx or
HeaderExample3.asmx.
   The C# web service was created in the Visual Studio .NET IDE, so the .cs
files contain code generated by the IDE.  This has no effect on invoking the
service from a Progress client, and is still included for working on the C#
files in the IDE.




