IBM Migration Utility for z/OS V2.1 improves usability when creating standard COBOL reports

IBM United States Software Announcement 204-074
April 27, 2004

 ENUS204-074.PDF (36KB)

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

At a glance

New in V2.1:

  • Addition of several utilities to improve usability, including:
    • Discovery and staging
    • Batch conversion
    • Parallel testing
    • Electronic output comparison
  • Syntax enhancements
  • Ability to perform a single-step job execution
  • Dynamic allocation of print, temporary, sort-work, and virtual files at run time
  • Support for IMS (DL1) databases
  • Support for Double Byte Character Set (DBCS) languages

For ordering, contact:

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


The IBM Migration Utility for z/OS® creates standard COBOL reports from CA-Easytrieve Plus language statements, without CA-Easytrieve Plus installed, and which run in place of the CA-Easytrieve Plus run-time interpreter. These applications can then be modified, maintained, and enhanced via standard COBOL programming.

The Migration Utility can be used to replace CA-Easytrieve Plus for existing reports, to modify or enhance converted reports using CA-Easytrieve Plus language, or to create new reports using the CA-Easytrieve Plus language.

In addition to cost savings, the use of the Migration Utility offers:

  • Easy extensibility to CA-Easytrieve Plus reports via standard COBOL programming
  • Improved performance in I/O searching, sorting, and the ability to port CA-Easytrieve Plus applications to any platform with a supported COBOL compiler including AIX® and OS/400® (subject to any limitations that compiler has)

Supported file types include:

  • Virtual Storage Access Method (VSAM)
  • Queued Sequential Access Method (QSAM)
  • Sequential Access Method (SAM)
  • DB2® (Native and Ca-Easytrieve Plus mode)
  • IMS™ (DL 1) Database
  • Tape files and unit record devices

Back to top
Key prerequisites

Refer to the Hardware requirements and Software requirements sections.

Back to top

Planned availability date

April 30, 2004
Back to top


The Migration Utility reads CA-Easytrieve Plus language statements, converts them to a neutral meta-format, generates standard COBOL statements, compiles (and optionally saves), and executes the compiled COBOL code. The generated COBOL source can be edited to include additional logic not supported by CA-Easytrieve Plus, or to make modifications to report content as required by changing business conditions.

These uses of Migration Utility for z/OS not only saves on CA-Easytrieve Plus license costs, but delivers several additional benefits, including superior efficiency in I/O handling and memory management, improved performance in sorting and searching, coexistence with other language environments and platforms, accessibility to all COBOL debugging tools, and the ability to augment CA-Easytrieve Plus logic with embedded COBOL subroutines. Additionally, Migration Utility:

  • Generates standard COBOL statements that can be imbedded in the CA-Easytrieve Plus program
  • Provides utilities that are available for converting CA-Easytrieve Plus record layouts to COBOL copy books
  • Allows COBOL copy books to be directly used in CA-Easytrieve Plus programs

Supported file types include:

  • VSAM
  • QSAM
  • SAM
  • DB2 (Native and CA-Easytrieve Plus mode)
  • Tape files
  • Unit record devices

