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:
  1. 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.
  2. 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.