IBM Support

PH71059: SERVICE FOR Z/OS DEBUGGER 17.0.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • 17.0  PTF  #13 17.0.5
    
    
    z/OS Debugger service 17.0.5 for
    
     IBM Developer for z/OS Enterprise Edition 17.0.5.
     IBM Developer for z/OS 17.0.5.
     IBM Debug for z/OS 17.0.5.
    
     IBM Test Accelerator for Z.
    
    
    --- Features ---
    
    See "What's new in IBM z/OS Debugger" in the z/OS Debugger
    documentation for any new features, if any, included in this
    service for Developer for z/OS Enterprise Edition,  Developer
    for z/OS and Debug for z/OS.
    
    --- End Features ---
    
    
    --- Service ---
    
    -EQA9993I messages during TAZ recording
    
     IMS MPP DEBUG RECEIVES EQA9993I - EQA00OHT: FAILED TO SET HOOK
     IN R/O STORAGE EQA9993I
    
     The EQA9993I message is caused by the debugger attempting to
     set a hook in its own module and failing because the module,
     loaded from linklist, resides in protected storage.
    
     (PH70886 at 17.0)
    
    
    -SYSDEBUG is missing in DTU Program Prep for COBOL V6 in program
     preparations
    
     V17 Debug Tool Utility is missing SYSDEBUG file support for
     COBOL V6.2+ in Program preparations.
    
     (PH70018 at 17.0)
    
    
    -IKJ56246I FILE IN USE message from DTU 4.6
    
     IMS ISO DEBUGGER : IKJ56246I FILE IN USE MESSAGE FROM DTU 4.6
     DTU 4.6 always allocates EQARESDS and EQATY2DS DDs if dsnames
     for them are provided, but it uses and deallocates the datasets
     only if class selection changes. Exiting DTU 4.6 without
     changing the class list leaves the DDs allocated, causing FILE
     IN USE messages on the next use of 4.6 in the same TSO session.
    
     (PH70452 at 16.0)
    
    
    -ABENDS0C4 in EQA00DBG when a debug session is terminated by a
     QUIT command from a nested enclave.
    
     (PH70606 at 16.0)
    
    
    -ABENDS0C7 at EQA00LSE+0000181A in Cobol V5+ debug on the LIST
     command if TEST parm specifies DBMDT%userid with no colon at
     the end.
    
     Running IVP EQAWIVPU
     /TEST(,CMDS,;,DBM%user id)    abends
     /TEST(,CMDS,;,DBM%user id;*)  works
    
     (PH70822 at 17.0)
    
    
    -RACROUTE ENVIR=DELETE to fix ACEE leak pthread_join() error 121
     in Debug Manger There is a memory leak in Debug Manager that
     fills the storage below the line.
    
     Added RACROUTE ENVIR=DELETE to fix ACEE leak.
    
     (PH70747 at 17.0)
    
    
    -DBM instances in Sysplex with DVIPA=ON sometimes fail to to
     identify primary node Debug Manager instances in Sysplex with
     DVIPA=ON sometimes fail to identify primary node - the system
     lacks a private IP address only the hub can bind to. There is a
     workaround to change the job name for the primary Debug Manager
     task and assign sysplex port to that job name, but in this
     scenario it is not possible to change the primary node with
     console commands without restarting Debug Manager.  The goal is
     to create parameter to force one of the instances to be a
     primary node on startup.
    
     (PH70746 at 17.0)
    
    
    -AbendS202 in Terminal Interface Manager when invalid parameters
     are given for EQAUOPTS dataset
    
     Terminal Interface Manager lets a user create a new LE options
     data set. If the user changes suggested allocation parameters
     incorrectly, TIM abends on writing to the data set.
    
     (PH70534 at 17.0)
    
    
    -Extra PGMS INPT recorded when a loop begins at the very
     beginning of a procedure - Cobol V5 Using Test Accelerator for
     z/OS (TAZ) v2.6.0, running a unit test with the recording for a
     COBOL v5+ program with a loop in the first executable line of a
     procedure, will result in a loop when BZUCFG configuration
     dataset is not found.
    
     (PH71115 at 17.0)
    
    
    -AbendS0C4 at EQA03CUS+5BCC in COBOL/Java mix debugging Using
     IBM Debug for z/OS for debugging an application containing a
     mix of COBOL and Java programs results in abendS0C4 at
     EQA03CUS+5BCC.
    
     (PH71511 at 17.0)
    
    
    -Incorrect format-3 parm string in DTU 2
    
     DEBUG TOOL UTILITY :  DEBUG TOOL PREFERENCE FILE IS NOT READ
     WHEN YOU TRY TO DEBUG NON LE ASSEMBLER IN DTU / OPTION 2
    
     Generated TEST string  is correct
     'TEST(ERROR,*,PROMPT,MFI:DBGTOOL.PREFS)/'
    
     However when the debug session is submitted the full parm
     string is
    
     PARM='XMPLOAD/TEST(ALL,*,PROMPT,MFI:DBGTOOL.PREFS)/'
    
     It should be
    
     PARM='XMPLOAD,TEST(ALL,*,PROMPT,MFI:DBGTOOL.PREFS)/'
    
     The debugger starts up but the sub option of the string are
     ignored.
    
     (PH71521 at 17.0)
    
    
    For COBOL V5 and V6:
    FIXCAT KEYWORD: COB0501T/K COB0502T/K
                    COB0601T/K COB0602T/K
                    COB0603T/K COB0604T/K
                    COB0605T/K
    
    For z/OS Debugger:
    FIXCAT KEYWORD: DEBUGGER/K
    
    --- End Service ---
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: z/OS Debugger 17.0 users who need the        *
    *                 features or have the problems described in   *
    *                 the Problem Description.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: 17.0  PTF  #13 17.0.5                   *
    *                                                              *
    *                                                              *
    *                      z/OS Debugger service 17.0.5 for        *
    *                                                              *
    *                       IBM Developer for                      *
    *                       z/OS Enterprise Edition 17.0.5         *
    *                       IBM Developer for z/OS 17.0.5          *
    *                       IBM Debug for z/OS 17.0.5              *
    *                                                              *
    *                       IBM Test Accelerator for Z.            *
    *                                                              *
    *                                                              *
    *                      --- Features ---                        *
    *                                                              *
    *                      See "What's new in IBM z/OS Debugger"   *
    *                      in the z/OS Debugger documentation for  *
    *                      any new features, if any, included in   *
    *                      this service for Developer for z/OS     *
    *                      Enterprise Edition,  Developer for z/OS *
    *                      and Debug for z/OS.                     *
    *                                                              *
    *                      --- End Features ---                    *
    *                                                              *
    *                                                              *
    *                      --- Service ---                         *
    *                                                              *
    *                      -EQA9993I messages during TAZ recording *
    *                                                              *
    *                       IMS MPP DEBUG RECEIVES EQA9993I -      *
    *                       EQA00OHT: FAILED TO SET HOOK IN R/O    *
    *                       STORAGE EQA9993I                       *
    *                                                              *
    *                       The EQA9993I message is caused by the  *
    *                       debugger attempting to set a hook in   *
    *                       its own module and failing because the *
    *                       module, loaded from linklist, resides  *
    *                       in protected storage.                  *
    *                                                              *
    *                       (PH70886 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -SYSDEBUG is missing in DTU Program     *
    *                       Prep for COBOL V6 in program           *
    *                       preparations                           *
    *                                                              *
    *                       V17 Debug Tool Utility is missing      *
    *                       SYSDEBUG file support for COBOL V6.2+  *
    *                       in Program preparations.               *
    *                                                              *
    *                       (PH70018 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -IKJ56246I FILE IN USE message from DTU *
    *                       4.6                                    *
    *                                                              *
    *                       IMS ISO DEBUGGER : IKJ56246I FILE IN   *
    *                       USE MESSAGE FROM DTU 4.6 DTU 4.6       *
    *                       always allocates EQARESDS and EQATY2DS *
    *                       DDs if dsnames for them are provided,  *
    *                       but it uses and deallocates the        *
    *                       datasets only if class selection       *
    *                       changes. Exiting DTU 4.6 without       *
    *                       changing the class list leaves the DDs *
    *                       allocated, causing FILE IN USE         *
    *                       messages on the next use of 4.6 in the *
    *                       same TSO session.                      *
    *                                                              *
    *                       (PH70452 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -ABENDS0C4 in EQA00DBG when a debug     *
    *                       session is terminated by a QUIT        *
    *                       command from a nested enclave.         *
    *                                                              *
    *                       (PH70606 at 16.0)                      *
    *                                                              *
    *                                                              *
    *                      -ABENDS0C7 at EQA00LSE+0000181A in      *
    *                       Cobol V5+ debug on the LIST command if *
    *                       TEST parm specifies DBMDT%userid with  *
    *                       no colon at the end.                   *
    *                                                              *
    *                       Running IVP EQAWIVPU                   *
    *                       /TEST(,CMDS,;,DBM%user id)    abends   *
    *                       /TEST(,CMDS,;,DBM%user id;*)  works    *
    *                                                              *
    *                       (PH70822 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -RACROUTE ENVIR=DELETE to fix ACEE leak *
    *                       pthread_join() error 121 in Debug      *
    *                       Manger There is a memory leak in Debug *
    *                       Manager that fills the storage below   *
    *                       the line.                              *
    *                                                              *
    *                       Added RACROUTE ENVIR=DELETE to fix     *
    *                       ACEE leak.                             *
    *                                                              *
    *                       (PH70747 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -DBM instances in Sysplex with DVIPA=ON *
    *                       sometimes fail to to identify primary  *
    *                       node Debug Manager instances in        *
    *                       Sysplex with DVIPA=ON sometimes fail   *
    *                       to identify primary node - the system  *
    *                       lacks a private IP address only the    *
    *                       hub can bind to. There is a workaround *
    *                       to change the job name for the primary *
    *                       Debug Manager task and assign sysplex  *
    *                       port to that job name, but in this     *
    *                       scenario it is not possible to change  *
    *                       the primary node with console commands *
    *                       without restarting Debug Manager.  The *
    *                       goal is to create parameter to force   *
    *                       one of the instances to be a primary   *
    *                       node on startup.                       *
    *                                                              *
    *                       (PH70746 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -AbendS202 in Terminal Interface        *
    *                       Manager when invalid parameters are    *
    *                       given for EQAUOPTS dataset             *
    *                                                              *
    *                       Terminal Interface Manager lets a user *
    *                       create a new LE options data set. If   *
    *                       the user changes suggested allocation  *
    *                       parameters incorrectly, TIM abends on  *
    *                       writing to the data set.               *
    *                                                              *
    *                       (PH70534 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -Extra PGMS INPT recorded when a loop   *
    *                       begins at the very beginning of a      *
    *                       procedure - Cobol V5 Using Test        *
    *                       Accelerator for z/OS (TAZ) v2.6.0,     *
    *                       running a unit test with the recording *
    *                       for a COBOL v5+ program with a loop in *
    *                       the first executable line of a         *
    *                       procedure, will result in a loop when  *
    *                       BZUCFG configuration dataset is not    *
    *                       found.                                 *
    *                                                              *
    *                       (PH71115 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -AbendS0C4 at EQA03CUS+5BCC in          *
    *                       COBOL/Java mix debugging Using IBM     *
    *                       Debug for z/OS for debugging an        *
    *                       application containing a mix of COBOL  *
    *                       and Java programs results in abendS0C4 *
    *                       at EQA03CUS+5BCC.                      *
    *                                                              *
    *                       (PH71511 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      -Incorrect format-3 parm string in DTU  *
    *                       2                                      *
    *                                                              *
    *                       DEBUG TOOL UTILITY :  DEBUG TOOL       *
    *                       PREFERENCE FILE IS NOT READ WHEN YOU   *
    *                       TRY TO DEBUG NON LE ASSEMBLER IN DTU / *
    *                       OPTION 2                               *
    *                                                              *
    *                       Generated TEST string  is correct      *
    *                       'TEST(ERROR,*,PROMPT,MFI:DBGTOOL.PREF  *
    *                        S)/'                                  *
    *                                                              *
    *                       However when the debug session is      *
    *                       submitted the full parm string is      *
    *                                                              *
    *                       PARM='XMPLOAD/TEST(ALL,*,PROMPT,MFI:DB *
    *                       GTOOL.PREFS)/'                         *
    *                                                              *
    *                       It should be                           *
    *                                                              *
    *                       PARM='XMPLOAD,TEST(ALL,*,PROMPT,MFI:DB *
    *                       GTOOL.PREFS)/'                         *
    *                                                              *
    *                       The debugger starts up but the sub     *
    *                       option of the string are ignored.      *
    *                                                              *
    *                       (PH71521 at 17.0)                      *
    *                                                              *
    *                                                              *
    *                      For COBOL V5 and V6:                    *
    *                      FIXCAT KEYWORD: COB0501T/K COB0502T/K   *
    *                                      COB0601T/K COB0602T/K   *
    *                                      COB0603T/K COB0604T/K   *
    *                                      COB0605T/K              *
    *                                                              *
    *                      For z/OS Debugger:                      *
    *                      FIXCAT KEYWORD: DEBUGGER/K              *
    *                                                              *
    *                                                              *
    *                      --- End Service ---                     *
    ****************************************************************
    Miscellaneous service.
    

Problem conclusion

  • Service available.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH71059

  • Reported component name

    ZOS DEBUGGER

  • Reported component ID

    5724T0713

  • Reported release

    H00

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2026-04-24

  • Closed date

    2026-06-17

  • Last modified date

    2026-06-23

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UO08244 UO08245

Modules/Macros

  • BZU2CLCT BZU2TABL BZUACMPR BZUACNFG BZUADCMP BZUAFREE BZUAGAID
    BZUAGETM BZUAMOUT BZUAMSGS BZUAPARM BZUARGID BZUASTMG BZUATABL
    BZUAWREC BZUCDEFN BZUCINFO BZUDCLCT BZUDCP   BZUDCPPX BZUDDFLT
    BZUDTABL BZUF0208 BZUF2020 BZUF2404 BZUF5212 BZUF5214 BZUF5412
    BZUF7832 BZUF7834 BZUFC412 BZUFCLCT BZUFFNCT BZUFTABL BZUHCLCT
    BZUHTABL BZUJCLCT BZUJTABL BZUKCLCT BZUKTABL BZULCLCT BZULTABL
    BZUMSGEN BZURMSGS BZUUCLCT BZUUTABL BZUVCLCT BZUVTABL BZUWCLCT
    BZUWTABL BZUX0202 BZUX0204 BZUX0206 BZUX020A BZUX06XX BZUX0C02
    BZUX0C04 BZUX0E02 BZUX0E06 BZUX0E08 BZUX0E0A BZUXCLCT BZUXCOPY
    BZUXDFLT BZUXNARG BZUXNUMB BZUXPAID BZUXTABL BZUXVLTH BZUZCLCT
    BZUZTABL EQA00A64 EQA00ABE EQA00AEH EQA00AEI EQA00AIO EQA00ALO
    EQA00AMD EQA00ANC EQA00ANL EQA00BKP EQA00BLD EQA00BLK EQA00BND
    EQA00BPP EQA00C53 EQA00C62 EQA00C63 EQA00C64 EQA00C65 EQA00C66
    EQA00C67 EQA00C68 EQA00C69 EQA00C70 EQA00C71 EQA00C72 EQA00C73
    EQA00C74 EQA00C75 EQA00C76 EQA00CCV EQA00CCX EQA00CEC EQA00CEE
    EQA00CEM EQA00CEX EQA00CHG EQA00CIC EQA00CND EQA00CTX EQA00CUS
    EQA00CV  EQA00CVC EQA00CVT EQA00DBG EQA00DBH EQA00DBI EQA00DBJ
    EQA00DCL EQA00DEH EQA00DEI EQA00DLD EQA00DMM EQA00DSF EQA00DTA
    EQA00DTC EQA00DTL EQA00DU  EQA00E40 EQA00E41 EQA00E42 EQA00E63
    EQA00E65 EQA00E68 EQA00E69 EQA00E71 EQA00E73 EQA00E75 EQA00EH2
    EQA00EHB EQA00EHI EQA00EMG EQA00ENV EQA00ER0 EQA00ER1 EQA00ER2
    EQA00EVH EQA00EXE EQA00FA  EQA00FIN EQA00FRE EQA00GCC EQA00GDD
    EQA00GDF EQA00GDG EQA00GDP EQA00GDV EQA00GFU EQA00GFV EQA00GIV
    EQA00GLV EQA00GPA EQA00GSV EQA00GTO EQA00HFS EQA00HKN EQA00HKS
    EQA00INT EQA00IPD EQA00KBM EQA00LAM EQA00LBL EQA00LCM EQA00LDD
    EQA00LDR EQA00LDU EQA00LDW EQA00LDX EQA00LDY EQA00LIS EQA00LLC
    EQA00LLF EQA00LLH EQA00LLT EQA00LMS EQA00LNG EQA00LNK EQA00LRC
    EQA00LSE EQA00LST EQA00MDP EQA00MEM EQA00MIP EQA00NAM EQA00NML
    EQA00NMU EQA00NTC EQA00OEH EQA00OEI EQA00OHB EQA00OHC EQA00OHD
    EQA00OHE EQA00OHH EQA00OHI EQA00OHL EQA00OHT EQA00OHV EQA00OSX
    EQA00PBK EQA00PDM EQA00POP EQA00PST EQA00QCS EQA00QFY EQA00QNS
    EQA00QRY EQA00QSS EQA00REG EQA00RES EQA00RPB EQA00RSV EQA00RUN
    EQA00RWD EQA00SBM EQA00SET EQA00SRT EQA00STO EQA00STR EQA00STT
    EQA00STU EQA00SVC EQA00TMM EQA00TMX EQA00TRA EQA00TSR EQA00TTL
    EQA00TVT EQA00V00 EQA00V68 EQA00V69 EQA00V70 EQA00V71 EQA00V72
    

Fix information

  • Fixed component name

    ZOS DEBUGGER

  • Fixed component ID

    5724T0713

Applicable component levels

  • RH00 PSY UO08244

       UP26/06/18 I 1000

  • RH0J PSY UO08245

       UP26/06/18 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":"BU029","label":"Software"},"Product":{"code":"SSVSZX","label":"IBM Debug for z Systems"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"H00"}]

Document Information

Modified date:
23 June 2026