IBM Debug Tool for z/OS V6.1 helps improve application developer productivity

IBM United States Software Announcement 205-216
September 13, 2005

 

 ENUS205-216.PDF (44KB)

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

(Corrected on December 1, 2005)

A part number was corrected.
 

At a glance

IBM Debug Tool for z/OS V6.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 topBack to top
 

Overview

IBM Debug Tool for z/OS® V6.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.

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

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

V6.1 has added functional and usability improvements which make Debug Tool an even more productive tool to use.
 
Back topBack to top
 

Key prerequisites

Refer to the Software requirements section.
 
Back topBack to top
 

Planned availability date

November 11, 2005
 
Back topBack to top
 

Description

Debug Tool for z/OS V6.1 includes the following new features and enhancements:

Usability

  • Breakpoints, monitors, and settings can now be saved and restored across debug sessions independent of the environment in which Debug Tool is running.
  • A set of prefix commands has been added so that you can interact with the Monitor window. The prefix commands that are available in the Monitor window will generate the corresponding Debug Tool command line command. These new prefix commands provide a better way to interact with the Monitor window.
  • You can now set an AT ENTRY breakpoint without Debug Tool knowing about the program ahead of time. This enhancement makes it easier to specify breakpoints.
  • The SET LONGCUNAME command has been updated to support the AT ENTRY breakpoint.
  • New suboptions have been added to the FIND command to enable you to navigate through searches more effectively. Changes have also been made to make the FIND command more like ISPF's FIND command.
  • The command LIST FREQUENCY * has been enhanced so that it optionally displays the source statement along with the source statement number and the number of times the statement was run.
  • The full-screen mode through a VTAM® terminal facility, which is used to debug non-TSO and non-CICS programs in full-screen mode, is enhanced so that you do not need to know the terminal LU of the VTAM terminal that will be used by Debug Tool. A new session manager will provide a method to attach to the program being debugged via an arbitrary unused VTAM terminal.
  • A CICS Installation Verification Program (IVP) has been added to help you ensure that Debug Tool has been properly installed and customized for the CICS debugging environment.

New function

  • Debug Tool can now debug C and C++ programs compiled with the new DEBUG compile option. The DEBUG compile option was available with C/C++ for z/OS V1.5.
  • The NAMES command has been added to allow you to have some control over the load modules and compile units that Debug Tool displays and debugs. The NAMES EXCLUDE function allows you to inform Debug Tool that certain load modules and/or compile units are not to be debugged (for example, data modules). The NAMES INCLUDE function allows you to inform Debug Tool that certain load modules and/or compile units that would normally be considered nondebuggable are to be debugged as user programs.
  • The AT CHANGE command has been enhanced to support level 88 data items.
  • Support has been added to debug PL/I applications where the programs in the application are compiled with a mixture of new and old IBM PL/I compilers such as IBM Enterprise PL/I for z/OS V3, IBM VisualAge® PL/I for z/OS V2, IBM PL/I for MVS™ and VM V1, and IBM OS PL/I V2.
  • Debug Tool now supports PL/I production load modules compiled with the SEPARATE suboption of TEST. This suboption causes the compiler to create the debug information in a separate file. 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 the existing dynamic debug support allows 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.
  • If your users use DTCN to specify debugging profiles, you can customize Debug Tool to require that your users specify some or all resource types. For example, if your users are debugging a heavily used CICS program, you can require that they specify a Terminal ID and a Transaction ID to avoid having Debug Tool started every time that a CICS program is run.
  • Remote debug support is enhanced to:
    • Allow you to specify the code page for proper rendering of national language characters on the remote debugger window.
    • Allow you to edit attributes of existing breakpoints.
    • Delay conditional expression evaluation until the potential breakpoint execution. This allows expressions which may be out of scope when the breakpoint is set.

Debug Tool Utilities and Advanced Functions V6.1

Debug Tool Utilities and Advanced Functions V6.1 is a separate, optional product that builds on the function in Debug Tool V6.1, providing even more debugging capability for z/OS and OS/390 applications. Debug Tool V6.1 is included in Debug Tool Utilities and Advanced Functions V6.1. For more information on Debug Tool Utilities and Advanced Functions V6.1, refer to Software Announcement 205-217 , dated September 13, 2005.

Section 508 of the U.S. Rehabilitation Act

The product in this announcement 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 topBack to top
 

Hardware and software support services

SmoothStart™/installation services

IBM SmoothStart and Installation Services are not provided.

Business Partner information

If you are a Direct Reseller - System Reseller acquiring products from IBM, you may link directly to Business Partner information for this announcement. A PartnerWorld ID and password are required (use IBM ID).

BP Attachment for Announcement Letter 205-216

Trademarks

 
IMS, MVS, 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, VTAM, 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 topBack 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 V6 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 (5694-A01)
  • OS/390® V2.10 (5647-A01)

