IBM United States
Software Announcement 203-198
August 5, 2003

IBM CICS Interdependency Analyzer for z/OS V1.2 helps identify resource interdependencies within CICS systems

 ENUS203-198.PDF (44KB)

(Corrected on September 15, 2003)

The seventh bullet in the Overview has been modified.

At a glance

The IBM CICS Interdependency Analyzer for z/OS (CICS IA) helps users better understand the make-up of their application set, improving their ability to maintain and enhance the applications. V1.2 of CICS IA delivers a range of enhancements, including extended support for CICS commands, support for EXEC calls to DB2, IMS, and WebSphere MQ, and the ability to hold information on multiple CICS regions in one VSAM file.

For ordering, contact:

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

Overview

The IBM CICS® Interdependency Analyzer for z/OS® (CICS IA) is a run-time tool for use with CICS Transaction Server for OS/390® or CICS Transaction Server for z/OS. By identifying sets of CICS resources used by individual CICS transactions, and their relationships to other CICS resources, it enables users to understand the make-up of their application set, including:

  • What a CICS region contains
  • What resources a transaction needs in order to run
  • Which programs use which resources
  • What resources are no longer used

This gives users a much improved ability to maintain, enhance, modify, or redistribute their application portfolio. While CICS is running, interdependencies are captured as they occur, then stored in a VSAM file. In turn, this is loaded to a DB2® database, from which these resource relationships can be displayed. Summary and detailed reports can be printed from the VSAM file.

V1.2 of CICS IA delivers a range of enhancements, including the following:

  • Support for CICS TS V2.2 commands supporting long TS Queue names, FEPI, TCP/IP, Web, and Java™ resources
  • Support for SYSID information even where not specified in the EXEC CICS command
  • Inclusion of calls to DB2, IMS™, and WebSphere® MQ remote resources
  • The ability to hold information on several CICS regions in one VSAM RLS file
  • Provision of a single point of control at one terminal for configuring CICS IA options for each region
  • The ability to view the last date on which a CICS resource was used

Key prerequisites

CICS IA V1.2 requires OS/390 V2.10, or later, and is for use with CICS Transaction Server for OS/390 V1.3 or CICS Transaction Server for z/OS V2.2.

Planned availability date

September 26, 2003

Description

The IBM CICS Interdependency Analyzer for z/OS (CICS IA) is a run-time tool for use with CICS Transaction Server that identifies the sets of CICS resources used by individual CICS transactions, and their relationships to other CICS resources. It runs as a set of exits in each chosen CICS region, and intercepts the EXEC CICS commands (and some other commands), and records the associated resource interdependencies: transactions, programs, BMS maps, files, TS queues, TD queues, and so on. This enables the user to see what a CICS region contains; what resources a transaction needs in order to run; which programs use which resources; and what resources are no longer used. This knowledge greatly improves the ability to enhance, modify, or optimize the portfolio of applications.

CICS IA V1.2 is comprised of the following principal components:

  • Collector — This is an exit-driven function that captures the interdependencies as they occur in each enabled CICS region, and stages the writing of these interdependencies to an MVS™ dataspace. An asynchronous transaction then copies these interdependencies to a VSAM file. The VSAM file can be used to rebuild the dataspace at CICS restart.
  • Query Database — This DB2 database is loaded from the VSAM files under operator control, and provides the interdependency information to the Query Interface.
  • Query Interface — This interface displays any CICS resource-to-resource relationships from the Query Database. It displays end-to-end relationships such as the files used by a transaction and the functions involved like browse, update, and so on.
  • Scanner — This is a static function which produces summary and detailed printed reports on the EXEC CICS commands it finds in modules in an application load library.
  • Reporter — This function reports on the selected CICS commands that were executed and captured by the Collector and stored in VSAM files. The reports can be printed or displayed.

Important enhancements delivered in CICS IA V1.2 include the following:

  • CICS IA V1.2 supports all CICS commands up to and including those of CICS TS V2.2. This means that long TS Queue names, FEPI, TCP/IP, Web, and Java resources are now supported.
  • SYSID information for EXEC CICS commands is collected, even where the SYSID is not specified in the command itself but is set by other means, for example by an exit (such as in workload balancing or a customer exit). This function requires APAR PQ76355 for CICS Transaction Server for OS/390 V1.3, or APAR PQ76357 for CICS Transaction Server for z/OS V2.2. These will be made available by the end of 2003.
  • To gain a fuller picture of the resources used by a transaction, resource relationships are now collected and queried for the following non-CICS EXEC calls:
    • EXEC SQL calls to DB2 Universal Database® resources
    • EXEC DLI calls to IMS Database resources (to be delivered via the service channel at a later date)
    • EXEC MQM calls to WebSphere MQ resources
  • It is now possible for the user to gather resource information for several CICS regions into one VSAM Record Level Sharing (RLS) file.

