IBM Debug Tool for z/OS V6.1 helps improve application developer productivity
IBM United States Software Announcement 205-216September 13, 2005
 ENUS205-216.PDF (44KB)
|
At a glance(Corrected on December 1, 2005)
 |
| 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 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 to top
|
|
| Key prerequisites |
|
Refer to the
Software requirements
section.
Back to top
|
|
| Planned availability date |
|
November 11, 2005
Back 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 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
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 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 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 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 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 
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 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 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 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
Back to top
Printable version