IBM TXSeries CICS 5.0.0.5 PTF APAR README

IBM^(R) TXSeries^(TM) CICS 5.0.0.5 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). This PTF updates TXSeries CICS to version 5.0.0.5. This README file lists the defects that have been fixed in the TXSeries CICS 5.0.0.5 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 operating systems.

Note: For information about obtaining and installing the TXSeries CICS 5.0.0.5, see the READPTF_<lang>.htm file for the PTF.

---

Table of contents

Important notes

Contents of the TXSeries CICS 5.0.0.5 PTF

Contents of previous PTF releases

Contents of the TXSeries CICS 5.0.0.4 PTF

Contents of the TXSeries CICS 5.0.0.3 PTF

Contents of the TXSeries CICS 5.0.0.2 PTF

Contents of the TXSeries CICS 5.0.0.1 PTF

---

Important notes

These notes are for TXSeries CICS 5.0 on the AIX, Solaris, HP-UX, and Windows operating systems.

• The environment variable CICS_FTOD_FILETYPE_BINARY has been removed with APAR IY39584 because, by default, all processing is done in BINARY mode. Therefore, the setting or unsetting of this environment variable has no effect.
• An environment variable called CICS_SFS_LOGICAL_PARTITION_SIZE has been added to TXSeries from CICS 5.0.0.3 upward. This is to enable customers to use parameters to specify the size of the logical partition for an SFS server. See APAR IY38349.
• [AIX Systems only] For APAR IY39592 , For APAR IY39592, in TXSeries CICS 5.0.0.2 and upward, a script (cicsppcgwy_odmchange) that enables you to update the ODM database is shipped in the directory /usr/lpp/cics/bin. You must run the cicsppcgwy_odmchange script once after a PTF install. You do not need to run it again after subsequent PTF installs. This script makes required changes to a specific section in the ODM. It does not affect other sections inside the ODM.
• [Windows^(R) NT Systems only] If you are using TXSeries CICS, you can gain improved diagnostic information if you download redistributable versions of two .dlls that are provided by Microsoft^(R) Corporation. The .dlls are "psapi.dll" and "dbghelp.dll".
• MaxRegionPoolSize in the RD stanza can have a maximum value of only 268389424 bytes; not the 268435456 (256 MB-1) that is stated in the CICS Administration Reference manual.
• Micro Focus Cobol Animator and TXSeries CICS 5.0.0.3 upward work better together when they are at minimum maintenance levels of ServerExpress 2.2 SP1 and Fixpack 22.02_3.
• When using statistics APIs with IBM COBOL, two copybooks are to be included. Copybook CICS-STAT1 is to be included in the working-storage section; CICS-STAT2 is to be included in the linkage section.
• Enhancements to CICS:
• The support for CICS Foundation Classes (CFC) has been reintroduced on TXSeries CICS 5.0 for AIX platforms from CICS 5.0.0.2 upward.
• The support for CICS Screen Design Aid (CICSSDA) has been reintroduced on TXSeries CICS 5.0 for UNIX platforms from CICS 5.0.0.2 upward.
• Program Search Path. An environment variable called CICS_PROGRAM_PATH has been added to TXSeries from CICS 5.0.0.3 upward.  If a PathName attribute of a Program Definition specifies a filename that does not contain any slash character (/) (for Open Systems) or backslash character (\) (for Windows Platforms) and the program cannot be found, the paths that are on the CICS_PROGRAM_PATH environment are used with the PathName attribute to try to load the program or map. The CICS_PROGRAM_PATH environment variable supports standard Operating System behavior for paths.  Therefore, on Windows platforms the paths are delimited with a semi-colon (;), and on UNIX platforms the paths are delimited with a colon (:).
• External Authentication Manager. An environment variable called CICS_EAM has been added to TXSeries CICS from 5.0.0.3 upward. This environment variable specifies a user exit, similar to the External Security Manager, that is called by CICS in the following conditions:
• When a user and password combination needs checking
• When a password needs changing

The exit is also called if no UserDefinition stanza entry exists for the user who is trying to log in. The exit is called after a successful password validation, and allows the exit to specify, in the stanza, a model UserID to copy settings such as TSL and RSL keys. This user is then installed into CICS.

The definitions for the user exit are included in cics_esm.h. The first function that is called is CICS_EAM_Init, which is passed a CICS_EAM_RegionData structure and a CICS_EAM_FnBuf structure. The CICS_EAM_FnBuf structure should be filled in with the addresses of the other necessary functions. If any of these functions are set to null, or the function does not return CICS_EAM_RETURN_OK, the region abends.

