/*
 * Licensed Materials - Property of IBM
 * 5648-D89
 * (C) Copyright IBM Corp. 1998, 2001 All Rights Reserved.
 * US Government Users Restricted Rights - Use, duplication or disclosure
 * restricted by GSA ADP Schedule Contract with IBM Corp.
 */

Program Temporary Fix 6 (Retain PTF WR21033, "PTFix6F" in this document) contains replacement files for
WebSphere Business Components Composer version 4.0  ("WSBC Composer" in this document) with PTF5 applied.

PTFix5 (Retain PTF WR20956) is a prerequisite for PTFix6F.

This 'ReadMe.txt' file should be read in its entirety before applying PTFix6F on top of a
currently installed WSBC Composer with PTFix5 (Retain PTF WR20956) already applied. 
If you are using this file in conjunction with the 'Installation Guide' for an initial installation from the
product CD, please refer to the 'ReadMe.txt' file in PTFix5 before using this one; PTFix5 must be installed first. 

Any manually-applied fixes not included in this PTFix should be carefully evaluated and re-applied 
if appropriate, to avoid back-leveling the code.

This Fix is distributed in files:

	Develop.zip
	Document.zip
	DWorkb.zip
	SrvSamp.zip
	VAJava.zip

These files should be unzipped into the corresponding target directory, as specified below,
depending on the features you selected during the original installation of the product.
The extract process should keep folder names and overwrite any existing file.  Before the
extract process you should save any customized files (i.e. dse.ini) for reference purposes.

Starting with this PTFix there is a new folder (resources) in the installation directory, updates are not provided 
for another folder (classes) and a change is assumed in the default environment:

 - Up to PTF5 the default environment for the updates included the old Swing implementation (JFC1.0.3/JDK1.1.x) and
   alternative code was also provided for the Swing1.1.x/JDK1.2 environment.  This alternative code was identified with 
   an 'S11' suffix (refer to the ReadMe file in PTFix5 for details).  Starting with PTFix6F all the updated code is
   intended for the formerly called 'S11' environment only, without using any explicit environment suffix.  This applies
   to files in the 'jar' folder as well as package versions in the new .dat file shipped for the ivjrepository folder.

 - The 'classes' folder (with the full tree of deployed classes for the former standard environment) is not updated anymore 
   and will remain at the PTFix5 level.  If required, deploy the code from the VisualAge for Java environment or the jar file.

 - A new 'resources' folder contains properties files with externalized strings required by some WSBC Composer packages.
   These files will also be copied into the project_resources folder for the VisualAge for Java project but are not
   'released' to the project; in fact, a new version for the 'WebSphere Business Components Composer' project is NOT provided
   with this PTFix.  These files should be included in any deployment of the corresponding packages.


Extracting files from 'Develop.zip'
-----------------------------------

This should be done in all the machines with the 'Development environment' feature installed.
The target directory for this extract is the directory specified on WSBC Composer installation.

Extracting files from 'Document.zip'
-----------------------------------

This should be done in all the machines with the 'Documentation' feature installed.
The target directory for this extract is the directory specified on WSBC Composer installation.

The Online Information System is not being fully updated.  Replacement files are provided for online javadoc reference only. 

Extracting files from 'DWorkb.zip'
-----------------------------------

This should be done in all the machines with the 'Development workbench repository' feature installed.
The target directory for this extract is the directory specified on WSBC Composer installation.

As in previous PTFixes, an update is required to each Development Workbench user workspace.
Refer to the ReadMe file in the new 'install_directory\dwinstall\Update FROM PTF5 to PTF6' folder for more information.

If you are installing a new Development Workbench Repository (as conducted by the "Installation Guide") the installation
code in this PTFix will install the databases with the new structure, with no further update requirements.

Extracting files from 'SrvSamp.zip'
-----------------------------------

This should be done in all the machines with the 'Development environment' and/or 
the 'Server environment for the sample application' feature installed.
The target directory for this extract is the directory specified on WSBC Composer installation.

If the machine is operating as a server, references to '127.0.0.1' in the
install_directory\dse.ini and install_directory\html\wkstype1.html files 
should be replaced with the real machine name.

