IBM TPF Toolkit V3.6 delivers development tool enhancements based on the latest Eclipse technology

IBM United States Software Announcement 210-426
December 14, 2010

Table of contents
Overview Overview Publications Publications
Key prerequisites Key prerequisites Technical information Technical information
Planned availability date Planned availability date Ordering information Ordering information
Description Description Terms and conditions Terms and conditions
Product positioning Product positioning Prices Prices
Program number Program number Order now Order now

Top rule
Bottom rule

IBM® TPF Toolkit integrates Transaction Processing Facility (TPF) application development with the Eclipse-based development environment. It supports development of applications for TPF and z/TPF. TPF Toolkit offers TPF application developers state-of-the-art, workstation-based tools that are designed to be integrated and powerful, yet easy to use and easy to customize.

What's new in TPF Toolkit V3.6

  • Integration of the latest Eclipse V3.6 technology
  • Enhanced High Level Assembler (HLASM) user macros and content assistant, providing increased ease of use
  • Remote C/C++ Editor and System z® Live Parsing Extensible Editor (LPEX), providing source formatting capability
  • New Code Coverage feature, improving the effectiveness of software testing
  • Enhanced Trace Log, providing a graphical hierarchical view and analysis view
  • New 3270 host emulator, enabling easier access to TPF systems with macro recording support
  • Enhanced debug support to associate debug sessions with TPF projects, providing better management of debug sessions
  • New source scan API feature, providing more powerful custom rules creation
  • Enhanced TPFtool utility for supporting interactive substitution variables
  • Improved remote index search

For ordering, contact your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: SE001).

Back to topBack to top
Top rule
Key prerequisites
Bottom rule

For details, refer to the Hardware requirements and Software requirements sections.

Back to topBack to top
Top rule
Planned availability date
Bottom rule

December 17, 2010: Electronic and physical software delivery

Back to topBack to top
Top rule
Bottom rule

TPF Toolkit V3.6 delivers the following enhancements:

Editor improvements

The language used to define HLASM user macros is enhanced to allow defining macros with parameters that contain bracket lists, thus providing increased accuracy from the HLASM syntax checker and reducing the need to compile to ensure correct HLASM source. The new language now allows for greater precision when defining macros, eliminating the need to have multiple macro definitions, thus increasing clarity of errors provided by the syntax checker. A new user interface to define macros is also provided, thus making it easier to input new macros into user macro files and helping to reduce errors in macro syntax.

The HLASM content assistant is significantly enhanced to provide advanced content assist, automatically adding required parameters, as well as providing assistance on parameter names, and values for keyed and positional parameters. The content assistant also provides contextual information from within the program by providing the user with proposals of variables, symbols, and labels defined within the file. Combined, these enhancements help the user input syntactically correct HLASM code at a much quicker pace, without having to refer to reference materials, helping to provide the user with significant productivity gains.

The Remote C/C++ Editor and System z LPEX Editor now provide the user with the ability to format their source. The user can define and share their own formatting options, or use one of the preconfigured code styles to make C/C++ code easier to read, increasing code understanding, and enforce standard formatting for teams.

Code Coverage tool

A critical measure of the effectiveness of software testing is how much of an application is executed by various test suites. To maintain high quality, it is important that test suites cover a range of scenarios that test many aspects of an application. The new Code Coverage feature in TPF Toolkit allows you to easily analyze your test suites. The Code Coverage tool displays the percentage of code executed at various levels of detail and can be used to determine if testing coverage is adequate.

Trace log enhancements

In previous versions of TPF Toolkit, trace log collections were managed through commands run from the debug console. In Version 3.6, users can start and stop trace log collection conveniently through the Debug view while the associated debug session is active.

The System z LPEX Editor is enhanced for trace log files (*.report) so that a graphical hierarchical view of the trace log file is presented to the user. This new tree view allows the user to better understand the flow of the trace log and can be configured to indicate which information needs to be displayed or hidden, helping the user analyze the file for desired information. Existing filters can be run against this new view, along with new filters that can be created which allow data to be excluded from the list, again helping the user with their analysis of the raw data provided in a trace log file.

