IBM United States
Software Announcement 201-340
November 27, 2001

IBM Debug Tool for z/OS and OS/390 V1R3

 ENUS201-340.PDF (42KB)


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:

  • Support for assembler (via disassembly view)
  • New functions requested by customers

For ordering, contact:

Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).

Overview

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:

  • Support for multithreaded applications including new support delivered in V3 of the COBOL and PL/I compilers and run times
  • Dynamic debug of COBOL applications, often called production or "hookless" debug
  • Interactive debug of JES batch applications from a 3270 interface
  • Assembler support, via a disassembly view of a load module
  • An ISPF setup and invocation utility to assist users in starting a debug session

Key Prerequisites

  • One of the following:
    • z/OS V1R1 (5694-A01), or later
    • OS/390 V2R10 (5647-A01), or later
    • VM/ESA® V2R4 (5654-030), or later
    • z/VM™ V3R1 (5654-A17), or later
    • z/VM V4R1 (5739-A03), or later
  • Depending on the function used, certain levels of other programs may be required. Refer to the Software Requirements section for details.

Planned Availability Date

March 29, 2002

Description

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 and OS/390.

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.

No new function has been added to the VM component of Debug Tool in V1R3.

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:

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

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:

  • Monitor window

    Displays status of items you choose to monitor, such as variables, registers, programs, the execution environment, and Debug Tool settings. For example, you can use this window to watch the content of variables change during program execution.

  • Source window

    Displays the program source or disassembly view, with the current statement highlighted. In the prefix area at the left of this window, you can enter commands to set, display, and remove breakpoints.

  • Log window

    Records and displays your interactions with Debug Tool and, optionally, shows program output. This window contains the same information as the log file.

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 Frequency Counting: Debug Tool counts how many times a statement or verb has been processed in an application program. This allows you to verify the coverage of your code paths.

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.

Session Logging: Each debug session can be recorded in a log file for reviewing, editing, or replaying. This allows you to replay the actions taken in a session to pinpoint errors in an application.

General Testing: 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.

Euro Currency

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.

EuroReady Solutions: IBM considers a solution to be EuroReady when the solution providers have:

  • Analyzed the euro requirements, including the need to comply with relevant EC rules
  • Built in appropriate function

and can clearly demonstrate this by:

  • Detailing euro related requirements
  • Describing how these will be implemented in the solution
  • Declaring when the implementation will be generally available

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

SmoothStart™/Installation Services

IBM SmoothStart and Installation Services are not provided.

Trademarks

 
z/OS, z/VM, IMS, WebSphere, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, VM/ESA, DB2, and CICS are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
UNIX is a registered trademark 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.

Technical Information

Specified Operating Environment

Hardware Requirements

Debug Tool for z/OS™ and OS/390® will run on any hardware configuration supported by the licensed programs specified below.

Software Requirements

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.

Required Licensed Programs

  • One of the following:
    • z/OS V1R1 (5694-A01)
    • OS/390 V2R10 (5647-A01)
    • VM/ESA® V2R4 (5654-030)
    • z/VM™ V3R1 (5654-A17)
    • z/VM V4R1 (5739-A03)

Optional Licensed Programs

  • AD/Cycle® C/370™ V1R2 (5688-216)
  • C/C++ for MVS/ESA™ Version 3 (5655-121)
  • C/C++ feature of OS/390 (5647-A01)
  • C/C++ feature of z/OS (5694-A01)
  • VS COBOL II V1.3.1, V1.3.2, V1.4.1 (5688-958, 5688-023) — with limitations
  • AD/Cycle COBOL/370™ V1R1 (5688-197)
  • COBOL for MVS™ & VM V1R2 (5688-197)
  • COBOL for OS/390 & VM V2R1 (5648-A25)
  • Enterprise COBOL for z/OS and OS/390 V3R1 (5655-G53)
  • High Level Assembler/MVS & VM & VSE (5696-234)
  • OS PL/I V2.1, V2.2, V2.3 (5688-909, 5688-910) — with limitations
  • PL/I for MVS & VM R1.1 (5688-235)
  • VisualAge® PL/I for OS/390 V2R2 (5655-B22)
  • Enterprise PL/I for z/OS and OS/390 V3R1 (5655-H31)
  • VisualAge for Java™, Enterprise Edition for OS/390 V2.0 (5655-JAV) — remote debug only

Planning Information

Packaging: The Debug Tool for z/OS and OS/390 V1R3 package includes:

  • Basic machine-readable material on the customer-selected distribution medium
  • Program Directory (GI10-8445)
  • Customization Guide (GC27-1571)
  • Licensed Program Specifications (GC27-1572)

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.

Customer Financing

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:

Ordering Information

Current Licensees

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).

Reorder forms are scheduled to be mailed by April 12, 2002. Reorder forms returned to SDF will be processed within 10 workdays of receipt. When V1R3 is available, V1R2 will no longer be available.

New Licensees

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

Example 1

For a single machine with 11 MSUs, the PSLC features to be ordered would be:

  • PSLC Base, 3 MSUs — quantity 1
  • PSLC Level A, 1 MSU — quantity 8

Example 2

For two machines in a Parallel Sysplex, which have an aggregation of 60 MSUs, the PSLC features to be ordered would be:

  • PSLC chargeable license #1:
    • PSLC Base, 3 MSUs — quantity 1
    • PSLC Level A, 42 MSUs — quantity 1
    • PSLC Level B, 1 MSU — quantity 5
    • PSLC Level B, 10 MSUs — quantity 1
  • PSLC no-charge license #2:
    • PSLC NC ID — quantity 1

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.

Flat Workload License Charge Features

               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

Basic Machine-Readable Material

                         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

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

Terms and Conditions Licensing: The following apply to products ordered with Extended License Charges:

  • Z125-6018, ICA Attachment for Extended License Charges, which should be signed by the customer
  • Z125-6019, ICA Exhibit for Extended License Charges

Unlicensed Documentation: A memo to users, a program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

                                                       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.

Customized Offerings

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.

IBM Operational Support Services — Support Line: Yes

Prices

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.

Order Now

 Use Priority/Reference Code: LE001
 
 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@vnet.ibm.com
 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.

Trademarks

 
z/OS, z/VM, C/370, MVS/ESA, COBOL/370, MVS, and PR/SM are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, VM/ESA, AD/Cycle, VisualAge, System/390, Parallel Sysplex, BookManager, and Systempac are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
Other company, product, and service names may be trademarks or service marks of others.