In addition to eliminating the CA-Easytrieve Plus license costs, Migration Utility for z/OS delivers the following benefits:

  • Total cost of ownership is reduced.
  • COBOL I/O handling and memory management are more efficient.
  • COBOL sorting and searching is more efficient.
  • COBOL coexists better with other languages and environments.
  • All COBOL debugging tools can be used.
  • More COBOL skills are available in the labor market for program support.
  • COBOL is portable to other platforms (subject to supplier's functional limitations).

Sample JCL is provided for each job step in the translation process, which can be adapted to the user's operating standards. Migration Utility ships as a set of macros which interprets the CA-Easytrieve Plus syntax and generates the meta format, and load modules which perform the rest of the conversion to COBOL. The sample JCL then invokes the COBOL compile, link, and go steps.

Migration Utility Services

Get the most out of your IT department's time by contracting for Migration Utility V2 services. Our services can help you educate your staff, get you started with conversion, convert all your programs, or something in between, and help keep the learning curve to a minimum. IBM offers several packages with a wide range of services including basic and test tool education, program conversion, and on-call support. Customized services can also be developed when your requirements are more extensive. Contact your IBM representative for more information about Migration Utility V2 services or visit IBM's Migration Utility V2 information library at the following Web site

Section 508 of the U.S. Rehabilitation Act

IBM Migration Utility for z/OS is capable as of March 26, 2004, when used in accordance with IBM's associated 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.

Value Unit based pricing

Value Unit based pricing will help to align the prices of these products to the principle of the PSLC pricing curve which provides for a lower price per millions of service units per hour (MSU) for larger capacities.

There is also be a price benefit when customers grow their capacity. Additional capacity will based on the number of Value Units (MSUs) the customer has already installed, for example, additional capacity will not be priced starting at the base with a higher price per unit, but on the capacity that is already installed.

Note that Value Units of a given product cannot be exchanged, interchanged, aggregated with Value Units of another product.

IPLA and Subscription and Support considerations

IBM International Program License Agreement (IPLA) licenses can be transferred from one machine to another within, but not limited to an enterprise. The customer may aggregate the capacity for all the processors the product is operated on to achieve a more economic price. This will result in a single Proof of Entitlement. It is the customer's responsibility to manage the distribution of Value Units within the limits of the entitlement of the product license.

Subscription and Support must cover the same capacity as the product license entitlement. Subscription and Support will be available in the country in which the agreement is made.


IMS is a trademark of International Business Machines Corporation in the United States or other countries or both.
z/OS, AIX, OS/400, and DB2 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
Offering information

Product information will be available through the Offering Information Web site at

Back to top

One copy of the following publications is supplied automatically with the basic machine-readable material and can be ordered immediately after planned availability:

Title                                        number
IBM Migration Utility for
 z/OS(R) V2.1.0
  License Information                        GC31-8962
  Program Directory                          GI10-3340

The following publication cannot be ordered in hardcopy. The publication is available on the Web

IBM Migration Utility for z/OS User's Guide and Reference User's Guide and Reference

Displayable softcopy publications: The IBM Migration Utility for z/OS User's Guide and Reference is provided in displayable softcopy form. The files are shipped on the same media type as the basic machine-readable material.

Terms and conditions for use of the machine-readable files are shipped with the files.
Back to top

Technical information

Specified operating environment

Hardware requirements

Migration Utility for z/OS V2.1 operates on any hardware that runs one of the following:

  • OS/390® V2.10 (5647-A01), or later
  • z/OS V1.2 (5694-A01), or later

Software requirements

Migration Utility for z/OS V2.1 operates on either of the following:

  • OS/390 V2.10 (5647-A01), or later
  • z/OS V1.2 (5694-A01), or later

Packaging: IBM Migration Utility for z/OS is distributed with the following content:

  • Basic machine-readable material
  • Program Directory
  • Proof of Entitlement (PoE)
  • IBM International Program License Agreement (IPLA)
  • License Information

Back to top
Ordering information

Value Unit exhibit VUE007

                 MSUs               MSUs               Value
                 minimum            maximum            units/MSU
Base               1                  3                1
Tier A             4                 45                0.45
Tier B            46                175                0.36
Tier C           176                315                0.27
Tier D           316                  +                0.2

Value Units for non-MSU-based S/390® processors:

Hardware                         machine
MP3000 H30                        6
MP3000 H50                        8
MP3000 H70                       12
ESL Models                        2

Ordering example: The total number of Value Units is calculated according to the following example.

If the customer has installed 1,500 MSUs, the applicable Value would be:

Translation from MSUs to Value Units

                                   Units/                 Value
             MSUs         *        MSU           =        Units
Base             3        *        1.00          =          3.00
Tier A          42        *         .45          =         18.90
Tier B         130        *         .36          =         46.80
Tier C         140        *         .27          =         37.80
Tier D       1,185        *         .20          =        237.00
Total        1,500                                        343.50

When calculating the total number of Value Units, the sum is to be rounded up to the next integer.

Example: In the above ordering example, for the product running on a machine with 1,500 MSUs requiring 344 Value Units, order feature number 0001, quantity 94, and feature number 0002, quantity 1.

Ordering z/OS through the Internet

ShopzSeries provides an easy way to plan and order your z/OS ServerPac or CBPDO. It will analyze your current installation, determine the correct product migration, and present your new configuration based on z/OS. Additional products can also be added to your order (including determination of whether all product requisites are satisfied). ShopzSeries is available in the U.S. and several countries in Europe. In countries where ShopzSeries is not available yet, contact your IBM representative (or Business Partner) to handle your order via the traditional IBM ordering process. For more details and availability, visit the ShopzSeries Web site at

The products in this announcement have one charge unit — Value Units.

Value Units for IBM 9672 Processors will be based upon the full capacity of these systems. This is applicable to all S/390-based systems that are measured on MSU capacity. Information on MSU capacities can be found in the "IBM System/370™, System/390®, and zSeries® Machine Exhibit," Z125-3901.

Value Units for zSeries will be based upon full MSU capacity as defined in the Machine Exhibits.

There will be a tool available that provides support for transforming the MSU-based capacities of S/390 systems to new Value Units by calculating the applicable number of Value Units for a given number of MSUs.

Basic license: To order, specify the program number, feature number 9001 for asset registration, and the one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium. To suppress shipment of media, select the license-only option in CFSW.

Translation from MSUs to Value Units

                             MSUs                         MSU
Base                           1-3                        1.00
Tier A                         4-45                       0.45
Tier B                        46-175                      0.36
Tier C                       176-315                      0.27
Tier D                       316+                         0.20

                              Program     entity
Description                   number      MMID
Migration Utility for         5697-I89    S010WT0
 z/OS V2.1

                                    OTC      Medium
                          Program   feature  feature
Description               number    number   number      Medium
Migration Utility for     5697-I89           5802        3480 tape
 z/OS V2.1
  1 Value Unit                      0001
  250 Value Units                   0002

Single version charging: To elect single version charging, the customer must notify and identify to IBM the prior program, replacement program, and the machine on which the programs are operating.

On/Off Capacity on Demand

Program    Feature
number     number    Description
5697-I89   0003      MSU-DAY(s)- Temporary Use
5697-I89   0004      MSU-DAY QTY 250-Temporary Use

Customized Offerings

Product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Back to top

Terms and conditions

Licensing: IBM IPLA. PoEs are required for all authorized use.

These products are licensed under the IPLA, the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6312) which provides for support with ongoing access to releases and versions of the program. 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. S/390 and zSeries IBM Operational Support Services — SoftwareXcel is an option for those customers who desire added services.

