This section helps you to isolate and determine the cause of CICS® IA problems.
Steps to take to try to solve errors with CICS® IA.
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.
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.
This section gives an overview of the CICS® Interdependency Analyzer (CICS IA), and describes its components.
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.
This section describes what you need to do before you can use CICS® IA.
You run the CICS® IA Collector to look for instances of program commands that might cause resource dependencies or transaction affinities.
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.
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.
CICS® IA provides jobs to unload CICS IA data into CSV files. These files can be used to populate the IBM® supported UDB databases.
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.
The Load Module Scanner scans load modules for instances of program commands that could cause resource dependencies or transaction affinities.
The CICS® IA CSECT Scanner scans load modules for information that can be used to identify the version of each CSECT.
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.
This section describes how to run the sample CICS® IA batch query job CIUJSAMP.
This section describes tools and techniques that you can use to find the cause of a problem, and suggests one or more actions for solving it.
If the CINT, CINB or CINC transaction or an exit program, encounters a serious error the Collector stops by terminating CINT, CINB and CINC.
Before looking further for the cause of the problem, review the following preliminary checks. These checks might highlight a simple cause or, at least, narrow the range of possible causes.
One of the first requirements in solving a CICS® IA problem is to determine what type of problem you are experiencing.
For certain problem types, you might be asked to supply a CICS® TS trace. To switch tracing on and off, use the Global Options Menu.
For certain types of problem, you might be asked to supply a dump of CICS® IA. To request a dump of a CICS IA address space and its associated data space, use the MVS DUMP command.
The CICS® IA plug-in and APAR level are obtained from two places. The IBM® Support team will ask for one or both of these.
How to gather required documentation.
The IBM® Support structure helps you to resolve problems with IBM products and ensure that you can make the best use of your IBM computing systems. Program support is available to all licensed users of IBM licensed programs.
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.
The Appendix describes available Stored Procedures and Command Flow user exit.
CICS® IA detects dynamic COBOL calls, which are collected by the Dependency and Command Flow Data collectors.
Accessibility features help a user who has a physical disability, such as restricted mobility or limited vision, to use software products successfully
Download the PDF format documentation for CICS Interdependency Analyzer for z/OS 6.1