In addition to the graphical tree view for trace log files, an analysis function which opens the Trace Log Analysis view with statistics from the trace log file is provided. The analysis view displays various measurable statistics of critical areas such as allocation, deallocation, log size, and macro counts, helping the user to find bottlenecks and identify critical entries in the trace log. Users who have created their own macro families will also see counts for these in the Trace Log Analysis view, which can be configured to hide or display statistics as desired, thus providing the user with a configurable statistical summary of their trace log file.

Embedded 3270 Emulator

With the introduction of a new 3270 host emulator, access your TPF systems without having to switch away from your development environment. The host emulator feature also allows you to record macros that can be replayed at any time to perform repetitive tasks automatically.

Associate project with debug session

In previous versions of TPF Toolkit, users could only associate TPF projects containing source code with a debug session when the session was active. In Version 3.6, TPF projects can be linked to a particular debug session when the session is created and they can be managed through the Remote Systems Explorer. This makes management of debug sessions easier for an administrator as well as end users.

Scan Tool Java™ API

In previous releases, the source scan tools available in TPF Toolkit aided in migration and governance tasks. In addition to the existing tools, IBM-supplied rules and custom template rules developed by users, TPF Toolkit added a source scan API feature. Using the new source scan Java API, users can create more powerful custom rules to analyze C/C++ and HLASM source files.

Launch interactive substitution variables from TPFtool

The TPFtool utility is enhanced to support interactive substitution variables. Take advantage of this feature and incorporate user interaction into your TPFtool scripts.

Remote index search improvements

Users can now specify multiple index directories to search through when performing a remote index search. The most recent index among the index directories specified will be automatically selected when retrieving search results. Using this new feature, an administrator could perform a scheduled index of larger portions of the code base in a common directory, while individual developers could index smaller portions of the code base in their own personal directories while still ensuring that the most up-to-date results would always be displayed when a remote index search is performed. In addition, index creation performance has been improved, shortening the time it takes to create an index for a large directory.

Accessibility by people with disabilities

A U.S. Section 508 Voluntary Product Accessibility Template (VPAT) containing details on accessibility compliance can be requested at

Section 508 of the U.S. Rehabilitation Act

IBM TPF Toolkit V3.6 is capable as of December 17, 2010, when used in accordance with associated IBM documentation, of satisfying the applicable requirements of Section 508 of the Rehabilitation Act, provided that any assistive technology used with the product properly interoperates with it. A U.S. Section 508 Voluntary Product Accessibility Template (VPAT) can be requested on the following website

Back to topBack to top
Top rule
Product positioning
Bottom rule

TPF Toolkit is built on the Eclipse application development environment.

The Eclipse project was initiated when IBM donated the source code for their latest internal application development platform to the developer community by way of the open-source Eclipse Public License. Currently, the Eclipse project is managed by a consortium of companies that includes IBM.

Eclipse is an open and universal tool platform. Eclipse is open source in that anyone can obtain the source code. Eclipse is universal in that it allows for near-infinite extensions to the integrated development environment (IDE) through the use of plug-ins.

For more information on the Eclipse project, visit

IBM TPF Toolkit is an ideal product if you want to:

  • Move up to the latest in application development technology based on the Eclipse application development environment
  • Gain flexibility to integrate your own tools into the extensible integrated development environment
  • Gain skills that are portable to other IBM application development tools based on Eclipse
  • Benefit from the latest Eclipse implementation of tools that are ported to TPF Toolkit
  • Be positioned to exploit new Eclipse technology in the future

TPF Toolkit continues to support programming of applications in C, C++, and High Level Assembler targeted to run on a TPF system. TPF customers are aware that assembler programmers are becoming scarce and more expensive. TPF Toolkit offers an excellent opportunity for TPF customers who want to expand their skills by starting to write more applications in C or C++, while simplifying their assembler programming environment.

Using the Java Development Tools (JDT) that are included within TPF Toolkit's development environment, TPF customers can write stand-alone workstation applications in Java. They can also use JDT to create Java plug-ins to extend the TPF Toolkit IDE.

Back to topBack to top
Top rule
Program number
Bottom rule

