Feedback

IBM Debug Tool for z/OS V5.1 helps improve application delivery

IBM United States Software Announcement 204-206
September 21, 2004

 

 ENUS204-206.PDF (42KB)

Table of contents   Document options  
At a glance Technical information
Overview Ordering information
Key prerequisites Terms and conditions
Planned availability date Prices
Description Order now
Hardware and software support services  
 
Printable version

 
At a glance

IBM Debug Tool for z/OS V5.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 800-IBM-CALL (Reference: LE001).
 
Back to top
 

Overview

IBM Debug Tool for z/OS® V5.1 is IBM's interactive source-level debugging tool for compiled applications. It is a program testing and analysis aid that helps you examine, monitor, and control the execution of application programs written in C, C++, COBOL, or PL/I on a z/OS or OS/390® system. By using the disassembly view, Debug Tool is also able to provide support for programs compiled with the NOTEST compiler option, or applications that include other languages.

Debug Tool supports debugging of application programs that run in the following environments:

  • CICS®
  • IMS™
  • DB2®
  • WebSphere®
  • TSO
  • JES/batch
  • UNIX® System Services

V5.1 provides the following functional and usability improvements which make Debug Tool an even more productive tool to use:

  • Dynamic debugging support for PL/I and C/C++
  • Improved handling for long compile unit (CU) names for C/C++ and Enterprise PL/I programs
  • %WHERE built-in function
  • Remote debug conditional watch breakpoint support
  • Remote debug COBOL local variable pane performance enhancement
  • Remote debug additional command support
  • Remote debug step/breakpoint log message support

 
Back to top
 
Key prerequisites

One of the following:

  • z/OS V1.1 (5694-A01), or later
  • OS/390 V2.10 (5647-A01)

Depending on the function used, certain levels of other programs may be required. Refer to the Software requirements section for details.


 
Back to top
 

Planned availability date

September 24, 2004
 
Back to top
 

Description

Dynamic debug support for PL/I and C/C++: Debug Tool can now use the Dynamic Debug facility to implement breakpoints during debugging of PL/I and C/C++ programs. Compiler generated hooks are still required. The use of the Dynamic Debug facility can help improve performance of the application while running under control of the debugger.

Improved handling for long CU names for C/C++ and Enterprise PL/I programs: Debug Tool now provides the ability to use a short or a long CU name for programs compiled with all versions of C and C++ compilers, and those compiled with the VisualAge® PL/I and Enterprise PL/I compilers. This will allow you to use a CU name that fully displays in the Session panel header so that you can more easily identify the proper CU.

%WHERE built-in function: The %WHERE built-in function for Assembler and Disassembly has been added in V5.1. This function can be used in a LIST command to resolve a hexadecimal value to an offset from a compilation unit or DSECT. It returns a string indicating where the address specified by the operand is located.

Remote debug conditional watch breakpoint support: The watch breakpoint function has been enhanced to allow the user to specify a condition. A watch breakpoint is used to "watch" N bytes of storage for a change. The number of bytes to watch and an expression that can be resolved to an address are specified when setting a breakpoint. You will also be able to add a simple expression (for example, Var1=10). The breakpoint will only be stopped at when the condition is evaluated to be true.

Remote debug COBOL local variable pane performance enhancement: Performance of the local variable pane in remote debug is improved during a COBOL application debug session.

Remote debug additional command support: Support is added in remote debug to display CU information to the Command Log window when the DESCRIBE CUS command is used. Support is also added in remote debug to display Debug Tool version information to the Command Log window when the CALL %VER command is used.

Remote debug step/breakpoint log message support: To help you determine the reason why control is returned to you during a session, remote debug will now show log messages in the command window when control is returned when a breakpoint is hit.

Debug Tool Utilities and Advanced Functions V5.1: Debug Tool Utilities and Advanced Functions V5.1 is a separate, optional product that builds on the function in Debug Tool V5.1, providing even more debugging capability for z/OS and OS/390 applications. Debug Tool V5.1 is now included in Debug Tool Utilities and Advanced Functions V5.1. For more information on Debug Tool Utilities and Advanced Functions V5.1, refer to Software Announcement 204-207 , dated September 21, 2004.

