Feedback
IBM United States
Software Announcement 202-114
June 18, 2002

IBM Merge Tool for z/OS and OS/390 — Merges Parallel Development

 ENUS202-114.PDF (46KB)


At a Glance

The IBM Merge Tool for z/OS and OS/390:

  • Provides the tools necessary to identify, analyze, and consolidate independently coded changes that affect the same source
  • Assists project management with analysis, providing the details required for accurately determining what resources are needed for the consolidation effort
  • Assists programmers in isolating conflicting changes and addressing the conflicts
  • Assists programmers in the actual consolidation of several independently coded versions of source

For ordering, contact:

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

Overview

The Merge Tool for z/OS™ and OS/390® is a source code merging utility that automatically merges up to two versions of source code with the original or base version of source. The merge process produces three major outputs:

  • A marked-up (work) file member, created to show the results of merging the two versions. It highlights inserted, deleted, moved and conflicting lines.
  • A merged file member containing all modifications to the source members.
  • Statistics showing the number of modifications broken down into inserted, deleted and shifted lines. The statistics also show the number of conflicting modifications.

The Merge Tool will enable both project management and programmers to:

  • Address the common problems that originate with parallel development
  • Perform their tasks, with the details required, in a timely and accurate manner

Key Prerequisites

One of these operating systems:

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

Planned Availability Date

June 21, 2002

Description

The Merge Tool provides the tools required by both project management and programmers to manage the task of consolidating source where parallel development occurs. Whether the parallel development effort is of a simple or complex nature the task and tools are the same. What will change is who will use the tools and perform the tasks.

Interactive Structured Programming Facility (ISPF) Workbench

A simple-to-use ISPF front-end allows for fast access to source members and programmer functions such as editing Work File members. Generated member lists can then be used as the object of the Merge Tool actions and reports in foreground or batch through a single ISPF panel.

Reports

The Merge Tool provides reports that will assist in the assessment of the effort required for merging the source members. Of particular significance are statistics for conflicting modifications for each member.

The Merge Tool Actions

A variety of actions are available to perform the merge tasks. The user can determine the degree of the merge action based on the complexity of the changes.

Batch Utility

A batch utility is available to perform most actions that are available in the ISPF Workbench.

Work File

Output from the initial combination of source is also known as the mark-up file. The first seven bytes of this file indicate the merge activity that will take place. This is the sole input to the merge action.

Globalization Support

This initial release of Merge Tool provides English language single-byte character support (SBCS).

Value Unit-Based Pricing

Value Unit-based pricing will help to align the prices of this product to the principle of the Parallel Sysplex® License Charge (PSLC) pricing curve which provides for a lower price per MSU (millions of service units per hour) 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, that is, 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: Value Units of a given product cannot be exchanged/interchanged/aggregated with Value Units of another product.

IBM Programming License Agreement (IPLA) and Subscription & Support Considerations

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 (PoE). It is the customer's responsibility to manage the distribution of Value Units within the limits of the PoE of the product license.

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

Trademarks

 
z/OS is a trademark of International Business Machines Corporation in the United States or other countries or both.
 
OS/390 and Parallel Sysplex 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.

Offering Information

Product information is available through Offering Information (OITOOL) at:

Publications

One copy of each of the following publications is supplied automatically with the basic machine-readable material:

                                                       Order
Title                                                  Number
 
IBM Merge Tool for z/OS(TM) and OS/390(R)
 V1.1.0
  License Information (LI)                             GC27-1695
  Memo to User                                         GI10-8482
  Program Directory                                    GI10-8464

Technical Information

Hardware Requirements

The Merge Tool for z/OS and OS/390 operates on any hardware which runs OS/390 V2.10, or later (5647-A01) or z/OS V1.1, or later (5694-A01).

Software Requirements

The Merge Tool for z/OS and OS/390 operates on OS/390 V2.10, or later (5647-A01) or z/OS V1.1, or later (5694-A01).

Planning Information

Customer Responsibilities

Packaging: The Merge Tool (5697-H70) is distributed with the following content:

  • Basic machine-readable material
  • Program Directory
  • Memorandum to User
  • Proof of Entitlement (PoE)
  • IBM International Program License Agreement (IPLA)
  • LI

Ordering Information

The product in this announcement has one charge unit, Value Units.

Value Unit Exhibit VUE007

                                 Value                 Value
                                 Units/                Units/
Usage Level    Minimum  Maximum   MSU     HW            Machine
 
Base              1        3      1       MP3000 H30       6
PSLC/Level A      4       45      0.45    MP3000 H50       8
PSLC/Level B     46      175      0.36    MP3000 H70      12
PSLC/Level C    176      315      0.27    ESL Models       2
PSLC/Level D    316        +      0.2

The product in this announcement has 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.

Translation from MSUs to Value Units Example

               MSUs       Value Units/MSU
Base           1-3            1.00
Tier A         4-45            .45
Tier B        46-175           .36
Tier C       176-315           .27
Tier D       316+              .20

Note: For the actual translation from MSUs to Value Units for this product, see below.

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

If the customer has installed 1100 MSUs, the applicable Value Units would be:

Translation from MSUs to Value Units

 
              MSUs    x  Value Units/MSU  = Value Units
  Base          3     x      1.00         =      3.00
  Tier A       42     x       .45         =     18.90
  Tier B      130     x       .36         =     46.80
  Tier C      140     x       .27         =     37.80
  Tier D      785     x       .20         =    157.00
 
  Total      1100                              264

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

                                                  Feature
                                                  Number
 
  1 Value Unit                                    0001