Program                Program
number        VRM      name
5724-H79      3.6.0    IBM TPF Toolkit 

Back to topBack to top
Top rule
Offering Information
Bottom rule

Product information is available via the Offering Information website

Also, visit the Passport Advantage® website

Back to topBack to top
Top rule
Bottom rule

No publications are shipped with this program.

Back to topBack to top
Top rule
Technical information
Bottom rule

Specified operating environment

Hardware requirements

Before attempting to install IBM TPF Toolkit, you must ensure that you meet the client system requirements for each workstation.

Each workstation must meet the following requirements:

  • Intel® Pentium® III 800 MHz processor (minimum requirement).
  • 650 MB disk space for the installation of the English national language version (NLV). More disk space may be required for the installation of other NLV support.
  • 512 MB RAM minimum (1 GB recommended if running multiple applications).
  • 17-inch monitor.
  • XGA display 1024 x 768 (minimum requirement).
Software requirements

Client programming requirements

  • Microsoft® Windows® XP Professional SP1, or later
  • Microsoft Windows Vista Business or Enterprise
  • Microsoft Windows 7 Ultimate
  • TCP/IP (installed and configured)
  • Hummingbird Maestro™ V10.0, or later (optional)

TPF system requirements

  • It is recommended that the TPF system be at the latest PUT level for complete function and stability of the following components: debugger, performance analysis, web services, and code coverage. The following lists the minimum system levels required.
  • One of the following:
    • z/TPF V1.1: PUT 2 with the following APARs applied
      • For debug: PJ31357, TPF Views APAR PJ31890, SW00SR View APAR PJ32221, and Registration Enhancements APAR PJ34615 (z/TPF) and PK77217 (z/TPFDF)
      • For performance analysis: PJ31771 and PJ31854
      • For web services: PJ31953
      • For code coverage: PJ37973
    • TPF 4.1
      • PUT 15 or 16 TPF system with APARs PJ28041, PJ28176 (CXML), PJ27905, and PJ29430 applied.
      • PUT 17 TPF system with APAR PJ29430 applied. If this system already has APAR PJ28649 (merged Assembler/C debug capability) applied, then APAR PJ29585 must also be applied.
      • Debug: TPF Views APAR PJ31891, SW00SR View APAR PJ32240
      • TPF Views APAR PJ31891

z/OS® system requirements

z/OS 1.10, or later, with the following installed

Linux® on System z system requirements

  • For detailed information on the development system requirements for z/TPF Enterprise Edition V1.1, refer to the z/TPF book available in the IBM TPF Product Information Center located at

    Detailed information can be found in z/TPF ->Reference->Migration->Operating system requirements and planning information->Software->Required Linux Software.

  • Additional Linux on System z system requirements
    • TCPIP.
    • REXEC or SSH server enabled.
    • Optional: IBM Developer Kit for Linux Java 2 Technology Edition 5.0 31- or 64-bit zSeries® -- This is required to run the Remote System Explorer. For more information, refer to
    • DFS™ - SMB (optional).
    • NFS (optional).
    • OpenSSH server that supports the SSH2 protocol (optional).
      Note: The OpenSSH server must be configured to use the SSH2 protocol and allow password and key authentication.

The program's specifications and specified operating environment information may be found in documentation accompanying the program, if available, such as a readme file, or other information published by IBM, such as an announcement letter. Documentation and other program content may be supplied only in the English language.


For additional information, refer to Usage restriction in the Terms and conditions section of this announcement, or to the license information document that is available on the IBM Software License Agreement website

Planning information


IBM TPF Toolkit V3.6 CD

Security, auditability, and control

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 topBack to top
Top rule
Software Services
Bottom rule

IBM Software Services has the breadth, depth, and reach to manage your services needs. You can leverage the deep technical skills of our lab-based Software Services team and the business consulting, project management, and infrastructure expertise of our IBM Global Services team. Also, we extend our IBM Software Services reach through IBM Business Partners to provide an extensive portfolio of capabilities. Together, we provide the global reach, intellectual capital, industry insight, and technology leadership to support a wide range of critical business needs.

