IBM TXSeries Encina 5.0.0.3 PTF APAR README

IBM^(R) TXSeries^(TM) Encina 5.0.0.3 PTF APAR README for AIX^(R), Windows^(R), HP-UX ^(R) and Solaris^(R) Systems

Copyright International Business Machines Corporation 2003. All rights reserved.
Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication, or disclosure is subject to restrictions set forth in GSA ADP Schedule contract with IBM Corp.

About this document

The TXSeries Program Temporary Fix (PTF) is a collection of cumulative product patches and recent software fixes. For TXSeries, separate PTFs exist for CICS and Encina^(R). Installing this PTF updates TXSeries to version 5.0.0.3. This README file lists the defects fixed in the TXSeries Encina 5.0.0.3 PTF for the AIX, Windows, HP-UX and Solaris operating systems. This README also provides some important notes about TXSeries on the AIX, Solaris, HP-UX and Windows systems.

Note: For information about obtaining and installing the TXSeries Encina 5.0 PTF3, see the READPTF_Lang.htm file for the PTF.

Important notes

Contents of the TXSeries Encina 5.0.0.3 PTF

Contents of previous PTF releases

Contents of the TXSeries Encina 5.0.0.2 PTF
Contents of the TXSeries Encina 5.0.0.1 PTF

Important notes

The following are important notes about TXSeries Encina 5.0 on the AIX, Solaris, HP-UX, and Windows systems.

Starting with TXSeries 5.0 PTF1 (5.0.0.1), the default version of enconsole on AIX has been changed from the Java-based version as shipped in 5.0.0.0 to a non-Java implementation similar to the enconsole that shipped in TXSeries 4.3. This change was made to address potential stability problems related to the interaction of DCE and Java on AIX. The non-Java Enconsole lacks two new features in 5.0.0.0: (1) support for defining, viewing, and updating routing tables and (2) National Language support. Users wishing to employ routing tables can use enccp for this purpose. The Java implementation is still supported. Users can make use of the Java implementation by invoking the jenconsole script located in /usr/lpp/encina/bin. In case of stability problems encountered during usage, we advise users to revert to the default.
TXSeries Encina 5.0.0.1 and later PTF's are incompatible with the Tivoli Instrumentation module shipped with Encina. Due to changes in the implementation of Encina, the Tivoli module does not work if this TXSeries Encina 5.0.0.3 PTF is installed. If your site depends on the correct operation of the TXSeries Tivoli Instrumentation you should not install this PTF and should contact your customer support representative for further information. The changes in Encina do not affect any scripts that you may have written to allow Tivoli monitoring of TXSeries processes; the incompatibility only affects the Instrumentation module included with the product.

Contents of the TXSeries Encina 5.0.0.3 PTF

This section lists the APARs fixed in this PTF.

APAR Number Problem Description Solution
IY48063 SFS client hanging on WaitForOfd. This fixes the double decrement problem for the case when a transaction is aborted on the server side and RPC returns TRPC_MGR_ABORTED error. This fix adds WARNING messages for attempts to decrement refCount or inUse below 0 and does not allow these counters to go below this value.

IY44374 Encina servers suffer a FATAL failure with DCE-sec-0072 during key change. This results when the server keyfile contains the maximum number of 255 keys. Proper code change is incorporated that attempts to delete the key before adding a new one. This will prevent the crash from occurring.

IY41168 Enconsole is not picking up existing valid DCE login credentials in a DCE Slim client setup on Windows systems. This requires the user to perform a second DCE login. The principal is checked and exception is thrown if a NULL principal value is returned.

IY46854 Problem with cell restore/replications sample scripts. There are two problems with the shrinkwrapRepository sample script.
paCurrentClients attribute cannot be modified and should be added to the excluded attribute list.

createvol in the script does not know the right system type for creating volumes. This is only a problem in cells including some AIX and some non-AIX nodes.
Proper code change is incorporated to fix both the mentioned problems.

IY46820 HP showProcInfo causes enm to segv, because it uses dde. Rewrote this tool to work with gdb.

