IBM Support

PM17328: Service for Debug Tool 10.1.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • --- Features ---
    
    -Debug Tool now supports debugging of assembler programs that
     exploit the latest IBM zEnterprise 196 architecture.  In
     addition, new Debug Tool variables, %GPRH0, %GPRH1, ...
     %GPRH15, are now available to reference the high, 32-bit
     registers.  See the +HOLD for more information.
    
    -Debugger support for the new Enterprise PL/I 4.1 compiler,
     including the new GONUMBER(SEPARATE) compiler option. Support
     for GONUMBER(SEPARATE) also requires a new Language
     Environment runtime PTF for APAR PM19445. See the ++HOLD for
     more information.
    
    -Coverage Utiity support for the new Enterprise PL/I 4.1
     compiler.
    
    -Load Module Analyzer:  Add SS (seconds) to LEINFO compile
     time.
    
    -Listing PL/1 array enhancements. Display single occurrence and
     display array as it is stored in memory.  See the +HOLD for
     more information.
     (PM21186 at 10.1)
    
    -The EQALMA LEINFO option now generates non-LE compile date and
     time information for OS/VS COBOL and VS COBOL II in addition
     to the LE information for all LE enabled languages.
    
    -The Debug Tool internal heap limit for expression processing
     has been increased to 250M, allowing larger data items to be
     processed.  See the ++HOLD for information about changes to
     the Explanation and Programmer response for EQA1484E.
    
    -Update the Enterprise PL/I IVPs for Enterprise PL/I 4.1.
    
    --- End Features ---
    
    --- Service ---
    
    -ABENDS0C1 in EQA00STO+x'000000E8' expanding a C variable from
     RD/z.
     (PM16663 at 9.1)
    
    -Host session hangs with PROG755 monitoring DBCS variable with
     bad data. No error occurs with SET DBCS OFF.
     (PM17597 at 9.1)
    
    -User opens a COBOL table. Its index number is displayed
     incorrectly. This fails on RDz 7.0.1.1, not 7.0.1.4.
     (PM17732 at 10.1)
    
    -DTSU COPY drops the DUMMY keyword from DD statement.
     (PM17984 at 9.1)
    
    -Dynamic Table Manager not compatible with CEEBINIT that is
     linked with EQADICXT.
     (PM18400 at 10.1)
    
    -Unable to debug assembler if called from LE cobol with
     CEETEST.
    
     Customer has a main program XXXX which call the exit XXX@S01,
     where a CEETEST call is issued and the session for debugging
     is established. After going back to the main program XXXX,
     XXXX calls the program which they want to debug. Here, they
     can debug a COBOL program with this method. However they can
     not debug an assembler program. The session for debugging is
     disconnected when XXXX calls the assembler program they want
     to debug.
     (PM18664 at 9.1)
    
    -Updating a variable monitor in optimized COBOL results in:
     EQA1418E One or more of multiple updates were not processed.
     (PM18726 at 10.1)
    
    -Exception occurs in EQA0AIP1+x'00009414'. The failure is
     occurring on the EXecute instruction (44F0B1C6), which is
     really trying to process an MVC instruction (D207 E000 8002).
     Exception occurs due to an invalid address in reg8.
     (PM19035 at 10.1)
    
    -Customer received "EQA1980E  The Debug File for xxxxxx could
     not be opened or read." when they used SET DEFAULT LISTINGS to
     a copied debug file.
     (PM19270 at 9.1)
    
    -LE U4088 while listing large structure.
     (PM19541 at 9.1)
    
    -AbendS0C6 occurred due to bad branch out of EQADCCXR. The
     module was attempting to branch to another routine whose
     address should be contained in DtRcb control block. However,
     the control block was overlaid. This APAR is intended to
     prevent the control block from being overlaid.
     (PM20478 at 10.1)
    
    -While debugging a program that expects to receive CEE067
     condition, the message was not issued.
     (PM20538 at 9.1)
    
    -AbendS0C4 in EQANCDBG+x'0000259C' on a Load instruction (5890
     32F4) due to an invalid value in reg3. Problem occurs when
     user issues a QUIT command while in Debug Tool.
     (PM20801 at 10.1)
    
    -On entry to an assembler program ABENDS0C1 occurs after
     entering Debug Tool command 'LIST R13->+4'.  The following
     message is also being issued.  "+EQA9988S A debug tool has
     terminated the enclave.  +nmest:ABEND at EQA00EVH+000CCE92 /
     PSW: ....."
     (PM21358 at 10.1)
    
    -During a debug session, user sets fields to monitor, and then
     finishes and gets out of debug, but when they start it up
     again, the fields that were set to monitor are either no
     longer there or get an error and have to be reset for
     monitoring. Here is the error received:
    
        An error occurred during expression evaluation.
    
     This is because the hyphens in the COBOL variable names now
     have spaces surrounding them. This problem can be seen with
     commands such as:
    
        MONITOR LIST BRK-INSURANCE-LINE(2),
    
     when also debugging a C program. This is due to the fact that
     data names in Assembler and in C are not valid with hyphens.
     (PM21196 at 8.1)
    
    -Error in Monitor window when Scroll set to CSR.
     The problem occurs during a debugging session on a 3270 screen
     and having the "Scroll" set to "CSR".  After having put
     several variables in the MONITOR window, the cursor has been
     moved inside the MONITOR window and the PF8 key (DOWN) had
     been selected several times; after that the PF7 key (UP) has
     been selected once and then a second time: the second attempt
     and any other attempt to go UP with the PF7 key appear to
     fail. The problem always happens when the cursor is on the
     second-last line of the MONITOR window.
     (PM22320 at 10.1)
    
    -Customer is unable to start Debug Tool using DTSU setup file.
     Allocation failed - EQAZ050W Allocation of a temp data set.
     (PM22676 at 10.1)
    
    -EQALANGX at FA PTF UK59774 level.
     EQALANGX version 2010-08-19 22:17
    
    -If Debug Tool is running in Separate (formerly known as Dual)
     terminal mode or in Screen Control Mode, it runs with the
     userid of the application and not the userid of the display
     terminal. This causes confusion/problems with SAVESETS and
     SAVEBPS.
    
     This service will change Debug Tool to use the userid of the
     display terminal.
    
    -Messaging is enhanced when resources are exhausted during
     expression evaluation.  See the ++HOLD for information about
     changes to the Explanation and Programmer response for
     EQA1484E.
    
    -DTCN plug-in: Test Connection error handling fixes.  See the
     ++HOLD DOC for information about installing this update.
    
    -Some storage isses are resolved by limiting the monitor table
     to 30000 lines (SET MONITOR LIMIT is thus limited to 30000).
    
    
    These defects have already been shipped via separate PTFs:
    
    PM09411 / UK58904 PE
    -If a Debug Tool user is stopped after a STEP, and a
     previously-set STIMER or STIMERM interval expires, and a timer
     exit routine was specified, Debug Tool can take an exception
     (such as an s0c1).
    
    PM21383 / UK60143
    -A Debug Tool session using Terminal Interface Manager hangs
     after starting the program after APPLY of UK58904.
    
    --- End Service ---
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Debug Tool 10.1.0 users who need the         *
    *                 features or have the problems described      *
    *                 in the Problem Description.                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: --- Features ---                        *
    *                                                              *
    *                      -Debug Tool now supports debugging of   *
    *                       assembler programs that exploit the    *
    *                       latest IBM zEnterprise 196             *
    *                       architecture.  In addition, new Debug  *
    *                       Tool variables, %GPRH0, %GPRH1, ...    *
    *                       %GPRH15, are now available to          *
    *                       reference the high, 32-bit registers.  *
    *                       See the +HOLD for more information.    *
    *                                                              *
    *                      -Debugger support for the new           *
    *                       Enterprise PL/I 4.1 compiler,          *
    *                       including the new GONUMBER(SEPARATE)   *
    *                       compiler option. Support for           *
    *                       GONUMBER(SEPARATE) also requires a new *
    *                       Language Environment runtime PTF for   *
    *                       APAR PM19445. See the ++HOLD for more  *
    *                       information.                           *
    *                                                              *
    *                      -Coverage Utiity support for the new    *
    *                       Enterprise PL/I 4.1 compiler.          *
    *                                                              *
    *                      -Load Module Analyzer:  Add SS          *
    *                       (seconds) to LEINFO compile time.      *
    *                                                              *
    *                      -Listing PL/1 array enhancements.       *
    *                       Display single occurrence and display  *
    *                       array as it is stored in memory.  See  *
    *                       the +HOLD for more information.        *
    *                       (PM21186 at 10.1)                      *
    *                                                              *
    *                      -The EQALMA LEINFO option now generates *
    *                       non-LE compile date and time           *
    *                       information for OS/VS COBOL and VS     *
    *                       COBOL II in addition to the LE         *
    *                       information for all LE enabled         *
    *                       languages.                             *
    *                                                              *
    *                      -The Debug Tool internal heap limit for *
    *                       expression processing has been         *
    *                       increased to 250M, allowing larger     *
    *                       data items to be processed.  See the   *
    *                       ++HOLD for information about changes   *
    *                       to the Explanation and Programmer      *
    *                       response for EQA1484E.                 *
    *                                                              *
    *                      -Update the Enterprise PL/I IVPs for    *
    *                       Enterprise PL/I 4.1.                   *
    *                                                              *
    *                      --- End Features ---                    *
    *                                                              *
    *                      --- Service ---                         *
    *                                                              *
    *                      -ABENDS0C1 in EQA00STO+x'000000E8'      *
    *                       expanding a C variable from RD/z.      *
    *                       (PM16663 at 9.1)                       *
    *                                                              *
    *                      -Host session hangs with PROG755        *
    *                       monitoring DBCS variable with bad      *
    *                       data. No error occurs with SET DBCS    *
    *                       OFF.                                   *
    *                       (PM17597 at 9.1)                       *
    *                                                              *
    *                      -User opens a COBOL table. Its index    *
    *                       number is displayed incorrectly. This  *
    *                       fails on RDz 7.0.1.1, not 7.0.1.4.     *
    *                       (PM17732 at 10.1)                      *
    *                                                              *
    *                      -DTSU COPY drops the DUMMY keyword from *
    *                       DD statement.                          *
    *                       (PM17984 at 9.1)                       *
    *                                                              *
    *                      -Dynamic Table Manager not compatible   *
    *                       with CEEBINIT that is linked with      *
    *                       EQADICXT.                              *
    *                       (PM18400 at 10.1)                      *
    *                                                              *
    *                      -Unable to debug assembler if called    *
    *                       from LE cobol with CEETEST.            *
    *                                                              *
    *                       Customer has a main program XXXX which *
    *                       call the exit XXX@S01, where a CEETEST *
    *                       call is issued and the session for     *
    *                       debugging is established. After going  *
    *                       back to the main program XXXX, XXXX    *
    *                       calls the program which they want to   *
    *                       debug. Here, they can debug a COBOL    *
    *                       program with this method. However they *
    *                       can not debug an assembler program.    *
    *                       The session for debugging is           *
    *                       disconnected when XXXX calls the       *
    *                       assembler program they want to debug.  *
    *                       (PM18664 at 9.1)                       *
    *                                                              *
    *                      -Updating a variable monitor in         *
    *                       optimized COBOL results in:  EQA1418E  *
    *                       One or more of multiple updates were   *
    *                       not processed.                         *
    *                       (PM18726 at 10.1)                      *
    *                                                              *
    *                      -Exception occurs in                    *
    *                       EQA0AIP1+x'00009414'. The failure is   *
    *                       occurring on the EXecute instruction   *
    *                       (44F0B1C6), which is really trying to  *
    *                       process an MVC instruction (D207 E000  *
    *                       8002).  Exception occurs due to an     *
    *                       invalid address in reg8.               *
    *                       (PM19035 at 10.1)                      *
    *                                                              *
    *                      -Customer received "EQA1980E  The Debug *
    *                       File for xxxxxx could not be opened or *
    *                       read." when they used SET DEFAULT      *
    *                       LISTINGS to a copied debug file.       *
    *                       (PM19270 at 9.1)                       *
    *                                                              *
    *                      -LE U4088 while listing large           *
    *                       structure.                             *
    *                       (PM19541 at 9.1)                       *
    *                                                              *
    *                      -AbendS0C6 occurred due to bad branch   *
    *                       out of EQADCCXR. The module was        *
    *                       attempting to branch to another        *
    *                       routine whose address should be        *
    *                       contained in DtRcb control block.      *
    *                       However, the control block was         *
    *                       overlaid. This APAR is intended to     *
    *                       prevent the control block from being   *
    *                       overlaid.                              *
    *                       (PM20478 at 10.1)                      *
    *                                                              *
    *                      -While debugging a program that expects *
    *                       to receive CEE067 condition, the       *
    *                       message was not issued.                *
    *                       (PM20538 at 9.1)                       *
    *                                                              *
    *                      -AbendS0C4 in EQANCDBG+x'0000259C' on a *
    *                       Load instruction (5890 32F4) due to an *
    *                       invalid value in reg3. Problem occurs  *
    *                       when user issues a QUIT command while  *
    *                       in Debug Tool.                         *
    *                       (PM20801 at 10.1)                      *
    *                                                              *
    *                      -On entry to an assembler program       *
    *                       ABENDS0C1 occurs after entering Debug  *
    *                       Tool command 'LIST R13->+4'.  The      *
    *                       following message is also being        *
    *                       issued.  "+EQA9988S A debug tool has   *
    *                       terminated the enclave.  +nmest:ABEND  *
    *                       at EQA00EVH+000CCE92 / PSW: ....."     *
    *                       (PM21358 at 10.1)                      *
    *                                                              *
    *                      -During a debug session, user sets      *
    *                       fields to monitor, and then finishes   *
    *                       and gets out of debug, but when they   *
    *                       start it up again, the fields that     *
    *                       were set to monitor are either no      *
    *                       longer there or get an error and have  *
    *                       to be reset for monitoring. Here is    *
    *                       the error received:                    *
    *                                                              *
    *                          An error occurred during expression *
    *                          evaluation.                         *
    *                                                              *
    *                       This is because the hyphens in the     *
    *                       COBOL variable names now have spaces   *
    *                       surrounding them. This problem can be  *
    *                       seen with commands such as:            *
    *                                                              *
    *                          MONITOR LIST BRK-INSURANCE-LINE(2), *
    *                                                              *
    *                       when also debugging a C program. This  *
    *                       is due to the fact that data names in  *
    *                       Assembler and in C are not valid with  *
    *                       hyphens.                               *
    *                       (PM21196 at 8.1)                       *
    *                                                              *
    *                      -Error in Monitor window when Scroll    *
    *                       set to CSR.                            *
    *                       The problem occurs during a debugging  *
    *                       session on a 3270 screen and having    *
    *                       the "Scroll" set to "CSR".  After      *
    *                       having put several variables in the    *
    *                       MONITOR window, the cursor has been    *
    *                       moved inside the MONITOR window and    *
    *                       the PF8 key (DOWN) had been selected   *
    *                       several times; after that the PF7 key  *
    *                       (UP) has been selected once and then a *
    *                       second time: the second attempt and    *
    *                       any other attempt to go UP with the    *
    *                       PF7 key appear to fail. The problem    *
    *                       always happens when the cursor is on   *
    *                       the second-last line of the MONITOR    *
    *                       window.                                *
    *                       (PM22320 at 10.1)                      *
    *                                                              *
    *                      -Customer is unable to start Debug      *
    *                       Tool using DTSU setup file.            *
    *                       Allocation failed - EQAZ050W           *
    *                       Allocation of a temp data set.         *
    *                       (PM22676 at 10.1)                      *
    *                                                              *
    *                      -EQALANGX at FA PTF UK59774 level.      *
    *                       EQALANGX version 2010-08-19 22:17      *
    *                                                              *
    *                      -If Debug Tool is running in Separate   *
    *                       (formerly known as Dual) terminal mode *
    *                       or in Screen Control Mode, it runs     *
    *                       with the userid of the application and *
    *                       not the userid of the display          *
    *                       terminal. This causes                  *
    *                       confusion/problems with SAVESETS and   *
    *                       SAVEBPS.                               *
    *                                                              *
    *                       This service will change Debug Tool to *
    *                       use the userid of the display          *
    *                       terminal.                              *
    *                                                              *
    *                      -Messaging is enhanced when resources   *
    *                       are exhausted during expression        *
    *                       evaluation.  See the ++HOLD for        *
    *                       information about changes to the       *
    *                       Explanation and Programmer response    *
    *                       for EQA1484E.                          *
    *                                                              *
    *                      -DTCN plug-in: Test Connection error    *
    *                       handling fixes.  See the ++HOLD DOC    *
    *                       for information about installing this  *
    *                       update.                                *
    *                                                              *
    *                      -Some storage isses are resolved by     *
    *                       limiting the monitor table to 30000    *
    *                       lines (SET MONITOR LIMIT is thus       *
    *                       limited to 30000).                     *
    *                                                              *
    *                      These defects have already been shipped *
    *                      via separate PTFs:                      *
    *                                                              *
    *                      PM09411 / UK58904 PE                    *
    *                      -If a Debug Tool user is stopped after  *
    *                       a STEP, and a previously-set STIMER or *
    *                       STIMERM interval expires, and a timer  *
    *                       exit routine was specified, Debug Tool *
    *                       can take an exception (such as an      *
    *                       s0c1).                                 *
    *                                                              *
    *                      PM21383 / UK60143                       *
    *                      -A Debug Tool session using Terminal    *
    *                       Interface Manager hangs after starting *
    *                       the program after APPLY of UK58904.    *
    *                                                              *
    *                      --- End Service ---                     *
    ****************************************************************
    * RECOMMENDATION: Installations that need these features or    *
    *                 problem fixes should install this service.   *
    ****************************************************************
    New features and miscellaneous service.
    

Problem conclusion

  • New features and service available.
    

Temporary fix

Comments

  • ×**** PE10/10/12 FIX IN ERROR. SEE APAR PM24362  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PM17328

  • Reported component name

    DEBUG TOOL Z/OS

  • Reported component ID

    5655V5000

  • Reported release

    A10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2010-06-28

  • Closed date

    2010-09-24

  • Last modified date

    2010-10-12

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

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

    UK60766

Modules/Macros

  • EQA00A64 EQA00ABE EQA00AEH EQA00AEI EQA00ALO EQA00ANC EQA00ANL
    EQA00BKP EQA00BLD EQA00BLK EQA00BND EQA00B
    
    ***This field was truncated.  To obtain the full apar record, please contact your local support center.***
    

Fix information

  • Fixed component name

    DEBUG TOOL Z/OS

  • Fixed component ID

    5655V5000

Applicable component levels

  • RA10 PSY UK60766

       UP10/09/28 P F009 ¢

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A10","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSTQWA","label":"IBM Debug for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A10","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
15 October 2020