Note: OS/390 V2 and z/OS releases prior to V1.4 are out of service.

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++ element of OS/390 (5647-A01)
  • C/C++ element of z/OS (5694-A01)
  • CICS® Transaction Server for OS/390 V1.3 (5655-147)
  • CICS Transaction Server for z/OS V2.2 and V2.3 (5697-E93)
  • CICS Transaction Server for z/OS V3.1 (5655-M15)
  • VS COBOL II V1.3.1, V1.3.2, V1.4 (5668-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 V3 (5655-G53)
  • Debug Tool Utilities and Advanced Functions for z/OS V6.1 (5655-P15)
  • 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.4 and V1.5 (5696-234)
  • IMS™ V7 (5655-B01)
  • IMS V8 (5655-C56)
  • IMS V9 (5655-J38)
  • OS PL/I V2.1, V2.2, V2.3 (5668-909, 5668-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 V3 (5655-H31)
  • WebSphere® Studio Enterprise Developer V5.1.1 with fix for APAR PQ89965 or V5.1.2 (5724-B67)
  • WebSphere Developer for zSeries® V6.0 (5724-L44)

Planning information

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

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

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 topBack 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 the 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 V6 should specify:
    • Type: 5655
    • Model: P14

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.

Parallel Sysplex® License Charge (PSLC) basic license: To order a basic license, specify the program number and quantity of Service Units in Millions (MSUs).

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 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
 
S0121TL          Debug Tool for        Basic MLC, PSLC below 3 MSU
                  z/OS V6              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
 
S0121TL          Debug Tool            Basic MLC, Variable WLC
                  for z/OS V6          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
 
S0121TL          Debug Tool for        Basic MLC, Entry WLC
                  z/OS V6

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
 
S0121TL          Debug Tool for        Basic MLC, GOLC
                  z/OS V6

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
 
S0121TL          Debug Tool for        Basic MLC, zELC
                  z/OS V6

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

Orderable                 Distribution
supply ID    Language     medium         Description
 
S012BNV      US English   3480 Tape      Debug Tool for
                           Cartridge      z/OS V6
S0121SZ      Japanese     3480 Tape      Debug Tool for
                           Cartridge      z/OS V6

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.

Unlicensed documentation: A Program Directory (GI10-8680) and Licensed Program Specifications (GC18-9546) are 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 V6 User's Guide (SC18-9534)
  • Debug Tool V6 Reference and Messages (GC18-9536)
  • Debug Tool V6 Summary of Commands and Built-in Functions (SC18-9537)
  • Debug Tool V6 Customization Guide (SC18-9538)

IBM Publications Center

The Publications Center is a worldwide central repository for IBM product publications and marketing material with a catalog of 70,000 items. Extensive search facilities are provided. Payment options for orders are via credit card (in the U.S.) or customer number for 50 countries. A large number of publications are available online in various file formats, and they can all be downloaded by all countries free of charge.

The IBM Publications Notification System (PNS) enables subscribers to set up profiles of interest by order number or product number. PNS subscribers automatically receive e-mail notifications of all new publications defined in their profiles. These may then be ordered or downloaded from the Publications Center

The site is available in English and Canadian French.

Displayable softcopy publications: All IBM Debug Tool for z/OS Version 6 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®). Noncustomized items (CDs, diskettes, source media, and media kits) will continue to be shipped via the stand-alone product.
 
Back topBack 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, a 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-P14     IBM Debug Tool
            Interactive                     for z/OS V6
            Debug
 
5658-995   Inspect for C/370  5655-P14     IBM Debug Tool
            and PL/I V1                     for z/OS V6
 
5688-194   CODE/370 V1        5655-P14     IBM Debug Tool
                                            for z/OS V6
 
5688-194   IBM Debug Tool     5655-P14     IBM Debug Tool
            for z/OS and                    for z/OS V6
            OS/390 V1
 
5655-H32   IBM Debug Tool     5655-P14     IBM Debug Tool
            for z/OS and                    for z/OS V6
            OS/390 V3
 
5655-L24   IBM Debug Tool     5655-P14     IBM Debug Tool
            for z/OS V4                     for z/OS V6
 
5655-M18   IBM Debug Tool     5655-P14     IBM Debug Tool
            for z/OS V5                     for z/OS V6
 
5655-P14   IBM Debug Tool     To a follow-on if any
            for z/OS V6

Warranty applies: Yes

Licensed program materials availability

  • Restricted Materials of IBM: None
  • Nonrestricted Source Materials: None
  • Object Code Only (OCO): All

Program services

  • 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 — SupportLine: 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 topBack to top
 

Prices

Entitlement                            License option/
identifier        Description          pricing metric
 
S0121TL           Debug Tool for       Basic MLC, GOLC
                   z/OS V6

Entitlement                            License option/
identifier        Description          pricing metric
 
S0121TL           Debug Tool for       Basic MLC, zELC
                   z/OS V6

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

Variable Workload License Charges

Entitlement                            License option/
identifier        Description          pricing metric
 
S0121TL           Debug Tool for       Basic MLC, Variable WLC
                   z/OS V6             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.

Refer to Software Announcement 200-354 , dated October 3, 2000, Software Announcement 201-258 , dated September 11, 2001, and Software Announcement 202-105 , dated April 30, 2002, for additional details on IBM Workload License Charges.

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 (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 six 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)

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

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, from both 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 site

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, please visit


 
Back topBack 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, VisualAge, WebSphere, zSeries, Parallel Sysplex, BookManager, the e-business logo, 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 topBack to top
 

 
Printable version Printable version