When a user logs in, the Authenticate function is called. This function is passed in a CICS_EAM_RegionData structure and a CICS_EAM_Logon structure.  It includes the user ID and password that are to be authorized.  The three valid return codes are CICS_EAM_RETURN_INVALID, CICS_EAM_PASSWORD_EXPIRED, and CICS_EAM_RETURN_OK. Any other code abends the transaction.

When a user requests to change a password, the Authenticate function is used to authenticate the password. If authentication succeeds, the ChangePassword function is called.  Two structures are passed to this function: a CICS_EAM_RegionData and a CICS_EAM_ChangePassword.  The CICS_EAM_ChangePassword structure contains the user ID, the new password, and the old password.  The expected return codes are CICS_EAM_RETURN_OK, CICS_EAM_RETURN_INVALID and CICS_EAM_RETURN_FAIL.  CICS_EAM_RETURN_FAIL. Any unrecgonized return code abends the transaction. CICS_EAM_RETURN_INVALID can be returned if the new password is not a valid password. For example, if it is too short, or does not meet password restrictions.

After a user has been authenticated, and if the user is not already defined to CICS, the UserInstall function is called.  Two structures are passed to this function: a CICS_EAM_RegionData and a CICS_EAM_NewUser.   The CICS_EAM_NewUser structure contains the user ID that is installed.  The member ModelID that is in CICS_EAM_NewUser must be set to an already-defined ID (maximum 8 characters), which is copied and installed as the new user ID.

o Beginning with PTF 5, TXSeries usage can be monitored by the IBM Tivoli License Manager .

o Beginning with PTF5, TaskPrivatePool can be allocated up to 536870911 bytes (512 MB - 1). To allocate more than 256 MB on AIX, the following environment variable must be set in the regions environment file:

           LDR_CNTRL=MAXDATA=0x20000000

For more information about the above environment variable, see the AIX Performance Management Guide.

• Beginning with PTF5, all CICS messages will include process ID, thread ID, and timestamp with millisecond accuracy. This might affect customer-written scripts or system management agents that parse CICS messages.
• Beginning with PTF5, on AIX, two variants of CICS application servers (cicsas) are shipped: one with runtime linking enabled, the other without. The default cicsas has runtime linking enabled, and is in the /usr/lpp/cics/bin directory. The other cicsas is in the /usr/lpp/cics/bin/nortl directory. To use the non-runtime linked cicsas, set the environment variable CICS_NORTL_CICSAS to 1 in the region environment file.

---

Contents of the TXSeries CICS 5.0.0.5  PTF

This section lists the APARs fixed in this PTF.

APAR #	Abstract
IY49133	Blank user ID is passed with programs that are started by way of STARTUPPROGLIST.
IY49268	Incorrect listener process ID is printed in symrecs record after listener termination.
IY49429	With DB2 as the file server, IVP transactions terminate abnormally.
IY49684	Subsequent EXEC CICS LINK fails, if preceded by a Program not found error.
IY49979	CICSTRAN fails if a COBOL source file has lines that contain more than 255 characters.
IY49791	CICS-STAT copybook does not work with IBM COBOL.
IY50425	JAVA transactions abends with A147 when SAFETYLEVEL RD attribute is set to NORMAL.
IY52189	Micro Focus COBOL programs abend with A583 when SAFETYLEVEL RD attribute is set to NORMAL.
IY52238	CICS region does not start if shorthand characters such as %H are present in the FD resource definition file.
IY52342	CEMT INQUIRE TRAN TRANID always returns a full listing.
IY52721	Date format for message ERZ010128E in console log is always MM/DD/YY instead of the locale specific format.
IY53067	Task private pool cannot extend beyond 256 MB.
IY53251	Cannot debug applications by using CEDF when LC_MESSAGES=ko_KR.
IY54655	A 'DUPLICATE TERMID' error can be generated when connecting to a TXSeries region with many (>15000) terminals already installed.
IY54680	With Oracle 9i 64 bit, IBM COBOL cheese transaction fails with an ASRA.
IY54448	CICSSFSIMPORT command fails with ENC-SFS-0007 BAD FIELD NAME because index field is null.
IY49944	File DFHCJDB.MAP is required so that the CJDB JAVA debugging can be used. It was not included in the Solaris package.
IY49946	Message ERZ001033E says, "JDK3 is not installed on machine", instead of "JRE not installed on the machine".
IY52264	When EAM is used, User_Install is not called from CUC client.
IY52917	Micro Focus Animator session is to be detached after every program that is run in a transaction.
IY53245	CICS region abends with U6301 after the termination of a cicssl process.
IY54951	CICS region comes down when DB2 8.1 1PC is used with the new XA open string.
IY54958	CICS application server fails to load JVM; it looks for jvm.dll in wrong place.

