Feedback

IBM Debug Tool for z/VM V4.1 helps to minimize coding errors and increase debugging efficiency

IBM United States Software Announcement 204-212
September 21, 2004

 

 ENUS204-212.PDF (39KB)

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

 
At a glance

IBM Debug Tool for z/VM V4.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

Application programmers need to minimize coding errors while working quickly to meet end-user demands. To effectively manage workloads and build applications, developers need robust, easy-to-use tools to compile, test, and debug their applications.

IBM Debug Tool for z/VM® V4.1 is an interactive source-level debugging tool for compiled applications. It helps you increase debugging efficiencies and aids in reducing application-development cycle times. This program testing and analysis aid helps you examine, monitor, and control the execution of application programs written in C, C++, COBOL, or PL/I on a z/VM system. By using the disassembly view, Debug Tool can also support programs compiled with the NOTEST compiler option and applications that include other languages such as Assembler.
 
Back to top
 

Key prerequisites

One of the following:

  • IBM z/VM V5.1 (5741-A05), or later
  • IBM z/VM V4.4 (5739-A03), or later

Depending on the function used, certain levels of other programs may be required. For details, refer to the Software requirements section.
 
Back to top
 

Planned availability date

September 24, 2004
 
Back to top
 

Description

Interactive full-screen debugging: The full-screen interface lets you interactively debug any application as it runs. You can start Debug Tool when an application is initialized, or it can be started dynamically when a condition occurs. The application itself can also start 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. 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 displays the same information recorded in the log file.

The available PF keys are displayed at the bottom of the screen. These provide a basic set of screen manipulation and debugging commands. You can customize the screen display and these keys to suit your testing and development needs.

Separate file support and dynamic debug support: Debug Tool supports COBOL production load modules compiled with the SEPARATE sub-option of TEST, such as TEST(NONE,SYM,SEPARATE). This sub-option causes the compiler to create the debug information in a separate file. In addition, the need to have compiled-in hooks for Debug Tool to control the application has been removed with the addition of the Dynamic Debug Support. 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 Dynamic Debug support is aimed to allow 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.

Source-level debugging: You can monitor source code for C/C++ or a compiler listing for COBOL and PL/I. Compiler listings are an expanded source listing that, in addition to program source, contains copy book source for COBOL or includes 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; debugging support is provided only through the disassembly view.

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.

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 help minimize the number of defects introduced during the normal application development process.

Switch between hexadecimal and decimal display: The following enhancements have been added:

  • A command, which can be assigned to a PF key, that enables you to switch the display of data between decimal and hexadecimal.
  • Parameters added to the MONITOR command turn hexadecimal representation on or off for data being displayed in the Monitor window.
  • Default behavior is changed so data that cannot be displayed in the variable's defined data type is displayed in hexadecimal.

Enhanced LIST cursor command: The RETRIEVE command has been enhanced so that when a LIST CURSOR command is performed on a variable, the retrieval action includes retrieval of the variable and the LIST keyword.

FIND command no longer requires use of quotes: The Debug Tool's FIND command has been changed so that it no longer requires quotes around the search string.
 
Back to top
 

Hardware and software support services

SmoothStart™/installation services

IBM SmoothStart and Installation Services are not provided.

Trademarks

 
SmoothStart is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
z/VM is a registered trademark of International Business Machines Corporation in the United States or other countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.

 
Back to top
 
Technical information

Hardware requirements

Debug Tool for z/VM® runs on any hardware configuration supported by the licensed programs specified below.

Software requirements

Unless otherwise announced by IBM, Debug Tool for z/VM V4 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/VM V5.1 (5741-A05)
  • z/VM V4.4 (5739-A03)

Optional licensed programs

  • C/C++ for z/VM (5654-A22)
  • COBOL for OS/390® & VM V2 (5648-A25)
  • High Level Assembler/MVS™ & VM & VSE (5696-234)
  • PL/I for MVS & VM V1.1.1 (5688-235)

Planning information

Packaging: The Debug Tool for z/VM V4.1 package includes:

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

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

Order VM SDO and VSE SIPO through the Internet

ShopzSeries provides an easy way to plan and order zSeries® software upgrades. This now includes VM and VSE. Using ShopzSeries, customers can quickly generate orders for VM SDOs and VSE SIPOs. Additionally, ShopzSeries will ensure your order is technically correct (that is, ensures any co-req or pre-req or incompatibility conditions are resolved to ensure timely order placement and processing). ShopzSeries is available in the United States 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/VM V4 should specify Type 5654, Model A23.

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.

Processor-based/graduated charges license: To order specify the feature number below that corresponds to the group that contains the designated machine.