To learn more about IBM Software Services or to contact a Software Services sales specialist, visit

Back to topBack to top
Top rule
Ordering information
Bottom rule

This product is available only via Passport Advantage. It is not available as shrinkwrap.

Product identifier
description          PID        Product group      Product category
IBM TPF Toolkit      5724-H79   IBM Application    WebSphere
Charge metric
                     Part number or
Program name         PID number           Charge metric
IBM TPF Toolkit      5724-H79             Authorized User

Passport Advantage customer: Media pack entitlement details

Customers with active maintenance or subscription for the products listed are entitled to receive the corresponding media pack.

Media pack description           Part number
IBM TPF Toolkit V3.6             BA108ML 

Back to topBack to top
Top rule
Terms and conditions
Bottom rule

The information provided in this announcement letter is for reference and convenience purposes only. The terms and conditions that govern any transaction with IBM are contained in the applicable contract documents such as the IBM International Program License Agreement, IBM International Passport Advantage Agreement, and IBM Agreement for Acquisition of Software Maintenance.

This product is available only via Passport Advantage. It is not available as shrinkwrap.


IBM International Program License Agreement including the License Information document and Proof of Entitlement (PoE) govern your use of the program. PoEs are required for all authorized use. Part number products only, offered outside of Passport Advantage, where applicable, are license only and do not include Software Maintenance.

This software license includes Software Subscription and Support (also referred to as Software Maintenance).

These programs are licensed under the IBM Program License Agreement (IPLA) and the associated Agreement for Acquisition of Software Maintenance, which provide for support with ongoing access to releases and versions of the program. IBM includes one year of Software Subscription and Support (also referred to as Software Maintenance) with the initial license acquisition of each program acquired. The initial period of Software Subscription and Support (also referred to as Software Maintenance) can be extended by the purchase of a renewal option, if available. These programs have a one-time license charge for use of the program and an annual renewable charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours), as well as access to updates, releases, and versions of the program as long as support is in effect.

License Information form number


The program's License Information will be available for review on the IBM Software License Agreement website
Limited warranty applies


Limited warranty

IBM warrants that when the program is used in the specified operating environment, it will conform to its specifications. The warranty applies only to the unmodified portion of the program. IBM does not warrant uninterrupted or error-free operation of the program or that IBM will correct all program defects. You are responsible for the results obtained from the use of the program.

IBM provides you with access to IBM databases containing information on known program defects, defect corrections, restrictions, and bypasses at no additional charge. For further information, consult the IBM Software Support Handbook found at

IBM will maintain this information for at least one year after the original licensee acquires the program (warranty period).

Program technical support

Technical support of a program product version or release will be available for a minimum of three years from the general availability date, as long as your Software Subscription and Support (also referred to as Software Maintenance) is in effect. This technical support allows you to obtain assistance (via telephone or electronic means) from IBM for product-specific, task-oriented questions regarding the installation and operation of the program product. Software Subscription and Support (Software Maintenance) also provides you with access to updates (modifications or fixes), releases, and versions of the program. You will be notified, via announcement letter, of discontinuance of support with 12 months' notice. If you require additional technical support from IBM, including an extension of support beyond the discontinuance date, contact your IBM representative or IBM Business Partner. This extension may be available for a fee.

Money-back guarantee

If for any reason you are dissatisfied with the program and you are the original licensee, you may obtain a refund of the amount you paid for it, if within 30 days of your invoice date you return the program and its PoE to the party from whom you obtained it. If you downloaded the program, you may contact the party from whom you acquired it for instructions on how to obtain the refund.

For clarification, note that (1) for programs acquired under the IBM International Passport Advantage offering, this term applies only to your first acquisition of the program and (2) for programs acquired under any of IBM's On/Off Capacity on Demand (On/Off CoD) software offerings, this term does not apply since these offerings apply to programs already acquired and in use by you.

Volume orders (IVO)


Passport Advantage applies

Yes, and through the Passport Advantage website at
Usage restriction


For additional information, refer to the License Information document that is available on the IBM Software License Agreement website
Software Subscription and Support (Software Maintenance) applies