Contents of previous PTF releases

This section lists the APARs that were fixed in the previous TXSeries CICS PTF release:

• Contents of the TXSeries CICS 5.0.0.4 PTF
• Contents of the TXSeries CICS 5.0.0.3 PTF
• Contents of the TXSeries CICS 5.0.0.2 PTF
• Contents of the TXSeries CICS 5.0.0.1 PTF

Contents of the TXSeries CICS 5.0.0.4  PTF

APAR #	Abstract
IY44038	TXSERIES CICS should display command output in uppercase on terminals that are defined with Codepage 930, Japanese Katakana.
IY45018	CICS region abends U3466 because of a timing problem in which invalid address pointers are being used.
IY45388	The cicsam process has an excessive number of terminated threads that do not clean up.
IY45497	New format of file that is generated by cicsddt is not compatible with old applications.
IY46148	CICS JAVA programs throw an Unsupported Encoding Exception.
IY46207	CICS WLM DPL exit is not compatible with the CTG module.
IY46321	Incorrect handling of force purge request for XA registered transaction might cause a hang in the resource manager.
IY46887	SEGV is generated when a non-CICS COBOL program loads a CICS COBOL program.
IY47179	SEGV in POSTMORTEM prevents a valid region Abend.
IY47180	CICS gets a segment violation when non-CICS COBOL program calls a CICS COBOL program with a new EIB and COMMAREA.
IY47668	Invalid return code from TXSeries to the CICS Universal Client when attempting to install an existing terminal.
IY47705	Reintroduce DATA-CONTEXT as COBSW=+0l fails to disable RTScache.
IY47922	CICS abends with U4802 during shutdown while cleaning up XA resources.
IY48288	When LC_MESSAGES=C@LFT is specified in the /etc/environment file, CICS utility programs fail to start.
IY49424	CICSAS processes SIGSEGVs during task termination.
IY49425	With TSQAGELIMIT set, the aged temporary storage queues are not being deleted.
IY49432	U5655 abend occurs when CICS receives a signal with a ping response, which forces an assert of the process.

Contents of the TXSeries CICS 5.0.0.3 PTF

,

APAR #	Abstract
IY39066	While the CICSTRAN command is running, an ERZ005019E error occurs when the source contains DBCS characters.
IY39829	Messages ERZ001005I and ERZ015033E are issued incorrectly when a CICS COBOL program issues a COBOL call to another program.
IY40369	CICSAS does not issue XA_CLOSE to disassociate RMs when it is terminated.
IY40420	Terminating Stash mutex at shutdown is not correct.
IY40613	LU0 is not available when CICS tracing is ON, resulting in region abends.
IY40951	Remove the requirement to be in root to run cicsmkcobol to build the ServerExpress runtime.
IY41065	Region pool storage is not released when IP client times out (on all platforms).
IY41877	CICS region abends with U5701 because of a timing problem between CICSAS and CICS log daemon.
IY41891	CICS region hangs on mutex after EXEC CICS INQUIRE TASK from the application.
IY41898	CADB transaction will not handle concurrent animator sessions.
IY42061	Animator hangs after the end of program execution.
IY42123	Access violation when CICS accesses a freed stash buffer. This causes process heap corruption, and the process fails.
IY43299	Abend A57A occurs after timeout is received on CPMI transaction.
IY44314	A CECI INQUIRE CONNECTION on an APPC connection is returning CONNSTATUS(1) when the connection is inservice and acquired.
IY44368	CICSTFMT reports Signal 11, for a trace that was generated by CUC.
IY44392	Console mutex is held by dead application server, causing a region hang.
IY44470	A keyword overflow in the CFC header file (icccndeh.hpp) is causing compilation errors.
IY44541	Cannot set EXIT 33 on the program definition GUI panel.
IY44550	CICS goes down because RM_XA does not support asynchronous abort.
IY44567	Transactions that are running in a CICSAS process might abend ASRA following an initial ASRA abend that causes potential corruption.
IY44570	A CICS region terminates abnormally following an AKCS abend in CICSAM when an attempt to create CICSAS fails with BDE_TRANSIENT_ERROR.

For more details about the defects that went into this PTF, see the TXSeries CICS 5.0.0.3 PTF Readme, which is available on the "TXSeries CICS 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=swg24005014 .

Contents of the TXSeries CICS 5.0.0.2 PTF

This section lists the APARs that are fixed in this PTF.