An online interface is provided where the user can maintain the status of the CICS IA Collectors in all enabled CICS regions from one CICS terminal. This gives a single point of control for configuring CICS IA options for each region. This is dependent on the use of VSAM RLS.

Information is now available via the Reporter on the date when a resource was last used. This can be used for housekeeping of CICS resource definitions.

Accessibility by people with disabilities

The CICS Interdependency Analyzer V1.2 is operated using the keyboard. The product displays standard 3270 panels which have been tested for use by people with visual impairment using the JAWS screen reader. The product documentation, the User's Guide and Reference , is provided in softcopy (PDF) format.

Section 508 of the U.S. Rehabilitation Act

IBM CICS Interdependency Analyzer for z/OS V1.2 is capable as of September 26, 2003, 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 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, 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

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.

Product positioning

CICS Interdependency Analyzer for z/OS helps users to understand the resource usage in their CICS systems in order to help with decisions on changing and improving systems, such as:

  • Splitting workload and moving applications to more CICS regions
  • Allowing the benefits of workload balancing to be exploited across CICSPlex® and Sysplex
  • Maintaining, enhancing, and migrating business applications

Information provided by CICS IA is vital when planning improvements or expansion of a system. It is ideal when systems are being merged or consolidated, for example, as a result of a company acquisition.

Customers who are using CICS Transaction Affinities Utility (a component of CICS Transaction Server) to identify the affinities within their CICS systems will benefit from the additional capabilities of cross-system analysis which CICS IA provides.

CICS IA and WebSphere Studio Asset Analyzer (WSAA) complement each other to provide a complete and accurate picture of CICS applications. The principal objective of CICS IA is improved application maintenance, whereas the purpose of WSAA is improved reuse of applications. CICS IA looks at the data as the product is running, whereas WSAA looks at the source; CICS IA looks at data over a period of time, whereas WSAA is static; CICS IA presents its data via the 3270 interface or in reports, whereas WSAA employs a browser interface.

Trademarks

 
IMS and MVS are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
CICS, z/OS, OS/390, DB2, WebSphere, DB2 Universal Database, and CICSPlex are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Java is a trademark of Sun Microsystems, Inc.
 
Other company, product, and service names may be trademarks or service marks of others.

Offering information

Product information will be available on day of announcement through Offering Information Web site at:

Publications

The following publications are provided for this product:

Title                                        Order number
 
CICS(R) Interdependency Analyzer:            SC34-6080
 User's Guide and Reference
 
CICS Interdependency Analyzer:               GI10-2547
 Program Directory

The Program Directory is delivered in hardcopy; it is also available in softcopy, in PDF format. Note that the User's Guide and Reference is no longer provided in hardcopy. It is available in PDF format for download from the IBM Publications Center, at:

Download is free of charge. If hardcopy is required, it can be printed from the PDF.

Technical information

Specified operating environment

Hardware requirements

IBM CICS Interdependency Analyzer for z/OS® V1.2 operates on any hardware that supports the prerequisite Operating System and CICS Transaction Server.

Software requirements

IBM CICS Interdependency Analyzer for z/OS V1.2 operates with the following CICS and Operating System levels:

  • OS/390® (5647-A01) V2.10, or z/OS (5694-A01) at any level
  • CICS Transaction Server for OS/390 V1.3 (5655-147) or CICS Transaction Server for z/OS V2.2 (5697-E93)

If the user wishes to share VSAM files across CICS regions within a SYSPLEX, the VSAM RLS function of DFSMS is required.

CICS IA V1.2 requires OS/390 or z/OS SMP/E for installation and maintenance.

CICS IA V1.2 requires access to DB2® Universal Database® Server for OS/390 V6.1 (5645-DB2), or later

Planning information

Packaging: The package in which the product is delivered contains:

  • The product, on 3480 1/2-inch tape cartridge
  • Printed Program Directory (GI10-2547)
  • License Information (GC34-6081)
  • IPLA Booklet (Z125-3301)
  • Proof of Entitlement

Security, auditability, and control

IBM CICS Interdependency Analyzer for z/OS V1.2 uses the security and auditability features of the supported Operating systems.

The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

Ordering information

IBM CICS Interdependency Analyzer for z/OS V1.2 is licensed under the IBM International Program License Agreement (IPLA). It has a single one time license charge (OTC) based on Value Units for program usage, and an annual recurring charge for enhanced support that includes telephone assistance, service, and future product updates (enhancements and new versions or releases).