IY43250 Improve Encina signal handling routines. Some of the Encina signal handle routines have been modified in the handler code to improve the signal handling.

IY46822 SFS server abends "Encina Internal Error" while deleting records from a sfs-btree file. Proper code change is incorporated to fix this problem.

IY43902 tkadmin commands fail with ENC-tra-0100 with large TIDs. Proper code change is incorporated to gather command line inputs (TIDs for example) of size up to ULONG_MAX.

IY42669 In encina include files, mon.h and ema.h. The ENCINA_CALLING directive is missing in the declaration of ema_Terminate. The ENCINA_CALLING directive is added in the declaration of ema_Terminate.

IY45171 The TID in Encina is of type unsigned long. While OTS admin tool prints out this number incorrectly as long. If the number is too big and exceeded the range for long, it goes to negative numbers. The Encina transaction module does not take negative TIDs. Proper code change is incorporated to fix the negative TID information problem.

IY44367 Encina 5.0 WIN NT/2000 PTF2 install fails when the Locale is non-English. Proper code change is incorporated in the installer code to fix this problem.

IY46078 The processing agent (PA) crashes when failing to attach to shared memory. When there are 2 or more Monitor application servers (MASs), the shared memory string of the last MAS created is used for all other MASs when they increase the PA count. Proper code change is incorporated to fix this problem.

Contents of previous PTF releases

This section provides information about how you can find the APARs fixed in the previous TXSeries 5.0 PTF releases:

Contents of the TXSeries Encina 5.0.0.2 PTF

This section lists the APARs fixed in the TXSeries Encina 5.0.0.2 PTF:

APAR Number Abstract

IY37413 Stability and performance problems in Enconsole

IY42151 Overlap of check box in wintidl GUI

IY42154 Java JVM dumping core for poor interactions between Java JVM signal handlers and Encina signal handlers

IY42155 Problems with build on wintidl GUI for having long path names in the options

IY42146 Resource timed out problem in wintidl GUI while starting the GUI after ending abruptly

IY38354 Dead lock problem while deleting records from very large SFS btree-clustered files

IY37784 Unauthenticated clients not getting binding handles even when the servers were set for no authorization.

IY21899 Memory leaks in DPL programming model.

IY18449 Application abort while using FLT model in PPC gateway

IY30109 Enconsole instability on AIX 5.1

IY42157 Memory leaks in Encina++ servers using OTS factory model.

IY42158 TIDL compiler not accepting user defined exceptions in TACF

IY42159 PPC Gateway fails with Enc-PPC-1032 due to TID mismatch

IY38268 Client not refreshing the binding handles after RPC exceptions due to server crashing

IY34863 Getting ENC-bde-0040 Invalid group in server.out when the groupname list is larger than buffer size.

IY39195 Memory leaks in DDT component in SFS

For more information about PTF2, see the "TXSeries Encina Version 5.0 PTF 2 Download page" of the TXSeries Support Web site: http://www.ibm.com/support/docview.wss?rs=175&context=SSAL2T&q=&uid=swg24004349.

Contents of the TXSeries Encina 5.0.0.1 PTF

TXSeries Encina 5.0.0.1 PTF is only on the AIX and Windows platforms to synchronize with the GA levels of TXSeries Encina 5.0 on the HP-UX and Solaris platforms. Applying this PTF upgrades TXSeries from 5.0.0.0 to 5.0.0.1 on AIX and Windows platforms.

This is a full refresh of the GA product and contains all the TXSeries Encina 4.2 and 4.3 APARs processed since the TXSeries 5.0 release on AIX and Windows systems

For more details about the defects that went into this PTF, please see the TXSeries 5.0.0.1 PTF Readme, which is available on the "TXSeries Encina Version 5.0 PTF 1 (AIX - NT) Download Page" of the TXSeries Support Web site: http://www-1.ibm.com/support/docview.wss?rs=175&context=SSAL2T&uid=swg24003552.

There have been many modifications done with respect to the Encina Enconsole/Jenconsole facility. For more details please refer to the TXSeries support flashes on the Web at the following site: http://www.ibm.com/software/ts/txseries/support