Specify the applicable basic graduated monthly license option.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         Basic graduated
                                                 MLC

Multiple Operating System — PR/SM™ (MOSP): For a graduated monthly license charge (MLC), specify the feature number below that corresponds to the group that contains the designated machine.

Specify the applicable MOSP graduated monthly license option.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         MOSP graduated
                                                 MLC

Note: The group can be determined by referring to either the Exhibit for 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 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
 
S011CMS          Debug Tool for z/VM V4         Basic OTC, ESL

ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).

Workload license charge (WLC) basic license: Flat WLC features

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         Basic MLC,
                                                 Flat WLC

Tiered Workload License Charge (TWLC):

Specify the TWLC monthly license option.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         Basic MLC, TWLC

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
 
S011CMS          Debug Tool for z/VM V4         Basic MLC, GOLC

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
 
S011CMS          Debug Tool for z/VM V4         Basic MLC, zELC

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

DSLO license: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number that follows for a graduated MLC that corresponds to the group containing the designated machine.

Specify the applicable basic DSLO graduated monthly license option.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         DSLO graduated
                                                 MLC

Multiple operating system — PR/SM™ (MOSP)

For a graduated MLC, specify the following feature number that follows that corresponds to the group that contains the designated machine.

Specify the applicable MOSP DSLO graduated monthly license option.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         MOSP DSLO
                                                 graduated MLC

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

Specify the applicable ELC license option.

Entitlement                                     License option/
identifier           Description                pricing metric
 
S011CMS              Debug Tool for             ELC Including
                      z/VM V4                     80 MSU, Basic
                                                 Per User Base
                                                ELC Above 80 MSU,
                                                 Per Usage
                                                 Additional
                                                 Quantity
                                                ELC Above 80 MSU,
                                                 Per Block of
                                                 50 MSU Additional
                                                 Quantity

Terms and conditions licensing

The following apply to products ordered with ELC:

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

Unlicensed documentation: A Program Directory (GI10-8669) and Licensed Program Specifications (GC18-9387) is supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.

The following optional publication will be available after product availability:

  • Debug Tool for z/VM User's Guide (SC18-9388)

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/VM V4 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.
 
Back to top
 

Terms and conditions

Agreement: IBM Customer Agreement

Variable charges apply: Yes

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.

Replaced programs             Replacement programs
 
Program          Program      Program             Program
name             number       name                number
 
CODE/370 V1      5688-194     IBM Debug Tool      5654-A23
                               for z/VM V4
IBM Debug Tool   5688-194     IBM Debug Tool      5654-A23
 for z/OS(R)                   for z/VM V4
 and OS/390 V1
IBM Debug Tool   5654-A23     To a follow-on if any
 for z/VM V4

Warranty applies: Yes

Licensed program materials availability

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

Program services

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
  • Services for DSLO licenses: Provided through basic license location

IBM operational support services — SoftwareXcel: Yes
 
Back to top
 

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.

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for                 Basic graduated MLC,
                  z/VM V4                       MOSP graduated MLC,
                                                DSLO graduated MLC,
                                                MOSP DSLO graduated
                                                 MLC

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         Basic OTC, ESL
 
S011CMS          Debug Tool for z/VM V4         Basic MLC, GOLC
 
S011CMS          Debug Tool for z/VM V4         Basic MLC, zELC

Flat workload charge

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for z/VM V4         Basic MLC,
                                                 Flat WLC

Tiered Workload License Charge (TWLC)

Entitlement                                     License option/
identifier       Description                    pricing metric
 
S011CMS          Debug Tool for                 Basic MLC, TWLC
                  z/VM V4
 
S011CMS          Debug Tool for                 ELC Including 80 MSU,
                  z/VM V4                        Basic Per User Base
                                                ELC Above 80 MSU,
                                                 Per Usage Additional
                                                 Quantity
                                                ELC Above 80 MSU,
                                                 Per Block of 50 MSU
                                                 Additional Quantity

OTC: Customers who pay an OTC for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new function may be offered as an optional feature and charged for separately.

Variable charges: The applicable graduated OTC or graduated MLC will be based on the group of the designated machine on which the licensed program is licensed for use. If the program is designated to a processor in a group for which no charge is listed above, the charge of the next higher group listed applies.

For upgrades of OTC licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups.

For downgrades of OTC licenses to a machine in a lower group, there will be no adjustment or refund of OTCs paid.

For upgrades or downgrades of MLC licenses, the MLC applicable to the higher or lower group will apply.

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

 
MVS, IBMLink, PR/SM, and PR/SM are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
z/VM, OS/390, zSeries, System/390, BookManager, and z/OS are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.

Back to top
 

 
Printable version