Section 508 of the U.S. Rehabilitation Act

The Debug Tool for z/OS V5.1 is capable as of its general availability, when used in accordance with IBM's associated documentation, of satisfying the applicable requirements of Section 508 of the Rehabilitation Act, provided that any assistive technology used with the product properly interoperates with it.
 
Back to top
 

Hardware and software support services

SmoothStart™/installation services

IBM SmoothStart and Installation Services are not provided.

Trademarks

 
IMS, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
z/OS, OS/390, CICS, DB2, WebSphere, and VisualAge are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
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.

 
Back to top
 
Technical information

Specified operating environment

Hardware requirements

Debug Tool for z/OS® runs on any hardware configuration supported by the licensed programs specified below.

Software requirements

Unless otherwise announced by IBM, Debug Tool for z/OS V5 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)

Optional licensed programs

Depending on the functions used, one or more of the following programs may be required:

  • 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)
  • CICS® Transaction Server for OS/390 V1.3 (5655-147)
  • CICS Transaction Server for z/OS V2.2 (5697-E93)
  • 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)
  • Debug Tool Utilities and Advanced Functions for z/OS and OS/390 V5.1 (5655-M19)
  • DB2® UDB for OS/390 V6 (5645-DB2)
  • DB2 UDB for z/OS and OS/390 V7 (5675-DB2)
  • DB2 UDB for z/OS V8 (5625-DB2)
  • High Level Assembler/MVS & VM & VSE, V1 (5696-234)
  • IMS/ESA® V7 (5655-B01)
  • IMS™ V8 (5655-C56)
  • OS PL/I V2.1, V2.2, V2.3 (5688-909, 5688-910), with limitations
  • PL/I for MVS & VM V1.1.1 (5688-235)
  • VisualAge® PL/I for OS/390 V2.2 (5655-B22)
  • Enterprise PL/I for z/OS and OS/390 V3 (5655-H31)
  • WebSphere® Studio Enterprise Developer V5.1.1 (5724-B67) with fix for APAR PQ89965 (which is included in interim fix 5.1.1.01)

Planning information

Packaging

The Debug Tool for z/OS V5.1 package includes:

  • Basic machine-readable material on the customer-selected distribution medium
  • Program Directory (GI10-8598)
  • Licensed Program Specifications (GC18-9313)

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 communication facilities.
 
Back to top
 

Ordering information

Ordering z/OS through the Internet

ShopzSeries provides an easy way to plan and order your z/OS ServerPac or CBPDO. It will analyze your current installation, determine the correct product migration, and present your new configuration based on z/OS. Additional products can also be added to your order (including determination of whether all product requisites are satisfied). ShopzSeries is available in the U.S. 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

New licensees

  • 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/OS V5 should specify Type: 5655 Model: M18.

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.

Entry support license (ESL): To order an ESL license, 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
 
S011CMT               Debug Tool              Basic OTC, ESL
                       for z/OS V5

ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).

Parallel Sysplex® license charge (PSLC) basic license: To order a basic license, specify the program number and quantity of MSU.

If there is more than one program copy in a Parallel Sysplex, the charge for all copies is associated to one license by specifying the applicable PSLC license options and quantity represented by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program copies, specify the System Usage Registration No-Charge (SYSUSGREG NC) Identifier on the licenses.

Entitlement                                   License option/
identifier            Description             pricing metric
 
S011CMT               Debug Tool              Basic MLC, PSLC
                       for z/OS V5             below 3 MSU Basic
                                               MLC, PSLC AD
                                               SYSUSGREG NC,
                                               PSLC AD

Workload license charge (WLC) basic license: If there is more than one program copy in a Parallel Sysplex, the charge for all copies is associated to one license by specifying the applicable WLC license options and quantity represented by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program copies, specify the Workload Registration Variable WLC Identifier on the licenses.