The ordering information for CICS IA V1.2 is unchanged from that previously announced for CICS IA V1.1, in Software Announcement 201-339 , dated December 14, 2001.

When this new release is available, the prior release, CICS IA V1.1, will no longer be available.

Existing customers who purchased CICS IA V1.1 with a current Software Subscription and Support agreement (5655-G77) are entitled to receive CICS IA V1.2 at no charge. A new order must be placed for the product, with delivery of media via the customized offerings.

Customers who do not have a current Software Subscription and Support agreement but wish to upgrade to this new release must either:

  • Place a new order for the product, or:
  • Purchase Software Subscription and Support, backdated to the date on which their current release of CICS IA was ordered. They can then place a new order for the product, and will receive CICS IA V1.2 at no charge.
Value Unit Exhibit VUE007

             MSUs        MSUs         Value Units/
             minimum     maximum      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                 Value Units/
                         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
 
                            Value
             MSUs     *     Units/MSU    =     Value 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 (formerly SHOPS390) 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.

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

                                 Medium
                    Program      feature
Description         number       number     Medium
 
CICS IA             5655-G76     5802       3480 1/2-inch
                                             tape cartridge
 
CICS IA --
 Software
 Subscription       5655-G77     6535       Paper
 and Support

Translation from MSUs to Value Units
 
               MSUs         Value Units/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

                                             One-
                                             Time
                                             Charge
                              Program        feature
Description                   number         number
 
CICS Interdependency          5655-G76
 Analyzer for z/OS
 
1 Value Unit                                 0001
250 Value Units                              0002

Subscription and Support

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

To order, specify the support program number, 5655-G77, feature number 9001 for asset registration, and the applicable feature number from the table below. IBM is also providing subscription and support for these products 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. Note that customer is not entitled to new products.

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

                                           Annual
                                           Support
                                           Charge
                              Program      feature
Description                   number       number
 
CICS Interdependency          5655-G77
 Analyzer for z/OS --
 Subscription and Support
 
1 Value Unit                               0001
250 Value Units                            0002
Decline SW Subscription
 and Support (no charge)                   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.

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), Application Development (AD) and CICS 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 AD, DM, or CICS Tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for eligible AD, DM and CICS 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 AD, DM and CICS tools

To be eligible for sub-capacity charges for AD, DM and CICS Tools, the machine on which the AD, DM and CICS 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, DM or CICS Tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for each eligible AD, DM, and CICS 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, DM, and CICS 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 AD, DM or CICS 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.

Licensing: IBM International Program License Agreement. Proofs of Entitlement (PoEs) are required for all authorized use.

These products are licensed under the IBM Program License Agreement (IPLA), and the associated Agreement for Acquisition of Support, and the Addendum for Support Z125-6435 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) 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 — Support Line is an option for those customers who desire added services.

Limited warranty applies: Yes

Warranty: This program has warranty for a minimum of one year from acquisition from IBM or authorized business partner. The warranty provided to the customer, for at least one year from acquisition, is access to data bases (read Web sites )for program information, FAQs, including any known fixes to defects, which the customer can download or obtain otherwise and install at their leisure.

Program support: Enhanced Support, called Subscription and Support, 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. The customer will be notified of discontinuance of support with 12 months notice.

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 Services Announcement 601-023 , dated July 10, 2001.

IBM Operational Support Services — Support Line: Yes

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.

Prices

The existing prices for CICS Interdependency Analyzer for z/OS Version 1 are unaffected by this announcement. For price information, contact your IBM representative.

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:

Order now

To order, contact the Americas Call Centers, your local IBM representative, or your IBM Business Partner.

To identify your local IBM representative or IBM Business Partner, call 800-IBM-4YOU (426-4968).

 Phone:     800-IBM-CALL (426-2255)
 Fax:       800-2IBM-FAX (242-6329)
 Internet:  ibm_direct@vnet.ibm.com
 Mail:      The Americas Call Centers
            Dept. LE001
            P.O. Box 2690
            Atlanta, GA  30301-2690
 
 Reference: LE001

The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.

Note: Shipments will begin after the planned availability date.

Trademarks

 
The e-business logo, System/370, z/Architecture, MVS, and iSeries are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
CICS, z/OS, OS/390, DB2 Universal Database, DB2, S/390, System/390, zSeries, Systempac, Passport Advantage, and AIX 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.
 
Requisite is a registered trademark of IBM Corporation and Rational Software Corporation, in the United States, other Countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.