IBM TXSeries Encina 5.0.0.4 PTF APAR README

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

Copyright International Business Machines Corporation 2004. 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, Encina to version 5.0.0.4. This README file lists the defects fixed in the TXSeries, Encina 5.0.0.4 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 PTF4, see the READPTF_Lang.htm file for the PTF.


Table of contents

Important notes

Contents of the TXSeries Encina 5.0.0.4 PTF

Contents of previous PTF releases

Contents of the TXSeries Encina 5.0.0.3 PTF
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.

  1. 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.
  2. 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.4 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.
  3. Beginning Encina 5.0 PTF 4, TXSeries usage can be monitored by the IBM Tivoli License Manager.

Contents of the TXSeries Encina 5.0.0.4 PTF

This section lists the APARs fixed in this PTF.

APAR Number Problem Description Solution
IY59536 "drpcgwy" is not able to handle if RPC definition size exceeds 16K. Proper code changes are incorporated so that drpcgwy works irrespective of RPC definition size.
IY45905 DRPC gateway startup fails with DCE-rpc-0012 (address in use). Proper code change is incorporated to fix this problem.
IY47923 The Combination of 5.0 client with 4.x server combination does not work in case of Monitor applications because of the design changes in the binding models from 4.2 to 5.0. The 5.0 Binding model has been extended to allow the combination of 5.0 clients work with 4.x servers. This new feature can be enabled by setting a new environment variable ENCINA_TPM_SHORT_TERM_RES_TYPE.
IY48563 xa_prepare returns XAER_PROTO in case of dynamic registration. Proper code change is incorporated to fix this problem.
IY50237 Fatal error in Monitor when getting top ancestor of an invalid tid. This problem occurs when the MAS is built to use 'static association' with the RM. Proper code change is incorporated to fix this problem.
IY51256 Encina Com Wizard/comTidl compiler generates bad code when migrating from TX4.2/Gradient DCE to TX5.0 IBM DCE. Proper code change is incorporated to fix this problem.
IY53517 Incorrect compiler directive in code, generated by COM wizard. Proper code change is incorporated to fix this problem.
IY54740 The 6 digit PID's were getting truncated in the Encina trace. Proper code change is incorporated to support 6 Digit PID's.
IY54920 The RPC call which takes conformant array as it's argument is failing and returns error. Proper code change is incorporated to fix this problem.
IY58037 "drpcidl" refers to a local AFS directory for one of its dependent libraries on AIX platform. 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.3 PTF

This section lists the APARs fixed in TXSeries Encina 5.0 PTF3.

APAR Number Problem Description Solution
IY40183 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 bellow 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.
  1. paCurrentClients attribute cannot be modified and should be added to the excluded attribute list.
  2. 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 upto 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.

For more information about PTF3, see the "TXSeries Encina Version 5.0 PTF 3 Download page" of the TXSeries Support Web site:

http://www-1.ibm.com/support/docview.wss?rs=175&context=SSAL2T&uid=swg24005555.

Contents of the TXSeries Encina 5.0.0.2 PTF

This section lists the APARs fixed in the TXSeries Encina 5.0 PTF2.

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 unstability 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