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.
Who this information is for
This information is for anyone who needs to understand, install, or use the CICS® Interdependency Analyzer.
How to use this information
This information is intended to be read sequentially.
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.
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.
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.
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.
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.
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.3, 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.
Updating the Dependency database objects
CICS® IA provides a number of batch jobs to update the database from the VSAM files.
Updating the Affinity database objects
CICS® IA provides the CIUAFFLD batch job to update the database from the VSAM files.
Updating the Command Flow database objects
CICS® IA provides batch jobs to update the database from the command flow log stream.
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.
Identifying the data that you collect
You can reduce the amount of data you initially collect by identifying patterns in your resource names, and by using a collection ID to identify the data you load into IBM® Db2®.
Managing the collected data
To manage the data that you have collected, you can delete your unwanted data and keep your data sources in sync.
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.
Configure a new UDB environment
How to create a UDB configuration and access a previous UDB configuration.
Configure an existing UDB environment
To select an existing UDB configuration, select option 6 from the configuration menu.
Create a CICS® IA UDB database
To create a CICS® IA UDB database, follow these steps.
Loading the IVP data into the CICS® IA UDB database
CICS® IA provides sample data that you can load into your new CICS IA UDB database. You can then connect to the database by using the CICS IA plug-in for CICS Explorer and verify that your UDB database is working correctly.
Update the CICS® IA UDB database
When a CICS® IA UDB database is created, you can load the data.
Preparing CSV files
Before you can update a CICS® IA UDB database with new data, you need to convert the VSAM files that are created by the Collector to the QSAM flat files or, in other words, comma-separated values (CSV) files.
Running the Dependency Reporter
This section describes how to run the CICS® IA Dependency Reporter. The Dependency Reporter consists of a batch job, CIUJCLRP, that produces reports of the dependencies found by the Collector.
Running the Affinities Reporter
The CICS® IA Affinities Reporter can be used to produce reports and definitions.
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.
Analyzing a sample threadsafe report
Analyzing the sample output produced by a summary report and a detail report.
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.
Creating a summary report
You can request a summary report from the Load Module Scanner by editing and running the CIUJCLLS job.
Creating a detailed report
You can request a detailed report from the Load Module Scanner by editing and running the job CIUJCLLD.
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.
The CIUJCLCS job
To run the CSECT Scanner, you can edit and run the CIUJCLCS job. This job produces a printed report and updates the CIU_PROGRAM_INFO and CIU_CSECT_INFO Db2® tables.
The CIUUDBCS job
To run the CSECT Scanner, you can edit and run the CIUJCLSS job. This job produces a printed report and creates CSV files.
Contents of the printed report
The printed report has two line formats; one for load module information and one for CSECT information.
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.
Editing the CIUAFFBL job
To run the Builder, edit and run the CIUAFFBL job.
Syntax for input to the Builder
The syntax in the sequential data sets used as input for the Builder is similar, but not identical, to that allowed by CICSPlex SM.
Output from the Builder
The Builder produces a file containing a set of definitions of combined affinity transaction groups and a report listing the combinations that occurred.
Running the sample Db2® query
This section describes how to run the sample CICS® IA batch query job CIUJSAMP.
The CIUJSAMP job
This CIUJSAMP job produces SQL output for the sample query you have selected.
Solving problems
This section helps you to isolate and determine the cause of CICS® IA problems.
Overview of CICS® IA problem determination
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.
Dealing with errors
Steps to take to try to solve errors with CICS® IA.
Contacting IBM® Support
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.
Commands monitored for potential dependencies
This section lists the commands monitored by the Collector because they have the potential to create dependencies.
Commands monitored for potential affinities
This section lists the affinity-related EXEC CICS® commands detected by the CICS IA Collector.
Details of what is detected
This section describes what is detected by the Detector and Reporter for each affinity type.
Dependency Reporter output
The reported offset of a command is the offset from the start of the load module of the BALR to the CICS® stub.
Load Module Scanner output
The reported offset of a command is the offset from the start of the load module of the command CICS® argument zero.
The structure of the Dependency database objects
This section describes the tables and views defined in the Dependency database.
The structure of the Affinity objects
This section describes the tables and views defined in the set of Affinity database objects.
The structure of the Load Module Scanner objects
This section describes the tables and views defined in the Load Module Scanner database objects.
The structure of the CSECT Scanner objects
This section describes the tables and views defined in the CSECT Scanner database.
The structure of the CICS® regions objects
This section describes the structure of the CICS® regions objects.
The structure for the Detailed resource objects
This section describes the structure for the Detailed resource objects.
The structure of the CICS® IA plug-in for IBM® CICS Explorer™ resource objects
This section describes the CIU_RESOURCE table. This table is used by the CICS® IA plug-in to improve performance and combine resource tables.
The structure of the Version objects
This section describes the CIU_VERSION table. This table is used by the CICS IA plug-in for CICS® Explorer to synchronize the CICS IA plug-in version being used and the base IA database objects.
The structure of the Command Flow table objects
This section describes the Command Flow base table that contains records for each command that is issued by the transactions. You can write your own SQL applications to query the table; these applications must use native SQL to write the queries.
The Structure of the Program Flows table objects
This section describes the structure of two CICS IA tables that are used only to generate the program flows report in the CICS IA plug-in for the CICS Explorer.
Type and Function mapping for monitored commands
Learn about the correspondence between resource type and command function for the monitored CICS® commands.
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.
Contacting IBM® Support
Information on IBM® support policy can be found on our Web site.
CIU1000E
CIUMSGE Language Module Not Found
CIU1001I
Begin CICS® IA IVP for TS version: CICS-version-number
CIU1002I
Installation verification ended successfully
CIU1003E
Transaction verification failed, transaction ID: transaction-name
CIU1004E
Program verification failed, program ID: program-name
CIU1005E
VSAM file verification failed, file ID: file-name
CIU1006I
Transaction verified, transaction ID: transaction-name
CIU1007I
Program verified, program ID: program-name
CIU1008I
VSAM file verified, file ID: file-name
CIU1009E
Verification unsuccessful — highest return code: return-code
CIU1010I
TD queue verified, TD queue ID: TDqueue-name
CIU1011E
TD queue verification failed, TD queue ID: TDqueue-name
CIU1012I
DB2ENTRY verified, DB2ENTRY ID: DB2entry-name
CIU1013W
DB2ENTRY verification failed, DB2ENTRY ID: DB2ENTRY-name
CIU10141
DB2TRAN verified, DB2TRAN ID: DB2TRAN-name
CIU1015W
DB2TRAN verification failed, DB2TRAN ID: DB2TRAN-name
CIU1016I
JOURNALMODEL verified, model ID: model-name
CIU1017E
JOURNALMODEL verification failed, model ID: model-name
CIU2101W
CINT already in use by user userid
CIU2102W
Collector is not state
CIU2103W
Collector is already stopped
CIU2104W
Invalid key was pressed
CIU2105I
CINT session has ended
CIU2106W
Options must be Y(Yes) or N(No)
CIU2107W
Size must be integer (10 to 2000 Mb)
CIU2108W
Select a valid date/time format
CIU2109W
Select a valid date/time separator
CIU2110I
No amendments were entered
CIU2111I
CINT options are updated
CIU2113W
Options must be Y(Yes), N(No) or blank(default)
CIU2114I
Records are restored
CIU2115I
Dependency files are emptied
CIU2116W
Dataspace too large - no storage available
CIU2117W
Dataspace too large - IEFUSI limit reached
CIU2118I
No records were restored
CIU2119I
CICS® is terminating
CIU2120I
Press Enter to confirm Start with data restore or PF12 to cancel
CIU2121I
Press Enter to confirm Start without restore or PF12 to cancel
CIU2122I
Press Enter to confirm Stop or PF12 to cancel
CIU2123I
Enter to confirm Start ALL or PF12 to cancel
CIU2124I
Enter to confirm Stop ALL or PF12 to cancel
CIU2125E
A CINT action must be supplied
CIU2126I
No actions to take
CIU2127W
Transaction ID prefix is invalid
CIU2128W
Language code is invalid
CIU2129W
Control file CIUCNTL not open in the FOR
CIU2130W
Dependency file CIUINTn not open in the FOR
CIU2131W
Control file CIUCNTL is not available
CIU2132W
Dependency file CIUINT1 is not available
CIU2133W
Error opening Control file CIUCNTL
CIU2134W
Error opening Dependency file CIUINT1
CIU2135S
CICS® command data failed RESP=eibresp RESP2=eibresp2 RCODE=eibrcode
CIU2136W
Exclude list name is invalid
CIU2137I
Affinity files are emptied
CIU2138W
Options must be Y(Yes), N(No), or D(Detail)
CIU2139W
Options must be Y(Yes), N(No), D(Detail) or blank(default)
CIU2140W
Value must be between 2 and 9999, or 1 for no updates
CIU2141W
Options must be A (Affinity), I (Interdependency), or B (Both)
CIU2142W
Options must be A (Affinity), I (Interdependency), B (Both), or blank
CIU2143W
Options must be Y (Yes), N (No), A (Aff.), I (Dep.), or B (Both)
CIU2144W
Options must be Y (Yes), N (No), A (Aff.), I (Dep.), B (Both), or blank
CIU2145I
All files are emptied
CIU2146I
Press Enter to confirm REFRESH or PF12 to cancel
CIU2147I
Press Enter to confirm REFRESH ALL or PF12 to cancel
CIU2148I
CINT applid CICS® Resource options are updated
CIU2149I
CINT applid Db2/MQ/IMS/CPSM options are updated
CIU2150I
CINT applid General options are updated
CIU2151I
CINT applid Time and Date options are updated
CIU2152I
CINT applid CICS® Affinity options are updated
CIU2153I
CINT applid Global options are updated
CIU2154I
CINT applid Task options are updated
CIU2155I
CINT applid Natural resource options are updated
CIU2159E
Task collection trigger value must be between 1 and 9999
CIU2160I
CINC session has ended
CIU2161I
CICS® is terminating
CIU2162W
Control file CIUCNTL is not available
CIU2163W
Error opening Control file CIUCNTL
CIU2164W
There are no connected CICS® regions
CIU2165W
Too large number of selected regions
CIU2166W
Invalid selection of APPLID
CIU2168W
Option option is invalid
CIU2170W
Options must be 1, 2, 3 or N(No)
CIU2185I
CINT region-name Application Collection Options are updated.
CIU2186E
Maximum applications-amount applications can be selected for dependency collection.
CIU2186I
CINT region-name Application Collection Options are updated by user ID.
CIU2187I
Enable collection of Application Data collection-option.
CIU2188E
Wrong option for collection of Application Data.
CIU2188S
Memory allocation error at point point-number.
CIU2189E
For DEFAULTS, Application Collection Option must chosen.
CIU2191I
CINT region-name Application Collection Options are set to DEFAULTS
CIU2192I
CINT region-name Appl. Coll. Options are set to DEFAULTS by user ID. (Appl. Coll. is abbreviated because of TDQ limits)
CIU2193S
Error opening CICS® IA Applications file.
CIU2201S
CICS® command data failed RESP=eibresp RESP2=eibresp2 RCODE=eibrcode
CIU2202S
VSAM filetype file filename command failed RESP=eibresp RESP2=eibresp2
CIU2204I
CINT being used by userid
CIU2206S
CICS® command PROGRAM program failed RESP=eibresp RCODE=eibrcode
CIU2207E
Db2® table error on tablename SQL code code
CIU2208E
CICS® region is not connected to IBM® Db2®
CIU2209S
Records in control file CIUCNTL have incorrect format
CIU2210S
Create dataspace action failed REASON=reason code ERROR=error code
CIU2211S
Create table action failed REASON=reason code TABLE=table number
CIU2212S
Add element action failed REASON=reason code TABLE=table number
CIU2213S
Stop of collector has failed during Start processing
CIU2214I
Collector is now state
CIU2215S
Stop of Collector has failed
CIU2216S
Destroy pool action failed REASON=reason code ERROR=error code
CIU2217S
Destroy table action failed REASON=reason code TABLE=table number
CIU2218S
CINT has abended abend code in program program
CIU2219I
Data type collector is now state
CIU2220S
Create CPOOL action failed REASON=reason code
CIU2221S
Function call failed: FUNCTION=function code REASON=reason code
CIU2222S
Destroy CPOOL action failed REASON=reason code
CIU2224S
Error calculating space utilisation
CIU2225E
Unsupported type of CINT task initiation
CIU2226E
Incorrect CINT action: action
CIU2227I
Non-terminal CINT task initiating
CIU2228S
Replace element action failed REASON=reason code TABLE=table number
CIU2229S
UT/TT table update failed FUNC=function code REASON=reason code TABLE=table number
CIU2230S
VSAM dependency file filename header READ failed RESP=eibresp RESP2=eibresp2
CIU2231I
Number of records restored = count
CIU2232E
CICS® Release release is not supported by the Collector
CIU2233W
CIUINTDT call failed REASON=reason code
CIU2236I
EXEC CICS DISABLE STOP for program exitprog OK
CIU2238I
EXEC CICS DISABLE EXITALL for program exitprog OK
CIU2239S
DISABLE EXITALL for program exitprog failed RESP=eibresp RCODE=reason code
CIU2240I
EXEC CICS ENABLE EXIT for program exitprog, EXIT exit OK
CIU2241I
EXEC CICS ENABLE EXIT START for program exitprog OK
CIU2242I
EXIT PROGRAM exitprog already disabled
CIU2243I
EXEC CICS ENABLE TRUE for program exitprog OK
CIU2244S
Exclude list name has invalid contents at offset offset
CIU2245S
Dump domain function function failed RESP=resp RCODE=rcode
CIU2246E
Collector is not in START or PAUSED state
CIU2247W
CICS® IA dataspace is nn percent full
CIU2248I
CINT applid CICS® Resource options are updated by userid
CIU2249I
CINT applid Db2/MQ/IMS/CPSM options are updated by userid
CIU2250I
CINT applid General options are updated by userid
CIU2251I
CINT applid Time and Date options are updated by userid
CIU2252I
CINT applid CICS® Affinity options are updated by userid
CIU2253I
CINT applid Global options are updated by userid
CIU2254I
CINT applid Task options are updated by userid
CIU2255I
CINT applid Natural resource options are updated by userid
CIU2256I
CINT command_name is requested by userid for applid
CIU2257I
CINT Collector runtime options for applid:
CIU2258I
options_list
CIU2275W
Control file CIUCNTL not open in the FOR
CIU2276S
CICS® command data failed RESP=eibresp RESP2=eibresp2 RCODE=eibrcode
CIU2277S
USER record is not found in the CIUCNTL control file
CIU2278S
USER record in the CIUCNTL control file has incorrect format
CIU2279S
CONTROL1 record is not found in the CIUCNTL control file.
CIU2280S
REGION record is not found in the CIUCNTL control file.
CIU2281S
CINC has abended abend in program program
CIU2283I
CINC being used by userid
CIU2284S
Records in control file CIUCNTL have incorrect format
CIU2285E
Unsupported type of CINC task initiation
CIU2287E
CICS® Release release is not supported by the CINC
CIU2288S
CINC abending - internal error elsewhere in the CINC
CIU2289I
CINC command flow options are updated by userid
CIU2290I
options_list
CIU2291S
CICS® command PROGRAM program failed RESP=eibresp RCODE=eibrcode
CIU2292I
EXEC CICS® ENABLE EXIT for program exitprog, EXIT exit OK
CIU2293W
CINC Collector is already active for userid
CIU2294W
Max concurrent CINC Collector sessions limit reached
CIU2295W
User journal name journal_name value is already used by other active user
CIU2296I
CINC Collector runtime options for userid
CIU2297W
CINC Collector is not started in all/some your regions
CIU2298I
CINC Collector is started in your regions
CIU2299W
CINC Collector is not started. All options are empty.
CIU2300W
CINC Collector is not started. Option option is empty
CIU2301W
CINC Collector is not started. Some regions are not connected.
CIU2303W
CINC Collector is not stopped. There are no active collector sessions.
CIU2304W
CINC Collector is not stopped. There are no connected regions.
CIU2308I
CINC Collector is stopped by uuuu
CIU2309I
CINC Collector has logged nnnn records for uuuu
CIU2310W
CINC Collector is not stopped. Option option is empty.
CIU2311I
CINC Collector is stopped for uuuu. Limit of tasks: nnnn .
CIU2312I
CINC Collector is stopped for uuuu. Limit of records: nnnn .
CIU2313W
Invalid cursor position
CIU2314W
CINC already in use by user userid
CIU2316W
CINC Collector is not started. All regions are not connected
CIU2317W
CINC Collector is already active for some regions
CIU2319W
Updates are rejected because CINC Collector is running for userid
CIU2320I
CINC Collector is stopped. Total records written: number
CIU2321W
APPLIDs applidID is not found in control file. Updates are rejected.
CIU2322W
Duplicate APPLIDs applidID specified. Updates are rejected.
CIU2323W
Journal Copy Criteria option is invalid. Enter LAST, USER or CFID
CIU2324W
CINC Collector is not started in all your regions
CIU2325W
CINC Collector is started in some your regions
CIU2326W
CINC was not completed for userid
CIU2327W
CICS® ApplIDs option is empty
CIU2328W
CINC Collector was not completed for userid
CIU2329S
An abend occurred in program program for region region
CIU2330S
CINC Collector for USERID userid1 is already started by userid2
CIU2331W
Privileged Collection not started. In use by another privileged user userid
CIU2332W
Privileged Collection not started. In use by general users.
CIU2333W
General Collection not started. In use by privileged user userid
CIU2335W
The value for the Authority field is incorrect
CIU2336W
Wildcard characters in the UserID field are not allowed for general users
CIU2351E
Invalid journal type in model
CIU2352I
Logstream lsname assigned for CINC user userid
CIU2353E
Different Control file names
CIU2354I
User exit exit was loaded
CIU2500I
There is no action to process.
CIU2501W
No more users allowed. Maximum limit of users reached.
CIU2502I
No users were added.
CIU2503I
User userid was not copied.
CIU2504E
Cannot manage user userid. It is in use by someone else.
CIU2505E
User userid has "ACTIVE" status. Stop CINC collector and try again.
CIU2506I
User userid was not updated.
CIU2507W
Confirm the deletion of user userid.
CIU2508I
The deletion of user userid was cancelled.
CIU2509W
Journal name must begin with a letter.
CIU2510E
Cannot delete user userid – CINC session is active.
CIU2511W
User name can contain national characters. It must be alphanumeric.
CIU2512W
Journal name can contain national characters. It must be alphanumeric
CIU2513E
Cannot update user userid – CINC session is active.
CIU2514I
User userid was added.
CIU2515E
Cannot add user userid – CINC user or CINT region already exists.
CIU2516E
Cannot add user userid – internal error occurred.
CIU2517W
Cannot update user userid – CINC collector is active.
CIU2518I
User userid updated.
CIU2519E
Update failed – user userid does not exist.
CIU2520E
Cannot update user userid – internal error occurred.
CIU2521E
CICS® TS release is current_release. Release required_release or higher is required.
CIU2522W
Consequences of deleting user with unknown status are unpredictable.
CIU2523I
CICS® Interdependency Analyzer for z/OS® - nnnnnn
CIU3117I
CINT options refreshed
CIU3301I
CINB task is starting
CIU3302S
CINB received an unrecognizable request
CIU3303S
CINB has abended abend code in program program
CIU3304S
CINB abending - system error elsewhere in the Collector
CIU3305I
CINB save started - because of reason
CIU3306I
CINB save ended - count records saved
CIU3307I
CINB terminated - Collector is stopping
CIU3308I
Message received from program program
CIU3309I
Collector action by date/time options
CIU3310S
Invalid file number for table in GWA
CIU3311E
Transaction CINB must be initiated by transaction CINT
CIU3312S
CINB abending - CICS® is terminating
CIU3313S
Invalid address for program in the GWA
CIU3314S
Function call failed FUNCTION=function code REASON=reason code TABLE=table number
CIU3315S
File filename is full
CIU3316S
Unexpected resource type resourcetype
CIU3318I
Tasks before stopping:: nnnn .
CIU3319I
Records before stopping: nnnn .
CIU3320I
CIUCPOOL: Limit of cells is exceeded. NNNNN records rejected
CIU3321I
Performance Monitoring is activated.
CIU3322I
Performance Monitoring is deactivated
CIU3323I
The TCB switch counter data is not available
CIU3324I
CINB: count type records saved
CIU3325I
CINB: DETAILED: count records type type saved
CIU3326I
New dependencies total: count
CIU3327I
New resource details total: count
CIU3371I
Transaction CINS is starting
CIU3372S
Transaction CINS has abended with abend code in program program.
CIU3373E
Transaction CINS must be initiated by transaction CINT.
CIU3374I
Transaction CINS has terminated - Collector is stopping.
CIU3380I
Collector Statistics not available for this period of time.
CIU3401I
Master System trace flag is set ON
CIU3402I
Master User trace flag is set ON
CIU3405I
Master System trace flag is restored OFF
CIU3406I
Master User trace flag is restored OFF
CIU3407I
Error at setting Master trace flag. Response code: eibresp
CIU3408I
ENTER TRACENUM for program name failed RESP=eibresp . HL_TRACE forced to N
CIU4100S
Function call failed FUNCTION=function code REASON=reason code TABLE=table number
CIU4200S
Dataspace is full
CIU4300E
Interaction with Natural failed REASON=reason
CIU4301S
Service service failed RCODE=rcode REASON=reason
CIU4302S
Interface with Natural is disabled.
CIU4307S
Interaction with Natural failed REASON=reason
CIU4308S
CICS® command data failed RESP=eibresp RESP2=eibresp2 RCODE=eibrcode
CIU4309S
Interaction with Natural has abended abend code
CIU5000S
Function call num is invalid for module
CIU5001E
filename control record not found for applid applid. Run canceled
CIU5003E
Some action failed. Return/ABEND code=return reason=reason
CIU5004E
GENCB failed for filename CB=control block RC=return code REASON=reason code
CIU5005S
File number filenum is invalid
CIU5006S
Attempt to actionfilename. File is type
CIU5007S
RPL number rplnum is invalid for filename
CIU5008S
Table number table number is invalid
CIU5012E
Invalid PARM specified. Program terminated.
CIU5015E
Invalid {MATCH | STATE | CONTEXT} value specified. Correct and rerun
CIU5016E
DSPSIZE value is not numeric. Correct and rerun
CIU5017E
DSPSIZE is invalid. It must be between 2 and 2000
CIU5018E
Load of modname has failed AC=abcode RC=reason_code
CIU5019E
Dataspace too large - no storage available
CIU5020E
Dataspace too large – IEFUSI limit reached
CIU5021E
Create dataspace failed REASON reason_code ERROR error_code
CIU5022E
Create table failed REASON reason_code TABLE table_number
CIU5023E
Keyword keyword is invalid or unexpected
CIU5024E
Keyword keyword is missing
CIU5025E
A value of value is invalid for keyword keyword
CIU5026E
Invalid CREATE type
CIU5027E
Incorrect number of brackets
CIU5028E
Missing semicolon
CIU5029E
Keyword keyword is duplicated
CIU5030E
No valid statements in REPGRPS – processing terminated
CIU5031E
CIUTABM error function element TABLE table_number REASON reason_code MODULE progname
CIU5032E
No HEADER record found – statement ignored
CIU5033E
Duplicate TRANGRP name
CIU5034E
Transaction group has not been previously created
CIU5035W
Dependency data may be be incomplete because of abend type abend
CIU5036E
Dataspace is full
CIU5037E
No valid transaction IDs in REPGRPS – processing terminated
CIU5038E
Invalid AFFLIFE for AFFINITY
CIU5039E
PARM keyword is duplicated. Correct and rerun
CIU5040E
Invalid REMOVE type
CIU5041E
Report type is not recognized — processing terminated
CIU5042I
Error reading Applid input – processing terminated
CIU5043I
Error reading CIUCNTL file – processing terminated
CIU5044E
Db2® table error on tablename SQL code code
CIU5050E
OPTION ERROR: modulename A VALUE OF optionvalue IS INVALID FOR OPTION optionname.
CIU5051E
modulename ERROR ON OPEN OF CIUOPTS
CIU6002E
Bad parameter: xxx
CIU6003I
Last use timestamps will not be updated
CIU6004I
Last use timestamps will be updated
CIU6005I
Number of new rows added to tablename = nnnn
CIU6006I
Number of existing rows in tablename = nnnn
CIU6007I
Number of rows updated in tablename = nnnn
CIU6008E
SQL error: xxxxxxxx, yyyyyyyyy
CIU6010E
File error: xxxxxxxx, yyyyyyyyy
CIU6011I
**** QSAM OUTPUT STATISTICS FOR TABLE tablename ****
CIU6012I
-------------------------------------
CIU6013I
Number of processed records:
CIU6014I
Number of existing rows:
CIU6015I
Number of rows updated:
CIU6016E
CIU_THREADSAFE_CMD table is empty.
CIU6017I
QSAM CSV files will be produced
CIU6018E
QSAM error, xxxxxxxx, yyyyyyyy. X=program name; y=diagnostic information
CIU6019I
Journal records read = nnnnnnnn
CIU6020I
Trace records written = nnnnnnnn
CIU6021W
No rows selected for processing from tablename
CIU6022I
**** UPDATE STATUS FOR TABLE tablename ****
CIU6023I
Number of new rows added:
CIU6024E
SQLERRMC: sqlerrmc
CIU6030I
CONTROL1 record added to control file
CIU6031I
CONTROL1 record already exists
CIU6032I
Defaults record added to control file
CIU6033I
DEFAULTS record already exists
CIU6034I
APPLID region record added to control file
CIU6035I
APPLID region record already exists
CIU6036I
Number of regions added =number
CIU6037I
Number of existing regions =number
CIU6038I
Number of error records =number
CIU6039W
No input records found for //REGIONS
CIU6040E
Input record error – add region(aaaaaaaa,ssss,_dumphlq_)
CIU6041E
CICS® APPLID must be 1 to 8 characters
CIU6042E
CICS® SYSID must be 1 to 4 characters
CIU6043W
No input records found for //CIUMIGXT
CIU6044I
Parse OK - Number of APPLS added =
CIU6045I
Parse failed - XML-EVENT: XML-TEXT:
CIU6046I
Number of duplicate rows fixed in tablename = count
CIU6047I
Number of applications migrated =
CIU6048E
Length of APPLIC code > 8
CIU6049E
Length of APPLIC name > 50
CIU6050E
Length of APPLIC tran > 4
CIU6051E
Length of APPLIC program > 8
CIU6052I
Unknown record type type was read from file file. The record is skipped.
CIU6053I
Data records read: number.
CIU6054I
Data records processed: number.
CIU6055I
Data records skipped: number.
CIU6056W
procedure_name warning. SQL contention occurred while modifying Db2 tables data.
CIU6057E
procedure_name error. Invalid parameter specified: parameter.
CIU6058S
procedure_name SQL error. SQLCODE=sql_code ERRMSG="db2_error_message".
CIU6059I
Db2 procedure procedure_name ended with RC=return_code.
CIU6064E
CICS IA Dump HLQ must be 1 to 8 characters and non-blank - for DEFAULTS.
CIU6065E
SYSID must be ''DFTS'' for DEFAULTS.
CIU6067E
Translation table modname length is invalid
CIU7000I
5655-U86 (C) Copyright IBM® Corp. 2001, 2025
CIU7001S
An irrecoverable error has occurred in module module.
CIU7003I
Enter a valid option
CIU7027I
No regions defined to CICS® IA
CIU7028W
Invalid action code.
CIU7029I
Action processed successfully.
CIU7030I
Start/Stop request cancelled.
CIU7031E
Connection to remote region not acquired
CIU7032E
Connection to remote region not found
CIU7033I
Enter new Applid and Sysid
CIU7034I
New Applid already exists
CIU7035I
Press Enter to confirm delete or PF12 to cancel
CIU7036I
Request cancelled
CIU7037I
State must be STOPPED before you can delete
CIU7038I
Options 1-3 not valid for single region file
CIU7039I
Press Enter to confirm action or PF12 to cancel
CIU7041I
CICS® IA not installed in target region
CIU7042I
Option number not valid for item
CIU7043I
Maximum of 200 records in control file
CIU7044I
CINC Action processed successfully.
CIU7046E
CINC user userid entry not found.
CIU7047S
CINC Unknown request has been received.
CIU7052E
Region name record Control file has an incorrect format.
CIU7053E
Region name record is not found in Control file.
CIU7100I
CICS IA beta trial period is over.
CIU8000E
The file you have selected could not be found. Please select another file.
CIU8001E
File read error: an internal key value is not a valid integer. Please select another file.
CIU8002E
File read error: an internal key value is not a valid integer. Please select another file.
CIU8003E
File read error: an internal key value is not a valid integer. Please select another file.
CIU8004E
File read error: an internal key value is not a valid key value. Please select another file.
CIU8005E
File read error: an internal key value is not a valid key value. Please select another file.
CIU8006E
File read error: an internal key value is not a valid key value. Please select another file.
CIU8007E
File read error: APPS must be a 3 character code.
CIU8008E
File read error: error reading the selected file.
CIU8009E
Error closing file.
CIU8040E
The URL provided in the CICS® IA Preferences appears invalid. Please check the Host URL given in the CICS IA Preferences.
CIU8045E
Communication with the host failed.
CIU8050E
Communication with the host failed.
CIU8055E
The data could not be displayed in a table. Please try the client again. If the problem persists contact IBM® support.
CIU8060E
Copy fail: Cannot copy row numbers. Select another cell and try again.
CIU8061E
Copy fail: No Cell in the table was selected. Select an individual cell and try again.
CIU8067E
FileIO error: error saving FILENAME. Please try again.
CIU8068E
FileIO error: error overwriting file. Please try again.
CIU8100I
All available data for this query retrieved from the host.
CIU8101I
There are more records to be retrieved.
CIU8102I
No data to retrieve for this query.
CIU8103W
CICS® region is not connected to IBM® Db2®. See message CIU8200I in the CINT log.
CIU8104W
Invalid Application code. See message CIU8202W in the CINT log.
CIU8105W
Enter a valid 2 digit KEY1 field. See CIU8203W in the CINT log.
CIU8106W
Enter correct WHERE clause. See message CIU8204W.
CIU8107W
No columns selected for display. See message CIU8206W.
CIU8108E
Bad CICS® return code. See message CIU8205E in the CINT log.
CIU8109E
Bad SQL return code. See message CIU8201E in the CINT log.
CIU8110E
Client and server not compatible. See message CIU8207E in the CINT log.
CIU8111E
No message file found on host.
CIU8120E
Invalid return code from the host. Contact IBM® support.
CIU8200W
CICS® region is not connected to IBM® Db2®
CIU8201E
Db2® table error on function SQL code code
CIU8202W
Enter a valid 3 digit application code.
CIU8203W
Enter a valid 2 digit KEY1 field.
CIU8204W
One or more WHERE fields are not alphanumeric.
CIU8205S
CICS® command failed RESP=resp RESP2=resp2
CIU8206W
No columns SELECTED for display.
CIU8207E
Client and server not at the same service level.
Collector table manager diagnostics
This section lists the meaning for each possible value of the call parameters that are included in the error messages issued if an error occurs on a call to the Collector table manager, CIUTABM.
Collector CINB request queue manager diagnostics
This section lists the meaning for each possible value of the call parameters that are included in the error messages issued if an error occurs on a call to the Collector CINB request queue manager, CIUCINP.
Required data
To calculate the space allocation requirements, estimate some values for the environment in which you want to run CICS® IA.
Data space allocation
The data space consists of a number of tables, both permanent and temporary. The number and size of the tables varies depending on whether you are collecting Interdependency data or Affinities data.
VSAM data set allocation
There are ten VSAM files associated with CICS® IA.
Db2® space allocation
Calculate the Db2® space allocations using these assumptions and guidance.
CICS® IA transaction security
CICS® IA has no internal RACF® security classes. The two main interfaces are application programs. These two interfaces are the Operations and Administration Interface that is driven by transaction CINT and the Eclipse-based Query Interface.
Db2® security
CICS® IA uses Db2® packages to control access to the tables in CICS and batch. All the packages are bound in to both the batch plan and the CICS plan. The plan names can be defined at customization time.
CICS® IA External Interfaces
The Appendix describes available Stored Procedures and Command Flow user exit.
Db2® Stored Procedures
You can use the CICS® IA External Interfaces to directly access different types of collected data from you application.
The CICS® IA Command Flow user exit
The CICS® IA Command Flow user exit provides additional options when you are saving information about the traced commands into the dataspace.
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
Enabling hover help for screen readers
The CICS® IA plug-in for CICS Explorer uses hover help to provide you with extra information, however tooltips might not be readily available when using a screen reader such as JAWS.
Download PDF
Download the PDF format documentation for CICS Interdependency Analyzer for z/OS 6.3