eFix (APAR): pq47372
Status: efix

For Release: WebSphere 3.5.3

For Operating System: NT/2000 only

Supercedes eFixes: N/A

CMVC defect: pq47372  

Byte size of APAR: 226KB 

Date: 4/6/01

Abstract: Enhancement in dispatching algorithm for the Web server plugin; Added caching of clone IP addessses

Description/sypmtom of problem:

- Enhancement in dispatching algorithm for the Web server plugin
- CST_AIX: Internal Server errors by IHS plug-in
- Make identifier id configurable for url rewriting
- OSE Remote failover broken when two or more clones are down
- Default values for OSE connection retries are too high
- Added caching of clone IP addresses (performance improvement)

DIRECTIONS TO APPLY EFIX:

1) Stop the Web Server(s)
2) Stop all WebSphere clones
3) Stop WebSphere Admin Server
4) Verify that all java processes are stopped
5) Save the old versions of the affected "*.dll" files in C:\WebSphere\Appserver\bin
6) Copy the new *.dll files into C:\WebSphere\Appserver\bin
7) Restart the web server(s) and restart WebSphere AdminServer


ADDITIONAL INFORMATION:


Notes on configuration parameters:
----------------------------------
a. In bootstrap.properties file the parameter ose.refresh.interval specifies
   how often the properties files are checked for any changes. For production
   environments this should be increased from the default of 20 seconds.
   (suggested value greater than 60)

b. In bootstrap.properties file the parameter ose.failure.retry_timer specifies
   how often clones should be re-checked after an error condition. When an
   error is detected on a clone, new requests are not sent to it until this
   timer expires. Any down clones will also be checked after the propreties
   files have been re-loaded, as controlled by a) above. (suggested value 20)

c. The clone selection can be configured to be random by adding a parameter 
   to the queues.properties file as follows (example is for queue ibmoselink): 
   ose.srvgrp.ibmoselink.clone.selection=RANDOM. If this parameter is not 
   specified it will default to round-robin clone selection.


The following files are included in the fix:
--------------------------------------------
    ascommon.dll
    asoutc.dll
    asoutsj.dll
    stubj.dll
    
Notes on configuration parameters:
----------------------------------
a. In bootstrap.properties file the parameter ose.refresh.interval specifies
   how often the properties files are checked for any changes. For production
   environments this should be increased from the default of 20 seconds.
   (suggested value greater than 60)

b. In bootstrap.properties file the parameter ose.failure.retry_timer specifies
   how often clones should be re-checked after an error condition. When an
   error is detected on a clone, new requests are not sent to it until this
   timer expires. Any down clones will also be checked after the propreties
   files have been re-loaded, as controlled by a) above. (suggested value 20)

c. The clone selection can be configured to be random by adding a parameter 
   to the queues.properties file as follows (example is for queue ibmoselink): 
   ose.srvgrp.ibmoselink.clone.selection=RANDOM. If this parameter is not 
   specified it will default to round-robin clone selection.