IBM CICS Interdependency Analyzer for z/OS V1.3 also analyzes transaction affinities

IBM United States Software Announcement 204-190
August 17, 2004


 ENUS204-190.PDF (58KB)

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


Back to top

CICS® Interdependency Analyzer (CICS IA) for z/OS® V1.3 is a tool for use with CICS Transaction Server (CICS TS) on the mainframe, which identifies the resources used by CICS transactions and the relationships between them. Resources identified include those associated with transactions, programs, Basic Mapping Support (BMS) maps, files, temporary storage (TS) queues, transient data (TD) queues, 3270 Bridge facility, Web Services, CorbaServer, and Enterprise JavaBeans(5) (EJBs).

It also reports on DB2®, IMS™, and MQ resources which are used by CICS. This information helps to improve your capability and efficiency in maintaining and enhancing your critical CICS applications. It helps speed CICS application migration and reuse, and increases CICS system availability.

Enhancements in this release include:

  • Affinities data captured by the Transaction Affinities utility in CICS can be loaded into DB2 tables for analysis. The query interface has been updated for affinities.
  • Improvements in the data collected for DB2 subsystem resources.
  • Length of resource names increased from 50 to 200 bytes, to accommodate ENQ/DEQ names.
  • Sample SQL queries that allow resource comparisons on the data in DB2 tables.
  • New procedures, including sample data, for the installation process.
  • Task Control Block data is collected, to assist in assessing threadsafe aspects of CICS-DB2 programs.
  • Main, auxiliary, and Coupling Facility temporary storage queues are differentiated.
  • Sample SQL queries to allow housekeeping functions on the DB2 data.

Back to top
Key prerequisites

CICS Interdependency Analyzer for z/OS V1.3 may be used with CICS TS for OS/390® V1.3, or CICS Transaction Server for z/OS V2.2, or later.
Back to top

Planned availability date

September 24, 2004

For ordering, contact:

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


CICS IA is a run-time tool for use with CICS TS for OS/390 or CICS TS for z/OS 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 certain others, and records the associated resource interdependencies including transactions, programs, BMS maps, files, TS queues, TD queues, 3270 Bridge facility, Web Services, CorbaServer, and EJB resources. 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
  • What resources are no longer used

In addition, CICS IA analyzes transaction affinities data, both inter-transaction affinities and transaction-system affinities. This information is essential when implementing dynamic workload balancing.

CICS IA also collects details about and reports on inter-relationships between CICS and DB2, IMS, and MQ resources. The availability of this information greatly improves the ability to maintain, enhance, modify, or optimize the portfolio of applications, speed application reuse as e-business applications, and implement dynamic workload balancing for continuous availability.

CICS IA V1.3 is made up of the following principal components:

  • Collector — This exit-driven function captures the interdependencies and (in this release) affinities as they occur in each enabled CICS region, and stages the writing of these interdependencies and affinities to an MVS™ dataspace. An asynchronous transaction then copies these interdependencies and affinities to a VSAM file. The VSAM file or files can be used to rebuild the dataspace at CICS restart.
  • Dependency database — This DB2 database is loaded from the VSAM files under operator control, and provides the interdependency and affinity 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 such as browse and update.
  • Scanner — This static function 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.

A range of significant enhancements is now delivered in CICS IA V1.3. These include:

  • A batch job is provided to load data captured by the Transaction Affinities utility (part of CICS TS) into DB2 tables for analysis. Extensions are provided to the SQL query interface to assist in analysis of data in the affinities data tables. This new capability allows you easily to view and analyze the affinity information collected in multiple CICS regions from a single point of control.
  • A set of sample SQL queries is provided to allow resource comparisons on the data in the DB2 tables. These enable basic predictive capabilities, for example:
    • Comparison of applications across regions
    • Comparison of all interdependencies across regions
  • Improved data capture facilities are provided in the Collector for the DB2 subsystem, so that it now identifies the resource name whenever possible.
  • The Collector function has been extended so that it now supports long resource names of up to 200 bytes, rather than the previous restriction to 50 bytes.
  • New installation verification procedures, including sample data, are now provided to assist the installation process.
  • Task Control Block (TCB) information is now added to the data gathered by the collector. This may be used, for example, to identify CICS-DB2 programs that are not threadsafe, and thus help in migrating these programs to be threadsafe.
  • A new capability allows differentiation between types of Temporary Storage Queues (TSQs) — Main, auxiliary, and Coupling Facility.
  • A set of sample SQL queries and jobs is provided to allow housekeeping functions to be performed on the data in the DB2 tables. For example:
    • Delete all resources captured before a given date
    • Delete all resources for a given application