Warning: a file named 'error.jsp' was provided in PTFix5 as 'error.JSP' by error (it is accessed in a case-sensitive context) and
is replaced in this PTFix with the correct name.  If the extract process in your operating environment has not been capable to
actually do this change in the file name, then do it manually.  For example: rename 'error.JSP' to 'error', then to 'error.jsp'.
This file has been installed under the 'html' folder in the target directory.

Extracting files from 'VAJava.zip'
-----------------------------------

This should be done in all the machines with the 'Development environment' feature installed.
The target directory for this extract is the VisualAge for Java installation directory.

Note that the file 'error.jsp' is also extracted here and the same warning pointed for 'SrvSamp.zip' apply.  The file is installed under
the 'ide\project_resources\IBM WebSphere Test Environment\hosts\default_host\default_app\web\dse\html' folder in the target directory.

Upgrading the VisualAge for Java Integrated Development Workspace
-----------------------------------------------------------------

After the update has been installed, several Java packages must be replaced in the VisualAge for Java project.  
The following replacement packages must be imported into your VAJ repository from the dseFix6F.dat repository.
This repository is located in the install_directory\ivjrepository folder (the same location as the dseall.dat repository).

	com.ibm.dse.appl.ej.base v4.0.6
	com.ibm.dse.appl.ej.client v4.0.6
	com.ibm.dse.appl.ej.server v4.0.6
	com.ibm.dse.appl.forwarding.base v4.0.6
	com.ibm.dse.appl.forwarding.server v4.0.6
	com.ibm.dse.applsrv.aa v4.0.6
	com.ibm.dse.applsrv.aa.tools v4.0.6
	com.ibm.dse.automaton v4.0.6
	com.ibm.dse.automaton.ext v4.0.6
	com.ibm.dse.automaton.html v4.0.6
	com.ibm.dse.base v4.0.6     (uses 'base1.properties' and 'base2.properties')
	com.ibm.dse.base.types v4.0.6
	com.ibm.dse.base.types.ext v4.0.6
	com.ibm.dse.clientserver v4.0.6
	com.ibm.dse.cs.html v4.0.6     (uses 'htmlclient.properties')
	com.ibm.dse.cs.java v4.0.6     (uses 'javaclient.properties')
	com.ibm.dse.cs.servlet v4.0.6     (uses 'csservlet.properties')
	com.ibm.dse.cs.xml v4.0.6     (uses 'xmlclient.properties')
	com.ibm.dse.desktop v4.0.6     (uses 'desktop.properties' and 'desktopsample.properties')
	com.ibm.dse.gui v4.0.6
	com.ibm.dse.gui.jspbeans v4.0.6
	com.ibm.dse.gui.jsputil v4.0.6
	com.ibm.dse.samples.aa.server v4.0.6
	com.ibm.dse.samples.appl v4.0.6     (uses 'sampleappl.properties')
	com.ibm.dse.samples.comms v4.0.6     (uses 'commssample.properties')
	com.ibm.dse.samples.ej.server v4.0.6
	com.ibm.des.samples.formsprint v4.0.6     (uses 'formssample.properties')
	com.ibm.dse.samples.html v4.0.6     (uses 'htmlsample.properties')
	com.ibm.dse.samples.landp v4.0.6     (uses 'landpsample.properties')
	com.ibm.dse.samples.sap v4.0.6     (uses 'sapsample.properties')
	com.ibm.dse.samples.wosa v4.0.6     (uses 'wosasample.properties')
	com.ibm.dse.services.appltables v4.0.6
	com.ibm.dse.services.comms v4.0.6
	com.ibm.dse.services.formsprint v4.0.6
	com.ibm.dse.services.fpprint v4.0.6
	com.ibm.dse.services.itoc v4.0.6
	com.ibm.dse.services.jdbc v4.0.6
	com.ibm.dse.services.jfprint v4.0.6
	com.ibm.dse.services.ldap v4.0.6
	com.ibm.dse.services.mq v4.0.6
	com.ibm.dse.services.notes v4.0.6
	com.ibm.dse.tools.servermonitor v4.0.6     (uses 'servermonitor.properties')