Entitlement                                   License option/
identifier            Description             pricing metric
 
S011CMT               Debug Tool              Basic MLC, Variable
                       for z/OS V5             WLC Workload
                                               Registration,
                                               Variable WLC

Entry workload license charge (EWLC) basic license: To order a basic license, specify the program number and the quantity of MSUs.

Entitlement                                   License option/
identifier            Description             pricing metric
 
S011CMT               Debug Tool              Basic MLC,
                       for z/OS V5             Entry WLC

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
 
S011CMT               Debug Tool              Basic MLC,
                       for z/OS V5             GOLC categories

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
 
S011CMT               Debug Tool              Basic MLC,
                       for z/OS V5             zELC models

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
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)
 
                                                    Feature
Description                                         number
 
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.

Unlicensed documentation: A Program Directory (GI10-8598) and Licensed Program Specifications (GC18-9313) is supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.

The following optional publications will be available after product availability:

  • Debug Tool V5 User's Guide (SC18-9302)
  • Debug Tool V5 Reference and Messages (SC18-9304)
  • Debug Tool V5 Summary of Commands and Built-in Functions (SC18-9305)
  • Debug Tool V5 Customization Guide (SC18-9306)
  • Debug Tool V5 Fact Sheet (G325-2408-01)

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/OS V5 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.

Customized offerings

Most product media is shipped only via customized offerings (that is, CBPDO, ServerPac, SystemPac®). Non-customized items (CDs, diskettes, source media, and media kits) will continue to be shipped via the stand-alone product.
 
Back to top
 

Terms and conditions

Agreement: IBM Customer Agreement

Variable charges apply: No

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.

Volume orders: Not applicable

Replaced programs                       Replacement programs
Program   Program                       Program   Program
number    name                          number    name
 
5734-CB4  COBOL                         5655-M18  IBM Debug Tool
           Interactive                             for z/OS V5
           Debug
 
5658-995  Inspect for C                 5655-M18  IBM Debug Tool
           C/370 and                               for z/OS V5
           PL/I V1
 
5688-194  CODE/370 V1                   5655-M18  IBM Debug Tool
                                                   for z/OS V5
 
5688-194  IBM Debug                     5655-M18  IBM Debug Tool
           Tool for z/OS                           for z/OS V5
           and OS/390 V1
 
5655-H32  IBM Debug                     5655-M18  IBM Debug Tool
           Tool for z/OS                           for z/OS V5
           and OS/390 V3
 
5655-L24  IBM Debug Tool                5655-M18  IBM Debug Tool
           for z/OS V4                             for z/OS V5
 
5655-M18  IBM Debug Tool                To a follow-on if any
           for z/OS V5

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:
      IBM Corporation
      APAR Processing
      P.O. Box 49023
      San Jose, CA 95161-9023

IBM Operational Support Services — SoftwareXcel: Yes

Entry workload license charge (EWLC): A revised contract (Attachment for zSeries z800 Software License Charges, Z125-6587-04) is in place for entry workload license charge (EWLC). This revised contract must be signed by the customer.
 
Back to top
 

Prices

For charges, contact your IBM representative.

Entitlement                            License option/
identifier         Description         pricing metric
 
S011CMT            Debug Tool          Basic MLC,
                    for z/OS V5         GOLC categories

 
 
Entitlement                            License option/
identifier         Description         pricing metric
 
S011CMT            Debug Tool          Basic MLC,
                    for z/OS V5         zELC models

Entitlement                            License option/
identifier         Description         pricing metric
 
S011CMT            Debug Tool          Basic MLC, PSLC
                    for z/OS V5         below 3 MSU
                                        Basic MLC, PSLC
                                        AD SYSUSGREG
                                        NC, PSLC AD

Entitlement                            License option/
identifier         Description         pricing metric
 
S011CMT            Debug Tool          Entry End
                    for z/OS V5         User/390 Entry
                                        Support License:

Variable workload license charges

