Summary of changes

Start of change

Changes introduced with the PTF for APAR PI29800

  • Support is added for debugging subtasks initiated by the ATTACH assembler macro. Multiple subtasks might be debugged concurrently, as well as the parent task.
  • Delay debug mode is enhanced to support non-LE programs in certain circumstances.
End of change
Start of change

Changes introduced with the PTF for APAR PI24559

  • Start of changeDelay debug mode is enhanced to include C functions. In addition, a load module name can now be paired with a program name or C function in the delay debug data set.End of change
  • Start of changeTerminal Interface Manager Start of changenowEnd of change allows the same user to log on multiple times on separate terminals. This allows multiple tasks to be debugged by the same user ID simultaneously.End of change
  • Start of changeSupport is added for Automonitor for C/C++. End of change
  • Start of changeM/L prefix commands are enhanced to support these prefix commands for C/C++. End of change
  • Start of changeThe CICS DTST transaction that is used to display, scan and modify CICS storage is enhanced to support 64 bit addresses.End of change
  • Start of changeCode Coverage support is added for Enterprise COBOL for z/OS Version 5.End of change
  • Start of changeCALL %FA command is enhanced to support remote debug mode.End of change
  • Start of changeAT GLOBAL LABEL, AT LABEL, CLEAR AT GLOBAL LABEL, CLEAR AT LABEL, LIST AT GLOBAL LABEL, LIST AT LABEL and LIST NAMES LABEL commands are enhanced to support remote debug mode.End of change
End of change

Changes introduced with the PTF for APAR PI16543

Start of change
  • Support is added for CICS TS 5.2.
  • The DTCN Remote Plug-in is enhanced to support the use of SYSID (the SYSIDNT of a region in a CICSPLEX ) to select CICS tasks to debug.
  • The DTCN Remote Plug-in is enhanced to support additional CICS "Application" resource types that are introduced in CICS TS 5.2.
    You can use these new resource types to select a program to debug:
    • Platform
    • Application
    • Operation
    • Version
  • Code Coverage support for interactive remote.
  • Code Coverage support for z/OS XL C.
  • SET LIST BY SUBSCRIPT ON support for COBOL for MFI. This includes QUERY LIST BY SUBSCRIPT support.
  • The CLIENTID option is added to the EQAOPTS DLAYDBGXRF command. This option allows a remote Debug Tool user using the enhanced DTSP Plug-in to identify a specific DB/2 client ID, and to only trap DB/2 stored procedures executed using that client ID.
End of change

Changes introduced with the PTF for APAR PI06312

  • The REPOSITORY option is added to the EQAOPTS DLAYDBGXRF command. This option instructs Debug Tool to communicate with the Terminal Interface Manager to determine whether a user requests to debug an IMS™ transaction or DB/2 stored procedure associated with a generic user ID. This is an alternative to using the cross reference table data set.
  • The Swap IMS Transaction Class and Run Transaction utility is enhanced to allow the user to manipulate the TEST option that is used for the debug message region. This allows the user to supply commands or preference files, and to direct the Debug Tool session to the remote user interface or to an alternate Terminal Interface Manager user ID.
  • For CICS, provide protection of storage that was GETMAINed in the current task by a program that is not the active program. This support is enabled via INITPARM=(EQA0CPLT='STG') in the CICS startup parameters and is only available during a remote debug session.
  • <PROGRAMDSCOMPILEDATE> and <PROGRAMDSCOMPILETIME> tags are added to the XML tags for code coverage. These two tags specify the compile data and time of the program source that is contained in the program data set.
  • Support is added for generating a client certificate to the remote debugger if it does not exist.
  • A note is added to the Coverage Utility User's Guide and Messages about the accuracy of execution counts (frequency counts) for single statement Program Areas (PAs).

