CICS report
A CICS® report consists of a header page and, if the dependency data file contains interdependency records, one or more pages of interdependency records.
Figure 1 shows an example header page
and Figure 2 an example page of interdependency
records.
Figure 1. Example CICS report
from the Dependency Reporter—header
page
Generated by CICS Transaction Inter-dependency Utility on 2011/01/04
2011/01/04 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 320 - Page: 1
--LIST OF CICS COMMAND GROUPS--
Command Type Reporting
------------- ---------
1
START Yes 2
XCTL Yes
LOAD Yes
LINK Yes
RETURN Yes
HANDLE Yes
TC Yes
FC Yes
BMS Yes
TS Yes
TD Yes
JRNL Yes
DTP Yes
COUNTER Yes
FEPI Yes
WEB Yes
OTHER Yes
ISPC Yes
ISFC Yes
ISTR Yes
ISTS Yes
ISTD Yes
IDB2 Yes
IDJAR Yes
IBRFA Yes
ICORB Yes
ITCP Yes
IFEPI Yes
IJRNL Yes
- 1 Incorrect command types
- On an interdependency report that includes CICS commands (that is, where the REPTYPE statement is specified as "CICS" or "ALL"), this area lists any CICS command groups that were specified incorrectly on the CMDGRPS DD statement.
- 2 Command types reported
- On an interdependency report that includes CICS commands, this list shows all the command types that are to be reported. Command groups selected on the CMDGRPS DD statement are marked Yes, and those not selected No.
Figure 2. Example CICS report from the Dependency Reporter—main
body
2011/01/27 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 320 - Page: 2
CICS RESOURCES REPORT FOR APPLID: IYCYZC3C
Tran Program Offset Command Resource
------------------------------------------------------------------------------------------
Sysid Usage First Run Last Run Term TCBmode
------------------------------------------------------------------------------------------
D8CS DSN8CC0 000009EA RECEIVE MAP DSN8CCD
---- 16 2011-01-27 09.34.34 2011-01-27 09.35.06 Y QR
00000B24 RECEIVE MAP DSN8CCG
---- 27 2011-01-27 09.34.34 2011-01-27 09.35.29 Y QR
00000D62 LINK PROGRAM DSN8CC1
---- 51 2011-01-27 09.34.34 2011-01-27 09.36.09 Y QR
00001020 SEND MAP DSN8CCG
---- 27 2011-01-27 09.34.34 2011-01-27 09.35.24 Y QR
0000106A RETURN TRANSID D8CS
---- 27 2011-01-27 09.34.34 2011-01-27 09.35.24 Y QR
The report lists all the CICS commands
that were collected by the Collector and
(because this is a CICS dependency
report) selected in the CMDGRPS DD statement of the CIUJCLRP job.
The report entries contain the following information:
- Tran
- The identifier of the CICS transaction under which the command was issued.
- Program
- The name of the program that issued the command.
- Offset
- The offset, from the load point of the program, of
the BALR instruction of the command detected. The Dependency Reporter produces
an offset of -1 (X'FFFFFFFF') if it could not determine an
offset; that is, if either of the following is true:
- The program was defined with RELOAD(YES).
- The offset calculated is not within the program, which might indicate that the program or perhaps language runtime code has passed control to another program by using a non-CICS mechanism, for example, a VS COBOL II dynamic call.
Note:- This offset is not the same as the offset given by the Load Module Scanner. For an EXEC CICS command, the offset given by the Load Module Scanner is the offset of the command argument 0 declaration from the start of the load module. See Correlating Load Module Scanner and Dependency Reporter output to source.
- An output of X'FFFFFFFF' indicates that individual commands cannot be directly located in a program. The program must be scanned for all instances of the command, because more than one instance might be present.
- Command
- The command that was detected.
- Resource
- The resource against which the command was issued, causing a dependency between it and the named program.
- Sysid
- If the command was shipped or routed to a remote CICS region, the system identifier of the remote region.
- Usage
- The number of times that this command, with the same CICS APPLID, SYSID, transaction, program, offset, resource, remote SYSID, remote name, command group, command function and program length has been detected.
- First Run
- The date and time at which this command, with the same CICS APPLID, SYSID, transaction, program, offset, resource, remote SYSID, remote name, command group, command function and program length, was first detected. Times are shown in local time.
- Last Run
- The date and time at which this command, with the same CICS APPLID, SYSID, transaction, program, offset, resource, remote SYSID, remote name, command group, command function and program length, was first detected.Times are shown in local time.
- Term
- Whether or not the transaction was associated with a terminal.
- TCBmode
- The CICS TCB mode at the time the command was executed.