IBM Support

PI17909: RDZ V9.1.0: INTEGRATED DEBUGGER ISSUE WHEN DEBUGGING A CICS TRANSACTION THAT MAKES AN EXEC CICS XCTL CALL.

Subscribe

You can track all active APARs for this component.

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.



Document information

More support for: Rational Developer for System z

Software version: 9.1

Reference #: PI17909

Modified date: 09 December 2014