For charges, contact your IBM representative.

Entitlement                            License option/
identifier         Description         pricing metric
 
S011CMT            Debug Tool          Basic MLC,
                    for z/OS V5         Variable WLC
                                        Workload
                                        Registration,
                                        Variable WLC

Sub-capacity charges for VWLC products

Sub-capacity charges for VWLC products are based on product LPAR utilization capacity. Product LPAR utilization capacity for a VWLC product is the highest number of MSUs utilized by the combined LPARs in which a VWLC product runs concurrently during a reporting period. The number of MSUs is based on the highest observed rolling 4-hour average utilization used by the combination of the relevant LPARs during the reporting period. For additional details on IBM workload license charges, refer to:

  • Software Announcement 200-354 , dated October 3, 2000
  • Software Announcement 201-258 , dated September 11, 2001
  • Software Announcement 202-105 , dated April 30, 2002

Sub-capacity charges terms and conditions

zSeries software charges at less than full machine capacity for eligible VWLC products apply when z/OS is running in z/Architecture™ (64 bit) mode on an IBM eServer 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 a VWLC product is based on the utilization of the LPARs where/when the product executes. To obtain charges at less than full machine capacity for VWLC products, the customer is required to:

  • Sign and abide by the terms of the Attachment for zSeries Workload License Charges — Pre-ILM (Z125-6516).
  • Obtain the latest version of the Sub-Capacity Reporting Tool.
  • Install any VWLC product and IBM eServer zSeries 900 Licensed Internal Code (LIC) service required for sub-capacity charging. Required service will be listed on the WLC Web site
  • Collect SMF data as required by the Sub-Capacity Reporting Tool. Retain the collected SMF data for a period of not less than 6 months.
  • Use the IBM provided Sub-Capacity Reporting Tool to process the collected SMF data. The Sub-Capacity Report produced by the tool is used to determine required license capacity for the VWLC products. Required license capacity is determined based on the largest MSU value of a VWLC product running concurrently in all LPARs during the reporting period. IBM reserves the right to request the system data that supports these product defined capacity values for a period of up to six months after the data was collected.
  • Provide an initial Sub-Capacity Report to begin to receive the benefits of less than full machine capacity charges. Sub-capacity charging will follow submission of a Sub-Capacity Report. There will be no retroactive application of sub-capacity charges.
  • Submit Sub-Capacity Reports monthly.
  • Submit Sub-Capacity Reports for all VWLC products with complete data for the entire reporting period to the e-mail address and by the date, specified on the zSeries Software Pricing Web site

    and in the current Workload License Charge Exhibit (Z125-6324). Sub-Capacity Reports that reflect a changed product defined capacity will be considered to be orders placed by the customer without further action on the customer's part and IBM is authorized to make any resulting billing increase or decrease. To place an order for a new license or to discontinue licenses, move licenses between machines, report a hardware model upgrade or enable or disable product features, the customer must contact IBM or their IBM Business Partner

  • Configure machine to send weekly Transmit System Availability Data (TSAD) to IBM via the IBM eServer zSeries 900 Remote Support Facility (RSF), if the machine cannot connect via the RSF, provide this TSAD via an alternate means documented in the z/OS publication "Planning for Workload License Charges" at

Entry workload license charge (EWLC)

For charges, contact your IBM representative.

Entitlement                            License option/
identifier         Description         pricing Metric
 
S011CMT            Debug Tool          Basic MLC,
                    for z/OS V5         Entry WLC

Entry support license 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. 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

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 without notice. For more financing information, visit


 
Back to top
 
Order now

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:  ibm_direct@vnet.ibm.com
 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.

Trademarks

 
C/370, MVS/ESA, MVS, IMS, IBMLink, and z/Architecture are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
z/OS, OS/390, AD/Cycle, CICS, DB2, IMS/ESA, VisualAge, WebSphere, Parallel Sysplex, zSeries, the e-business logo, BookManager, and SystemPac 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.

Back to top
 

 
Printable version