Modifying a Dependency Reporter Job

Changes to make before running the CIUJCLRP job.

The JOB accounting parameters
Modify the JOB card statement to meet your site standards.
The STEPLIB DD statement
Specify the name of the CICS® IA load library in which you have installed the Dependency Reporter program, CIUREP.
The CIUINT1 DD statement
Specify the name of the CICS dependency data file for this region.
  • Each dependency data file has a header record that specifies the APPLID of the CICS region that created the record. The Dependency Reporter checks this APPLID with the APPLID recorded in the control record file, CIUCNTL, and only proceeds if they match.
  • If the dependency data files and the control record file are shared across multiple regions, they contain a header record for each of the monitored regions.
The CIUINT2 DD statement
Specify the name of the DB2® dependency data file for this region.
The CIUINT3 DD statement
Specify the name of the MQ dependency data file for this region.
The CIUINT4 DD statement
Specify the name of the IMS™ dependency data file for this region.
The CIUINT5 DD statement
Specify the name of the CICS "+32" dependency data file for this region. This CICS dependency file that records dependencies on CICS resources with names longer than 32 bytes.
The CIUCNTL DD statement
Specify the name of your CICS IA control VSAM file for this CICS region.
The APPLID DD statement
Specify this statement as follows:
APPLID
Specify the VTAM® application identifier (APPLID) of the CICS region for which you want dependency data to be reported. Dependency data is returned for the specified region only.
ALL
Returns data for all regions in the dependency data files.
blank
Causes data for all regions in the dependency data files to be returned.
REPTYPE
Specify the type of command, CICS, DB2, MQ, IMS, or all, that you want to be included in the report:
CICS
Only CICS commands are to be included.
DB2
Only DB2 commands are to be included.
MQ
Only MQ commands are to be included.
IMS
Only IMS commands are to be included.
ALL
All types of command are to be included.
blank
All types of command are to be included.
The CMDGRPS DD statement

Specify the CICS commands and command groups that are to be reported. Enter each one on a separate line.

The statement is effective only if you have specified, on the REPTYPE statement, that CICS (or all) commands are to be included in the report.

The command groups that can be specified map directly to those that can be selected on the Collector. If no command or group is given, all detected interdependencies are reported. If one or more commands or command groups is specified, only they are reported.

Here are the commands and command groups that you can specify, with the commands that are reported in each case:

BMS
SEND MAP, RECEIVE MAP
COUNTER
DEFINE COUNTER, DEFINE DCOUNTER, DELETE COUNTER, DELETE DCOUNTER, GET COUNTER, GET DCOUNTER, QUERY COUNTER, QUERY DCOUNTER, REWIND COUNTER, REWIND DCOUNTER, UPDATE COUNTER, UPDATE DCOUNTER
DTP
ALLOCATE SYSID, ALLOCATE SESSION, CONNECT PROCESS, SEND CONVID, SEND SESSION, CONVERSE CONVID, CONVERSE SESSION, FREE
FC
READ, WRITE, DELETE, STARTBR, READNEXT, READPREV, ENDBR, RESETBR, UNLOCK, REWRITE
FEPI
All the FEPI API commands listed in Start of changeDependency-related CICS FEPI API commands detected by the CICS Interdependency AnalyzerEnd of change
HANDLE
HANDLE ABEND PROGRAM
IBRFA
INQUIRE BRFACILITY, SET BRFACILITY
ICORB
CREATE CORBASERVER, INQUIRE CORBASERVER, SET CORBASERVER, PERFORM CORBASERVER, DISCARD CORBASERVER
IDB2
CREATE DB2ENTRY, CREATE DB2TRAN, INQUIRE DB2ENTRY, INQUIRE DB2TRAN, SET DB2ENTRY, SET DB2TRAN, DISCARD DB2ENTRY, DISCARD DB2TRAN
IDJAR
CREATE DJAR, INQUIRE DJAR, PERFORM DJAR, DISCARD DJAR, INQUIRE JVMPROFILE
IFEPI
All the FEPI SPI commands listed in Start of changeDependency-related CICS FEPI SPI commands detected by the CICS Interdependency AnalyzerEnd of change
IJRNL
INQUIRE JOURNALNAME, INQUIRE JOURNALNUM, SET JOURNALNAME, SET JOURNALNUM, DISCARD JOURNALNAME, DISCARD JOURNALNUM
ISFC
CREATE FILE, INQUIRE FILE, SET FILE, DISCARD FILE
ISPC
CREATE PROGRAM, INQUIRE PROGRAM, SET PROGRAM, DISCARD PROGRAM
ISTD
CREATE TDQUEUE, INQUIRE TDQUEUE, SET TDQUEUE
ISTR
CREATE TRANSACTION, INQUIRE TRANSACTION, SET TRANSACTION, DISCARD TRANSACTION
ISTS
CREATE TSMODEL, INQUIRE TSMODEL, DISCARD TSMODEL, INQUIRE TSPOOL, INQUIRE TSQUEUE, SET TSQUEUE, INQUIRE TSQNAME, SET TSQNAME
ITCP
CREATE TCPIPSERVICE, INQUIRE TCPIPSERVICE, SET TCPIPSERVICE, DISCARD TCPIPSERVICE
JRNL
WRITE JOURNALNUM, WRITE JOURNALNAME, WAIT JOURNALNUM, WAIT JOURNALNAME
LINK
LINK
LOAD
LOAD, dynamic COBOL calls
OTHER
ADDRESS CWA, ASSIGN APPLID
RETURN
RETURN TRANSID
START
START
TC
ENQ, DEQ
TD
READQ TD, WRITEQ TD, DELETEQ TD
TS
READQ TS, WRITEQ TS, DELETEQ TS
WEB
WEB ENDBROWSE FORMFIELD, WEB ENDBROWSE HTTPHEADER, WEB EXTRACT, WEB READ FORMFIELD, WEB READ HTTPHEADER, WEB READNEXT FORMFIELD, WEB READNEXT HTTPHEADER, WEB RECEIVE, WEB RETRIEVE, WEB SEND, WEB STARTBROWSE FORMFIELD, WEB STARTBROWSE HTTPHEADER, WEB WRITE HTTPHEADER
XCTL
XCTL
SYSPRINT DD statement
Specify the destination for the report produced by the Dependency Reporter.

The Reporter cannot read from a dependency data file while the Collector has the file open for update, so you cannot run the Reporter if the Collector is RUNNING or PAUSED.