IBM United States
Software Announcement 201-340
November 27, 2001
IBM Debug Tool for z/OS and OS/390 V1R3
At a Glance
A new release of IBM Debug Tool for z/OS and OS/390 adds the following support on z/OS and OS/390:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
IBM Debug Tool for z/OS and OS/390® V1R3 is IBM's debugger for compiled applications. Debug Tool supports applications written in C/C++, COBOL, High Performance Java (HPJ), and PL/I today. With this announcement, Debug Tool supports assembler (via disassembly view). Debug Tool is the new name for CODE/370.
Debug Tool V1R3 delivers many new functions requested by customers. Included in this release are:
New Product Name for V1R3
With V1R3 the product name has changed to more accurately reflect the
functionality currently available in the product. In V1R1 and V1R2, this
product was known as CoOperative Development Environment/370 (CODE/370).
Starting with V1R3, the product is now known as IBM Debug Tool for z/OS
What's New in V1R3
Debug Tool supports the new COBOL Enterprise for z/OS and OS/390 V3, and Enterprise PL/I for z/OS and OS/390 V3. These new compilers and their corresponding run times have included new support for multithreaded applications to support e-business applications, interoperability with Java on z/OS and OS/390, as well as unicode application data. The Java interoperability requires the use of the remote debug interface.
Debug Tool can now debug COBOL production load modules where the new compiler option has been utilized to create the debug information in a separate file. This option, called "Dynamic Debug" in Debug Tool, permits debugging of a load module that does not have debug information embedded in the load module. Many customers have requested this function, which requires use of a new COBOL compiler option at compile time.
Interactive debug of JES applications is now supported for the 3270 terminal interface. In addition, this facility permits debug of DB2® stored procedures and IMS transactions (without BMS) from the 3270 terminal interface.
The Debug Tool setup utility helps you create a setup file that contains information about your program. The setup file contains information on file allocation, run-time options, program parameters, and the name of the program to be executed. The setup utility also provides a run command which can perform the file allocations and then invoke the program with the specified options in a foreground environment.
Debug Tool Features
Debug Tool provides all the good things you'd expect from a source level debugger applications programmers can step through their programs, listing variables as they go. Debug Tool provides a rich set of breakpoints that allow users to "run" the application at normal speed until a specific event (change of a variable, for example) occurs.
Debug Tool is a program testing and analysis aid that helps you examine, monitor, and control the execution of programs written in C/C++, COBOL, PL/I, Assembler, or High Performance Java (HPJ). Applications can include other languages, but Debug Tool will only provide support via disassembly view. Debug Tool works in:
Interactive Debugging: Using the full-screen interface, you can interactively debug any application as it runs (including batch applications). You can invoke Debug Tool when an application is initialized, or it can be started dynamically when a condition occurs. The application itself can also invoke Debug Tool.
The full-screen interface is divided into three windows:
Source-Level Debugging: You can monitor source code for C/C++, HPJava, and PL/I (when used with Enterprise PL/I V3) or a full compiler listing for COBOL and PL/I. Compiler listings are an expanded source listing that, in addition to program source, contain copy book source for COBOL or include file source for PL/I.
Mixed-Language Applications Debugging: Debug Tool supports seamless debugging of mixed-language applications within the same session, and recognizes when the current programming language changes. Language modules not supported by Debug Tool are tolerated, but debugging support is provided via a disassembly view only.
Dynamic Patching: For each supported programming language, there is a set of interpreted commands that you can use to specify actions to be taken. These commands are subsets of the programming languages, so they are easy to learn, and allow you to make adjustments to your application while you debug it.
You can use the commands to alter the value of variables and structures, and to control the flow of an application. For example, a programmer can declare a new variable and use the variable to patch a program as it executes.
Dynamic Breakpoint Setting: You can set breakpoints in an application program, monitor variables for changes, and watch for specified exceptions and conditions during program execution. For example, you can cause an application to stop when a specific variable or location in storage is changed. You can set, change, and remove breakpoints as you go through the application. You do not need to know where you want to set a breakpoint before you start.
Single-Step Debugging: To focus on a problem area, you can step line by line through the execution of an application. For example, when an application stops for a breakpoint, you can carefully examine each line that follows. Single-step debugging, along with the ability to set dynamic breakpoints, allows you to monitor, interrupt, and continue through the flow of the program to identify errors easily.
Program Information Gathering: Debug Tool can display program and environment information. You can display, monitor, and alter program variables or storage in real time. You can also check how your application was compiled, and look at its structure.
You can also use Debug Tool as a test tool. By using the session
logging feature as you debug code, you can save the results of your
session for use as input to a future Debug Tool session. As you make
changes to your code, you can use the saved log file as input to Debug
Tool in order to verify that no unexpected behavior occurs as a result of
these changes. Session logging allows you to create suites of regression
test cases that you can use to minimize the number of new bugs introduced
during the normal application development process.
This program is EuroReady.
For more information on the implications of the euro, visit the IBM euro Web site at:
EuroReady Products: IBM considers an IBM product to be EuroReady if the product, when used in accordance with its associated documentation, is capable of correctly processing monetary data in the euro denomination and of respecting the euro currency formatting conventions (including the euro sign). This assumes that all other products (for example, hardware, software, and firmware) that are used with this product are also EuroReady. IBM hardware products that are EuroReady may or may not have an engraved euro sign key on their keyboards.
Currently, EuroReady status applies primarily to IBM products specific to the EMU countries. Products that are not specific to these countries are deemed to be "not ready" for euro unless otherwise stated in the product's country-specific specifications.
IBM Hardware Ready: IBM supplies certain IBM products which include third-party software (preloaded or not) and/or third-party attached hardware. In these instances IBM is not in a position to assert that these third-party products are, in themselves, EuroReady.
Therefore, such IBM products will be designated as Hardware ready.
and can clearly demonstrate this by:
The euro capabilities of a EuroReady solution will be clearly identified as features of the solution specification as described in the contracts document.
Hardware and Software Support Services
IBM SmoothStart and Installation Services are not provided.
Specified Operating Environment
Unless otherwise announced by IBM, Debug Tool for z/OS and OS/390 V1R3 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.
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.
IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries around the world. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at:
Current licensees of IBM CODE/370 V1R2 will be sent a program reorder form that can be returned directly to IBM Software Delivery and Fulfillment (SDF).
Orders for new licenses can be placed now.
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 and OS/390 V1R3 should specify:
Type Model 5688 194
Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. For a graduated one-time charge (OTC) or graduated monthly license charge (MLC), specify one of the following feature numbers as applicable and corresponding to the group that contains the designated machine. Also, specify the feature number of the desired distribution medium.
Basic Graduated MLC Group Feature Number 18 0003 20 0004 25 0005 28 0006 29 0007 30 0008 31 0009 32 0010 35 0011 38 0012 40 0013 50 0014 60 0015 70 0016 80 0017
Multiple Operating System PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge, specify the following feature numbers, corresponding to the group that contains the designated machine.
MOSP Basic Graduated MLC Group Feature Number 18 0101 20 0102 25 0103 28 0104 29 0105 30 0106 31 0107 32 0108 35 0109 38 0110 40 0111 50 0112 60 0113 70 0114 80 0115
Note: The group can be determined by referring to either the Exhibit for IBM System/390® Machines (Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) associated with the IBM Customer Agreement (Z125-4575).
Entry Support License (ESL): To order an ESL, specify the program number, feature number 9001 for asset registration, and the applicable ESL OTC feature number. Also specify the feature number of the desired distribution medium.
Program Number/ ESL OTC Description Feature Number IBM Debug Tool for 2219 z/OS and OS/390 V1R3 (5688-194)
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 feature number 9001 for asset registration. Specify the PSLC Base feature. If applicable, specify the PSLC Level A and PSLC Level B features and quantity.
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 feature numbers and quantity represented by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program copies, specify the PSLC No-Charge (NC) Identifier feature on the licenses.
Also, specify the feature number of the desired distribution medium.
PSLC PSLC Basic License Machine Feature MLC Feature MSU Capacity Number Description 1 0199 PSLC Base, 1 MSU 2 0200 PSLC Base, 2 MSUs 3 0201 PSLC Base, 3 MSUs 4 -- 45 0202 PSLC Level A, 1 MSU 0203 PSLC Level A, 42 MSUs 46 or more 0204 PSLC Level B, 1 MSU 0205 PSLC Level B, 10 MSUs 0206 PSLC Level B, 50 MSUs NA 0207 PSLC NC Identifier
For a single machine with 11 MSUs, the PSLC features to be ordered would be:
For two machines in a Parallel Sysplex, which have an aggregation of 60 MSUs, the PSLC features to be ordered would be:
Workload License Charge (WLC) Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Also, specify the feature number of the desired distribution medium.
FWLC FWLC Feature Feature Number Description 4900 WLC (Debug Tool)
Growth Opportunity License Charge (GOLC): To order GOLC software, specify the program number, feature number 9001 for asset registration, and the GOLC monthly charge feature number from the table below. Also, specify the feature number for the desired distribution medium.
GOLC GOLC Feature Category Number H30 0400 H50 0401 H70 0402
Feature Environment Number Distribution Medium z/OS and OS/390 5861 9/6250 tape z/OS and OS/390 5862 3480 tape cartridge z/OS and OS/390 7537 4-mm DAT cartridge VM/ESA 5871 9/6250 tape VM/ESA 5872 3480 tape cartridge VM/ESA 5874 1/4-inch tape cartridge VM/ESA 7547 4-mm DAT cartridge
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) Satellite Electronic Delivery 3450 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 SDF receives the order. SDF will then ship the order via overnight air transportation.
DSLO License: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number below for a graduated one-time charge or graduated monthly license charge that corresponds to the group containing the designated machine.
DSLO Graduated Monthly Group Feature Number 18 0037 20 0038 25 0039 28 0040 29 0041 30 0042 31 0043 32 0044 35 0045 38 0046 40 0047 50 0048 60 0049 70 0050 80 0051
Multiple Operating System PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge, specify the following feature number below that corresponds to the group that contains the designated machine.
MOSP DSLO Graduated Monthly License Charge Group Feature Number 18 0131 20 0132 25 0133 28 0134 29 0135 30 0136 31 0137 MOSP DSLO Graduated Monthly License Charge Group Feature Number 32 0138 35 0139 38 0140 40 0141 50 0142 60 0143 70 0144 80 0145
Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license will be provided through the basic license location. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.
Extended License Charge (ELC) Basic License: To order a basic license, specify the appropriate program and feature number, if required, for asset registration. Specify the applicable Extended License Charge features. Also, specify the feature number of the desired distribution medium.
Processors with assigned capacity above 80 MSUs will now have VM and VSE software prices based on the CPU service unit capacity of the processor. The ELC price structure will have a Base Charge for 80 MSU capacity and an incremental Per MSU charge for all additional MSUs above the 80 MSU base.
ELC Feature Description Number ELC Base, 80 MSU Debug Tool 0305 ELC 1 MSU Debug Tool 0306 ELC 50 MSU Debug Tool 0307
Order Title Number Customization Guide GC27-1571 Licensed Program Specifications GC27-1572
The following optional publications will be available by general availability:
Order Title Number User's Guide SC27-1573 Fact Sheet SC27-1574 Reference Manual and Messages SC27-1575
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 and OS/390 unlicensed publications are available free of charge 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.
Most product media are shipped only via Customized Offerings (that is, CBPDO, ServerPac, Systempac®). Noncustomized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
The terms for IBM Debug Tool for z/OS and OS/390 (formerly CODE/370) licensed under the IBM Customer Agreement are unaffected by this announcement.
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
The charges for this product are unaffected by this announcement.
Use Priority/Reference Code: LE001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: firstname.lastname@example.org Mail: IBM Atlanta Sales Center Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690
You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU.
Note: Shipments will begin after the planned availability date.