
The VisualAge Smalltalk Web services 0.40 beta contains a collection of
functional enhancements to the 6.0.0 release including:
	- Seamless support for HTTPS endpoints 
	- Processing of messages with WSDL document/literal encoding
	- Execution time unloading of image components 
	- SST proxy support
(See whatsnew.txt for a description of these new features.
 View the license agreement in license.html)

Refreshed 6/20/2002
----------------------------------
Added the OS/2 version of 'essci40.dll' to the package in directory .\bin\os2

Directions for installing the beta
----------------------------------
1) This beta requires V6.0.0 of VA Smalltalk to already be installed
2) Unzip this zip file into a temp directory with at least 10M of free space
3) On Windows platforms, copy the file essci40.dll from the .\bin\windows directory into the bin directory where
	you installed V6.0.0 of VA Smalltalk
	On OS/2, copy the file essci40.dll from the .\bin\os2 directory into the bin directory where
	you installed V6.0.0 of VA Smalltalk
4) Copy the file SstWSSampleContainer.xml from the samples\sstws directory into the samples\sstws directory
	where you installed V6.0.0
5) Copy the file sstwsdep.xsd from the xml directory into the xml directory where you installed V6.0.0


This Web services .40 beta can be loaded into a VisualAge Smalltalk 6.0.0 image.
The Smalltalk Transcript should contain the following header:

VisualAge Smalltalk Enterprise, V6.0
(C) Copyright IBM Corporation, 1994, 2002.  All Rights Reserved.
VM Timestamp: 4.0,(NC) 4/24/2002



Load the V6.0.0 Web services feature
------------------------------------
The Web Services 6.0.0 feature must be loaded prior to attempting to load the beta.
Use the 'Transcript->Tools->Load/Unload Features...' menu option to load the feature named
ST: Server, Web Services


Import updated code
-----------------------------------
1) Execute the following line of code to cause required configuration maps to be imported
with the selected map.
	
	EtTools moveAllRequiredMapsToo: true

This allows you to import all required configuration maps by selecting a single configuration map.

2) Open a configuration maps browser 
	'Tools->Browse Configuration Maps'

3) Import beta code from the library file named '.\import\vastws40.dat'
	'Names->Import'
	Select the configuration map named 'Web Services - Delivery' (version= '[BETA 0.40]')

4) (Optional) Execute the following line of code to restore the 'moveAllRequiredMapsToo' to it's default
value.	
	EtTools moveAllRequiredMapsToo: false
	


Load updated code
-------------------------------
It is prudent to make a copy of your development image prior to executing the steps
below.
1) Select the configuration map 'Web Services - Delivery'
2) Select the version '[BETA 0.40]'
3) Select 'Editions->Load with Required Maps'
4) Save your image



Fixes/Web services
-----------------

14826 -  Admin. sample does not always select correct container in a development image
where the service is deployed to multiple containers.
14837 -  SstWSEncodingStrategy #register:as: is reversed.  (key and value must be passed
in reverse order of what one would expect).
14841 -  SstWSHttpDispatchHandler should use port manager
14846 -  #formattingEnabled switch is not always respected
14865 -  Bogus Web Services files in nls subdirectory
14723 - Service exposed on wrong endpoint (this is fixed by 14748)
14799 -  Support for HTTPS (client)
14747 -  Port manager does not support multiple URL endpoints
14748 - URL based service resolution in support of doc/lit services
14862 - Add creationMethod for handler creation
14875 - Web services should respect SST forwardExceptions
14759 - Packager warnings due to unimplemented methods
14813 - Fault message construction not consistent
14890 - Improper resolution of WSDL extension
14895 - Container needs API to create without registering
14891 - Signal exception when returned message is not SOAP
14904 - Remote client cannot access local endpoints
14835 - HTTP proxy support

Fixes/XML
---------

14828 - Issue more informative message on attribute value error
14836 - Class element mapping not resolved when serializing from schema
14840 - Stack overflow during XML serialization with unprefixed elements
14843 - AbtXmlMappedAttribute>>#abrAsString returns nil when object is set
14844 - AbtXmlMappedElement default set logic should allow any object
14854 - Serialization of AbtXmlMappedElement when type has <choice>
14856 - Need mapping for schema import  (missing classes AbtXmlSchemaImport and AbtXmlSchemaInclude)
14897 - Add #isRequired method to AbtXmlSchemaAttribute
14900 - AbtXmlMappedElements do not handle setting collections
14910 - xsi:type not specified for complex types


Extras
------
The VisualAge Smalltalk "Quick Tester" application is included in the beta .40 package.  To try the
Quick Tester, unzip the file .\wstester.zip.  After unzipping, read the file
.\wstester\readme.html for information about configuring and using the Quick Tester.

For those interested in using UDDI from within Smalltalk, a forthcoming Eye on Smalltalk article will
be placed on the IBM Smalltalk website shortly (http://www.ibm.com/software/ad/smalltalk/discussion/index.html).
The code snippets listed in the article require this beta in order to work correctly.


Troubleshooting
---------------
The walkback listed below occurs on Windows platforms if you fail to replace the library 'essci40.dll' with
the beta version.
	'Primitive failed in: SciSocketManager class>>#primFdSetSize due to OS error4'

Verify that the you have copied '.\bin\windows\essci40.dll' to the bin directory of your VA Smalltalk installation.
Make sure that an earlier copy of 'essci40.dll' is not included before the new copy in the system PATH.