Yes. Software Subscription and Support (also referred to as Software Maintenance) is included with licenses purchased through Passport Advantage and Passport Advantage Express. Product upgrades and Technical Support are provided by the Software Subscription and Support (Software Maintenance) offering as described in the Agreements. Product upgrades provide the latest versions and releases to entitled software and Technical Support provides voice and electronic access to IBM support organizations, worldwide.

IBM includes one year of Software Subscription and Support (Software Maintenance) with each program license acquired. The initial period of Software Subscription and Support (Software Maintenance) can be extended by the purchase of a renewal option, if available.

While your Software Subscription and Support (Software Maintenance) is in effect, IBM provides you assistance for your routine, short-duration installation and usage (how-to) questions, and code-related questions. IBM provides assistance via telephone and, if available, electronic access, only to your information systems (IS) technical support personnel during the normal business hours (published prime shift hours) of your IBM support center. (This assistance is not available to your end users.) IBM provides Severity 1 assistance 24 hours a day, 7 days a week. For additional details, consult your IBM Software Support Handbook at

Software Subscription and Support (Software Maintenance) does not include assistance for the design and development of applications, your use of programs in other than their specified operating environment, or failures caused by products for which IBM is not responsible under the applicable agreements.

For additional information about the International Passport Advantage Agreement and the IBM International Passport Advantage Express Agreement, visit the Passport Advantage website at
System i Software Maintenance applies


Variable charges apply


Educational allowance available

Not applicable

Back to topBack to top
Top rule
IBM Electronic Services
Bottom rule

IBM has transformed its delivery of hardware and software support services to help you achieve higher system availability. Electronic Services is a Web-enabled solution that offers an exclusive, no-additional-charge enhancement to the service and support available for IBM servers. These services are designed to provide the opportunity for greater system availability with faster problem resolution and preemptive monitoring. Electronic Services comprises two separate, but complementary, elements: Electronic Services news page and Electronic Services Agent.

The Electronic Services news page is a single Internet entry point that replaces the multiple entry points traditionally used to access IBM Internet services and support. The news page enables you to gain easier access to IBM resources for assistance in resolving technical problems.

The Electronic Service Agent™ is no-additional-charge software that resides on your server. It monitors events and transmits system inventory information to IBM on a periodic, client-defined timetable. The Electronic Service Agent automatically reports hardware problems to IBM. Early knowledge about potential problems enables IBM to deliver proactive service that may result in higher system availability and performance. In addition, information collected through the Service Agent is made available to IBM service support representatives when they help answer your questions or diagnose problems. Installation and use of IBM Electronic Service Agent for problem reporting enables IBM to provide better support and service for your IBM server.

To learn how Electronic Services can work for you, visit

Back to topBack to top
Top rule
Bottom rule

For all charges, contact your IBM representative.

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, from both 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

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.

Financing from IBM Global Financing helps you preserve cash and credit lines, enables more technology acquisition within current budget limits, permits accelerated implementation of economically attractive new technologies, offers payment and term flexibility, and can help match project costs to projected benefits. Financing is available worldwide for credit-qualified customers.

Back to topBack to top
Top rule
Order now
Bottom rule

To order, contact the Americas Call Centers or 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)
Mail:       IBM Teleweb Customer Support
  ® Sales Execution Center, Americas North
            3500 Steeles Ave. East, Tower 3/4
            Markham, Ontario
            L3R 2Z1

Reference: SE001

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.

Maestro, DFS and Electronic Service Agent are trademarks of IBM Corporation in the United States, other countries, or both.

IBM, System z, Passport Advantage, z/OS, OS/390, zSeries and are registered trademarks of IBM Corporation in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Intel and Pentium are registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.

Terms of use

IBM products and services which are announced and available in your country can be ordered under the applicable standard agreements, terms, conditions, and prices in effect at the time. IBM reserves the right to modify or withdraw this announcement at any time without notice. This announcement is provided for your information only. Additional terms of use are located at

For the most current information regarding IBM products, consult your IBM representative or reseller, or visit the IBM worldwide contacts page

Terms of use

Share this page

Digg Linked In

Contact IBM

Considering a purchase?