Welcome
Configuring CICS® IA
This section describes what you need to do before you can use CICS® IA.
Post configuration tasks
This section describes some optional tasks that you might be required to be perform.
Creating your translation table
CICS® IA uses a translation table to translate the resource name of the CICS IA dependency data before it is loaded to the Db2® CIU_CICS_DATA table or it creates the hlqc.CICS.CSV file.

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.3
CICS® IA Version 6.3 maintains broad functionality and provides full support for the new CICS Transaction Server 6.3. Building on previous releases, it includes updates for commands whose threadsafe status has been enhanced in CICS Transaction Server 6.3, enabling more applications to run without switching 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.
- Prepare your CICS® IA configuration environment
  CICS® IA uses an ISPF dialog that runs REXX execs to assist you in configuring your CICS IA environments.
- New Db2® configuration
  The data collected from the Dependency, Affinity and Command Flow collectors are stored in the CICS® IA database. Data collected from the CICS IA scanners are also stored in this database.
- New collection configuration
  CICS® IA provides a number of real-time collectors. To enable the collectors, you must complete a number of tasks to create the resources that are required to facilitate the collection and to define these resources to the CICS regions where the collectors run.
- Upgrading an existing Db2® configuration
  Before you begin upgrading your Db2® configuration, ensure that you have read and followed the instructions to prepare your CICS® IA environment and the Db2 considerations.
- Upgrading your collection configuration
  How to configure an existing collection environment for upgrade, upgrade an existing collection environment, and run the IVP transaction to verify the installation.
- Post configuration tasks
  This section describes some optional tasks that you might be required to be perform.
  - Creating your own program exclude, transaction exclude, and resource compression list
    You can use program exclude lists, transaction exclude lists, command exclude lists, and resource compression list to limit the volume of information collected by the Collector. In this section the term, Collector, refers to the Affinity and Dependency collector functions but for command exclude list the term, Collector, refers only to the Dependency collector functions.
  - Grouping transactions and programs into applications
    CICS® IA 5.1 and later provides utilities so that you can use CICS IA 3.2 Application definitions in your CICS IA 5.1 or later environment. However, CICS Transaction Server 5.1 and later provides the capability to define applications as part of the platform capabilities, and it is now advisable to define applications in this way.
  - CICS® IA Natural support
    With CICS® IA, you can gather CICS resource information for COBOL, PL/I, and Assembler language programs called from within a Software AG Natural program.
  - Starting and stopping CICS® IA from the PLT
    You can start CICS® IA from a program list table (PLT) program that is initiated during the third stage of CICS initialization; that is, a program that is specified in the second part of the program list table post initialization (PLTPI) list for the CICS region.
  - CICS® IA supplied modules required in the MVS link list
    If you use the MVS interactive problem control system (IPCS) to format and analyze CICS® system dumps, you can use the CICS IA system dump formatting routines, CIUIADUF and CIUICDUF, to format the CICS IA collector data areas.
  - Creating your translation table
    CICS® IA uses a translation table to translate the resource name of the CICS IA dependency data before it is loaded to the Db2® CIU_CICS_DATA table or it creates the hlqc.CICS.CSV file.
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.3

Creating your translation table

CICS® IA uses a translation table to translate the resource name of the CICS® IA dependency data before it is loaded to the Db2® CIU_CICS_DATA table or it creates the hlqc.CICS.CSV file.

About this task

By using a translation table, each "XY" byte of the resource name is converted to a byte whose offset from the start of this table is "XY". The translation table is a load module that has a fixed name of CIUTRNTB and a fixed location in the hlq.SCIULOAD library, where hlq is the high-level data set qualifier that was assigned during the CICS® IA installation.

You can control the translation by using the parameter that is passed to the CIUU040 module in the following sample jobs:

CIUUPDB
CIUUPDB1
CIUUDB

Specify Y to translate the data or N not to translate the data.

CICS® IA supplies a sample program translation table. The default program translation table, that is supplied with CICS® IA, is a load module called CIUTRNTB. The default translation table converts non-printable characters to ".".

A sample batch job, CIUJCLTT, is provided to assemble and link-edit the sample program translation table, CIUTRNTB. You can use the provided sample batch job to create your own translation table.

Procedure

Copy the sample CIUJCLTT job before you edit the JCL.
Change the JOB account and JOB card parameters to reflect your local environment.
Update the PGM keyword of the EXEC statement in the ASM step and enter the name of the assembly language that you want to use.
Modify the SYSIN DD statement and specify the name of the assembly language source library where your translation table can be found.
The default library is hlq.SCIUSRCE, where hlq is the high-level data set qualifier that is assigned during the CICS® IA installation. Change the member name to the name of your translation table.
You do not need to change the SYSLMOD DD statement. The translation table is a load module that must be called CIUTRNTB in the hlq.SCIULOAD library, where hlq is the high-level data set qualifier that is assigned during the CICS® IA installation.
When you are finished, you can submit the job to create your translation table.
Ensure that the job completed successfully.