250 Value Units                                   0002

Example: For a product running on machines with 1000 MSUs requiring 270 Value Units, would order feature number 0001, quantity 20 and feature number 0002, quantity 1.

Note: For actual feature numbers, see below.

Value Units for non MSU-based S/390 Processors:

  MP3000 Models
      H30       =   6.00  Value Units
      H50       =   8.00  Value Units
      H70       =  12.00  Value Units
 
 P/390, R/390, IBM 3006  =   2.00 Value Units

Basic License: To order, specify the program number (5697-H70), 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 the configurator aid CFSW.

                         OTC            Medium
                         Feature        Feature
Description              Number         Number         Medium
 
IBM Merge Tool                          5802           3480 Tape
  1 Value Unit           0001
250 Value Units          0002

To order the SW Subscription & Annual Support, specify program number 5655-I41 and the feature number from the table below. The quantity of SW Subscription & Support licenses must be equal to the number of OTC licenses ordered.

                                   Subscription/
                                   Support             Standard
                                   for                 ASC(1)
                                   Program             Feature
Program Name                       Number              Number
 
Subscription & Support for         5655-I41
 IBM Merge Tool Annual
    1 Value Unit                                       0001
  250 Value Units                                      0002
NC(2) -- Decline SW S&S                                0003
1
Annual support charge
2
No Charge

                         OTC            Medium
                         Feature        Feature
Description              Number         Number         Medium
 
5697-H70
 
IBM Merge Tool                          5802           340 Tape
   1 Value Unit          0001
 250 Value Units         0002

Subscription & Support: To receive voice technical support via telephone during normal business hours, and future releases and versions at no additional charge, Subscription & Support must be ordered. The capacity of Subscription & Support (Value Units) must be the same as the capacity ordered for the product licenses.

To order, specify the support program number and feature number 9001 for asset registration. IBM is also providing subscription and support for this product via a separately purchased offering under the terms of the IBM International Agreement for Acquisition of Support (IAAS). This offering:

  • Includes and extends the support services provided in the base support to include technical support via telephone during normal business hours.
  • Entitles customers to future releases and versions at no additional charge as. The customer is not entitled for new products.

Once subscription and support is ordered, the charges will renew automatically annually unless cancelled by the customer.

                                   ASC       Medium
                                   Feature   Feature
Description                        Number    Number    Medium
 
5655-I41
 
Subscription & Support                       6636      Hardcopy
 for IBM Merge Tool
    1 Value Unit                   0001
  250 Value Units                  0002
NC -- Decline SW S&S               0003

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

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.

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.

Terms and Conditions

Sub-Capacity Charges Terms and Conditions

IBM eServer zSeries software charges, at less than full machine capacity for eligible data management (DM) and application development (AD) tools, apply when z/OS is running in z/Architecture (64-bit) mode on an 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 DM or AD tool is based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for eligible AD and DM 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 Workload License Charge (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 AD and DM Tools

To be eligible for sub-capacity charges for AD and DM tools, the machine on which the AD and DM 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 AD or DM tool is based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for each eligible AD and DM 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 AD and DM 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 & 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 AD or DM Tools are licensed, the customer must determine if additional Value Units and Subscription & 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.

Licensing: IPLA. Proofs of Entitlement are required for all authorized use.

The IBM Agreement for Acquisition of Support (Z125-6011) applies for maintenance and does not require customer signatures.

This product is licensed under the IPLA, and 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 ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) and access to updates, releases, and versions of the program as long as support is in effect. S/390 and zSeries IBM Operational Support Services — Support Line is an option for those customers who desire added services.

Limited Warranty Applies: Yes

Program Services: Available until June 21, 2004

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 — Support Line 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 Support Line offering, refer to our Web site at:

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

IBM Operational Support Services — Support Line: No

AIX®/UNIX® Upgrade Protection Applies: No

Entitled Upgrade for Current AIX/UNIX Upgrade Protection Licensees: No

IBM eServer™ iSeries Software Subscription Applies: No

Variable Charges Apply: No

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

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.

                                        OTC
                         Program        Feature
Description              Number         Number         OTC
 
IBM Merge Tool           5697-H70
    1 Value Unit                        0001           $  1,800
 250 Value Units                        0002            450,000

To order the SW Subscription & Annual Support, specify program number 5655-I41 and the feature number from the table below. The quantity of SW Subscription & Support licenses must be equal to the number of OTC licenses ordered.

                                   ASC
                                   Feature
Program Name                       Number              ASC
 
Subscription & Support for IBM Merge Tool (5655-I41)
 
  1 Value Unit                     0001                $   270
250 Value Units                    0002                 67,500
NC -- Decline SW S&S               0003                     NC

Customer Financing: IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners to assist them in acquiring IT solutions. Offerings, rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:

Use the "Select a Country" menu to find a contact in your location or country.

Order Now

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

 
zSeries is a trademark of International Business Machines Corporation.
 
z/OS, System/370, MVS, e-business logo, and IBM eServer are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, S/390, System/390, Systempac, and AIX are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
UNIX is a registered trademark is a registered trademark of the Open Company in the United States and other countries.
 
Other company, product, and service names may be trademarks or service marks of others.