Welcome
Running the Collector
You run the CICS® IA Collector to look for instances of program commands that might cause resource dependencies or transaction affinities.
Changing the Collector options
You can control how the Collector operates by changing the options that it uses.

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.
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.
- Running the Collector for the first time
  To run the Collector for the first time, configure the region options using option 2 of the Collector Main Administration Screen before gathering any dependency or affinity data.
- Displaying the Collector Main Administration Menu panel
  Use this procedure to display the Collector Main Administration Menu panel.
- Controlling the collection of dependency and affinity data
  Use the menu CIU100 to control the collection of dependency and affinity data.
- Changing the Collector options
  You can control how the Collector operates by changing the options that it uses.
  - Specifying region-specific options: Region configuration
    Select 2 Configure Region Options from the Collector Main Administration Menu panel, CIU000. The Collector Region Configuration Menu panel, CIU200 appears.
  - Specifying resource options: Region configuration
    To specify the resource options to modify, you use the Resource Options panel. To display this panel, start from the general Region Configuration Menu panel, CIU200, type 4, then press Enter.
  - Specifying region-specific options: General
    To specify general region-specific options, you use the Region Configuration Menu panel.
  - Specifying region-specific options: API and SPI commands to be monitored
    Use the Region Configuration Menu panel CIU200 to specify the API and SPI commands to be monitored.
  - Specifying region-specific options: Application data collection
    You can configure the collection of CICS® TS Application data associated with programs and other CICS TS Resources from the Application Data Collection Options screen.
  - Specifying which dependency-related CICSPlex SM, Db2®, IMS®, and MQ commands are to be monitored
    Use the Resource Options panel CIU290, to specify which dependency-related commands are monitored.
  - Specifying which affinity-related CICS® commands are to be monitored
    Use the Resource Options panel, CIU290, and the CICS Affinities Options panel, CIU270, to specify which affinity related commands are to be monitored.
  - Specifying region-specific options: timers
    A timer controls the times and dates at which dependency data, affinity data, or both are collected in a CICS® region.
  - Specifying Natural options
    The Natural Options screen allows you to configure the collection of data on Adabas and Natural program calls.
  - Changing global options
    Use the Global Options Menu panel to modify the Collector global options.
- Managing the Command Flow collection using transaction CINC
  You can manage the Command Flow data collection with the aid of the User Command Flow Utility, which helps you to create new configurations of the Command Flow data collection options, change or define parameters of the configurations that already exist, and display statistics about data collection.
- Operating CICS® IA Collection from the CICS® IA Explorer plug-in
  In CICS® IA 6.1, you can manage data collection not only by using the CINC and CINT transactions, but also by using the CICS IA Explorer plug-in.
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

Changing the Collector options

You can control how the Collector operates by changing the options that it uses.

Option values are preserved in the CICS® IA control file, CIUCNTL, so that they can be used across separate runs of the Collector. For more information about the control file, see The control record VSAM file.

Running the CINT transaction at one CICS® terminal, you can:

Set region-specific options for a single Collector running on the local, or on a remote, CICS® region; see Specifying region-specific options: Region configuration.
Set region-specific options for each of multiple Collectors running on different CICS® regions; see Specifying region-specific options: Region configuration. You can set options for all the monitored regions simultaneously, provided that the options are to be set to identical values on each region.
Set global options that apply to all the Collectors you are running; see Changing global options.

Changes take effect only when the Collector is either restarted, Operations action 6 (Refresh Run Options) on screen CIU100 is selected, or the CINT REFRESHOPTIONS transaction is issued.