APAR #	Abstract
IY31878	Inquire Connection in TOR for APPC returns wrong values.
IY33219	CICSTERM fails when SafetyLevel is set to normal.
IY34265	Listener Process Name is wrong (bin.cics).
IY34812	Log is corrupt when CICS fails unexpectedly.
IY35491	INQUIRE TSQ resets the TSQ Read Index.
IY35880	Log record corruption occurred on CICS shutdown.
IY35981	PL/I programs do not work when migrated from TX 4.2 to TX 5.0.
IY37032	(Windows Systems) TSConfig - Online help for DefaultUserId needs to be updated.
IY37060	Keyboard locked because the FREEKB bit in the WCC is off  because an EBCDIC ASCII conversion has occurred in CICSTELD.
IY37371	Running CICSMIGRATE with -M flag for multiple regions fails.
IY38002	ERZ046357E/0572 could not access values during cicsmigrate.
IY38006	External trace attribute was not found during cicsmigrate.
IY38317	Symrecs is being generated after region shutdown.
IY38349	(AIX Systems) TXSeries 5.0 AIX use of CICS_SFS_SIZE variable.
IY38840	PGMIDERR even if the program runs OK.
IY39511	(Windows Systems) CICSLU process terminates unexpectedly (unhandled exception).
IY39514	(Windows Systems) TXSeries V5.0 Windows Locale.
IY39573	CSMT is becoming filled with ERZ027016E messages.
IY39577	(AIX Systems) Change cicsteld process to spawning with Exec.
IY39578	(AIX Systems) Change cicsmkcobol to use cob instead of ld in CICS 5.0.
IY39580	(AIX or HP-UX Systems) CICSAS hangs because of fopen in the signal handler.
IY39583	CICAS leaks memory for each terminal install through RPC.
IY39584	CICSDDT ftod fails when encountering a hex 1A.
IY39585	CICS initialization is not detecting an invalid RegionPoolBase of 0.
IY39586	CPU time for trans is being accumulated, resulting in AICA.
IY39590	Ftos fails to process the data stream that contains an 0x1A character.
IY39591	(Windows Systems) CMF Improvements in Windows.
IY39592	(AIX Systems) CICS ppcgateway server cannot start when smitty is used.
IY39593	(Solaris or HP-UX Systems) Cannot restart all services when "cicscp -v start all" is used.
IY39594	Cobol:cics freemain DataPointer(Address of A1) causes abend A47B.
IY39595	Device name is garbled in failed autoinstall request.
IY39599	Trace system double deallocation causes various errors.

For more details about the defects that went into this PTF, see the TXSeries CICS 5.0.0.2 PTF Readme, which is available on the "TXSeries CICS Version 5.0 PTF 2 Download page" of the TXSeries Support Web site: http://www-1.ibm.com/support/docview.wss?rs=175&context=SSAL2T&uid=swg24004442 .

Contents of the TXSeries CICS 5.0.0.1 PTF

The TXSeries CICS 5.0.0.1 PTF is for AIX and Windows platforms only. It synchronizes the AIX and Windows platforms with the GA levels of TXSeries CICS 5.0 on HP-UX and Solaris platforms. Applying this PTF upgrades AIX and Windows platforms from 5.0.0.0 to 5.0.0.1.

This is a cumulative update for the CICS functions of the GA TXSeries 5.0 product for the AIX and Windows platforms. It contains:

• All TXSeries CICS 4.2 and 4.3 APARs that have been processed since the GA for TXSeries 5.0 product for the AIX and Windows platforms.
• The modified CICS tracing facility, which has had new functions added. For more details about the trace changes, see the TXSeries 5.0 Release Notes, which are available on the Web at http://www.ibm.com/software/ts/txseries/library .

Also included in this PTF are the following CICS 5.0 defects:

APAR Number	Abstract
IY09951	SMIT panel for CICS is corrupted.
IY33194	DATA-CONTEXT and DATA-RECOVERY in ServerExpress is to be supported.
IY34123	Dumping of Empty Ring Buffer occurs when trace is off.
IY34124	An internal error occurs when PD has bad path.
IY34125	XA transactions abend with A583 after a normal COBOL transaction is run.
IY34130	A CADB DISPLAY error occurs on Server Express.
IY34170	CICS region might not start because of a deadlock between CICSLM main and listener threads.
IY34887	PROG798 occurred at DBCS Field because SO (0X0F) is incorrectly inserted without SI (0X0E).

For more details about the defects that went into this PTF, see the TXSeries CICS 5.0.0.1 PTF Readme, which is available on the "TXSeries CICS 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=swg24001889 .