IBM TXSeries CICS 5.0.0.3 PTF APAR README

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 CICS 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 CICS 5.0.0.3, see the READPTF_<lang>.htm file for the PTF.

Table of contents

Contents of the TXSeries CICS 5.0.0.3 PTF

Contents of previous PTF releases

Contents of the TXSeries CICS 5.0.0.2 PTF

Contents of the TXSeries CICS 5.0.0.1 PTF

Important notes

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

• The support for CICS Foundation Classes (CFC) has been re-introduced on TXSeries CICS 5.0 for AIX platforms from CICS 5.0.0.2 onwards.
• The environment variable CICS_FTOD_FILETYPE_BINARY has been removed with the APAR IY39584 , as by default we do all the processing in the BINARY mode. Hence, setting/unsetting of this environment variable will not have any effect.
• An environment variable called CICS_SFS_LOGICAL_PARTITION_SIZE has been added to TXSeries from CICS 5.0.0.3 onwards. This is to enable customers to parameterize the size of the logical partition for SFS server. See APAR IY38349
• [AIX Systems only] For APAR IY39592, please run the script file cicsppcgwy_odmchange provided in /usr/lpp/cics/bin. This script makes modifications needed to a specific section in the ODM. Other sections inside ODM are not affected by running this script.
• The support for CICS Screen Design Aid (CICSSDA) has been re-introduced on TXSeries CICS 5.0 for UNIX platforms from CICS 5.0.0.2 onwards.
• Users of TXSeries CICS on Windows^(R) NT platforms need to download redistributable versions of two .dlls named "psapi.dll" and "dbghelp.dll", which are provided by Microsoft^(R) Corporation. This step is optional, but is advisable, because it enables TXSeries CICS with improved diagnostic capabilities.
• MaxRegionPoolSize in the RD stanza can have a maximum value of only 268389424 bytes as against 268435456 bytes, which is stated in the CICS Administration Reference manual.
• To work with the Microfocus Cobol Animator, it is recommended that the customers use ServerExpress 2.2 SP1 with Fixpack 22.02_3 with TXSeries CICS 5.0.0.3
• Enhancements to CICS
  • Program Search Path. An environment variable called CICS_PROGRAM_PATH has been added to TXSeries from CICS 5.0.0.3 onwards.  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 can not be found, then the paths on the CICS_PROGRAM_PATH environment will be used in conjunction with the PathName attribute to try and load the program or map.The CICS_PROGRAM_PATH environment variable supports standard Operating System behaviour for paths.  So on Windows platforms the paths will be delimited with a semi-colon (;) and on UNIX platforms the paths will be delimited with a colon (:)
  • External Authentication Manager. An environment variable called CICS_EAM has been added to TXSeries CICS from 5.0.0.3 onwards. This environment variable specifies a user exit, similar to the External Security Manager, which is called by CICS in the following cases:
    • When a user/password combination needs checking
    • When a password needs changing.

    The exit is also called if there is not a UserDefinition stanza entry for the user trying to log in. The exit is called after a successful password validation, and allows the exit to specify a model UserId in the stanza 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 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 function Authenticate is called. This is passed in a CICS_EAM_RegionData structure and a CICS_EAM_Logon structure.  This includes the userid and password to be authorised.  The three valid return codes are CICS_EAM_RETURN_INVALID, CICS_EAM_PASSWORD_EXPIRED and CICS_EAM_RETURN_OK anything else abends the transaction.

    When a user requests to change their password, first the password is authenticated using Authenticate, and if authentication succeeds then ChangePassword is called.  This is passed two structures: a CICS_EAM_RegionData and a CICS_EAM_ChangePassword.  This contains the userid, 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 or any unrecgonised return code will abend 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 function UserInstall is called.  This is passed two structures: a CICS_EAM_RegionData and a CICS_EAM_NewUser .   This will contain the userid that is installed.  The member ModelID in CICS_EAM_NewUser needs to be set to an already defined id (maximum 8 characters), which is copied and installed as the new userid.

Contents of the TXSeries CICS 5.0.0.3  PTF

This section lists the APARs fixed in this PTF.

APAR #	Abstract
IY39066	ERZ005019E error when running CICSTRAN command 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 RM's when it is terminated
IY40420	Terminating Stash mutex at shutdown is not correct
IY40613	LU0 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 not released when IP client times out, on all platforms
IY41877	CICS region abends with U5701 due to timing issue between CICSAS and CICS log daemon
IY41891	CICS region hangs on mutex after EXEC CICS INQUIRE TASK from application
IY41898	CADB transaction will not handle concurrent animator sessions
IY42061	Animator hangs after the end of program execution
IY42123	Access violation from CICS accessing a freed stash buffer which results in process heap corruption and the process fails
IY43299	Abend A57A after timeout is received on CPMI transaction
IY44314	CECI INQUIRE CONNECTION on an APPC connection is returning CONNSTATUS(1) when the connection is inservice and acquired
IY44368	CICSTFMT reports Signal 11, for trace generated by CUC
IY44392	Console mutex held by dead application server resulting in region hang
IY44470	Keyword overflow in CFC header file (icccndeh.hpp) causing compilation errors
IY44541	Unable to set EXIT 33 on pragram definition GUI panel
IY44550	CICS goes down as RM_XA doesn't support asynchronous abort
IY44567	Transactions running in cicsas process may abend ASRA following an initial ASRA abend that causes potential corruption
IY44570	CICS region terminates abnormally following AKCS abend in CICSAM when attempt to create CICSAS fails with BDE_TRANSIENT_ERROR

Contents of previous PTF releases

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

• 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.2 PTF

This section lists the APARs 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 corrupt when CICS fails unexpectedly
IY35491	INQUIRE TSQ resets the TSQ Read Index
IY35880	Log record corruption on CICS shutdown
IY35981	PL/I programs does 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 due to the FREEKB bit in the WCC being set off due to the EBCDIC ASCII conversion in CICSTELD
IY37371	Running CICSMIGRATE with -M flag for multiple regions fail
IY38002	ERZ046357E/0572 could not access values during cicsmigrate
IY38006	External trace attribute not found during cicsmigrate
IY38317	Symrecs getting 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 getting filled up 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 our signal handler
IY39583	Cicsas leaks memory for each terminal install through RPC
IY39584	CICSDDT ftod fails when encountering a hex 1A
IY39585	CICS initialization not detecting invalid RegionPoolBase of 0
IY39586	CPU time for trans are being accumulated, resulting in AICA
IY39590	Ftos fails to process the data stream containing 0x1A character
IY39591	(Windows Systems) CMF Improvements in Windows
IY39592	(AIX Systems) CICS ppcgateway server is unable to start using smitty
IY39593	(Solaris or HP-UX Systems) Unable to restart all services using "cicscp -v start all"
IY39594	Cobol:cics freemain DataPointer(Address of A1) leads abend A47B
IY39595	Device name garbled in failed autoinstall request
IY39599	Trace system double deallocation leads to various errors

 

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, to synchronize with the GA levels of TXSeries CICS 5.0 on HP-UX and Solaris platforms. Applying this PTF upgrades from 5.0.0.0 to 5.0.0.1 on AIX and Windows platforms.

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

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

For more details about the defects that went into this PTF, please 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.