After the files are imported to your repository, use the VAJ Replace package command to update the packages with the above versions, as appropriate.
It is safe to close any Visual Composition Editor window and delete the 'DSE Gui beans' feature before replacing these packages.






------------------
Summary of changes
------------------

PTFix6F code provides fixes for the following IRS incidents:

(listed by IRS Id, followed with RETAIN PMR and APAR Number between brackets if applicable)

1249: Error Page attribute is optional in JSPForm but TBG assumes it is mandatory
1264: Wrong error message reading self defined processor file
1266: JDBCTable service cannot retrieve all records from a table
1292: If value of "typed" data item fails validation, but input form passes cross-validation satisfactorily, no error-page is displayed.
1300: Session expiry not detected by framework when sessions maintained using page-embedded session ids.  Java clients ok but not HTML clients.
1301: When using a comms pool with 1 or more MQ Connections, pool.getService() returns null
1374: Exception during handler registration for a remote client event in server side
1396: Inside the JDBCServicesConnMgrWS30 class  a look-up in the InitialContext to find the DataSource is performed every time a connection is requested.
1524: DOUBLE click  will crach the WAS because it recursively starts calling the error.jsp page !!!!!!!!!!!!!
1535: Cannot serialize Typed Data Elements. The propertyDescriptor is not serialize.
1564[45777/JR15515]: Calling the DSEStep getService() method results in a ClassCastException being thrown         
1567: CSReqServlet does not return a reply page when the server has not been started.
1583: Implement the Set Component Orientation to RIGHT_TO_LEFT for different components and for Component orientation
1584: ClassCastException occurs when an attribute has a special value "&@X...." in processors files.
1588: HTML Processor can not be started twice from the HtmlRequesHandler
1591[45853/JR15534]: HtmlRequestHandler throws an exception
1603[94354]: #CS and #HTML abnormal tracing.
1604[94355]: The utb getHtmlRequiredFields returns automaton fields even if automaton is not used 
1609: if an error occurs while processing request, the Servlet doesnt have control and continues executing the request,though the  response message has been sent to the client yet.
1619: Lu62Conversation service doesnt work correctly when receives segments with length equals to 0
1622: The order in which the types are declared is important. The workbench generates the types in the order they have been created so the generated file could contain the types in a wrong order.
1624[45956/JR15580]: WSBCC framework exception handling.
1626[45971/JR15563]: DseTypeExternalizer prints method exceptions twice. 
1627: The ElementState of the Datafield which may have been set programatically is ignored
1630: bad source structure in ...clientserver.CSSessionManager..
1641[46012/JR15592]: DSETypeExceptions thrown are not nested when returned. 
1651[73952]: There is a navigation problem when an application is executed from a browser.
1656[64008]: Panel close button does not work
1660[64013]: WSBCC Composer Windows not drawn correctly
1664[64020]: WSBCC Composer Multiple error messages for same error
1665[64021]: WSBCC Need automatically disappearing fault messages
1666[64023]: Put focus on window when enter property values 
1668[46060/JR15670]: Null should always be valid.
1669[46061/JR15632]: Initial value set in propertydescriptor in data field.
1682: DSEJSPContextServices getStringValue(String aString) method don't find data in the Session context.
1684: Error when a subflow returns a simple event name (e.g. "OK", "ERROR").
1707: Under a persistence environment, session inactivity handling does not work.
1713: setDecorators(Vector)::Tag method doesn't work properly
1715: Persistence specific parameters are bad read.
1718: Special state type, which executes an operation or a synchronous processor
1719: Add a preProcess method to the Action
1720: Bad parameter names in the session object.
1721: When the method ccSendReceive fails, return code received is not updated to display the error code.Return code is always 0. 
1742: The execute method of the Action interface does not throw exception.
1750[76057]: The blanks values are eliminated while generating XML attributes values
1751: unformatIndexedCollection(Vector,IndexedCollection)::HashtableIndexCollectionFormat isn't working properly
1757[12234/JR15758]: Context.getContextNamed throws a NullPointerException.
1775[76430/PQ47157]: Lu62Conversation does not deallocate the conversation when an error is produced sending the message to the partner.             
1776[76431/PQ47158]: CommunicationsPool does not mark 'inUse' objects that are being used , when new element created  .               
1792: Unappropriate messages.
1797[13247]: Index out of bound error
1804: Validation error information not shown when running operations.
1806: When the operation is executed before viewing the view, the data is not refreshed.
1812: clone not cloning correctly
1813[46331]: The base class com.ibm.dse.base.DataElement should implement Cloneable, since it has a public clone() method.
1817[46330]: cant load felf defined processor on class path fromjar     
1822[46345/JR15776]: In JetFormService, setFilePath() behaves differently  to initializeFrom(). 
1827: processor memory leak when html client session times-out.
1843: MQ service seems not to reconect automatically when MQ Series goes down and is restarted again.
1845: After executed two diferents executeSubFlowAct (flow composed by three steps: dummyJournal, dummyHost, dummyJournal) the second dummyHost waiting all the times in the method readWithTimeout (DummyLu0SnaSession). 
1852: Severe performance problems with WSBCC in the VisualAge Websphere Test Environment 
1856[13967]: Some problems found relating to WSBCC workbench.
1857: HtmlRequestHandler ClassCastException.
1859[78276/JR15845]: The customer has problems with the Type Data Elements when he tries to assign a value. 
1860[78279/JR15895]: Problem with the type externalizer. The data tag is being modyfied after a readObject.
1862[30170/JR16080]: LDAP code changes
1864: Error invalid tpName if tpName not filled, this field is not mandatory for 390 synchronous conversation.
1869[78485/PQ48201]: In synchronous LU6.2 conversations security_pgm is always used when passing the userid parameter. There is no way to use security_same in the conversations.   
1876[46435]: Unable to remove DSEHtmlProcessors from the Processor. Registry is any of the loadProcessor() methods have been called on  them.
1877[78899]: The entities appear duplicated in the workspace due to a problem importing them from a repository
1878: Availability of opCtx in request object.
1880: A new column named 'USER_DATA' is required in the USERS table
1883: WSBCC Dev Wrkbnch Versioning problem.
1888: When a session expires and an event is fired, first it is fired and after is set in the table as set It would be better to set as true first and after to fire the event
1889: When an error occurs parsing the header or the body of an xml file, an Exception thrown would be necessary to be captured by the Handler and stop the process flow.
1891: Error messages are being lost - createProcessor.
1896: Problems with the ComboBox in VisualAge.
1897: New feature it permits user to choose the messsageId or correlationId as the message search criteria.
1899: Element state is shared for all instances of a type (Retain-46494)
1901: Support blanks in path
1904[62332/JR15965]: System hangs after initializing LDAP service. 
1906[79708/JR16016]: Arrays problem
1907[79709/JR15947]: Problems updating entities versions from the repository to the Workspace with the Development Workbench.
1909[79766/JR15940]: Properties loss when updating entities versions in a workspace.
1914[14713]: The shared connection name cannot be dynamically set
1919: Synchronization in JavaExtensions.generateUniqueCode has been improved
1921: Can not initialize from browser.
1936: Enable operaitons cache
1939: Automaton technology: Processor Externalizer does not support relative paths.
1940: Poor performance of WSBCC DSETTypeExternaliser class loading.
1942: In the entities wizard if the basegroup is void the wizard shows an error message and then get closed, loosing all the information
1944: When creating child instances sometimes they appear duplicated.It's a refresh problem.
1951: Reading the xml request message the connector omits the last character.
1956[80139]: Memory leaking problem in LU62 connector
2021: sessionIdTable hashtable is not used in RequestValidationServices.
2025: Operation steps included in IFX self-defined operations should use the subtag param to define attributes that can be understood by the developement workbench.
2046: Blanks in paths
2053: Self defined operations externalizer does not accept relative paths.
2131: DSEHtmlProcessor.initializeFrom should NOT do setProcessorId.
2189: removeService not working propertly
2208: When the desktop is launched out the VisualAge, the SplitArea is shown on the left.
2228[37022]: the closeConnection() method will throw a NullPointerException




-----------------------------
End of ReadMe.txt for PTFix6F
