IBM Debug Tool for z/VM V4.1 helps to minimize coding errors and increase debugging efficiencyIBM United States Software Announcement 204-212
September 21, 2004
|Table of contents||Document options|
|At a glance|
IBM Debug Tool for z/VM V4.1 helps examine, monitor, and control the execution of application programs by enabling you to:
- Interactively debug an application as it runs
- Perform seamless debugging of mixed-language applications
- Make adjustments to your application while debugging
- Display, monitor, and alter program variables
Debug Tool also supports many programming languages and numerous execution environments.
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at
Back to top
Application programmers need to minimize coding errors while working quickly to meet end-user demands. To effectively manage workloads and build applications, developers need robust, easy-to-use tools to compile, test, and debug their applications.
IBM Debug Tool for z/VM® V4.1 is an interactive source-level debugging tool for compiled
applications. It helps you increase debugging efficiencies and aids in reducing
application-development cycle times. This program testing and analysis aid helps you examine,
monitor, and control the execution of application programs written in C, C++, COBOL, or PL/I on a
z/VM system. By using the disassembly view, Debug Tool can also support programs compiled with the
NOTEST compiler option and applications that include other languages such as Assembler.
Back to top
One of the following:
- IBM z/VM V5.1 (5741-A05), or later
- IBM z/VM V4.4 (5739-A03), or later
|Planned availability date|
September 24, 2004
Back to top
Interactive full-screen debugging: The full-screen interface lets you interactively debug any application as it runs. You can start Debug Tool when an application is initialized, or it can be started dynamically when a condition occurs. The application itself can also start Debug Tool.
The full-screen interface is divided into three windows:
Displays status of items you choose to monitor, such as variables, registers, programs, the execution environment, and Debug Tool settings. You can use this window to watch the content of variables change during program execution.
Displays the program source or disassembly view, with the current statement highlighted. In the prefix area at the left of this window, you can enter commands to set, display, and remove breakpoints.
Records and displays your interactions with Debug Tool and, optionally, shows program output. This window displays the same information recorded in the log file.
The available PF keys are displayed at the bottom of the screen. These provide a basic set of screen manipulation and debugging commands. You can customize the screen display and these keys to suit your testing and development needs.
Separate file support and dynamic debug support: Debug Tool supports COBOL production load modules compiled with the SEPARATE sub-option of TEST, such as TEST(NONE,SYM,SEPARATE). This sub-option causes the compiler to create the debug information in a separate file. In addition, the need to have compiled-in hooks for Debug Tool to control the application has been removed with the addition of the Dynamic Debug Support. The SEPARATE suboption permits debugging of a load module that does not have debug information embedded in the load module. The combination of this new compile option and Dynamic Debug support is aimed to allow you to generate load modules which are smaller in size and do not have compiled-in hooks, while retaining the ability to use all of the features of Debug Tool without compromising the performance of the application when deployed in a production environment.
Source-level debugging: You can monitor source code for C/C++ or a compiler listing for COBOL and PL/I. Compiler listings are an expanded source listing that, in addition to program source, contains copy book source for COBOL or includes file source for PL/I.
Mixed-language applications debugging: Debug Tool supports seamless debugging of mixed-language applications within the same session, and recognizes when the current programming language changes. Language modules not supported by Debug Tool are tolerated; debugging support is provided only through the disassembly view.
Dynamic patching: For each supported programming language, there is a set of interpreted commands that you can use to specify actions to be taken. These commands are subsets of the programming languages, so they are easy to learn, and allow you to make adjustments to your application while you debug it.
You can use the commands to alter the value of variables and structures, and to control the flow of an application. For example, a programmer can declare a new variable and use the variable to patch a program as it executes.
Dynamic breakpoint setting: You can set breakpoints in an application program, monitor variables for changes, and watch for specified exceptions and conditions during program execution. For example, you can cause an application to stop when a specific variable or location in storage is changed. You can set, change, and remove breakpoints as you go through the application. You do not need to know where you want to set a breakpoint before you start.
Single-step debugging: To focus on a problem area, you can step line by line through the execution of an application. For example, when an application stops for a breakpoint, you can carefully examine each line that follows. Single-step debugging, along with the ability to set dynamic breakpoints, allows you to monitor, interrupt, and continue through the flow of the program to identify errors.
Program information gathering: Debug Tool can display program and environment information. You can display, monitor, and alter program variables or storage in real time. You can also check how your application was compiled, and look at its structure.
Session logging: Each debug session can be recorded in a log file for reviewing, editing, or replaying. This allows you to replay the actions taken in a session to pinpoint errors in an application.
General testing: You can also use Debug Tool as a test tool. By using the session logging feature as you debug code, you can save the results of your session for use as input to a future Debug Tool session. As you make changes to your code, you can use the saved log file as input to Debug Tool in order to verify that no unexpected behavior occurs as a result of these changes. Session logging allows you to create suites of regression test cases that you can use to help minimize the number of defects introduced during the normal application development process.
Switch between hexadecimal and decimal display: The following enhancements have been added:
- A command, which can be assigned to a PF key, that enables you to switch the display of data between decimal and hexadecimal.
- Parameters added to the MONITOR command turn hexadecimal representation on or off for data being displayed in the Monitor window.
- Default behavior is changed so data that cannot be displayed in the variable's defined data type is displayed in hexadecimal.
Enhanced LIST cursor command: The RETRIEVE command has been enhanced so that when a LIST CURSOR command is performed on a variable, the retrieval action includes retrieval of the variable and the LIST keyword.
FIND command no longer requires use of quotes:
The Debug Tool's FIND command has been changed so that it no longer
requires quotes around the search string.
Back to top
|Hardware and software support services|
IBM SmoothStart and Installation Services are not provided.
Back to top
Unless otherwise announced by IBM, Debug Tool for z/VM V4 runs under the control of, or in conjunction with, the currently supported releases of the following programs and their subsequent releases or their equivalents. For more information on programs listed below that require program temporary fixes (PTFs), refer to the program directory, the customization guide, and the PSP bucket for this product.
Required licensed programs: One of the following:
- z/VM V5.1 (5741-A05)
- z/VM V4.4 (5739-A03)
Optional licensed programs
- C/C++ for z/VM (5654-A22)
- COBOL for OS/390® & VM V2 (5648-A25)
- High Level Assembler/MVS & VM & VSE (5696-234)
- PL/I for MVS & VM V1.1.1 (5688-235)
Packaging: The Debug Tool for z/VM V4.1 package includes:
- Basic machine-readable material on the customer-selected distribution medium
- Program Directory (GI10-8669)
- Licensed Program Specifications (GC18-9387)
Security, auditability, and control
The announced program uses the security and auditability features of the host operating system
software. The customer is responsible for evaluation, selection, and implementation of security
features, administrative procedures, and appropriate controls in application systems and
Back to top
Order VM SDO and VSE SIPO through the Internet
ShopzSeries provides an easy way to plan and order zSeries® software upgrades. This now includes VM and VSE. Using ShopzSeries, customers can quickly generate orders for VM SDOs and VSE SIPOs. Additionally, ShopzSeries will ensure your order is technically correct (that is, ensures any co-req or pre-req or incompatibility conditions are resolved to ensure timely order placement and processing). ShopzSeries is available in the United States and several countries in Europe. In countries where ShopzSeries is not available yet, contact your IBM representative (or IBM Business Partner) to handle your order via the traditional IBM ordering process. For more details and availability, visit the ShopzSeries Web site at
- Orders for new licenses can be placed now.
- Registered customers can access IBMLink for ordering information and charges.
- Shipment will not occur before availability date.
- Shipment will begin on the planned availability date.
- Unless a later date is specified, orders entered before the planned availability date will be assigned a schedule date of one week following availability.
- Orders entered after the planned availability date will be assigned a schedule date for the week following order entry.
- New users of IBM Debug Tool for z/VM V4 should specify Type 5654, Model A23.
Basic license: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify the feature number of the desired distribution medium shown below.
Processor-based/graduated charges license: To order specify the feature number below that corresponds to the group that contains the designated machine.
Specify the applicable basic graduated monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic graduated MLC
Multiple Operating System PR/SM (MOSP): For a graduated monthly license charge (MLC), specify the feature number below that corresponds to the group that contains the designated machine.
Specify the applicable MOSP graduated monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 MOSP graduated MLC
Note: The group can be determined by referring to either the Exhibit for System/390® Machines (Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) associated with the IBM Customer Agreement (Z125-4575).
Entry support license (ESL): To order an ESL, specify the program number and the applicable ESL one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium.
Specify the applicable ESL OTC license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic OTC, ESL
ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).
Workload license charge (WLC) basic license: Flat WLC features
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic MLC, Flat WLC
Tiered Workload License Charge (TWLC):
Specify the TWLC monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic MLC, TWLC
Growth opportunity license charge (GOLC): To order a basic license, specify the program number and the correct level.
Specify the GOLC monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic MLC, GOLC
zSeries entry license charge (zELC): To order zELC software, specify the program number and z800 model.
Specify the zELC monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic MLC, zELC
Single version charging: To elect single version charging, the customer must notify and identify to IBM the prior program and replacement program and the designated machine the programs are operating on.
Basic machine-readable material
Feature Description number English U.S., ENU -- IBM 3480 Cartridge 5802 1/2-inch CST 34K Kbpi -- Uncompressed
Customization options: Select the appropriate feature numbers to customize your order to specify the delivery options desired. These features can be specified on the initial or MES orders.
Example: If publications are not desired for the initial order, specify feature number 3470 to ship media only. For future updates, specify feature number 3480 to ship media updates only. If, in the future, publication updates are required, order an MES to remove feature number 3480; then, the publications will ship with the next release of the program.
Feature Description number Initial Shipments Serial number only (suppresses shipment 3444 of media and documentation) Ship media only (suppresses initial 3470 shipment of documentation) Ship documentation only (suppresses 3471 initial shipment of media) Update Shipments Ship Media updates only (suppresses 3480 update shipment of documentation) Ship documentation only (suppresses 3481 update shipment of media) Suppress updates (suppresses update 3482 shipment of media and documentation) Expedite Shipments Local IBM office expedite 3445 (for IBM use only) Customer expedite process charge 3446 ($30 charge for each product)
Expedite shipments will be processed to receive 72-hour delivery from the time IBM Software Delivery and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air transportation.
DSLO license: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number that follows for a graduated MLC that corresponds to the group containing the designated machine.
Specify the applicable basic DSLO graduated monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 DSLO graduated MLC
Multiple operating system PR/SM (MOSP)
For a graduated MLC, specify the following feature number that follows that corresponds to the group that contains the designated machine.
Specify the applicable MOSP DSLO graduated monthly license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 MOSP DSLO graduated MLC
Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license will be provided through the basic license location. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.
Extended license charge (ELC) basic license: To order a basic license, specify the appropriate program and feature number, if required, for asset registration. Specify the applicable ELC features. Also, specify the feature number of the desired distribution medium.
Processors with assigned capacity above 80 MSUs will now have VM and VSE software prices based on the CPU service unit capacity of the processor. The ELC price structure will have a Base Charge for 80 MSU capacity and an incremental Per MSU charge for all additional MSUs above the 80 MSU base.
Specify the applicable ELC license option.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for ELC Including z/VM V4 80 MSU, Basic Per User Base ELC Above 80 MSU, Per Usage Additional Quantity ELC Above 80 MSU, Per Block of 50 MSU Additional Quantity
Terms and conditions licensing
The following apply to products ordered with ELC:
- Z125-6018 ICA Attachment for ELCs, which should be signed by the customer
- Z125-6019 ICA Exhibit for ELCs
Unlicensed documentation: A Program Directory (GI10-8669) and Licensed Program Specifications (GC18-9387) is supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.
The following optional publication will be available after product availability:
- Debug Tool for z/VM User's Guide (SC18-9388)
Copies of unlicensed publications will be available for a fee after product availability. These copies may be ordered via direct order or you may contact your IBM representative.
Displayable softcopy publications: All IBM Debug Tool for z/VM V4 publications are available in displayable softcopy format (BookManager®, PDF) on the IBM Debug Tool Web site
Subsequent updates (technical newsletters or revisions between releases)
to the publications shipped with the product will be distributed to the
user of record for as long as a license for this software remains in
effect. A separate publication order or subscription is not needed.
Back to top
|Terms and conditions|
Agreement: IBM Customer Agreement
Variable charges apply: Yes
Indexed monthly license charge (IMLC) applies: No
Location license applies: No
Use limitation applies: No
Educational allowance available: Yes, 15% education allowance applies to qualified education institution customers.
Replaced programs Replacement programs Program Program Program Program name number name number CODE/370 V1 5688-194 IBM Debug Tool 5654-A23 for z/VM V4 IBM Debug Tool 5688-194 IBM Debug Tool 5654-A23 for z/OS(R) for z/VM V4 and OS/390 V1 IBM Debug Tool 5654-A23 To a follow-on if any for z/VM V4
Warranty applies: Yes
Licensed program materials availability
- Restricted Materials of IBM: None
- Non-Restricted Source Materials: None
- Object Code Only (OCO): All
Program services/SoftwareXcel Enterprise Edition or SoftwareXcel Basic Edition
- Support Center applies: Yes. Access is available through the IBM Support Center
- Available until discontinued: 12 months' written notice
APAR mailing address:
P.O. Box 49023
San Jose, CA 95161-9023
- Services for DSLO licenses: Provided through basic license location
IBM operational support services SoftwareXcel:
Back to top
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for Basic graduated MLC, z/VM V4 MOSP graduated MLC, DSLO graduated MLC, MOSP DSLO graduated MLC
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic OTC, ESL S011CMS Debug Tool for z/VM V4 Basic MLC, GOLC S011CMS Debug Tool for z/VM V4 Basic MLC, zELC
Flat workload charge
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for z/VM V4 Basic MLC, Flat WLC
Tiered Workload License Charge (TWLC)
Entitlement License option/ identifier Description pricing metric S011CMS Debug Tool for Basic MLC, TWLC z/VM V4 S011CMS Debug Tool for ELC Including 80 MSU, z/VM V4 Basic Per User Base ELC Above 80 MSU, Per Usage Additional Quantity ELC Above 80 MSU, Per Block of 50 MSU Additional Quantity
OTC: Customers who pay an OTC for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new function may be offered as an optional feature and charged for separately.
Variable charges: The applicable graduated OTC or graduated MLC will be based on the group of the designated machine on which the licensed program is licensed for use. If the program is designated to a processor in a group for which no charge is listed above, the charge of the next higher group listed applies.
For upgrades of OTC licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups.
For downgrades of OTC licenses to a machine in a lower group, there will be no adjustment or refund of OTCs paid.
For upgrades or downgrades of MLC licenses, the MLC applicable to the higher or lower group will apply.
ESL OTC: An OTC authorizes use only on IBM Entry End User/390 machines.
IBM Global Financing
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Offerings include financing for IT acquisition, including hardware, software, and services, both from IBM and other manufacturers or vendors. Offerings (for all customer segments: small, medium, and large enterprise), rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at
IBM Global Financing offerings are provided through IBM Credit LLC in the
United States and other IBM subsidiaries and divisions worldwide to
qualified commercial and government customers. Rates are based on a
customer's credit rating, financing terms, offering type, equipment type,
and options, and may vary by country. Other restrictions may apply.
Rates and offerings are subject to change, extension, or withdrawal
Back to top
To order, contact the Americas Call Centers, your local IBM representative, or your IBM Business Partner.
To identify your local IBM representative or IBM Business Partner, call 800-IBM-4YOU (426-4968).
Phone: 800-IBM-CALL (426-2255) Fax: 800-2IBM-FAX (242-6329) Internet: firstname.lastname@example.org Mail: IBM Americas Call Centers Dept: IBM CALL, 11th Floor 105 Moatfield Drive North York, Ontario Canada M3B 3R1 Reference: LE001
The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.
Note: Shipments will begin after the planned availability date.
Back to top