IBM Support

PM57307: Service for Debug Tool 11.1.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • --- Features ---
    
    -The consolidated Language Environment user exit (EQAD3CXT) can
     now register a Debug Tool pattern match routine to Language
     Environment.  Language Environment calls the pattern match
     routine before a invoking PIPI type SUB program. The pattern
     match routine determines whether a debug session is started
     for the program.  Customers can use the user exit to start a
     debug session for type SUB programs in the PIPI environment.
    
    -The EQAOPTS STARTSTOPMSG command has been enhanced with a new
     operand BATCHTSO.  This lets a site delineate between TSO and
     BATCHTSO.
    
    -The LOADDEBUGDATA command has been enhanced to support %CU and
     %PROGRAM substitution for the cu_name operand.
    
    -Add RTTI support to improve the debugging of C++ classes.
    
    -New site customizations for the Terminal Interface Manager
     (TIM).  The default data set name &USERID.DBGTOOL.EQAUOPTS for
     the "Edit LE options data set" option can now be changed by
     the system programmer by using the new -p parameter to
     EQAYSESM.
    
     In addition a new -m parameter to EQAYSESM is now supported to
     indicate that TIM should accept mixed-case passwords.
     (PM61105 at 11.1)
    
    --- End Features ---
    
    --- Service ---
    
    -Remote:  When the same AT ENTRY breakpoint is entered via
     debug console (or a preference file) two or more times, it is
     shown multiple times in the breakpoint view. Thus Debug Tool
     is not realizing that the breakpoint already exists.
     (PM51665 at 11.1)
    
    -Remote GUI:
     Using  code page 1390 in EQAOPTS and have the variable view
     open causes
     +EQA9999E - Debug Tool TCPIP error
     +EQA9999E - FeName=EQACSMTP Loc=220 Func=READ
     +EQA9999E - Err:
     +EQA9999E - IP: x.x.x.x
     +EQA9999E - Port:  8001
     +EQA9999E - UserId: ADCDB    TaskNum: N/A
     +Communications Failure on Read Req.
     (PM53861 at 10.1)
    
    -CICS: When using the DTST transaction for a program, a
     corresponding PPT entry will be created. If the program name
     is invalid or the program does not exist, the new PPT entry is
     not deleted.
     (PM56711 at 10.1)
    
    -CICS: ABENDS0C4 in CEEEVDBG.EQA00EVH at X'11055A' when the key
     of the storage area that the running program tries to access
     is different from that of the running program.
     (PM57074 at 10.1)
    
    -Change EQA9999E TCPIP msg severity level to W.
     (PM57260 at 11.1)
    
    -ABENDS0C1, EQA30STO Internal Error 00000004 received when
     using Debug Tool.
     (PM57532 at 11.1)
    
    -DTU Help panel improvements for panel EQAPBSE2:  The following
     fields are only needed for special scenarios not covered in
     the Installation default setup:
      DFSRESLB DD file list:
      DFSVSAMP DD file     :
      FORMAT   DD file list:
      IMS      DD file list:
      IMSACB   DD file list:
      PROCLIB  DD file list:
      STEPLIB  DD file list:
      SYSEXEC  DD file list:
     (PM58703 at 11.1)
    
    -CICS: When debugging a transaction, a macro calls a program. A
     second macro calls the same program. However, Debug Tool does
     not get invoked during the second macro call.
     (PM59281 at 10.1)
    
    -Exception occurs in Debug Tool module EQA00GDV at offset
     x'AB2'x on an MVC instruction (D225 2024 D3A2). ABENDS0C4
     occurs when the MVC attempts to move data past the end of the
     page boundary.
     (PM59507 at 11.1)
    
    -ABENDS0C4 in EQA50PRE at displacement '2AA2'x when changing
     display (hex or default) in auto monitor prefix area.
     (PM60309 at 11.1)
    
    -Program check exception in EQA00OHC + '32E4'x. Failing
     instruction is TM (9101 A014) due to an invalid address in
     reg10 gpr10
     (PM60412 at 11.1)
    
    -DTCU - 'GAnnotation   Create HTML Annotated Listing Report'
     does not handle COBOL sequence numbers properly.
    
    -In the past the LangCode passed to the EQAUEDAC/EQAUEDAT exit
     for LangX COBOL CU's was sometimes 4, sometimes 41 and
     sometimes 7.  The following LangCodes are now used as
     described:
        4 - COBOL
       41 - LangX COBOL (OS/VS COBOL, VS COBOL II (either LE or
            non-LE, or Enterprise COBOL compiled NOTEST) for which
            an LDD has been done.
    
    -DTCU - 'GTarget       Create HTML Targeted Coverage Report'
     panel should pick up the report output data set name (not the
     summary output data set name).
    
    -The WTOs in EQADDPXT when running PIPI SUB programs will now
     be controlled by the MSGS_SW flag value in the Language
     Environment user exit for DB2 (EQADDCXT). The WTOs in EQADDPXT
     will now be seen only when the MSGS_SW flag value is X'02' in
     EQADDCXT.
    
    -LangX Enterprise COBOL IVPs should use LIST rather than OFFSET
     to match the User's Guide.
    
    -The EQADCDEL program gives users a linkable actions service to
     process DTCN profiles which no longer have a user.  The
     default action for EQADCDEL is to set unowned profiles as
     inactive.  With this change, users can use a new EQAOPTS
     command DTCNDELETEDEADPROF to tell Debug Tool to delete the
     profile.
    
    -Debug session hangs up on startup of Java->COBOL. This is
     caused by an ABEND in EQA00HKS on one thread, which results in
     a deadlock.
    
    --- End Service ---
    
    
    These changes from APAR PM59373 PTF UK76810 are also included:
    
    --- Features ---
    
    -Debug Tool Utilities has been updated to allow the site to
     customize the default data set name for options:
    
       6  Debug Tool User Exit Data Set
    
       B  Delay Debug Profile
    
     for new users.
    
     (FITS: MR0215122321)
    
    --- End Features ---
    
    
    --- Service ---
    
    -The Terminal Interface Monitor (TIM) isn't responding properly
     if the user is not logged on to TIM.
     (PM57723 at 11.1)
    
    -DTCN plugin: Existing but inactive profile can not be
     activated when the customer site has requirements such as
     DTCNFORCETRANID, DTCNFORCEUSERID etc.  enabled via EQAOPTS.
    
     (PM59350 at 11.1)
    
    --- End Service ---
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Debug Tool 11.1 users who need the           *
    *                 features or have the problems described      *
    *                 in the Problem Description.                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: --- Features ---                        *
    *                                                              *
    *                      -The consolidated Language Environment  *
    *                       user exit (EQAD3CXT) can now register  *
    *                       a Debug Tool pattern match routine to  *
    *                       Language Environment.  Language        *
    *                       Environment calls the pattern match    *
    *                       routine before a invoking PIPI type    *
    *                       SUB program. The pattern match         *
    *                       routine determines whether a debug     *
    *                       session is started for the program.    *
    *                       Customers can use the user exit to     *
    *                       start a debug session for type SUB     *
    *                       programs in the PIPI environment.      *
    *                                                              *
    *                      -The EQAOPTS STARTSTOPMSG command has   *
    *                       been enhanced with a new operand       *
    *                       BATCHTSO.  This lets a site delineate  *
    *                       between TSO and BATCHTSO.              *
    *                                                              *
    *                      -The LOADDEBUGDATA command has been     *
    *                       enhanced to support %CU and %PROGRAM   *
    *                       substitution for the cu_name operand.  *
    *                                                              *
    *                      -Add RTTI support to improve the        *
    *                       debugging of C++ classes.              *
    *                                                              *
    *                      -New site customizations for the        *
    *                       Terminal Interface Manager (TIM).      *
    *                       The default data set name              *
    *                       &USERID.DBGTOOL.EQAUOPTS for the       *
    *                       "Edit LE options data set" option can  *
    *                       now be changed by the system           *
    *                       programmer by using the new -p         *
    *                       parameter to EQAYSESM.                 *
    *                                                              *
    *                       In addition a new -m parameter to      *
    *                       EQAYSESM is now supported to indicate  *
    *                       that TIM should accept mixed-case      *
    *                       passwords.                             *
    *                       (PM61105 at 11.1)                      *
    *                                                              *
    *                      --- End Features ---                    *
    *                                                              *
    *                      --- Service ---                         *
    *                                                              *
    *                      -Remote:  When the same AT ENTRY        *
    *                       breakpoint is entered via debug        *
    *                       console (or a preference file) two or  *
    *                       more times, it is shown multiple       *
    *                       times in the breakpoint view. Thus     *
    *                       Debug Tool is not realizing that the   *
    *                       breakpoint already exists.             *
    *                       (PM51665 at 11.1)                      *
    *                                                              *
    *                      -Remote GUI:  Using  code page 1390 in  *
    *                       EQAOPTS and have the variable view     *
    *                       open causes                            *
    *                       +EQA9999E - Debug Tool TCPIP error     *
    *                       +EQA9999E - FeName=EQACSMTP            *
    *                                   Loc=220 Func=READ          *
    *                       +EQA9999E - Err:                       *
    *                       +EQA9999E - IP: x.x.x.x                *
    *                       +EQA9999E - Port:  8001                *
    *                       +EQA9999E - UserId: ADCDB              *
    *                                   TaskNum: N/A               *
    *                       +Communications Failure on Read Req.   *
    *                       (PM53861 at 10.1)                      *
    *                                                              *
    *                      -CICS: When using the DTST transaction  *
    *                       for a program, a corresponding PPT     *
    *                       entry will be created. If the program  *
    *                       name is invalid or the program does    *
    *                       not exist, the new PPT entry is not    *
    *                       deleted.                               *
    *                       (PM56711 at 10.1)                      *
    *                                                              *
    *                      -CICS: ABENDS0C4 in CEEEVDBG.EQA00EVH   *
    *                       at X'11055A' when the key of the       *
    *                       storage area that the running program  *
    *                       tries to access is different from      *
    *                       that of the running program.           *
    *                       (PM57074 at 10.1)                      *
    *                                                              *
    *                      -Change EQA9999E TCPIP msg severity     *
    *                       level to W.                            *
    *                       (PM57260 at 11.1)                      *
    *                                                              *
    *                      -ABENDS0C1, EQA30STO Internal Error     *
    *                       00000004 received when using Debug     *
    *                       Tool.                                  *
    *                       (PM57532 at 11.1)                      *
    *                                                              *
    *                      -DTU Help panel improvements for panel  *
    *                       EQAPBSE2:  The following fields are    *
    *                       only needed for special scenarios not  *
    *                       covered in the Installation default    *
    *                       setup:                                 *
    *                        DFSRESLB DD file list:                *
    *                        DFSVSAMP DD file     :                *
    *                        FORMAT   DD file list:                *
    *                        IMS      DD file list:                *
    *                        IMSACB   DD file list:                *
    *                        PROCLIB  DD file list:                *
    *                        STEPLIB  DD file list:                *
    *                        SYSEXEC  DD file list:                *
    *                       (PM58703 at 11.1)                      *
    *                                                              *
    *                      -CICS: When debugging a transaction, a  *
    *                       macro calls a program. A second macro  *
    *                       calls the same program. However,       *
    *                       Debug Tool does not get invoked        *
    *                       during the second macro call.          *
    *                       (PM59281 at 10.1)                      *
    *                                                              *
    *                      -Exception occurs in Debug Tool module  *
    *                       EQA00GDV at offset x'AB2'x on an MVC   *
    *                       instruction (D225 2024 D3A2).          *
    *                       ABENDS0C4 occurs when the MVC          *
    *                       attempts to move data past the end of  *
    *                       the page boundary.                     *
    *                       (PM59507 at 11.1)                      *
    *                                                              *
    *                      -ABENDS0C4 in EQA50PRE at displacement  *
    *                       '2AA2'x when changing display (hex or  *
    *                       default) in auto monitor prefix area.  *
    *                       (PM60309 at 11.1)                      *
    *                                                              *
    *                      -Program check exception in EQA00OHC +  *
    *                       '32E4'x. Failing instruction is TM     *
    *                       (9101 A014) due to an invalid address  *
    *                       in reg10 gpr10                         *
    *                       (PM60412 at 11.1)                      *
    *                                                              *
    *                      -DTCU - 'GAnnotation   Create HTML      *
    *                       Annotated Listing Report' does not     *
    *                       handle COBOL sequence numbers          *
    *                       properly.                              *
    *                                                              *
    *                      -In the past the LangCode passed to     *
    *                       the EQAUEDAC/EQAUEDAT exit for LangX   *
    *                       COBOL CU's was sometimes 4, sometimes  *
    *                       41 and sometimes 7.  The following     *
    *                       LangCodes are now used as described:   *
    *                          4 - COBOL                           *
    *                         41 - LangX COBOL (OS/VS COBOL, VS    *
    *                              COBOL II (either LE or non-LE,  *
    *                              or Enterprise COBOL compiled    *
    *                              NOTEST) for which an LDD has    *
    *                              been done.                      *
    *                                                              *
    *                      -DTCU - 'GTarget       Create HTML      *
    *                       Targeted Coverage Report' panel        *
    *                       should pick up the report output data  *
    *                       set name (not the summary output data  *
    *                       set name).                             *
    *                                                              *
    *                      -The WTOs in EQADDPXT when running      *
    *                       PIPI SUB programs will now be          *
    *                       controlled by the MSGS_SW flag value   *
    *                       in the Language Environment user exit  *
    *                       for DB2 (EQADDCXT). The WTOs in        *
    *                       EQADDPXT will now be seen only when    *
    *                       the MSGS_SW flag value is X'02' in     *
    *                       EQADDCXT.                              *
    *                                                              *
    *                      -LangX Enterprise COBOL IVPs should     *
    *                       use LIST rather than OFFSET to match   *
    *                       the User's Guide.                      *
    *                                                              *
    *                      -The EQADCDEL program gives users a     *
    *                       linkable actions service to process    *
    *                       DTCN profiles which no longer have a   *
    *                       user.  The default action for          *
    *                       EQADCDEL is to set unowned profiles    *
    *                       as inactive.  With this change, users  *
    *                       can use a new EQAOPTS command          *
    *                       DTCNDELETEDEADPROF to tell Debug Tool  *
    *                       to delete the profile.                 *
    *                                                              *
    *                      -Debug session hangs up on startup of   *
    *                       Java->COBOL. This is caused by an      *
    *                       ABEND in EQA00HKS on one thread,       *
    *                       which results in a deadlock.           *
    *                                                              *
    *                      --- End Service ---                     *
    *                                                              *
    *                                                              *
    *                      These changes from APAR PM59373 PTF     *
    *                      UK76810 are also included:              *
    *                                                              *
    *                      --- Features ---                        *
    *                                                              *
    *                      -Debug Tool Utilities has been updated  *
    *                       to allow the site to customize the     *
    *                       default data set name for options:     *
    *                                                              *
    *                         6  Debug Tool User Exit Data Set     *
    *                                                              *
    *                         B  Delay Debug Profile               *
    *                                                              *
    *                       for new users.                         *
    *                                                              *
    *                       (FITS: MR0215122321)                   *
    *                                                              *
    *                      --- End Features ---                    *
    *                                                              *
    *                                                              *
    *                      --- Service ---                         *
    *                                                              *
    *                      -The Terminal Interface Monitor (TIM)   *
    *                       isn't responding properly if the user  *
    *                       is not logged on to TIM.               *
    *                       (PM57723 at 11.1)                      *
    *                                                              *
    *                      -DTCN plugin: Existing but inactive     *
    *                       profile can not be activated when the  *
    *                       customer site has requirements such    *
    *                       as DTCNFORCETRANID, DTCNFORCEUSERID    *
    *                       etc.  enabled via EQAOPTS.             *
    *                       (PM59350 at 11.1)                      *
    *                                                              *
    *                      --- 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

APAR Information

  • APAR number

    PM57307

  • Reported component name

    DEBUG TOOL Z/OS

  • Reported component ID

    5655W4500

  • Reported release

    B10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2012-02-02

  • Closed date

    2012-03-28

  • Last modified date

    2012-04-03

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

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

    UK77444

Modules/Macros

  • CDEPRDEF CDEPRSS  CKMONCMD EQA00A64 EQA00ABE EQA00AEH EQA00AEI
    EQA00ALO EQA00ANC EQA00ANL EQA00BKP 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

    5655W4500

Applicable component levels

  • RB10 PSY UK77444

       UP12/03/30 P F203 ¢

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":"B10","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":"B10","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
03 April 2012