A fix is available
APAR status
Closed as program error.
Error description
Debugging a CICS transaction that makes an EXEC CICS XCTL call with the Integrated Debugger may cause subsequent invocations of that transaction to abend, or may cause the CICS region to abend.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: 01.RDz users. * * 02.RDz users using Integrated Debugger with * * CICS * * 03.RDz security administrator * * 04.RDz Integarted Debugger users using LE * * exit * * 05.z/OS system programmer * * 06.Any users of the Integrated Debugger who * * debug CICS programs that make XCTL * * calls. * * 07.All Integrated Debugger users * * 08.Integrated Debugger users who use the * * compile option LANGUAGE(UE) * * 09.system administrators who's users use * * RDz Integrated Debugger and IBM Debug * * Tool for z/OS * **************************************************************** * PROBLEM DESCRIPTION: 01.The DebugSessionHandler logs error * * messages whenever there is a failed * * attempt to connect to DBM. * * 02.RDz coexistence issue with IBM * * Debug Tool due to shared TD queues * * 03.Definition of new security profiles * * which are required for the * * Integrated Debugger. * * 04.Service to Developer for System z * * (RDz) AQED3XXT LE user exit to * * remain compatible with IBM Debug * * Tool 13.1 APAR PI16543. * * 05.DBGMGR started task no longer uses * * SVC startup argument * * 06.Under the Integrated Debugger, * * stepping over or into a CICS XCTL * * call will work properly the first * * time, but all subsequent * * invocations of the transaction will * * abend. * * 07.Rational Developer for System z * * (RDz) Integrated Debugger does not * * display source when using SYSIN for * * specifying the compile options * * 08.Rational Developer for System z * * integrated debugger user receives * * message "The zOS probe was unable * * to locate the listing file dated * * 2014/06/13 07:50:28 for compile * * unit MYCBLPRG. Compile unit * * MYCBLPRG will be treated as * * non-debugable." * * The RDz user does not see the * * source code but (disassembled) * * assembler code. This happens when * * using the compile option * * LANGUAGE(UE). * * 09.Users are unable to debug * * multi-user CICS regions as * * expected. * **************************************************************** * RECOMMENDATION: * **************************************************************** 01.The DebugSessionHandler logs error messages whenever there is a failed attempt to connect to DBM. In some cases, DBM will not be running and, as a result, there can be several error messages logged. 02.Rational Developer for System z Integrated Debugger has a coexistence issue with IBM Debug Tool due to shared TD queues. 03.Definition of new security profiles which are required for the Integrated Debugger. AQE.AUTHDEBUG.STDPGM AQE.AUTHDEBUG.AUTHPGM Sample jobs FEKRACF and AQERACF are updated, so is the host configuration utility. 04.Service to Developer for System z (RDz) AQED3XXT LE user exit to remain compatible with IBM Debug Tool 13.1 APAR PI16543. 05.Rational Developer for System z (RDz) Integrated Debugger started task DBGMGR no longer uses the SVC startup argument 06.Session state from the first debug session was not cleaned up properly, leading to failures in subsequent runs 07.The Integrated Debugger could not correct retrieve and display the source while debugging when compile options that affect the listing were specified via SYSIN. 08.The compiler option Language(UE) was not supported by the Integrated Debugger. 09.The Integrated Debugger technique used to get control of applications at certain locations (breakpoints) involves inserting illegal instructions into the application. This causes the application to abend in cases where a single instance of the application (address space) is being used simultaneously by multiple users.
Problem conclusion
01.Instead of logging these messages as errors, they should be logged as informationals. 02.Rational Developer for System z Integrated Debugger is updated to use other TD queues CIBM, IBMDBGIN -> AQED, AQEDBGDS CIGZ, IGZDBGIN -> AQEM, AQEDBGM 03.Definition of new security profiles which are required for the Integrated Debugger. 04.Service to Developer for System z (RDz) AQED3XXT LE user exit to remain compatible with IBM Debug Tool 13.1 APAR PI16543. 05.DBGMGR started task no longer uses SVC startup argument 06.Fix made to debugger cleanup routines 07.The Integrated Debugger was modified to support specifying listing options via SYSIN 08.Support for Language(UE) was added to the Integrated Debugger. 09.The Integrated Debugger has been modified to handle debugging multi-user CICS regions.
Temporary fix
Comments
APAR Information
APAR number
PI17909
Reported component name
RD/Z HOST
Reported component ID
5724T0723
Reported release
910
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2014-05-14
Closed date
2014-12-05
Last modified date
2014-12-09
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI23650
Modules/Macros
AQECIC32 AQECIC41 AQECIC51 AQECSD AQECTL AQED3XXT AQEEVDBG AQEEV006 AQEJCL AQELDR31 AQELDR64 AQEL3Z3 AQEL3Z6 AQEL6Z3 AQEL6Z6 AQEMVS31 AQEMVS64 AQEQV006 AQERACF AQESVC03 AQEW3Z3 AQEW3Z6 AQEXPL31 AQEZPCM FEKFDBGM FEKRACF
Fix information
Fixed component name
RD/Z HOST
Fixed component ID
5724T0723
Applicable component levels
R910 PSY UI23650
UP14/12/09 I 1000
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSJK49","label":"IBM Developer for z Systems"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
09 December 2014