IBM United States
Software Announcement 202-193
August 20, 2002
IBM Debug Tool Utilities and Advanced Functions V3.1 Helps Maximize Availability of z/OS and OS/390 Applications
(Corrected on December 20, 2002)
The Key Prerequisites and Software Requirements sections were updated.
At a Glance
IBM Debug Tool Utilities and Advanced Functions for z/OS and OS/390, V3.1 provides additional debugging capabilities that help to maximize availability of z/OS and OS/390 applications. This software provides:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).
IBM Debug Tool Utilities and Advanced Functions for z/OS and OS/390®, V3.1 is IBM's newest product for source-level debugging for compiled applications.
This software builds on the function in IBM Debug Tool for z/OS and OS/390 V3.1, to provide even more debugging capability, helping to maximize the availability of z/OS and OS/390 applications.
Playback Support: This support allows you to replay and review the application execution paths. For programs compiled with COBOL for MVS and VM or later, you can also review data values. This allows you to simulate the backward execution of the application and review application data values using appropriate Debug Tool commands.
AutoMonitor Support for COBOL and PL/I: For programs compiled with the latest COBOL and PL/I compiler releases, this support automatically displays, in the Monitor window, the values of the variables referenced in the current statement. The values are displayed when Debug Tool gets control (for example, when you step to a statement or when a breakpoint is reached). Data items referenced by the current statement while the automonitor is in effect are automatically selected for monitoring and are displayed in the Debug Tool Monitor window and/or the Debug Tool log. Those explicitly selected for monitoring will also be displayed in the Monitor window.
Fault Analyzer Interface: A new command has been added to interface with the Fault Analyzer product. You can use this command to have Fault Analyzer create a symbolic dump that you can analyze using Fault Analyzer utilities.
Code Coverage: The new Debug Tool Coverage Utility measures code coverage in application programs written in COBOL, PL/I, C, C++, and z900 Assembler and compiled with specific IBM compilers and assemblers.
Support for OS/VS COBOL and Other Old COBOL Programs: Source programs written for OS/VS COBOL are supported for debugging by a "Convert and Compile" option. This option includes source conversion during the compile step. The compilation is done using either Enterprise COBOL for z/OS and OS/390 or COBOL for OS/390 and VM and then the converted OS/VS COBOL source programs can be debugged using Debug Tool. In addition, once the debugging is completed you can choose to continue using the OS/VS COBOL compiler, or since you have already debugged the new module and know it works, you can use the new level of source code that was produced during the compilation and use a newer compiler. One by one you will eventually convert all of your OS/VS COBOL source code to the latest compilers! This feature will also support ANY level of COBOL source program as input, including VS COBOL II, COBOL for MVS and VM, and COBOL for OS/390 and VM programs that were previously compiled with the CMPR2 compiler option. This source conversion can also be done separately from the compile step if you choose.
Preparation and Compilation Facilities for Programs:
Preparation and compile facilities are included that provide
functions that can be used to compile and link your COBOL, PL/I, C, and
C++ programs. They also provide you access to CICS® and DB2®
Value Unit Based Pricing
Value Unit based pricing will help to align the prices of these products to the principle of the PSLC pricing curve which provides for a lower price per MSU (millions of service units per hour) for larger capacities.
There is also a price benefit when customers grow their capacity. Additional capacity will be based on the number of Value Units (MSUs) the customer has already installed, for example, additional capacity will not be priced starting at the base with a higher price per unit but on the capacity that is already installed.
International Program License Agreement (IPLA) and Subscription and Support Considerations
IPLA licenses can be transferred from one machine to another within, but not limited to an enterprise. The customer may aggregate the capacity for all the processors the product is operated on to achieve a more economic price. This will result in a single Proof of Entitlement. It is the customer's responsibility to manage the distribution of Value Units within the limits of the entitlement of the product license.
Subscription and Support must cover the same capacity as the product license entitlement. Subscription and Support will be available in the country in which the agreement is made.
Consulting and Services
IBM consultants offer a training workshop for IBM Debug Tool Utilities and Advanced Functions for z/OS and OS/390®.
IBM Debug Tool Mentor Workshop: An IBM consultant will train up to ten personnel in the use of IBM Debug Tool Utilities and Advanced Functions for z/OS and OS/390. Your team will get an overview of the product's features and will learn to use it. If desired, the consultant can also install the software in your environment.
The services offerings are quick-start, hands-on training for your developers that help to promote Debug Tool Utilities and Advanced Functions understanding and acceptance. Get started today and maximize your staff's productivity by leveraging IBM's experienced consultants.
Product information will be available on day of announcement through Offering Information (OITOOL) at:
The Program Directory (GI10-8494) and License Information (GC18-7188) are supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.
Displayable Softcopy Publications: All IBM Debug Tool Utilities and Advanced Functions for z/OS and OS/390 V3 publications are available free of charge in displayable softcopy format (BookManager®, PDF) on the IBM Debug Tool Web site:
Specified Operating Environment
Unless otherwise announced by IBM, Debug Tool Utilities and Advanced Functions for z/OS and OS/390 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
The following programs are required software for the functions listed:
Optional Licensed Programs
The IBM Debug Tool Utilities and Advanced Functions (5655-J18) package includes:
The programs in this announcement have one charge unit Value Units.
Value Unit Exhibit VUE007
Value Value Units/ Units/ Usage Level Minimum Maximum MSU HW Machine Base 1 3 1 MP3000 H30 6 PSLC/Level A 4 45 0.45 MP3000 H50 8 PSLC/Level B 46 175 0.36 MP3000 H70 12 PSLC/Level C 176 315 0.27 ESL Models 2 PSLC/Level D 316 + 0.2
Value Units for IBM 9672 Processors will be based upon the full capacity of these systems. This is applicable to all S/390®-based systems that are measured on MSU capacity. Information on MSU capacities can be found in the "IBM System/370, System/390® and zSeries Machine Exhibit", Z125-3901.
Value Units for IBM zSeries will be based upon full MSU capacity as defined in the Machine Exhibits.
There will be a tool available that provides support for transforming the MSU-based capacities of S/390 systems to new Value Units by calculating the applicable number of Value Units for a given number of MSUs.
Translation from MSUs to Value Units Example
Value MSUs Units/MSU Base 1-3 1.00 Tier A 4-45 .45 Tier B 46-175 .36 Tier C 176-315 .27 Tier D 316+ .20
Note: For the actual translation from MSUs to Value Units for this product, refer to below.
If the customer has installed 1,000 MSUs, the applicable Value Units would be:
Translation from MSUs to Value Units
Value Value MSUs * Units/MSU = Units Base 3 * 1.00 = 3.00 Tier A 42 * .45 = 18.90 Tier B 130 * .36 = 46.80 Tier C 140 * .27 = 37.80 Tier D 685 * .20 = 137.00 Total 1,000 244
When calculating the total number of Value Units, the sum is to be rounded up to the next integer.
Feature 1 Value Unit 0001 250 Value Units 0002
Note: For actual feature numbers, refer to below.
Value Units for non-MSU-based S/390 Processors:
MP3000 Models H30 = 6.00 Value Units H50 = 8.00 Value Units H70 = 12.00 Value Units P/390, R/390, IBM 3006 = 2.00 Value Units
Basic License: To order, specify the program number, feature number 9001 for asset registration, and the one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium. To suppress shipment of media, select the license-only option in CFSW.
Translation from MSUs to Value Units
Value MSUs Units/MSU Base 1-3 1.00 Tier A 4-45 .45 Tier B 46-175 .36 Tier C 176-315 .27 Tier D 316+ .20
One- Time Charge Medium Program Feature Feature Description Number Number Number Medium Debug Tool 5655-J18 5832 3480 Utilities tape and Advanced Functions 1 Value Unit 0001 250 Value Units 0002
Subscription and Support
To receive voice technical support via telephone during normal business hours, and future releases and versions at no additional charge, Subscription and Support must be ordered. The capacity of Subscription and Support (Value Units) must be the same as the capacity ordered for the product licenses.
To order, specify the support program number and feature number 9001 for asset registration. IBM is also providing subscription and support for these products via a separately purchased offering under the terms of the IBM International Agreement for Acquisition of Support (IAAS). This Offering:
Once subscription and support is ordered, the charges will renew automatically annually unless cancelled by the customer.
To decline, specify the support program number and the decline no charge feature number listed below.
Annual Support Charge Medium Program Feature Feature Description Number Number Number Medium Subscription 5655-J19 6727 Hardcopy and Support Pub for Debug Tool Utilities and Advanced Functions 1 Value Unit 0001 250 Value Units 0002 Decline 0003 (no charge)
Product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
Sub-Capacity Charges Terms and Conditions
zSeries software charges at less than full machine capacity for eligible Data Management (DM) and Application Development (AD) Tools apply when z/OS is running in z/Architecture (64 bit) mode on a zSeries 900, no other MVS-based operating system is licensed to that server and the required information is provided by the customer in accordance with the applicable terms.
Sub-capacity charges for an eligible AD or DM Tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for eligible AD and DM tools, the customer is required to:
Sub-Capacity Charges for AD and DM Tools
To be eligible for sub-capacity charges for AD and DM Tools, the machine on which the AD and DM Tools are running must be eligible for WLC sub-capacity charges terms and conditions. The customer must have signed the Attachment for zSeries Workload License Charges-Pre-ILM, Z125-6516, and submitted at least one Sub-Capacity Report to IBM as defined in the attachment.
With sub-capacity charges, the charge for an eligible AD or DM Tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for each eligible AD and DM Tool for each machine, the customer should:
Management of the Value Unit entitlements continues to be a customer responsibility. If one of the following occur on a machine to which AD or DM Tools are licensed, the customer must determine if additional Value Units and Subscription and Support need to be ordered for those tools to cover the increase:
The following agreement applies for maintenance and does not require customer signatures:
These products are licensed under the IBM Program License Agreement (IPLA), and the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6312) which provides for support with ongoing access to releases and versions of the program. These programs have a one-time license charge for use of the program and an ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program as long as support is in effect. S/390 and zSeries IBM Operational Support Services Support Line is an option for those customers who desire added services.
Money-Back Guarantee: If for any reason you are dissatisfied with the Program, return it within 30 days from the invoice date, to the party (either IBM or its reseller) from whom you acquired it, for a refund. This applies only to your first acquisition of the Program.
For Operating System software, the revised IBM Operational Support Services Support Line offering will provide support for those operating systems and associated products that are not available with the newly announced Software Maintenance offering. This will ensure total support coverage for your enterprise needs, including IBM and selected non-IBM products. For complete lists of products supported under both the current and revised Support Line offering, refer to our Web site at:
For additional information on the revised IBM Operational Support Services, refer to Services Announcement 601-023 , dated July 10, 2001.
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.
One- Time Charge One- Program Feature Time Description Number Number Charge IBM Debug Tool 5655-J18 Utilities and Advanced Functions V3 1 Value Unit 0001 $ 500 250 Value Units 0002 125,000
Annual Charge Program Feature Annual Description Number Number Charge Subscription 5655-J19 and Support for IBM Debug Tool Utilities and Advanced Functions V3 1 Value Unit 0001 $ 75 250 Value Units 0002 18,750 Decline 0003 0 (no charge)
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our 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:
Use Priority/Reference Code: LE001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: email@example.com Mail: IBM Atlanta Sales Center Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690
You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU.
Note: Shipments will begin after the planned availability date.