Accessibility by people with disabilities

CICS IA V1.3 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. It communicates information independently of color. Its product documentation, the User's Guide and Reference , is provided in accessible softcopy (PDF) format.

Section 508 of the U.S. Rehabilitation Act

IBM CICS Interdependency Analyzer for z/OS V1.3 is capable as of September 24, 2004, when used in accordance with IBM 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 align the prices of these products 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 a price benefit when customers grow their capacity. Additional capacity will be 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, or 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.
Back to top

Product positioning

Are you looking to integrate your core business applications running in CICS with the new e-business applications and processes? Or are you looking to reduce the cost of current application maintenance? Is your information about existing applications incomplete?

IBM delivers a number of discovery solutions for the process of understanding, preserving, evolving, and integrating existing applications with new on demand e-business application models. Studies have shown that creating new code can be significantly more costly than reusing existing code. When an organization can reuse existing code that has provided business value for years, and which is tuned and deployed, the savings are potentially dramatic.

Discovery solutions are those that provide system inventory, application understanding and componentization. WebSphere® Studio Asset Analyzer and CICS IA are offerings in the discovery solutions category.

WebSphere Studio Asset Analyzer assists IT personnel with the maintenance and extension of existing assets through impact analysis and application understanding. It helps enterprise customers modernize their existing enterprise assets and skills by providing knowledge about their static environments (finding and reusing application code and the componentry that connects that code), and their dynamic environments (understanding what code is executing in run-time environments).

CICS IA provides additional information about run-time resource dependencies within your CICS systems. When documentation is lost or incomplete, or source code is unavailable, CICS IA automates the collection of runtime cross CICS resource interdependency data, including CICS calls to DB2, IMS, and WebSphere MQ. Interdependency analysis provided by CICS IA can help developers understand resource usage in CICS applications. CICS IA helps you analyze these interdependencies and assess the impact of application changes quickly and efficiently.

In addition to providing quality information for improved application reuse, CICS IA helps you understand the value of your current CICS assets, reduce cost of maintenance and analyze potential for improved application design. CICS IA helps solve a number of problems associated with application maintenance and enhancement. For example, it helps to:

  • Understand cross-system applications and dependencies
  • Know the resource topology within a particular CICS region
  • Run comparisons on discovered data
  • Identify the resource flow following a transaction ABEND
  • Understand the effect of opening and closing files
  • Know the last time a particular resource was used
  • Analyze resource relationships when planning for dynamic workload balancing

The detailed information on CICS resource relationships, and the ability to analyze this data and compare the results of the analysis across different regions, helps users with decisions on changing and improving systems, such as:

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

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 TS) to identify the affinities within their CICS systems will benefit from the additional capabilities of cross-system analysis which CICS IA provides.
Back to top

Reference information

For information on CICS Interdependency Analyzer for z/OS V1.2, refer to Software Announcement 203-198 , dated August 5, 2003.

For information on CICS Interdependency Analyzer for z/OS and OS/390 V1.1, refer to Software Announcement 201-339 , dated November 27, 2001.


IMS and MVS are trademarks of International Business Machines Corporation in the United States or other countries or both.
CICS, z/OS, DB2, OS/390, Parallel Sysplex, WebSphere, and CICSPlex 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 is available via the Offering Information Web site

Back to top

The following publications are provided:

Title                                                       number
CICS(R) Interdependency Analyzer V1.3 --                    SC34-6365
 User's Guide and Reference
CICS Interdependency Analyzer V1.3 --                       GI10-2547
 Program Directory

The User's Guide and Reference is provided only in PDF softcopy format. If hardcopy is required, it can be printed from the PDF. The Program Directory is delivered in hardcopy, and is also available in PDF softcopy format. These documents in PDF format are available for download, free of charge, from the IBM Publications Center, at

Back to top
Technical information

Hardware requirements

CICS IA V1.3 runs on any S/390® or IBM eServer zSeries® machine on which the applicable operating system and software will run.

Software requirements

CICS IA V1.3 may be used with CICS TS for OS/390® V1.3 (5655-147), or CICS TS for z/OS® V2.2 or V2.3 (5697-E93).