APAR Number	Problem Description	Solution
IY48063	SFS client hanging on WaitForOfd.	This fixes the double decrement problem for the case when a transaction is aborted on the server side and RPC returns TRPC_MGR_ABORTED error. This fix adds WARNING messages for attempts to decrement refCount or inUse below 0 and does not allow these counters to go below this value.
IY44374	Encina servers suffer a FATAL failure with DCE-sec-0072 during key change. This results when the server keyfile contains the maximum number of 255 keys.	Proper code change is incorporated that attempts to delete the key before adding a new one. This will prevent the crash from occurring.
IY41168	Enconsole is not picking up existing valid DCE login credentials in a DCE Slim client setup on Windows systems. This requires the user to perform a second DCE login.	The principal is checked and exception is thrown if a NULL principal value is returned.
IY46854	Problem with cell restore/replications sample scripts. There are two problems with the shrinkwrapRepository sample script. paCurrentClients attribute cannot be modified and should be added to the excluded attribute list. createvol in the script does not know the right system type for creating volumes. This is only a problem in cells including some AIX and some non-AIX nodes.	Proper code change is incorporated to fix both the mentioned problems.
IY46820	HP showProcInfo causes enm to segv, because it uses dde.	Rewrote this tool to work with gdb.
IY43250	Improve Encina signal handling routines.	Some of the Encina signal handle routines have been modified in the handler code to improve the signal handling.
IY46822	SFS server abends "Encina Internal Error" while deleting records from a sfs-btree file.	Proper code change is incorporated to fix this problem.
IY43902	tkadmin commands fail with ENC-tra-0100 with large TIDs.	Proper code change is incorporated to gather command line inputs (TIDs for example) of size up to ULONG_MAX.
IY42669	In encina include files, mon.h and ema.h. The ENCINA_CALLING directive is missing in the declaration of ema_Terminate.	The ENCINA_CALLING directive is added in the declaration of ema_Terminate.
IY45171	The TID in Encina is of type unsigned long. While OTS admin tool prints out this number incorrectly as long. If the number is too big and exceeded the range for long, it goes to negative numbers. The Encina transaction module does not take negative TIDs.	Proper code change is incorporated to fix the negative TID information problem.
IY44367	Encina 5.0 WIN NT/2000 PTF2 install fails when the Locale is non-English.	Proper code change is incorporated in the installer code to fix this problem.
IY46078	The processing agent (PA) crashes when failing to attach to shared memory. When there are 2 or more Monitor application servers (MASs), the shared memory string of the last MAS created is used for all other MASs when they increase the PA count.	Proper code change is incorporated to fix this problem.

APAR Number	Abstract
IY37413	Stability and performance problems in Enconsole
IY42151	Overlap of check box in wintidl GUI
IY42154	Java JVM dumping core for poor interactions between Java JVM signal handlers and Encina signal handlers
IY42155	Problems with build on wintidl GUI for having long path names in the options
IY42146	Resource timed out problem in wintidl GUI while starting the GUI after ending abruptly
IY38354	Dead lock problem while deleting records from very large SFS btree-clustered files
IY37784	Unauthenticated clients not getting binding handles even when the servers were set for no authorization.
IY21899	Memory leaks in DPL programming model.
IY18449	Application abort while using FLT model in PPC gateway
IY30109	Enconsole instability on AIX 5.1
IY42157	Memory leaks in Encina++ servers using OTS factory model.
IY42158	TIDL compiler not accepting user defined exceptions in TACF
IY42159	PPC Gateway fails with Enc-PPC-1032 due to TID mismatch
IY38268	Client not refreshing the binding handles after RPC exceptions due to server crashing
IY34863	Getting ENC-bde-0040 Invalid group in server.out when the groupname list is larger than buffer size.
IY39195	Memory leaks in DDT component in SFS

IBM TXSeries Encina 5.0.0.3 PTF APAR README

About this document

Table of contents

Important notes

Contents of the TXSeries Encina 5.0.0.3 PTF

Contents of previous PTF releases

Contents of the TXSeries Encina 5.0.0.2 PTF

Contents of the TXSeries Encina 5.0.0.1 PTF