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

 ENUS202-193.PDF (41KB)

(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:

  • Playback support
  • Automonitor support for COBOL and PL/I programs
  • An interface to the Fault Analyzer tool
  • A new code coverage tool
  • Support for OS/VS COBOL source programs
  • Preparation and compile facilities for programs
  • New commands to query, allocate, and free files

For ordering, contact:

Your IBM representative, an IBM Business Partner, or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).

Overview

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.

Key Prerequisites

  • One of the following:
    • z/OS V1.1 (5694-A01), or later
    • OS/390 V2.10 (5647-A01), or later
  • One of the following:
    • Debug Tool for z/OS and OS/390, V3.1 (5655-H32)
    • Enterprise COBOL for z/OS and OS/390, V3.2, Full Function (5655-G53)
    • Enterprise PL/I for z/OS and OS/390, V3.2, Full Function (5655-H31)
  • Depending on the function used, certain levels of other programs may be required. Refer to the Software Requirements section for details.

Planned Availability Date

September 27, 2002

Description

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.

File Processing Commands: A new set of commands is included that allows the user to query, allocate, and free files.

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® preprocessors.

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.

Note that Value Units of a given product cannot be exchanged/interchanged/aggregated with Value Units of another product.

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.

Trademarks

 
z/OS and MVS are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, CICS, and DB2 are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.

Education Support

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.

Services provided:

  • An IBM consultant will review the installation and configuration of IBM Debug Tool Utilities and Advanced Functions and provide recommendations for changes (if any) based on your current application development environment. The consultant can optionally install the software for you, if desired.
  • Training and hands-on lab exercises for IBM Debug Tool Utilities and Advanced Functions.

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.

Offering Information

Product information will be available on day of announcement through Offering Information (OITOOL) at:

Publications

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:

Technical Information

Specified Operating Environment

Hardware Requirements

Debug Tool Utilities and Advanced Functions for z/OS and OS/390 will run on any hardware configuration supported by the licensed programs specified below.

Software Requirements

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

  • One of the following:
    • z/OS V1.1 (5694-A01)
    • OS/390 V2.10 (5647-A01)
  • One of the following:
    • Debug Tool for z/OS and OS/390 V3.1 (5655-H32)
    • Enterprise COBOL for z/OS and OS/390 V3.2, Full Function (5655-G53)
    • Enterprise PL/I for z/OS and OS/390 V3.2, Full Function (5655-H31)

Corequisite Software for Certain Functions

The following programs are required software for the functions listed:

  • The Code Coverage support requires use of one of the following compilers:
    • C/C++ feature of OS/390 V2.6 through V2.10 (5647-A01)
    • OS/VS COBOL V1.2.4 (5740-CB1)
    • VS COBOL II V1.4.0 (5688-958, 5688-023)
    • COBOL for MVS™ & VM V1 (5688-197)
    • COBOL for OS/390 & VM V2 (5648-A25)
    • Enterprise COBOL for z/OS and OS/390 V3 (5655-G53)
    • High Level Assembler/MVS & VM & VSE R2, R3, and R4 (5696-234)
    • Assembler H V2 (5668-962)
    • OS PL/I V1.5.1 (5734-PL1, 5734-PL3)
    • OS PL/I V2.3 (5688-909, 5688-910)
    • VisualAge® PL/I for OS/390 V2.2 (5655-B22)
    • IBM PL/I for MVS and VM V1.1.1 (5688-235)

Optional Licensed Programs

  • AD/Cycle® C/370™ V1.2 (5688-216)
  • C/C++ for MVS/ESA™ V3 (5655-121)
  • C/C++ feature of OS/390 (5647-A01)
  • C/C++ feature of z/OS (5694-A01)
  • VS COBOL II V1.3.1, V1.3.2, V1.4 (5688-958, 5688-023) — with limitations
  • COBOL for MVS & VM V1 (5688-197)
  • COBOL for OS/390 & VM V2 (5648-A25)
  • Enterprise COBOL for z/OS and OS/390 V3 (5655-G53)
  • High Level Assembler/MVS & VM & VSE (5696-234)
  • OS PL/I V2.1, V2.2, V2.3 (5688-909, 5688-910) — with limitations
  • PL/I for MVS & VM R1.1 (5688-235)
  • VisualAge PL/I for OS/390 V2.2 (5655-B22)
  • Enterprise PL/I for z/OS and OS/390 V3.1 (5655-H31)
  • VisualAge for Java™, Enterprise Edition for OS/390 V2.0 (5655-JAV) — remote debug only

Planning Information

Packaging

The IBM Debug Tool Utilities and Advanced Functions (5655-J18) package includes:

  • Basic machine-readable material on the customer-selected distribution medium
  • A Program Directory (GI10-8494)
  • License Information (GC18-7188)
  • A Proof of Entitlement

Ordering Information

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 eServer 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.

Ordering Example: The total number of Value Units is calculated according to the following example.

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

Example: For a product running on machines with 1,000 MSUs requiring 270 Value Units, order feature number 0001, quantity 20 and feature number 0002, quantity 1.

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:

  • Includes and extends the support services provided in the base support to include technical support via telephone during normal business hours.
  • Entitles customers to future releases and versions at no additional charge. Note: customers are not entitled to new products.

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)

Single Version Charging: To elect single version charging, the customer must notify and identify to IBM the prior program and replacement program and the machine the programs are operating on.

Customized Offerings

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:

  • Determine the MSUs needed for each machine on which the tools will run. Only machines on which the customer has implemented sub-capacity Workstation License Charges (WLC) according to the above terms and conditions, are eligible for charges at less than full machine capacity for the tools.
  • Use the product defined capacity for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.

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:

  • Determine the MSUs needed for the machine on which the tools will run. In a data sharing environment, determine the aggregate MSUs needed on the machine where the tools run. Use the product defined capacity (MSUs) for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each Tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.
  • If the use of sub-capacity pricing terms for AD and DM Tools results in a reduced requirement for Value Units, thus freeing up entitlements, customers can reallocate the entitlement difference by distributing the Value Units across a larger or different set of systems, or reserve them for future growth. There will be no refunds for these freed up Value Units. Subscription and Support volumes and entitlements for existing contracts will continue to be at the same levels as the acquired licenses.

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 z/OS defined capacity is increased.
  • The requirements for WLC sub-capacity charges are no longer met.

Licensing: IBM International Program License Agreement. Proofs of Entitlement (PoE) are required for all authorized use.

The following agreement applies for maintenance and does not require customer signatures:

  • IBM Agreement for Acquisition of Support (Z125-6011)

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.

Limited Warranty Applies: Yes

Program Services: Available until September 30, 2004

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.

Copy and Use on Home/Portable Computer: No

Volume Orders (IVO): No

Passport Advantage Applies: No

Software Maintenance Applies: No

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.

IBM Operational Support Services — Support Line: Yes

AIX®/UNIX® Upgrade Protection Applies: No

Entitled Upgrade for Current AIX/UNIX Upgrade Protection Licensees: No

iSeries Software Subscription Applies: No

Variable Charges Apply: No

Educational Allowance Available: Yes, 15% education allowance applies to qualified education institution customers.

Prices

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)

Global Financing

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:

Order Now

 Use Priority/Reference Code: LE001
 
 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@vnet.ibm.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.

Trademarks

 
The e-business logo, zSeries, z/OS, MVS, C/370, MVS/ESA, and System/370 are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, BookManager, VisualAge, AD/Cycle, S/390, System/390, Systempac, and AIX are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
UNIX is a registered trademark of the Open Company in the United States and other countries.
 
Other company, product, and service names may be trademarks or service marks of others.