CICS IA V1.3 will run with any supported level of operating system with which the applicable CICS TS runs.

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.3 requires:

  • OS/390 or z/OS SMP/E for installation and maintenance
  • Access to DB2 Universal Database® Server for OS/390 V6.1 (5645-DB2), or later

User group requirements: The enhancements in R3 of CICS IA satisfy the following user group community requirements:

Description                                Requirement numbers
Affinity information in CICS IA data       MR1023025245
CICS IA support for long ENQ/DEQ names     MR0408023107
Merge capabilities with CICS Affinities    MR0225045710

Planning information

Packaging: The following items are delivered:

  • Program Directory (GI10-2547)
  • International Program License Agreement (IPLA) in multi-language booklet (Z125-3301)
  • License Information (GC34-6081)
  • Proof of entitlement
  • Product media for delivery by CBPDO or other Customized Offering: 3480 1/2-inch tape cartridge

Security, auditability, and control

IBM CICS Interdependency Analyzer for z/OS V1.3 uses the security and auditability features of the operating system under which it is running.

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 top

Ordering information

IBM CICS Interdependency Analyzer for z/OS V1.3 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. It also has an annual recurring charge for enhanced support that includes telephone assistance, service, and future product updates (enhancements and new versions or releases).

There is no change to the existing ordering information which applies to IBM CICS Interdependency Analyzer for z/OS V1.2. It is stated fully here for the convenience of users.

CICS IA V1.3 replaces CICS IA V1.2, which will no longer be available after the general availability of CICS IA V1.3.

Existing customers who have CICS IA V1.1 or V1.2, with a current Software Subscription and Support agreement (5655-G77), are entitled to receive CICS IA V1.3 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. Having done the latter, they can place a new order for the product, and will receive CICS IA V1.3 at no charge.

Value Unit exhibit VUE007

               MSUs           MSUs
               minimum        maximum        Value 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:

                         Value units/
 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 Units would be:

                                        Value Units/      Value
             MSUs             *         MSU       =       Units
Translation from MSUs to 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, quantity 344.

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

A tool will be 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.

                              Program        feature
Description                   number         number        Medium
CICS Interdependency          5655-G76       5802          3480
 Analyzer for z/OS V1                                       1/2-inch
CICS Interdependency          5655-G77       6535          Paper
 Analyzer for z/OS V1 --
 Software Subscription
 and Support

Description                   number
CICS Interdependency          5655-G76
 Analyzer for z/OS V1
Entitlement Entity Material
 Identifier (MMID):                          S00W1N4
 One Value Unit

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, and feature number 9001 for asset registration. 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.

Description                      number
Subscription and Support for     5655-G77
 CICS Interdependency Analyzer
 for z/OS V1
Entitlement Entity Material
 Identifier (MMID):                          S00W1MW
Per Value Unit
 SW Subscription & Support
  Registration (no charge)
One Value Unit
Decline SW Subscription and
 Support (no charge)
On/Off Capacity on Demand
Entitlement Entity Material
 Identifier (MMID):                          S00W1N4

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

Agreement: IBM International Program License Agreement. Proofs of Entitlement (PoE) 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 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

Warranty: This program has warranty for a minimum of one year from acquisition from IBM or authorized IBM Business Partner. The warranty provided to the customer, for at least one year from acquisition, is access to databases (read Web sites) for program information and FAQs, including any known fixes to defects, which the customer can download or obtain otherwise and install at 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

Usage restriction: Yes

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

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

IBM Operational Support Services — SoftwareXcel: 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.

Sub-capacity charges terms and conditions

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 server, 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 subcapacity 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 Subcapacity 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 subcapacity (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.

Sub-capacity utilization determination

Sub-capacity utilization is determined based on the utilization of a sub-capacity eligible parent program and machine.

Sub-capacity parent programs

  • CICS TS for z/OS V2.1, and later (5697-E93)
  • CICS TS for OS/390 V1.1, and later (5655-147)
  • CICS/ESA® V4.1 (5655-018)

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 — Attachment for Customer Initiated Upgrade and IBM eServer On/Off Capacity on Demand — Software (Z125-6611) - 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.

The existing prices for CICS IA for z/OS V1 are unaffected by this announcement. For price information, refer to earlier announcements, or contact your IBM representative.
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, z/Architecture, and MVS are trademarks of International Business Machines Corporation in the United States or other countries or both.
CICS, the e-business logo, S/390, zSeries, OS/390, z/OS, DB2 Universal Database, System/390, Systempac, Passport Advantage, AIX, and CICS/ESA 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?