Changes introduced with Debug Tool for z/OS Version 13.1

  • A method for gathering code coverage is added for the generation, viewing, and reporting of code coverage by using the Debug Tool mainframe interface (MFI) as the engine. This support is provided for applications written in Enterprise COBOL and Enterprise PL/I that are compiled with the TEST compiler option and its suboption SEPARATE. This is enabled via the new EQAOPTS CCPROGSELECTDSN, CCOUTPUTDSN, and CCOUTPUTDSNALLOC commands.
  • Debug Tool is enhanced to provide the automatic start of IMS message processing program (MPP) regions and dynamic routing of transactions. This allows a developer to dynamically start an MPP region, route a transaction to that MPP region, and at the end of the transaction shutdown the MPP region created for the developer thus reducing system resources.
  • To help with the ease of use of the MFI mode of Debug Tool for some users, an option is added that enables breakpoints, the current line, and the line with found text to be identified by a character indicator. This feature is enabled via a new EQAOPTS ALTDISP command.
  • Debug Tool is enhanced to support the following languages and platforms:
    • Enterprise COBOL for z/OS® V5.1
    • Enterprise PL/I for z/OS V4.4
    • CICS® TS V5.1
    • DB2® V11
    • IMS V13
    • z/OS, V2.1
    • C/C++ V2.1
  • Debug Tool is enhanced to support JCL for Batch Debugging in the DTSP plug-in. This facility is used to instrument JCL to initiate a debug session from the DTSP plug-in.
  • Support is added for an IMS transaction that is associated with a generic ID. A new feature is added to the consolidated Language Environment® user exit (EQAD3CXT) to search a new cross-reference table for the user ID of a user who wants to debug a IMS transaction that is started from the web and is associated with a generic ID. This enables Debug Tool to debug these transactions that use a generic ID. The user ID from the cross-reference table is used to find the user's Debug Tool user exit data set (userid.DBGTOOL.EQAUOPTS), which specifies the TEST runtime parameters and the display device address. An option is added to the Debug Tool Utilities ISPF panel, "C IMS Transaction and User ID Cross Reference Table", to allow each user to update the new cross reference table.
  • Support is added for tracing load modules loaded by an application. Commands TRACE LOAD and LIST TRACE LOAD are added for Debug Tool's MFI mode. This set of commands allows the user to get a trace of load modules loaded by the application. Start the trace by issuing TRACE LOAD START. Use LIST TRACE LOAD to display the trace. The trace includes load modules known to Debug Tool at the time the TRACE LOAD START command is entered and all that are loaded while the trace is active. End the trace by issuing TRACE LOAD END. Note that when the trace is ended, all trace information is deleted.
  • Support is added for terminating an idle Debug Tool session that uses the Terminal Interface Manager. Debug Tool supports a timeout option via the EQAOPTS SESSIONTIMEOUT command. This command allows the system programmer to establish a maximum wait time for debug sessions that use a dedicated terminal or the Terminal Interface Manager. If the debug session exceeds the specified time limit without any user interaction, the session will be terminated with either a QUIT or QUIT DEBUG.
  • Debug Tool Coverage Utility "Create HTML Targeted Coverage Report" is enhanced to allow the user to select from a list of COBOL Program-IDs, ignore changes to non-executable code, and produce a summary of the targeted lines with selectable HTML links.
  • Adds IMS information to start and stop messages generated by the EQAOPTS STARTSTOPMSG command.
  • Adds EQAOPTS STARTSTOPMSGDSN command and a Debug Tool Utilities option "Non-CICS Debug Session Start and Stop Message Viewer" to collect and view Debug Tool debugger session start and stop information.
  • Delay debug mode is enhanced with an EQAOPTS DLAYDBGCND command to control CONDITION trapping. In addition, an EQAOPTS DLAYDBGXRF command is added so that delay debug mode can use the "IMS Transaction and User ID Cross Reference Table". Further, NOTEST is now handled in delay debug mode.
  • A confirmation message is added to Debug Tool Utilities Option 6 "Debug Tool User Exit Data Set" to indicate that the updates have been saved into the EQAUOPTS data set.
  • The ON and AT OCCURRENCE commands are enhanced for Enterprise PL/I to support qualifying data.
  • LIST LDD and CLEAR LDD commands are added to display and remove LDD commands known to Debug Tool. LIST CC, CC START, and CC STOP commands are added to gather and display code coverage data.
  • Two EQAOPTS commands are added for remote debug mode. The EQAOPTS HOSTPORTS command specifies the specific host port number or range of host port numbers on the host for a TCP/IP connection from the host to a workstation. The EQAOPTS TCPIPDATADSN command provides the data set name for TCPIP.DATA via the SYSTCPD DD NAME when no GLOBALTCPIPDATA statement is configured.
  • A timestamp is added to the EQAY999* messages that the Terminal Interface Manager issues if the +T trace flag is on.
  • Debug Tool is enhanced to allow for using GOTO or JUMPTO command for programs that are compiled with OPT and NOEJPD suboptions of the Enterprise COBOL TEST compile option when SET WARNING setting is OFF.
  • An updated DTST transaction is included to write messages to the operator log when a user changes storage. These messages are intended to provide an audit trail of DTST storage changes.
  • Support is added for remote Playback through the Playback Toolbar in the Debug View.
  • The EQALANGP and EQALANGX modules are moved from Debug Tool's EQAW.SEQAMOD library to Common Component's IPV.SIPVMODA library. They are now aliases of IPVLANGP and IPVLANGX respectively. This removes duplication between the two tools.
  • Appendix "Quick start guide for compiling and assembling programs for use with IBM Problem Determination Tools products" in the Debug Tool User's Guide is removed because this has been placed in the IBM Problem Determination Tools for z/OS Common Component: Customization Guide and User Guide instead.