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.

Example CICS report from the Dependency Reporter—header page shows an example header page and Example CICS report from the Dependency Reporter—main body 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 2023/12/18


 2023/12/18 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 610  -  Page:   1
 --LIST OF CICS COMMAND GROUPS--

 Command Type       Reporting
 -------------      ---------
                               ❶        
   START               Yes     ❷
   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
   ASYNC               Yes

❶ 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.
❷ 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


 2023/12/18 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 610  -  Page:   2
                     CICS RESOURCES REPORT FOR APPLID: C62C1C01

Tran  Program  Offset    Command              Resource                                           SysId  RmtName
 --------------------------------------------------------------------------------------------------------------------
                 PrgLen            Usage  First Run             Last Run                Term    TCBmode
 --------------------------------------------------------------------------------------------------------------------
AFF9  AFFTEST9 000007DC  ADDRESS CWA          CWA                                                ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000830  ENQ RESOURCE         PROGPTR1                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000872  LOAD PROGRAM HOLD    AFFTEST1                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 000008CE  SEND TEXT            SEND TEXT                                          ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       QR

                 00000910  DEQ RESOURCE         PROGPTR1                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000958  ENQ RESOURCE         PROGPTR2                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 0000099A  LOAD PROGRAM HOLD    AFFTEST2                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 000009F0  SEND TEXT            SEND TEXT                                          ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       QR

                 00000A32  DEQ RESOURCE         PROGPTR2                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000A74  LOAD PROGRAM HOLD    AFFTEST3                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000AB6  LOAD PROGRAM HOLD    AFFTEST4                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000B6C  LOAD PROGRAM         AFFTEST5                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000BAE  LOAD PROGRAM         AFFTEST6                                           ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     Y       L8

                 00000BFE  SEND TEXT            SEND TEXT                                          ----   --------
                 00001B28              1  2023-12-16 22.38.54   2023-12-16 22.38.54     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

Term

Whether or not the transaction was associated with a terminal.

TCBmode

The CICS® TCB mode at the time the command was executed.