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)
|
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
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
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
September 24, 2004
Back to top
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
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
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 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
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
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 
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 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 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
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.
At a glance
