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
- PURGE MESSAGE, RECEIVE MAP, RECEIVE PARTN, ROUTE, SEND CONTROL, SEND MAP, SEND PAGE, SEND PARTNSET, SEND TEXT
- COUNTER
- BIF DEEDIT, BIF DIGEST, 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 SESSION, ALLOCATE SYSID, CONNECT PROCESS, CONVERSE CONVID, CONVERSE SESSION, FREE, RECEIVE CONVID, RECEIVE SESSION,SEND CONVID, SEND SESSION
- FC
- DELETE, ENDBR, READ, READNEXT, READPREV, RESETBR, REWRITE, STARTBR, UNLOCK, WRITE
- FEPI
- All the FEPI API commands listed in Dependency-related CICS FEPI API commands detected by the CICS Interdependency Analyzer
- HANDLE
- HANDLE ABEND PROGRAM
- IBRFA
- INQUIRE BRFACILITY, SET BRFACILITY
- ICORB
- CREATE CORBASERVER, DISCARD CORBASERVER, INQUIRE CORBASERVER, PERFORM CORBASERVER, SET CORBASERVER
- IDB2
- CREATE DB2ENTRY, CREATE DB2TRAN, DISCARD DB2ENTRY, DISCARD DB2TRAN, INQUIRE DB2ENTRY, INQUIRE DB2TRAN, SET DB2ENTRY, SET DB2TRAN
- IDJAR
- CREATE DJAR, DISCARD DJAR, INQUIRE DJAR, INQUIRE JVMPROFILE, PERFORM DJAR
- IFEPI
- All the FEPI SPI commands listed in Dependency-related CICS FEPI SPI commands detected by the CICS Interdependency Analyzer
- IJRNL
- DISCARD JOURNALNAME, DISCARD JOURNALNUM, INQUIRE JOURNALNAME, INQUIRE JOURNALNUM, SET JOURNALNAME, SET JOURNALNUM
- ISFC
- CREATE FILE, DISCARD FILE, INQUIRE FILE, SET FILE
- ISPC
- CREATE PROGRAM, DISCARD PROGRAM, INQUIRE PROGRAM, SET PROGRAM
- ISTD
- CREATE TDQUEUE, INQUIRE TDQUEUE, SET TDQUEUE
- ISTR
- CREATE TRANSACTION, DISCARD TRANSACTION, INQUIRE TRANSACTION, SET TRANSACTION
- ISTS
- CREATE TSMODEL, DISCARD TSMODEL, INQUIRE TSMODEL, INQUIRE TSPOOL, INQUIRE TSQNAME, INQUIRE TSQUEUE, SET TSQNAME, SET TSQUEUE
- ITCP
- CREATE TCPIPSERVICE, DISCARD TCPIPSERVICE, INQUIRE TCPIPSERVICE, SET TCPIPSERVICE
- JRNL
- WAIT JOURNALNAME, WAIT JOURNALNUM, WRITE JOURNALNAME, WRITE JOURNALNUM
- LINK
- GET64 CONTAINER, LINK, PUT64 CONTAINER
- LOAD
- LOAD, dynamic COBOL calls
- OTHER
- ADDRESS CWA, ASSIGN APPLID, CHANGE PASSWORD, CHANGE PHRASE, DUMP TRANSACTION, GETMAIN64, FREEMAIN64, SIGNAL EVENT, SIGNON, SIGNOFF, VERIFY PASSWORD, VERIFY PHRASE
- RETURN
- RETURN TRANSID
- START
- ASKTIME, CANCEL, DELAY, FORMATTIME, POST, RETRIEVE, START
- TC
- CHANGE TASK, DEQ, ENQ, SUSPEND, WAIT EVENT
- TD
- DELETEQ TD, READQ TD, WRITEQ TD
- TS
- DELETEQ TS, READQ TS, WRITEQ TS
- WEB
- CONVERTTIME, 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.