Welcome
Overview of the CICS® Interdependency Analyzer
This section gives an overview of the CICS® Interdependency Analyzer (CICS IA), and describes its components.
The Collector component
You can use the Collector in real-time to detect transaction resource definitions and transaction affinities in a running CICS® region.
What the Collector can monitor
The commands or calls that the Collector can monitor are listed. The commands or calls that the Collector actually monitors depend on how it is configured.

Preface
This information describes the IBM® CICS® Interdependency Analyzer for z/OS®. It explains what the program does and how to set up and run its various components.
What's new in CICS® IA Version 6.1
CICS® IA Version 6.1 continues to support a wide range of capabilities and fully supports new CICS Transaction Server 6.3. Building on previous releases, CICS IA Version 6.1 contains updates to reflect those commands for which CICS Transaction Server 6.3 has updated the threadsafe status allowing more applications to run without requiring a switch to QR TCB mode.
Overview of the CICS® Interdependency Analyzer
This section gives an overview of the CICS® Interdependency Analyzer (CICS IA), and describes its components.
- CICS® IA requirements
  Requirements for running CICS® IA.
- CICS® IA interdependency functions
  CICS® IA assists in understanding, in a controlled manner, the inter relationships between the shared common resources of applications and services.
- CICS® IA affinity related functions
  The affinity related functions of CICS® IA help users of CICS dynamic routing, who need to determine whether any of the transactions in their CICS applications use programming techniques that require them to be run in the same region thus creating an inter-transaction affinity, or in a particular region, thus creating a transaction-system affinity. Application programmers can use CICS IA to detect whether the programs they are developing are likely to cause transaction affinities.
- CICS® IA Command Flow functions
  The CICS® IA Command Flow utility allows individual users to capture CICS, IBM® Db2®, MQ and IMS® commands in a chronological order for one or more transactions. Each user can capture information for his or her given transaction or transactions. They can also individually load and view the data that they have captured.
- The Collector component
  You can use the Collector in real-time to detect transaction resource definitions and transaction affinities in a running CICS® region.
  - What the Collector can monitor
    The commands or calls that the Collector can monitor are listed. The commands or calls that the Collector actually monitors depend on how it is configured.
  - What the Collector does not monitor
    The program commands or calls that the Collector does not monitor are listed.
  - Controlling the Collector
    You can monitor and control the Collector through the CINT transaction. Also you can control the Collector from CICS® Explorer through the CICS IA plug-in for CICS Explorer.
  - How dependency data is collected
    The Collector uses tables in a data space to hold collected dependency data.
  - How affinity data is collected
    The Collector uses tables in a data space to hold collected affinity data.
  - Saving data
    The dependency and affinity data collected by the Collector is saved to CICS® IA VSAM files by the autosave transaction, CINB.
  - The dependency data and affinity data VSAM files
    To control the operation of multiple instances of the Collector, running on different CICS® regions, from a single CICS terminal, you must share the dependency data files, the affinity data files, and the control record file across all the regions being monitored.
  - The control record VSAM file
    The CICS® IA control file is a recoverable VSAM KSDS file that holds a single header record that holds global options that apply to all the CICS regions, a single DEFAULT control record that contains the default values for all regions and one control record for each CICS region being monitored that contains options that overrides the default record.
- The Dependency database objects
  The Dependency database objects contain accumulated data about all your programs and transactions and the resources that they use.
- The Affinity database objects
  The Affinity database objects contain accumulated data about all your programs and transactions and the affinities between them.
- The CICS® IA plug-in for CICS Explorer®
  The CICS® IA plug-in for CICS Explorer® (CICS IA plug-in) is an Eclipse plug-in that operates on top of the CICS Explorer to help you analyze the CICS IA data, including the interdependency data, affinity data, and Command Flow data. When you install the CICS IA plug-in for CICS Explorer there is help available on how to use the CICS IA plug-in, Help > Help Contents > CICS IA User Plug-in guide.
- CICS® IA reports
  CICS® IA can create dependency reports, affinity reports and threadsafe reports by running batch jobs.
- The Scanner component
  The Scanner component consists of two scanners: the Load Module Scanner and the CSECT Scanner.
- The Builder component
  The Builder is a batch utility that takes as input a file of basic affinity-transaction-group definitions created by the Reporter. It produces a file of combined affinity-transaction-group definitions suitable for input to CICSPlex SM.
