====================================================================
CWBCOWS.DLL Comm DLL for 32-bit WinSock API Support Test Fix Readme
====================================================================

Note:

  This test fix version applies to Client Access for Windows 95/NT
  release 320. 

  CWBCOWS.DLL Version:
    Release 320 : 05.002   May 06 1999 3:31 PM
    

I. Motivation
   ----------

    When opening multiple ODBC connections, individual connections have
    failures intermittently.  This occurs very infrequently.  A simple
    test application was created to repeated open 10 ODBC connections to
    different ODBC data sources and then close those connections.  This
    code was placed in a repeating loop.  Eventually one of these connections
    results in an SQL return code of -1 (SQL_ERROR).  The CA/400 history
    log shows corresponding CWBCO1003 and CWBCO1006 messages with
    failures to connect to the port mapper at port 449.  Sockets return
    codes of 10048 (once a 10060 sockets return code), indicating that
    a resource is in use and that the connection should be retried.

II. Description of Changes
    ----------------------

    With this fix, we will try to get the connection, and if it fails,
    if the return code is 10048 (Address in use)is necessary to retry again. 
    The maximum attempts number that the connection will be retried is 
    10; and if no one attempt is successful, then it will be a Communications 
    Error.  


III. Install/Uninstall
     -----------------

    Cwbcows.dll in Windows 95 is stored in C:\Windows\system where C is the
    drive where Windows 95 is installed.

    Cwbcows.dll in Windows NT is stored in C:\WINNT\system32 where C is the
    drive where Windows NT is installed.


    To install this test fix, perform the following steps:

    1) Make sure cwbcows.dll is not running. 

    2) Go to the directory where Cwbcows.dll must be installed, e.g.

          C:\>cd windows\system

    3) Backup the current version of cwbcws.dll, e.g.

          C:\windows\system>copy cwbcows.dll cwbcows.bak

    4) Copy the new version of cwbcows.dll, e.g.

          C:\windows\system>copy a:\cwbcows.dll c:\

       where a:\ is the drive where the new cwbcows.dll is located.


  To uninstall the test fix, perform the following steps:

    1) Make sure cwbcows.dll is not running. 

    2) Go to the directory where Cwbcows.dll must be installed, e.g.

          C:\>cd windows\system

    3) Restore the backed-up version of cwbcows.dll, e.g.

          C:\windows\system>copy cwbcows.bak cwbcows.dll