Limited warranty applies: Yes

Money-back guarantee: If for any reason you are dissatisfied with the Program, return it within 30 days from the invoice date, to the party (either IBM or its reseller) from whom you acquired it, for a refund. This applies only to your first acquisition of the Program.

Copy and use on home/portable computer: No

Volume orders (IVO): No

Passport Advantage® applies: No

Software Maintenance applies: No

For Operating System software, the revised IBM Operational Support Services — SoftwareXcel offering will provide support for those operating systems and associated products that are not available with the newly announced Software Maintenance offering. This will ensure total support coverage for your enterprise needs, including IBM and selected non-IBM products. For complete lists of products supported under both the current and revised SoftwareXcel offering, refer to our Web site at

For additional information on the revised IBM Operational Support Services, refer to Services Announcement 601-023 , dated July 10, 2001.

AIX®/UNIX® Upgrade Protection applies: No

Entitled Upgrade for current AIX/UNIX Upgrade Protection licensees: No

iSeries™ Software Subscription applies: No

Variable charges apply: No

Educational allowance available: Yes, 15% education allowance applies to qualified education institution customers.

Replaced Program                Replacement Program
Program      Program            Program        Program
number       name               number         name
 5655-I18    Migration Utility  5697-I89       Migration Utility
              for z/OS and                      for z/OS V2.1
              OS/390 V1.1

Sub-capacity charges terms and conditions

IBM eServer zSeries software charges at less than full machine capacity for eligible tools apply when z/OS is running in z/Architecture™ (64 bit) mode on a zSeries 900, no other MVS™-based operating system is licensed to that server, and the required information is provided by the customer in accordance with the applicable terms.

Sub-capacity charges for an eligible tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for eligible tools, the customer is required to:

  • Determine the MSUs needed for each machine on which the tools will run. Only machines on which the customer has implemented sub-capacity Workstation License Charges (WLC) according to the above terms and conditions, are eligible for charges at less than full machine capacity for the tools.
  • Use the product defined capacity for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.

Sub-capacity charges for tools

To be eligible for sub-capacity charges for tools, the machine on which the tools are running must be eligible for WLC sub-capacity charges terms and conditions. The customer must have signed the Attachment for zSeries Workload License Charges-Pre-ILM, Z125-6516, and submitted at least one Sub-Capacity Report to IBM as defined in the attachment.

With sub-capacity charges, the charge for an eligible tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for each eligible tool for each machine, the customer should:

  • Determine the MSUs needed for the machine on which the tools will run. In a data sharing environment, determine the aggregate MSUs needed on the machine where the tools run. Use the product defined capacity (MSUs) for z/OS (as specified on the Sub-Capacity Reports submitted to IBM for sub-capacity WLC) as the sub-capacity (MSUs) for each Tool.
  • Submit any additional MSUs and/or Value Units required for each product along with the current entitlement in Value Units for each product.
  • If the use of sub-capacity pricing terms for tools results in a reduced requirement for Value Units, thus freeing up entitlements, customers can reallocate the entitlement difference by distributing the Value Units across a larger or different set of systems, or reserve them for future growth. There will be no refunds for these freed up Value Units. Subscription and Support volumes and entitlements for existing contracts will continue to be at the same levels as the acquired licenses.

Management of the Value Unit entitlements continues to be a customer responsibility. If one of the following occur on a machine to which tools are licensed, the customer must determine if additional Value Units and Subscription and Support need to be ordered for those tools to cover the increase:

  • The z/OS-defined capacity is increased
  • The requirements for WLC sub-capacity charges are no longer met

On/Off Capacity on Demand

To be eligible for On/Off Capacity on Demand pricing, customers must be enabled for temporary capacity on the corresponding hardware, and the required contract — Z125-6611, Amendment for Customer Initiated Upgrade and IBM eServer® On/Off Capacity on Demand - Software — must be signed prior to use.
Back to top


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.

Program Name: IBM Migration Utility for z/OS V2.1

                          Program    feature
Description               number     number  OTC
Migration Utility for     5697-I89
 z/OS V2.1
     1 Value Unit                    0001    $  1,560
   250 Value Units                   0002     390,000
     1 MSU Day                       0003           4
   250 MSU Days                      0004       1,000

Global Financing

IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our 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)
 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.


System/370, iSeries, MVS, and z/Architecture are trademarks of International Business Machines Corporation in the United States or other countries or both.
The e-business logo, z/OS, OS/390, S/390, System/390, zSeries, Systempac, Passport Advantage, AIX, and eServer are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
UNIX 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.

Back to top

Printable version  

Share this page

Digg Linked In

Contact IBM

Considering a purchase?