Getting Started with the CICS® IA plug-in for CICS Explorer®
The CICS® Interdependency Analyzer plug-in for CICS Explorer® provides an Eclipse-based interface to analyze your CICS IA data. It also provides cheat sheets that guide you through the steps required to configure and install CICS IA. It is recommended that you download the CICS IA plug-in and follow the steps in the cheat sheets.
Configuring CICS® IA
This section describes what you need to do before you can use CICS® IA.
Running the Collector
You run the CICS® IA Collector to look for instances of program commands that might cause resource dependencies or transaction affinities.
Updating the Dependency and Affinity database objects
The Dependency database objects contain accumulated data about your applications and the resources that they use. Update the database objects regularly to add new information recorded by the Collector in the VSAM dependency files.
Managing your CICS® IA data
With each new release CICS® IA captures more data. In volatile development environments this data can soon become out of date. If you have out of date data, the CICS IA plug-in might retrieve more data than you need. The presence of unwanted data might impede your analysis and provide confusing results.
The CICS® IA UDB database
CICS® IA provides jobs to unload CICS IA data into CSV files. These files can be used to populate the IBM® supported UDB databases.
Running the Reporter
Running the Program Threadsafe report
The threadsafe report can be run from the CICS IA Explorer plug-in or as a batch job using the sample CIUJTSQ2 that can be found in SCIUSAMP.CICS. The report runs the Db2® stored procedure CIUSPTSR.
Running the Load Module Scanner
The Load Module Scanner scans load modules for instances of program commands that could cause resource dependencies or transaction affinities.
Running the CSECT Scanner
The CICS® IA CSECT Scanner scans load modules for information that can be used to identify the version of each CSECT.
Running the Builder
The CICS® IA Builder runs as a batch job to build affinity-transaction-group definitions suitable for input to the CICS system management product, CICSPlex SM.
Running the sample Db2® query
This section describes how to run the sample CICS® IA batch query job CIUJSAMP.
Solving problems
This section helps you to isolate and determine the cause of CICS® IA problems.
Details of dependencies and affinities collected
Correlating Load Module Scanner and Dependency Reporter output to source
The structure of the CICS® IA database
Messages and codes
This section describes the messages that the Collector, Query interface, Dependency Reporter, Affinities Reporter, Load Module Scanner, CSECT Scanner, and Builder can issue, and the transaction abend codes that the Collector can produce.
CICS® IA space considerations
CICS® IA security
CICS® IA External Interfaces
The Appendix describes available Stored Procedures and Command Flow user exit.
Collecting dynamic COBOL calls
CICS® IA detects dynamic COBOL calls, which are collected by the Dependency and Command Flow Data collectors.
Accessibility
Accessibility features help a user who has a physical disability, such as restricted mobility or limited vision, to use software products successfully
Download PDF
Download the PDF format documentation for CICS Interdependency Analyzer for z/OS 6.1

What the Collector can monitor

The commands or calls that the Collector can monitor are listed. The commands or calls that the Collector actually monitors depend on how it is configured.

For more information about configuring the Collector, see Controlling the Collector and What the Collector does not monitor.

The Collector can monitor the following commands or calls:

The EXEC CICS® API commands, listed in CICS API commands, that can cause transaction dependencies
The EXEC CICS® SPI commands, listed in CICS SPI commands, that can cause transaction dependencies
The CICS® Front End Programming Interface (FEPI) API commands, listed in CICS FEPI API commands, that can cause transaction dependencies
The CICS® FEPI SPI commands, listed in CICS FEPI SPI commands, that can cause transaction dependencies
The non-CICS API commands, listed in Non-CICS API commands detected, that can cause transaction dependencies
The EXEC CICS API and SPI commands, listed in Affinity-related CICS API and SPI commands detected by the CICS IA Collector and the CICS IA Load Module Scanner, that can cause transaction affinities
The dynamic COBOL calls that are detected by the Dependency and Command Flow Data collectors for the IBM COBOL programs if the CBLPSHPOP Language Environment® option is active. The Language Environment® option ALL31(ON/OFF) is supported for dynamic calls from IBM COBOL programs.
For more information about the CBLPSHPOP option, see Language Environment CBLPSHPOP option in the CICS TS 5.2 Documentation.
For information about the detection of dynamic COBOL calls, see Collecting dynamic COBOL calls.

For information about what the Collector reports for each monitored command, see Details of dependencies and affinities collected.

As well as monitoring program commands, the Collector also collects information about the CICS® regions on which it runs and stores that information in the CIU_REGION_INFO database table. For example, for each collection of dependency or affinity data, the table contains the names of the CICS® System Definition data set (CSD) and the first four resource group lists in the CSD.