C35
IBM Software Group
IBM CICS Interdependency Analyzer (CICS IA)
CICS Business Unit, Hursley
March 2003
© 2002 IBM Corporation
IBM Software Group |
Trademarks
The following are trademarks of the International Business Machines Corporation in the United States and/or other countries.
APPN*
BookManager*
CICS*, CICS TS, CICS Transaction
Server
DB2*
e-business logo*
Encina*
Enterprise Storage Server
ESCON*
ES/9000*
FICON
FICON Express
GDDM*
GDPS
Geographically Dispersed Parallel
Sysplex
HiperSockets
IBM*
IBM logo*
Infoprint*
IMS
Intelligent Miner*
iSeries
Magstar*
Multiprise*
MQSeries*
MVS
Netfinity*
NetView*
OS/390*
Parallel Sysplex*
PR/SM
The following are trademarks or registered trademarks of other companies.
pSeries
S/370
S/390*
SecureWay*
Sysplex Timer*
SystemPac*
VisualAge*
Virtual Image Facility
VM/ESA*
VSE/ESA
WebSphere*
z/Architecture
z/OS
z/OS.e
z/VM
zSeries
* Registered trademarks of IBM Corporation
Intel is a trademark of the Intel Corporation in the United States and other countries.
Java and all Java-related trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries.
Lotus, Notes, and Domino are trademarks or registered trademarks of Lotus Development Corporation.
Linux is a registered trademark of Linus Torvalds.
Microsoft, Windows and Windows NT are registered trademarks of Microsoft Corporation.
Penguin (Tux) compliments of Larry Ewing.
SET and Secure Electronic Transaction are trademarks owned by SET Secure Electronic Transaction LLC.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Notes:
Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that any user will experience will vary
depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an
individual user will achieve throughput improvements equivalent to the performance ratios stated here.
IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.
All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may have achieved. Actual environmental
costs and performance characteristics will vary depending on individual customer configurations and conditions.
This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without notice. Consult
your local IBM business contact for information on the product or services available in your area.
All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the performance, compatibility, or any
other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography.
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Agenda
Overview
What is CICS IA?
Why would I want it?
Getting Started
CICS IA Components
The Collector
The Reporter
The Scanner
The Dependency Database
The Query Interface
3
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
What is CICS IA ?
CICS Interdependency Analyzer for z/OS and OS/390 (CICS IA)
Resource interdependencies analysis
what programs are used by a transaction
what Files get read or updated by a transaction
the sequencing of transactions within an application
what transactions run in which regions or address spaces
Relationship data loaded onto a DB2 data base
Run-time tool
Not part of CICS Transaction Server for OS/390
Program Product - 5655-G76
Releases Supported ...
CICS Transaction Server for z/OS, Version 2
CICS Transaction Server for OS/390, Version 1
4
CICS IA |
© 2002 IBM Corporation
IBM CICS Interdependency Analyzer for z/OS and OS/390 (CICS IA) is a unique run-time tool that helps you identify
resource interdependencies within your CICS system using report data stored in a DB2 data base. These reports, which
can be interrogated on-line, will help you to improve your ability to maintain, enhance, and migrate your business
applications.
IBM Software Group |
CICS IA Overview
AOR or TOR/AOR
Collector
DB2
Dependency
Database
Query
interface
Dynamic
SQL
5
CICS IA |
CIU_DATA
etc.
DataSpace
DataSpace
DataSpace
Scanner
Application
Load Library
Collected
Dependency
Data
VSAM
CIUINT1
Report
SQL
Update
Reporter
Report
© 2002 IBM Corporation
CICS IA automates the process of collecting the data on the interdependencies between CICS resources.
CICS IA works in two ways - off-line and online.
Online Components
The Collector intercepts CICS commands which may be involved in an interdependency and records the details of the
resources used. For efficiencies sake the data is stored in a data space, which under user control, may be offloaded to
the Collected dependency data component. These data sets may be aggregated together and stored in a DB2
Database.
Routine use of CICS IA Collector component helps build a comprehensive database that you can mine online using a
the Query Interface component to gain a better understanding of:
·
Selected CICS region contents
·
Transaction resource run requirements
·
Program resource use
·
Unused resources
Off-line Components
The Reporter presents the dependency information collected by the Collector for a selected CICS region, in a structured
format. The Scanner provides the additional capability to scan the load module data sets detecting EXEC CICS
commands that may cause transaction resource dependency and to produce a printed report.
IBM Software Group |
Why use CICS IA?
Understand Active Application Inventory
Merger / Acquisition
Outsourcer
Maintain or Enhance Applications
Request to change or upgrade an application
Transactions, programs, data elements:
Files
Queues
Screens, ...
CICS IA identifies the resources that are affected directly and
indirectly
What to change, what to build, what to test, what needs to be
communicated to roles involved
Look across boundaries, including through shared data - files,
databases or queues
6
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Getting Started
CICS IA provides the following libraries:
SCIUCLIS - DB2 CLIST invoked by the DB2 update job
CIUUPDB.
SCIUDATA - SQL statements used in building and
updating the DB2 database.
SCIUDBRM - DB2 BIND packages.
SCIUEXEC - DB2 exec used in building new 'Applications'
SCIUINST - SMP/E Installation jobs.
SCIULOAD - load library to be added to the DFHRPL
SCIUSAMP - sample jobs to set up CICS IA , and run the
Reporter and Scanner.
SCIUSQL - DDL statements to create DBR database and
tables.
7
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Getting Started...
CIUJCLR
CIUJCLLD
CIUJCLLS
CIUJCLCA
CIUJCLCC
CIUDBCR
CIUCLR
CIUDBND
CIUANEW
CIUALOAD
CIUADESC
CIUDCTIN
CIUJ41CR
CIUJ12CR
CIUJ13CR
CIUJ21CR
CIUJ22CR
CIUUPDB
8
Job to run the reporter
Job to run the Scanner (detail report)
Job to run the Scanner (summary)
Job to create the VSAM dependency file
Job to create the VSAM control file
Job to create the DB2 dependency database
Job to clear the CIU_DATA table
Job to bind the DBRMs
Job to define a DB2 application
Job to load the APP_SQL table
Job to define Application description
Job to assemble DCT table entry (V4.1)
Job to define resource definitions for CICS/ESA 4.1
Job to define resource definitions for CICS TS 1.2
Job to define resource definitions for CICS TS 1.3
Job to define resource definitions for CICS TS 2.1
Job to define resource definitions for CICS TS 2.2
Job to update the database
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Getting Started...
To run CICS IA in CICS:
Apply PTF UQ73258 (APAR PQ69211).
Create the VSAM files for the collector
<hlq>.CIUCNTL A recoverable file used to hold control information (CIUJCLCC)
<hlq>.CIUINT1 A non-recoverable file used to hold dependency data (CIUJCLCA)
Build the dependency database (CIU_DATA)
DB2 Considerations
Under which 'qualifier' to create the DB2 tables ?
How to grant access to the DB2 plans and tables ?
Consult your DB2 Administrator.
Read Informational APAR II13437.
Defining the database
Edit and run job CIUDBCR to create the database.
Edit and run job CIUBND to bind the DBRMs.
Edit and run job CIUALOAD to define the default application.
9
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Getting Started...
To run CICS IA in CICS...:
Defining resources to CICS
Provided by CICS release - job name CIUJnnCR
CICS IA Programs, Transactions (CINT, CINB, CINQ), VSAM Files, DB2 Connections
and CINT TD Queue
Install CICS IA Resource Group per CICS region to be analyzed
Tailoring your CICS start-up job
DB2CONN=YES
ICVR=10000 (10 Secs+) or Collector abend AICA
Add SCIULOAD to the DFHRPL concatenation
Add to start-up JCL //CINT DD SYSOUT=*
Restart your CICS region
10
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Dependency Database
The database contains accumulated data about all your
applications and the resources that they use.
Update regularly
Run the Collector with your normal weekly workload to collect the base data
Also at
month ends
quarter ends
year ends
Then only need to update the database for new applications and changes.
11
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Creating Application Views
Group transactions into Applications
A 3 Character code
An Application Description
STEPS to Defining an Application table :Choose a 3 character code.
Select the sample skeleton 'CIUAPNEW' definition supplied in
SCIUDATA.
Using the skeleton create a member for your Application and store in
SCIUDATA , e.g. CIUAPxxx
Example - member CIUAPCAM (includes all transactions which start
CAM):
CAM
TRANSID LIKE 'CAM%'
You can use any valid SQL statements to define the transactions to form
the application.
12
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Creating Application Views ....
STEPS to defining an Application table (Contd) :Create the application definition SQL by editing and running job CIUANEW from
SCIUSAMP:
//CAM EXEC NEWAPP,MEMBER=CIUAPCAM
Add the application definitions to the APP_SQL table by editing and running job
CIUALOAD from SCIUSAMP. This uses the DB2 procedure DSNUPROC.
Add an application description for your 3 character code by editing and updating
CIUADESC from CIUSQL and running job CIUADESC from SCIUSAMP.
13
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Collector
CICS Tools
14
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
EXEC CICS Commands Monitored by CICS IA
CICS Inter-Transaction and Transaction-System Commands
READQ TS
WRITEQ TS
DELETEQ TS
READQ TD
WRITEQ TD
DELETEQ TD
LINK
RETURN TRANSID
XCTL
LOAD
ALLOCATE
FREE
CONNECT PROCESS
SEND CONVID/SESSION
CONVERSE CONVID/SESSION
START
SEND MAP
RECEIVE MAP
WRITE JOURNALNUM/NAME
WAIT JOURNALNUM/NAME
15
CICS IA |
READ FILE
WRITE FILE
UNLOCK FILE
DELETE FILE
STARTBR FILE
READNEXT FILE
READPREV FILE
ENDBR FILE
RESETBR FILE
REWRITE FILE
CREATE/INQUIRE/SET PROGRAM
DISCARD PROGRAM
CREATE/INQUIRE/SET FILE
DISCARD FILE
CREATE/INQUIRE/SET TRANSACTION
DISCARD TRANSACTION
CREATE/INQUIRE/SET TDQUEUE
HANDLE ABEND PROGRAM
CREATE/INQUIRE/SET JOURNALNAME
INQUIRE TSQUEUE
© 2002 IBM Corporation
IBM Software Group |
The Collector
CICS AOR, TOR/AOR
XEIOUT
CINT
CINB
Collected
Dependency Data
16
CICS IA |
DataSpace
Exit Points
EXIT Program
XEIIN
VSAM
© 2002 IBM Corporation
You can use the Collector in real-time to detect transaction resource dependencies in a running CICS region, and to
save details of the dependencies in an MVS data space. This data is subsequently saved to DASD. The Collector
consists of:
A control transaction, CINT
An autosave transaction, CINB
A global user exit program
This is shown in Figure 2 on page 6.
The data is collected by the global user exit program at exit points XEIOUT and XEIIN. This exit program intercepts all
the EXEC CICS commands that are needed to deduce dependencies. The exit program coexists with any other exit
programs at the same exit points. (It can be placed before or after other exit programs, without any of the exit programs
being affected.)
IBM Software Group |
CINT Transaction
CINT01 Version 1.1
The
Collector
Component
CICS Interdependency Analyzer
Applid IYCLZC0D
Press Start key (F5) to start detection.
Press Options key (F4) to modify the CINT operation options.
CINT state . . . . . . . . :
STOPPED by user CICSUSER
Number of pauses . . . . . : 0
Number of saves. . . . . . : 1
Records written last save. :153
Total records on file. . . : 153
Date/time of last start. . : 11/14/01 10:48:30 (MM/DD/YY HH:MM:SS)
Date/time of last save . . : 11/14/01 10:49:41 (MM/DD/YY HH:MM:SS)
Date/time of last change . :11/14/01 10:49:34 (MM/DD/YY HH:MM:SS)
Total time RUNNING . . . . : 0000:01:12 (HHHH:MM:SS)
Total time PAUSED. . . . . :
(HHHH:MM:SS)
Table dataspace name . . . :
% full
5696582R (C) Copyright IBM Corp. 1995
F1=Help F3=Exit F4=Options F5=Start F6=Stop F7=Pause F8=Continue F12=Cancel
17
CICS IA |
© 2002 IBM Corporation
CINT gives the screen to start and stop the statistics gathering as in the screen-shot depicted in this foil.
PF4 gives the options
Currently the VSAM file holds a 'First Recorded' time and a 'Change Recorded Time' for each resource call in the
program. It also holds an use count.
The key also contains the offset (location) of the resource call within a program. So if we had two 'EXEC CICS WRITEQ
TS QUEUE('FRED') within a program
then we have 2 records.
The VSAM load program does the following :Reads in the record.
Checks if it is already in the DB2 table (applid,homesysid,program,function,type,object,rmtsysid) Note it does not check
or store the location.
If it does not exist it inserts it. The LAST_RUN time stamp is taken from the 'change record time' in the VSAM file. The
FIRST_RUN time is not
inserted so it defaults to the time of the insert. Should it be taken from 'first recorded time' in the VSAM file ? . The use
count is taken from this VSAM
record.
If it does exist then if the 'change record time' on the VSAM record is greater than the LAST_RUN time on the DB2 table
then it updates the LAST_RUN time.
It does not update the USE_COUNT but this must have changed since the LAST_RUN time has changed indicating a
further use.
The UPDATE parameter must be set for this to happen.
IBM Software Group |
CICS IA - Controlling the Collector
CINT02
CINT Operation Options
Applid IYCLZC0D
Modify the options and press Enter to update, or press Cancel (F12)
Control options
Perform periodic saves . . . . . . Y
(Y=Yes or N=No)
Restore data on start. . . . . . . N
(Y=Yes or N=No)
Maintain usage counts. . . . . . . Y
(Y=Yes or N=No)
Size of dataspace. . . . . . . . . 16__ (10 to 2000 Mbytes)
Transid prefix (optional). . . . . ____ (1 to 4 characters)
Detect command types (Y=Yes or N=No)
BMS . . . . . .
Y
LINK . . . . . .
Y
XCTL . . . . . .
Y
LOAD . . . . . .
Y
INQ/SET/DSC Prg. Y
INQ/SET TDQueue. Y
File Control . . .
Y
Temporary Storage.
Y
Transient Data . .
Y
INQ/SET/DSC File .
Y
HANDLE ABEND PGM.. Y
DTP . . . . . . .
Y
START . . . . . .
Y
RETURN TRANSID . Y
INQ/SET/DSC Tran. Y
Journal Commands. Y
Last updated by CICSUSER on 11/02/01 10:47:44
F1=Help
18
F12=Cancel
CICS IA |
© 2002 IBM Corporation
You can monitor and control the Collector through the CINT transaction, which enables you to start, pause, continue,
and stop the collection of dependency data into the tables in the data space. Using the CINT transaction, you can also
specify for which dependency commands, and for which transactions, data is to be collected.
The options that you specify to control the Collector for a CICS region are preserved in a recoverable VSAM control file.
This screen gives the options which can be selected for the next time the facility is started.
the 'Perform Periodic Save' option. If this flag is set to yes then we will SAVE to the VSAM file when :1) the table within the dataspace gets full.
2) periodically - from what I can see the time period can be between 15 and 300 seconds and only saves when there is
something to save.
We will also SAVE to VSAM when we PAUSE and STOP.
The CIU_CHAIN table is not used in any of the online queries. It is created in the CIUUPDT job. The only thing I can see
is the we create a DB2 view called
V_CIU_INDIRCT_HITS . As far as I can see it is not used anywhere.
"CREATE VIEW
V_CIU_INDIRCT_HITS
AS SELECT FRONT_TXN, BACK_TXN, APPLID, HOMESYSID, TRANSID, PROGRAM,
FUNCTION, TYPE, OBJECT, RMTSYSID, USECOUNT, LAST_RUN
FROM CIU_CHAIN A, CIU_DATA B
WHERE A.BACK_TXN = B.TRANSID; "
IBM Software Group |
The Reporter
CICS Tools
19
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter
Batch Program
Runs against VSAM Dependency Data
CMDGRPS DD statement
BMS
SEND MAP, RECEIVE MAP
LINK
LINK
XCTL
XCTL
LOAD
LOAD
ISPC
INQUIRE PROGRAM, SET PROGRAM, DISCARD PROGRAM
FC
READ, WRITE, DELETE, STARTBR, READNEXT, READPREV, ENDBR, RESETBR, UNLOCK, REWRITE
TS
READQ TS, WRITEQ TS, DELETEQ TS
TD
READQ TD, WRITEQ TD, DELETEQ TD
ISFC
INQUIRE FILE, SET FILE, DISCARD FILE
DTP
ALLOCATE, CONNECT, SEND CONVID/SESSION, CONVERSE CONVID/SESSION, FREE
START START
RETURN RETURN TRANSID
ISTR
INQUIRE TRANSACTION, SET TRANSACTION, DISCARD TRANSACTION
ISTD
INQUIRE TDQUEUE, SET TDQUEUE
HANDLE HANDLE ABEND PROGRAM
JRNL
WRITE JOURNALNUM, WAIT JOURNALNUM
Header page details invalid commands and confirms command groups chosen
20
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter - full example
//JAMESEC JOB H254501-TSOO,JAMESE,MSGCLASS=Y,
//
NOTIFY=JAMESE,REGION=4096K,TIME=10
/*JOBPARM SYSAFF=MV55
//REPORT
EXEC PGM=CIUREP
//*********************************************************************
//* JCL NAME = CIUJCLRP
//* DESCRIPTIVE NAME = IBM CICS INTERDEPENDENCY ANALYZER
/*
Sample JCL for running Reporter
//* FUNCTION =
//*
Sample JCL to run the Reporter component of the
//*
Interdependency Analyzer
//*********************************************************************
//STEPLIB DD DSN=CIU.V110.SCIULOAD,DISP=SHR
//CIUINT1 DD DSN=CICSTLS.CIU530.CIUINT1,DISP=SHR
//CIUCNTL DD DSN=CICSTLS.CIU530.CIUCNTL,DISP=SHR
//CMDGRPS DD *
/*
//TRANGRPS DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
21
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter - full example header
CICS INTERDEPENDENCY ANALYZER
Command Type
------------
Version 1.1
Reporting
---------
BMS
LINK
XCTL
LOAD
ISPC
FC
TS
TD
ISFC
DTP
START
RETURN
ISTR
ISTD
HANDLE
JRNL
22
(CIU)
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter - full example output
CICS INTERDEPENDENCY ANALYZER
2003/03/05
Page
2
Applid=IYETZEJ3
Tran Program Offset
Command
Resource
(hex value)
Sysid
Usage
------------------------------------------------------------------------------------------------------------EQAC EQZ3ACTL 000003C8 XCTL
EQZ3STAT
C5D8E9F3E2E3C1E3
---3
000003C8 XCTL
EQZ3SWCF
C5D8E9F3E2E6C3C6
---1
0000046E RETURN TRANSID
EQAC
C5D8C1C3
---5
000008E2 SEND MAP
EQZMA01
C5D8E9D4C1F0F1
---5
0000098E RECEIVE MAP
EQZMA01
C5D8E9D4C1F0F1
---5
00000B24 LOAD
EQZTSCT
C5D8E9E3E2C3E340
---10
EQZ3STAT 00000692 XCTL
EQZ3ACTL
C5D8E9F3C1C3E3D3
---3
0000079C LOAD
EQZTSTAT
C5D8E9E3E2E3C1E3
---3
000009BE SEND MAP
EQZME01
C5D8E9D4C5F0F1
---3
00000A16 RECEIVE MAP
EQZME01
C5D8E9D4C5F0F1
---3
00000E5C LOAD
EQZTSCT
C5D8E9E3E2C3E340
---3
EQZ3SWCF 0000132C DELETEQ TS
EQMT+TA+
C5D8D4E34EE3C14E
---1
000013A8 STARTBR
EQZSWCH
C5D8E9E2E6C3C840
---2
00001408 READNEXT
EQZSWCH
C5D8E9E2E6C3C840
---2
0000148E WRITEQ TS
EQMT+TA+
C5D8D4E34EE3C14E
---18
0000152A READNEXT
EQZSWCH
C5D8E9E2E6C3C840
---18
000015A4 ENDBR
EQZSWCH
C5D8E9E2E6C3C840
---2
23
CICS IA |
(CIU)
Version 1.1
© 2002 IBM Corporation
IBM Software Group |
The Reporter - BMS example
//JAMESEC JOB H254501-TSOO,JAMESE,MSGCLASS=Y,
//
NOTIFY=JAMESE,REGION=4096K,TIME=10
/*JOBPARM SYSAFF=MV55
//REPORT
EXEC PGM=CIUREP
//*********************************************************************
//* JCL NAME = CIUJCLRP
//* DESCRIPTIVE NAME = IBM CICS INTERDEPENDENCY ANALYZER
/*
Sample JCL for running Reporter
//* FUNCTION =
//*
Sample JCL to run the Reporter component of the
//*
Interdependency Analyzer
//*********************************************************************
//STEPLIB DD DSN=CIU.V110.SCIULOAD,DISP=SHR
//CIUINT1 DD DSN=CICSTLS.CIU530.CIUINT1,DISP=SHR
//CIUCNTL DD DSN=CICSTLS.CIU530.CIUCNTL,DISP=SHR
//CMDGRPS DD *
BMS
/*
//TRANGRPS DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
24
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter - BMS example header
CICS INTERDEPENDENCY ANALYZER
Command Type
------------
Version 1.1
Reporting
---------
BMS
LINK
XCTL
LOAD
ISPC
FC
TS
TD
ISFC
DTP
START
RETURN
ISTR
ISTD
HANDLE
JRNL
25
(CIU)
Yes
No
No
No
No
No
No
No
No
No
No
No
No
No
No
No
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Reporter - BMS example output
CICS INTERDEPENDENCY ANALYZER
2
(CIU)
Version 1.1
2003/03/05
Page
Applid=IYETZEJ3
Tran Program Offset
Command
Resource
(hex value)
Sysid
Usage
------------------------------------------------------------------------------------------------------------EQAC EQZ3ACTL 000008E2 SEND MAP
EQZMA01
C5D8E9D4C1F0F1
---5
0000098E RECEIVE MAP
EQZMA01
C5D8E9D4C1F0F1
---5
EQZ3STAT 000009BE SEND MAP
EQZME01
C5D8E9D4C5F0F1
---3
00000A16 RECEIVE MAP
EQZME01
C5D8E9D4C5F0F1
---3
EQZ3SWCF 00002B2E SEND MAP
EQZMC01
C5D8E9D4C3F0F1
---3
00002BE0 RECEIVE MAP
EQZMC01
C5D8E9D4C3F0F1
---3
0000377E SEND MAP
EQZMC03
C5D8E9D4C3F0F3
---1
00003830 RECEIVE MAP
EQZMC03
C5D8E9D4C3F0F3
---1
OTTO ABLMC00 00000628 SEND MAP
OTTOM00
D6E3E3D6D4F0F0
---1
00001340 SEND MAP
OTTOM01
D6E3E3D6D4F0F1
---4
00001340 SEND MAP
OTTOM02
D6E3E3D6D4F0F2
---5
00001340 SEND MAP
OTTOM04
D6E3E3D6D4F0F4
---1
0000143C RECEIVE MAP
OTTOM00
D6E3E3D6D4F0F0
---1
0000143C RECEIVE MAP
OTTOM01
D6E3E3D6D4F0F1
---4
0000143C RECEIVE MAP
OTTOM02
D6E3E3D6D4F0F2
---5
0000143C RECEIVE MAP
OTTOM04
D6E3E3D6D4F0F4
---1
VA10 CAMA100C 000024CE SEND MAP
CAM1001
C3C1D4F1F0F0F1
---5
26
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner
CICS Tools
27
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner
Batch Program
Runs against Application Load Library
Summary or Detail reports
Summary report contains:
A separate line giving the following information about each module in the library:
Name
Size
Language (if determined)
Requires that at least one 'dependency-causing' EXEC CICS command is detected
Number of possible 'dependency-causing' EXEC CICS commands
an INTMOD output file which can then be used as input to the detailed scan
Detailed report contains
A section for each module, with:
A header line giving the name, size, and entry point of the module
A line for each possible dependency-causing command found, giving:
The offset of the command argument zero declaration from the start of the load module.
The contents of the command argument zero declaration (in hexadecimal).
The EDF DEBUG line number, if present.
What the command appears to be (for example, WRITEQ TS).
28
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner - summary example
//JAMESEC JOB H254501-TSOO,JAMESE,MSGCLASS=Y,
//
NOTIFY=JAMESE,REGION=4096K,TIME=10
/*JOBPARM SYSAFF=MV55
//SCAN
EXEC PGM=CIULMS,PARM='£SUMMARY,DETAILMODS'
//*********************************************************************
//* JCL NAME = CIUJCLLS
*
//* DESCRIPTIVE NAME = IBM CICS INTERDEPENDENCIES UTILITY
*
//*
Sample JCL for running Scanner (SUMMARY mode) *
//*
*
//* FUNCTION =
*
//*
Sample JCL to run the Load Module Scanner component of the
*
//*
Interdependencies Utility (SUMMARY mode).
*
//*
- the load library to scan is INPUT DD
*
//*
- the output report goes to SYSPRINT DD
*
//*
- the output module list goes to INTMOD DD
*
//*
- for a SUMMARY mode run, DETAIL DD is not used
*
//*
The following must be changed
*
//*
- the file DSN prefixes (CIU.CMZ100)
*
//*********************************************************************
//STEPLIB DD DSN=CIU.V110.SCIULOAD,DISP=SHR
//INPUT
DD DSN=JAMESE.V2R1M0.SEZPLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//INTMOD
DD DSN=JAMESE.CMZ100.DETMODS,DISP=SHR
//DETAIL
DD DUMMY
//
29
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner - summary example
CICS INTERDEPENDENCY ANALYZER Version 1.1.0
2003/03/05
LOAD MODULE SCANNER - SUMMARY LISTING OF JAMESE.V2R1M0.SEZPLOAD
Module
Name
-------CAMAA00C
CAMAA10C
CAMATRCC
CAMA001
CAMA100C
CAMA101
CAMA110C
CAMA115C
CAMA120C
CAMA130C
CAMA200C
CAMA201
CAMA210C
CAMA300C
CAMA310C
30
Module
Length
-------000086F0
0000B780
00004460
00000330
00008870
00000298
000085F8
00004B78
000078B8
00008DA0
00008660
00000208
00009850
0000A1E0
00008A38
CICS IA |
Module
Language
---------COBOL II
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
ASSEMBLER
Dependency
Statements
---------15
19
16
0
25
0
21
15
21
23
21
0
29
23
15
Page
1
MVS POSTs
Comment
---------0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
----------------------------Possible dependency commands.
Possible dependency commands.
Possible dependency commands.
Possible dependency commands.
Possible
Possible
Possible
Possible
Possible
dependency
dependency
dependency
dependency
dependency
commands.
commands.
commands.
commands.
commands.
Possible dependency commands.
Possible dependency commands.
Possible dependency commands.
© 2002 IBM Corporation
IBM Software Group |
The Scanner - summary example
CICS INTERDEPENDENCY ANALYZER Version 1.1.0
Page
5
LOAD MODULE SCANNER - SUMMARY LISTING OF JAMESE.V2R1M0.SEZPLOAD
2003/03/05
LOAD LIBRARY STATISTICS
===============================================================
Total modules in library
=
194
Total modules scanned
=
194
Total CICS modules/tables (not scanned)
=
0
Total modules in error (not scanned)
=
0
Total modules containing possible MVS POSTs
=
0
Total modules containing possible Dependency commands =
103
Total ASSEMBLER modules
=
73
Total C/370 modules
=
0
Total COBOL modules
=
0
Total COBOL II modules
=
30
Total PL/I modules
=
0
31
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner - summary example
The DETMODS dataset will contain an entry for all programs with possible
dependencies. This is used as input to the 'DETAILED' scan.
------------------------------------------------------------------------------BROWSE
JAMESE.CMZ100.DETMODS
Line 00000000 Col 001 080
Command ===>
Scroll ===> CSR
********************************* Top of Data **********************************
CAMAA00C
CAMAA10C
CAMATRCC
CAMA100C
CAMA110C
CAMA115C
CAMA120C
CAMA130C
CAMA200C
CAMA210C
CAMA300C
CAMA310C
CAMA320C
CAMA330C
CAMA340C
CAMA4A0C
32
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner - detailed example
//JAMESEC JOB H254501-TSOO,JAMESE,MSGCLASS=Y,
//
NOTIFY=JAMESE,REGION=4096K,TIME=10
/*JOBPARM SYSAFF=MV55
//SCAN
EXEC PGM=CIULMS,PARM='£DETAIL'
//*********************************************************************
//* JCL NAME = CIUJCLLS
*
//* DESCRIPTIVE NAME = IBM CICS INTERDEPENDENCIES UTILITY
*
//*
Sample JCL for running Scanner (DETAIL mode)
*
//*
*
//* FUNCTION =
*
//*
Sample JCL to run the Load Module Scanner component of the
*
//*
Interdependencies Utility (DETAIL mode).
*
//*
- the load library to scan is INPUT DD
*
//*
- the output report goes to SYSPRINT DD
*
//*
- the module list to use is in DETAIL DD
*
//*
- for a DETAIL mode run, INTMOD DD is not used
*
//*
The following must be changed
*
//*
- the file DSN prefixes (CIU.CMZ100)
*
//*********************************************************************
//STEPLIB DD DSN=CIU.V110.SCIULOAD,DISP=SHR
//INPUT
DD DSN=JAMESE.V2R1M0.SEZPLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//DETAIL
DD DSN=JAMESE.CMZ100.DETMODS,DISP=SHR
//INTMOD
DD DUMMY
//
33
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Scanner - detailed example
CICS INTERDEPENDENCY ANALYZER
Version 1.1.0
2003/03/05
Page
1
LOAD MODULE SCANNER - DETAILED LISTING OF JAMESE.V2R1M0.SEZPLOAD
Module Name - CAMAA00C
Offset
-------00000494
00003E13
00003E28
/
Load Module Length - 000086F0
Storage Content (HEX)
-------------------------------------------------0A0680002700002100
54020080290080000000000000
4E028020298020000000000000
00003E3D 0E06C0002900002400
00003E5F 0E06C0002900000400
00003E70 0E06C0002900002400
00003E81 0E06C0002900002400
0000558B 54020080290080000000000000
000055A0 4E028020298020000000000000
000055B5 0E06C0002900002400
000055D7 0E06C0002900000400
000055E8 0E06C0002900002400
000055F9 0E06C0002900002400
000079FE 0E06C0002900002400
00007A0F 0E06C0002900002400
Total possible Dependency commands =
Total possible MVS POSTs
=
34
/
CICS IA |
Module Entry Point - 00000020
EDF DEBUG
--------01036
00000
00000
00000
00000
00000
00000
00001
00001
00001
00001
00001
00001
00000
00000
Possible Command
----------------------DELETEQ TS
INQUIRE SYSTEM
INQUIRE PROGRAM
Dependency
----------Trans
System
System
LOAD PROGRAM HOLD
LOAD PROGRAM
LOAD PROGRAM HOLD
LOAD PROGRAM HOLD
INQUIRE SYSTEM
INQUIRE PROGRAM
LOAD PROGRAM HOLD
LOAD PROGRAM
LOAD PROGRAM HOLD
LOAD PROGRAM HOLD
LOAD PROGRAM HOLD
LOAD PROGRAM HOLD
Trans
Trans
Trans
Trans
System
System
Trans
Trans
Trans
Trans
Trans
Trans
15
0
© 2002 IBM Corporation
IBM Software Group |
The Scanner - detailed example
CICS INTERDEPENDENCY ANALYZER Version 1.1.0
LOAD MODULE SCANNER - DETAILED LISTING OF JAMESE.V2R1M0.SEZPLOAD
2003/03/05
Page
48
LOAD LIBRARY STATISTICS
===============================================================
Total modules in DETAIL file
=
103
Total modules scanned
=
103
Total CICS modules/tables (not scanned)
=
0
Total modules in error (not scanned)
=
0
Total modules containing possible MVS POSTs
=
0
Total modules containing possible Dependency commands =
103
Total ASSEMBLER modules
=
73
Total C/370 modules
=
0
Total COBOL modules
=
0
Total COBOL II modules
=
30
Total PL/I modules
=
0
35
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Database
CICS Tools
36
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Dependency Database
The database contains accumulated data about all your transactions
and programs and the resources that they use.
Optionally you can define applications
By grouping your transactions
Supports queries at the application level
The data base contains the following base tables:
CIU_DATA
This table stores information about every unique combination of CICS region, transaction,
program, function, and object recorded by the Collector.
CIU_CHAIN
This table joins with CIU_DATA to show indirect dependencies.
APP_SQL
This table holds the SQL commands that satisfy application query commands.
There are other facilitating tables used in the updates of these base tables.
37
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
CIU_DATA Table
38
Column
Type
Description
APPLID
CHAR(8)
CICS region applid
HOMESYSID
CHAR(4)
SYSID of local system
TRANSID
CHAR(4)
CICS transaction id
PROGRAM
CHAR(8)
Currently active CICS program
FUNCTION
CHAR(8)
CICS command function such as READ, WRITEQ
TYPE
CHAR(8)
Resource type, such as TS, Program etc.
OBJECT
CHAR(8)
Resource name
RMTSYSID
CHAR(4)
Remote SYSID where relevant
USECOUNT
INTEGER
Number of occurrences
FIRST_RUN
time
Time of first occurrence
LAST_RUN
time
Time of latest observation
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
CIU_CHAIN Table
Column
Type
Description
FRONT_TXN
CHAR(4)
Started Transaction
BACK_TXN
CHAR(4)
Connecting Transaction
NOTES:
This table allows a JOIN with CIU_DATA to show indirect
dependencies.
It shows relationships between transactions
A query on a TRANSID can show the resources that it uses, and also
any resources used by other transactions that it starts, or holds a
DTP conversation with.
39
CICS IA |
© 2002 IBM Corporation
For example, if TRN1 CONNECTs to TRN2, and TRN2 connects to TRN3, three rows in the table are needed to record
this:
TRN1 :TRN2
TRN2 :TRN3
TRN1 :TRN3
All queries about TRN1 can join this table to CIU_DATA using the second field as the join field and the first field to
perform the selection. Selecting on the joined tables where FRONT_TXN = TRN1 gives all the dependencies on
resources used by TRN2 and TRN3. To complete the picture, a further record is needed to include immediate
dependencies as well as indirect ones:
TRN1 :TRN1
IBM Software Group |
APP_SQL Table
Column
Type
Description
KEY1
SMALLINT
Option selected from first menu screen. Value 1-10
KEY2
SMALLINT
Option selected from second menu. Value 1-11
KEY3
SMALLINT
Indicator of precise or ’LIKE’ selection
KEY4
SMALLINT
Indicator of extra details required (1) =YES, (0)=NO
KEY5
SMALLINT
unused
APP
CHAR(3)
Application code if selected or ??? if not selected
SEQ
SMALLINT
Sequence in which SQL text read
USECOUNT INTEGER
SQLTEXT
CHAR(50)
SQL text used to satisfy query
NOTES:
This table holds the SQL commands that satisfy the queries that are set up in the Query
interface.
The SQL is run against CIU_DATA by the extract programs in the Query interface.
40
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Query Interface
CICS Tools
41
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
The Query Interface
The Query interface is:
A suite of CICS COBOL BMS programs
These programs allow you to dynamically interrogate the
dependency database.
The transaction CINQ drives this interface
CICS Transaction - CINQ
Interrogate the data that was collected from running your
applications
By resource type, for example
All files used by application AP1
All transactions started by transaction TRN1
42
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
CINQ - The Query Interface - Main Menu
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
Select the resource type to query: _
CIUM000
1
1. Transactions
2. Programs
3. TSQs
4. TDQs
5. Maps
6. Files
7. Applications
8. Regions
OR display all resources in application ___
Enter the application's 3 character code or
? for a list of applications available.
WARNING : Option 7 may take a long time.
5655-G76 (C) Copyright IBM Corp. 2001
PF1=Help PF3=Exit
43
CICS IA |
© 2002 IBM Corporation
The Query interface allows you to interrogate the data that was collected from your live applications by the Collector,
and stored in the dependencies database.
CINQ displays the menu of possible resource queries that you can make.
This screen gives view of the first panel.
Reports can be generated either by
A) choosing one of the resource types
B) an application can be given a 3 character code.
For example, if you want to know which transactions use a specific resource you would select option 1 on the menu.
You will then see a further menu screen allowing you to define the specific resource you want to query. This screen is
presented in the next foil.
IBM Software Group |
Resource Menu - Transactions
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
CIUM010
Query TRANSACTIONS
Select the option that best suits your query by entering the resource
details in the field provided for each option. Use % as a wildcard
character to specify a generic name.
Note: Only one option can be chosen.
1. Start transaction....____
(e.g.. TRN1 or TRN%)
2. Used by tran.........___
3. Use program..........________
4. Used by program......________
5. Use TDQ..............________ Detailed TDQ output? N
6. Use TSQ..............________ Detailed TSQ output? N
7. Use map..............________
8. Use file (ddname)....________ Detailed file output? N
CORD
9. In region............____
10. DTP to transaction...____
11. In application.......___
(enter ? for a list of application
codes)
PF1=Help PF3=End PF4=Exit
44
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Query Interface output screen
CICS IA V1.1
For your query
CICS Interdependency Analyzer for z/OS and OS/390
WHICH TRANS ARE IN REGION CORD
HOME TRAN
SYSID
CORD CINT
EHLP
EQRH
EQRM
EQSS
VA10
VA12
VA20
VA21
VA30
VA33
V200
V220
V800
V884
HOME TRAN
SYSID
No more details to display
PF3=End PF4=Exit PF7=Up PF8=Down
45
CIUM100
Page 1 of 1
CICS IA |
Here we see that in CICS region CORD the following transactions were used.
© 2002 IBM Corporation
IBM Software Group |
CINQ- Entering a 3-character application code
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
Select the resource type to query:
1.
2.
3.
4.
5.
6.
7.
8.
CIUM000
_
Transactions
Programs
TSQs
TDQs
Maps
Files
Applications
Regions
OR display all resources in application ?__
Enter the application's 3 character code or
? for a list of applications available.
WARNING : Option 7 may take a long time.
PF1=Help PF3=Exit
46
CICS IA |
If we return to the main menu and enter a ? ...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Selecting an Application
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
Application Names and Codes
_ Callpath/CICS
_ CallCoordinator/CICS
s OTTO for CICS
EQZ
CAM
OTT
Enter 'S' to select an application code
PF1=Help PF3=End PF4=Exit PF7=Up PF8=Down
47
CICS IA |
CIUM050
Page
1 of
1
© 2002 IBM Corporation
This screen shows the output for the previous request - the list of applications that have been assigned codes.
If we selecte TVA...(next foil)
IBM Software Group |
Resource Menu - Application Resources
CICS IA V1.1
For your query
CICS Interdependency Analyzer for z/OS and OS/390
WHICH RESOURCES ARE IN OTTO for CICS
In Tran Program
Regn
T530 OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
T620 OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
OTTO ABLMC00
Links/XCTL Strts DTP to Remote File
Loads
Tran
Tran Sysid
Map
Inquire
/Set
Retn
Tran
OTTO
OTTOCMD
OTTOEXIT
PF3=End PF4=Exit PF7=Up PF8=Down
48
CIUM300
OTTOMOD
OTTOM00
OTTOM01
OTTOM02
OTTOM04
OTTO
OTTOCMD
OTTOMOD
OTTOM00
OTTOM01
OTTOM02
OTTOM04
Page
1 of
2
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
CINQ
Select the resource type to query:
Select Transaction
1. Transactions
2. Programs
3. TSQs
4. TDQs
5. Maps
6. Files
7. Applications
8. Regions
CIUM000
1
OR display all resources in application ___
Enter the application's 3 character code or
? for a list of applications available.
WARNING : Option 7 may take a long time.
5655-G76 (C) Copyright IBM Corp. 2001
PF1=Help PF3=Exit
49
CICS IA |
© 2002 IBM Corporation
The Query interface allows you to interrogate the data that was collected from your live applications by the Collector,
and stored in the dependencies database.
CINQ displays the menu of possible resource queries that you can make.
This screen gives view of the first panel.
Reports can be generated either by
A) choosing one of the resource types
B) an application can be given a 3 character code.
For example, if you want to know which transactions use a specific resource you would select option 1 on the menu.
You will then see a further menu screen allowing you to define the specific resource you want to query. This screen is
presented in the next foil.
IBM Software Group |
Resource Menu - Transactions Using File OTTOCMD?
CICS IA V1.1
Query
CICS Interdependency Analyzer for z/OS and OS/390
CIUM010
TRANSACTIONS
Select the option that best suits your query by entering the resource
details in the field provided for each option. Use % as a wildcard
character to specify a generic name.
Note: Only one option can be chosen.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
Start transaction....
Used by tran.........
Use program..........
Used by program......
Use TDQ..............
Use TSQ..............
Use map..............
Use file (ddname)....
In region............
DTP to transaction...
In application.......
____
(eg. TRN1 or TRN%)
____
________
________
________
Detailed TDQ output? N
________
Detailed TSQ output? N
________
ottocmd_
Detailed file output? y
____
____
___
(enter ? for a list of application codes)
PF1=Help PF3=End PF4=Exit
50
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Transactions/ File Relationships
CICS IA V1.1
For your query
HOME
SYSID
T530
T620
FILE
OTTOCMD
OTTOCMD
CICS Interdependency Analyzer for z/OS and OS/390
WHICH TRANS USE FILE OTTOCMD
USED BY
TRAN
OTTO
OTTO
FUNCTION
HOME
SYSID
FILE
USED BY
TRAN
FUNCTION
READ
READ
No more details to display
PF3=End PF4=Exit PF7=Up PF8=Down
51
CIUM100
Page
1 of
1
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
CICS IA V1.1
Resource
Menu Select
Transactions
CICS Interdependency Analyzer for z/OS and OS/390
Select the resource type to query:
CIUM000
1
1. Transactions
2. Programs
3. TSQs
4. TDQs
5. Maps
6. Files
7. Applications
8. Regions
OR display all resources in application ___
Enter the application's 3 character code or
? for a list of applications available.
WARNING : Option 7 may take a long time.
5655-G76 (C) Copyright IBM Corp. 2001
PF1=Help PF3=Exit
52
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Transactions in Region T530?
CICS IA V1.1
Query
CICS Interdependency Analyzer for z/OS and OS/390
CIUM100
TRANSACTIONS
Select the option that best suits your query by entering the resource
details in the field provided for each option. Use % as a wildcard
character to specify a generic name.
Note: Only one option can be chosen.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
Start transaction....
Used by tran.........
Use program..........
Used by program......
Use TDQ..............
Use TSQ..............
Use map..............
Use file (ddname)....
In region............
DTP to transaction...
In application.......
____
(eg. TRN1 or
____
________
________
________
Detailed
________
Detailed
________
________
Detailed
T530
____
___
(enter ? for
TRN%)
TDQ output?
TSQ output?
file output?
N
N
N
a list of application codes)
PF1=Help PF3=End PF4=Exit
53
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Transactions/ Region Relationship
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
For your query
HOME
SYSID
T530
WHICH TRANS ARE IN REGION T530
TRAN
EQAC
EQRH
EQSI
EQSS
OTTO
VA10
VA11
VA20
VA30
VA40
VA41
VA42
VA48
V200
V220
No more details to display
PF3=End PF4=Exit PF7=Up PF8=Down
54
CIUM100
HOME
SYSID
T530
TRAN
V400
V550
V800
V884
V895
V897
Page
1 of
1
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Select Applications
CICS IA V1.1
CICS Interdependency Analyzer for z/OS and OS/390
Select the resource type to query:
1.
2.
3.
4.
5.
6.
7.
8.
CIUM000
7
Transactions
Programs
TSQs
TDQs
Maps
Files
Applications
Regions
OR display all resources in application
Enter the application's 3 character code or
? for a list of applications available.
WARNING : Option 7 may take a long time.
PF1=Help PF3=Exit
55
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Applications in Region T530?
CICS IA V1.1
Query
CICS Interdependency Analyzer for z/OS and OS/390
CIUM030
APPLICATIONS
Select the option that best suits your query by entering the resource
details in the field provided for each option. Use % as a wildcard character
to specify a generic name.
Note: Only one option can be chosen.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
Start transaction....
Used by tran.........
Use program..........
Used by program......
Use TDQ..............
Use TSQ..............
Use map..............
Use file (ddname)....
In region............
DTP to transaction...
(eg. TRN1 or TRN%)
T530
PF1=Help PF3=End PF4=Exit
56
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Applications/ Region Relationships
CICS IA V1.1
For your query
CICS Interdependency Analyzer for z/OS and OS/390
CIUM200
WHICH APPLICATIONS ARE IN REGION T530
Application Name
CallCoordinator/CICS
Callpath/CICS
OTTO for CICS
No more details to display
PF3=End PF4=Exit PF7=Up PF8=Down
57
Page
1 of
1
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Files in Application CAM?
CICS IA V1.1
Query
CICS Interdependency Analyzer for z/OS and OS/390
CIUM020
FILES
Select the option that best suits your query by entering the resource
details in the field provided for each option. Use % as a wildcard character
to select a generic name.
Note: Only one option can be chosen.
2. Used by tran.........
4. Used by program......
9. In region............
11. In application.......
cam
(enter ? for a list of application codes)
PF1=Help PF3=End PF4=Exit
58
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Resource Menu - Files/ Application Relationships
CICS IA V1.1
For your query
HOME
SYSID
T530
CICS Interdependency Analyzer for z/OS and OS/390
WHICH FILES ARE IN CallCoordinator/CICS
FILE
HOME
SYSID
FILE
CAMAAMRT
CAMAAMRV
CAMABPNT
CAMADNST
CAMAGRSV
CAMAISTT
CAMALBFT
CAMAPLTT
CAMASPFT
CAMASWIT
CAMASWIV
CAMATRKT
No more details to display
PF3=End PF4=Exit PF7=Up PF8=Down
59
CIUM100
Page
1 of
1
CICS IA |
Here various options can be chosen to show which transactions use a certain file or map etc.
If we enter CORD in option 9 (In region) we get the following report presented in the next foil...
© 2002 IBM Corporation
IBM Software Group |
Product Comparison - CICS IA and WSAA
CICS IA
WSAA
CICS
Multiplatforms
3270/Reports
Browser Interface
Looks at data in runtime
Looks at source
Collects data over a period of time
Improved application maintenance
Static (misinformation can occur)
Improved reuse of applications
CICS IA and WSAA complement each other to provide a
complete and accurate picture of CICS applications
60
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
CICS IA Summary
Helps understand resource usage and relationships in the
CICS applications to assist in
making an informed decision on the best way to split workload
and move applications across CICS regions
fully exploiting the benefits of Workload Balancing across CICSPlex
and Sysplex
improving your ability to maintain, enhance, and migrate your
business applications
Easy to use
interface, familiar to any CICS customer
Cross-System
Transactions, Programs, Applications
Optimised for run-time use
Commitment to future product enhancements
Affordability
61
CICS IA |
© 2002 IBM Corporation
CICS IA automates the collection of CICS resource interdependency data to help customers identify resource
interdependencies within their CICS system. System managers can gain access — either online or off-line — to the
collected data stored in an IBM DB2® Universal Database™. That enables them to better maintain the integrity of the
CICS system, enhance the performance of their business applications and reuse applications as ebusiness when
migrating to the latest versions of CICS TS. Information provided by CICS IA can help you to split one or many CICS
address spaces in response to increased business workload, or even answer simple questions about your CICS
system, like what programs are running in a known address space.
The interdependency analysis provided by CICS IA gives system programmers and managers necessary knowledge to
- analyze business applications targeted for workload management and fully exploit the benefits of Workload Balancing
across CICSPlex and Sysplex
- understand resource usage and relationships in the CICS applications (especially following a merger or acquisition) to
effectively manage increased business workload and build more flexible systems in the future
- reuse existing applications as e-business applications more efficiently
IBM Software Group |
Appendix
Useful Information on CICS
62
CICS IA |
© 2002 IBM Corporation
IBM Software Group |
Useful information
CICS Web site
CICS Product Web Page: Contains product information including highlights and benefits,
announcements, services, supportpacs, publications for CICS TS 2.2
http://ibm.com/cics
Customer Forums
IBM Talklink:
http://www.ibmlink.ibm.com/talklink/
CICS-L Forum:.
<[email protected]>
AD Tools
Bibliography:
CICS Interdependency Analyzer for OS/390 and
z/OS User's Guide and Reference, SC34-6080
DB2 Application Programming and SQL Guide
SC26–4377
DB2 Administration Guide SC26–4374
File Manager, Fault Analyzer, Debug Tool, and TPNS
SCLM, SCLM Suite, WebSphere asset Analyzer
http://www.ibm.com/software/ad
DB2 & IMS Tools
http://www.ibm.com/software/data/db2imstools/
63
CICS IA |
© 2002 IBM Corporation