|
IBM United States
Software Announcement 201-340 November 27, 2001 IBM Debug Tool for z/OS and OS/390 V1R3
At a GlanceA 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). OverviewIBM 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:
Key Prerequisites
DescriptionNew 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 V1R3Debug 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 FeaturesDebug 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 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 CurrencyThis 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:
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 ServicesSmoothStart™/Installation ServicesIBM SmoothStart and Installation Services are not provided.
Trademarks
Technical InformationSpecified Operating EnvironmentHardware Requirements
Debug Tool for z/OS™ and OS/390® will run on any hardware
configuration supported by the licensed programs specified below.
Software RequirementsUnless 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.
Planning InformationPackaging: The Debug Tool for z/OS and OS/390 V1R3 package includes:
Security, Auditability, and ControlThe 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 FinancingIBM 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 InformationCurrent LicenseesCurrent 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 LicenseesOrders 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. 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:
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 OfferingsMost 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 ConditionsThe 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. PricesThe 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
|
