Transaction resource data sections

Each transaction resource data section is made up of one or more transaction resource data records. Transaction resource data records are produced at the end of the transaction for which the data is being collected.

All the transaction resource data records produced by a single CICS® run have the same format, with a resource record header followed by a resource data section for each resource being monitored. The records are therefore of variable length, depending on the number of resources for which data is being collected. For example, one transaction might access only one file, but another transaction might access five files and two temporary storage queues.

Each distributed program link adds 32 bytes, each file resource adds 112 bytes, and each temporary storage queue adds a further 120 bytes to a record.

You can collect transaction resource data for up to a maximum of 64 distributed program links, 64 files, and 64 temporary storage queues. The DPL, FILE, and TSQUEUE parameters on the DFHMCT TYPE=INITIAL macro specify the maximum numbers of distributed program links, files, and temporary storage queues for which resource data can be collected for any one transaction. For example, if you specify FILE=10 in the DFHMCT TYPE=INITIAL macro, the file resource data section can have up to 1120 bytes of file resource data.

All the system-defined data fields in the transaction resource monitoring records are described in Transaction resource class data: Listing of data fields.

The format of the transaction resource monitoring records is shown in Figure 1.

Figure 1. Format of the resource monitoring data section
The picture shows three rectangles, one above the other. The top rectangle represents an SMF type 110 monitoring record. It consists of three sections: an SMF header, an SMF product section, and a transaction resource data section. The middle rectangle is an expansion of the transaction resource data section in the top rectangle. It consists of a number of transaction resource data records, numbered 1 to n. The bottom rectangle is an expansion of one of the transaction resource records in the middle rectangle. It consists of a number of data fields, marked 'Data for field 1' to 'Data for field n'.

You can map the transaction resource data section using the DFHMNRDS copybook, details of which are shown in Figure 2.

Figure 2. CICS transaction resource monitoring record DSECT (part 1)
DFHMNRDS DSECT  ,                      Monitoring Resource Record
*
         DS    0F                      Fullword allignment
MNR_LENGTH     DS  H                   Length of resource data
MNR_ID_EQUATE  EQU 79                  Monitoring domain id mask
MNR_ID         DC  AL2(MNR_ID_EQUATE)  Monitoring domain id
MNR_VERSION    EQU X'01'               DSECT version mask
MNR_DSECT_VERS DS  CL1                 DSECT version number
               DS  CL3                 Reserved
*
MNR_HEADER     DS  0XL48               Header Data
MNR_HDRLEN     DS  H                   Length of header data
               DS  XL2                 Reserved
               DS  XL8                 Reserved
MNR_TRN        DS  H                   Number of record triplets
               DS  XL2                 Reserved
MNR_ISO        DS  XL4                 Offset to ID data
MNR_ISL        DS  XL2                 Length of ID entry
MNR_ISN        DS  XL2                 Number of ID entries
MNR_FSO        DS  XL4                 Offset to File data
MNR_FSL        DS  XL2                 Length of File entry
MNR_FSN        DS  XL2                 Number of File entries
MNR_TSO        DS  XL4                 Offset to TSQueue data
MNR_TSL        DS  XL2                 Length of TSQueue entry
MNR_TSN        DS  XL2                 Number of TSQueue entries
MNR_DSO        DS  XL4                 Offset to DPL data
MNR_DSL        DS  XL2                 Length of DPL entry
MNR_DSN        DS  XL2                 Number of DPL entries
MNR_HDR_LENGTH EQU *-MNR_HEADER        Header data length
         SPACE ,
MNR_ID_DATA    DSECT                   Identification Data Entry
MNR_ID_TRANID  DS  CL4                 Transaction id
MNR_ID_TERMID  DS  CL4                 Terminal id
MNR_ID_USERID  DS  CL8                 User id
MNR_ID_STYPE   DS  CL4                 Transaction Start type
MNR_ID_START   DS  XL8                 Transaction Start time
MNR_ID_STOP    DS  XL8                 Transaction Stop time
MNR_ID_TASKNO  DS  XL4                 Transaction Sequence Number
MNR_ID_LUNAME  DS  CL8                 VTAM Luname
MNR_ID_PGMNAME DS  CL8                 First program name
MNR_ID_UOW_PX  DS  XL20                Network Unit-of-Work Prefix
MNR_ID_UOW_SX  DS  XL8                 Network Unit-of-Work Suffix
MNR_ID_RSYSID  DS  CL4                 Remote sysid routed to
MNR_ID_TRN_FLAGS DS  XL8               Transaction flags
MNR_ID_FCTYNAME  DS  CL4               Transaction Facility name
MNR_ID_RTYPE     DS  CL4               Resource Record Type
MNR_ID_TERMINFO  DS  0XL4              Terminal Information
MNR_ID_NATURE    DS  XL1               Nature
MNR_ID_NATURE_NOTAPPLIC EQU X'00'          Not applic
MNR_ID_NATURE_TERMINAL  EQU X'01'          Terminal
MNR_ID_NATURE_SESSION   EQU X'02'          Session
MNR_ID_SESSTYPE  DS  XL1               Session Type
MNR_ID_SESSTYPE_NOTAPPLIC EQU X'00'        Not applic
MNR_ID_SESSTYPE_IRC       EQU X'01'        IRC
MNR_ID_SESSTYPE_IRC_XM    EQU X'02'        IRC XM
MNR_ID_SESSTYPE_IRC_XCF   EQU X'03'        IRC XCF
MNR_ID_SESSTYPE_LU61      EQU X'04'        LU61
MNR_ID_SESSTYPE_LU62_SING EQU X'05'        LU62 SINGLE
MNR_ID_SESSTYPE_LU62_PARA EQU X'06'        LU62 PARALLEL
MNR_ID_ACMETH    DS  XL1               Access method
MNR_ID_ACMETH_NOTAPPLIC EQU X'00'          Not applic
MNR_ID_ACMETH_VTAM      EQU X'01'          VTAM
MNR_ID_ACMETH_BSAM      EQU X'03'          BSAM
Figure 3. CICS transaction resource monitoring record DSECT (part 2)
MNR_ID_ACMETH_TCAM      EQU X'04'          TCAM
MNR_ID_ACMETH_BGAM      EQU X'06'          BGAM
MNR_ID_ACMETH_CONSOLE   EQU X'07'          CONSOLE
MNR_ID_DEVCODE   DS  XL1               Device type code
*                                          See TYPETERM RDO attribute
MNR_ID_TERMCNNM  DS  CL4               Terminal Connection name
MNR_ID_RES_FLAGS DS  0XL4              Resource flags
MNR_ID_RES_FLAG1 DS  XL1               Resource flag 1
MNR_FILE_LIMIT_EXCEEDED    EQU X'80'   Resource File limit exceeded
MNR_TSQUEUE_LIMIT_EXCEEDED EQU X'40'   Resource TSQueue limit exceeded
MNR_DPL_LIMIT_EXCEEDED    EQU X'20'   Resource DPL limit exceeded
               DS  XL3                 Reserved
MNR_ID_ISIPICNM DS XL8                 IPCONN name
               DS  XL8                 Reserved
               DS  XL8                 Reserved
MNR_ID_CLIPADDR         DS CL40        Client IP Address
MNR_ID_ORIGIN_NETWKID   DS CL8         Originating networked
MNR_ID_ORIGIN_APPLID    DS CL8         Originating applid
MNR_ID_ORIGIN_ATT_TIME  DS CL8         Originating task start time
MNR_ID_ORIGIN_TRANNUM   DS CL4         Originating tran seq no
MNR_ID_ORIGIN_TRANID    DS CL4         Originating tran id
MNR_ID_ORIGIN_USERID    DS CL8         Originating userid
MNR_ID_ORIGIN_USER_CORR DS CL64        Originating user data
MNR_ID_ORIGIN_TCPIPSERV DS CL8         Originating TCPIPSERVICE
MNR_ID_ORIGIN_PORTNUM   DS XL4         Originating portnumber
MNR_ID_ORIGIN_CLIPADDR  DS CL40        Originating Client IPaddress
MNR_ID_ORIGIN_CLIPPORT  DS XL4         Originating client portnum
MNR_ID_ORIGIN_TRANFLAG  DS XL8         Originating tran flags
MNR_ID_ORIGIN_FCTYNAME  DS CL8         Originating facility name
                        DS CL8         Reserved
MNR_PHD_NETWKID         DS CL8         Previous Hop data networkid
MNR_PHD_APPLID          DS CL8         Previous Hop data applid
MNR_PHD_ATTACH_TIME     DS CL8         Previous Hop data task start
MNR_PHD_TRANNUM         DS CL4         Previous Hop data tran seqno
MNR_PHD_TRANID          DS CL4         Previous Hop data tranid
MNR_PHD_COUNT           DS XL4         Previous Hop data count
                        DS CL4         Reserved
MNR_ID_TRNGRPID         DS CL28        Transaction group ID
                        DS CL4         Reserved
                        DS CL8         Reserved
MNR_PTD_ATTACH TIME     DS CL8         Previous Tran data task start
MNR_PTD_TRANNUM         DS CL4         Previous Tran data tran seqno
MNR_PTD_TRANID          DS CL4         Previous Tran data tranid
MNR_PTD_COUNT           DS XL4         Previous Tran data count
                        DS CL4         Reserved
                        DS CL8         Reserved
MNR_ID_LENGTH  EQU *-MNR_ID_DATA       Identification entry data length
         SPACE ,
MNR_FILE_ENTRY DSECT                   File Entry
MNR_FILE_NAME  DS  CL8                 File name
MNR_FILE_GET   DS  XL8                 File Get time/count
MNR_FILE_PUT   DS  XL8                 File Put time/count
MNR_FILE_BRWSE DS  XL8                 File Browse time/count
MNR_FILE_ADD   DS  XL8                 File Add time/count
MNR_FILE_DEL   DS  XL8                 File Delete time/count
MNR_FILE_TOTAL DS  XL8                 File Total time/count
MNR_FILE_AM_RQ DS  XL4                 File Access Method request count
               DS  XL4                 Reserved
MNR_FILE_IO_WT DS  XL8                 File I/O wait time
MNR_RLS_FILE_IO_WT DS  XL8             RLS File I/O wait time
MNR_CFDT_IO_WT DS  XL8                 CFDT I/O wait time
MNR_FILE_XC_WT DS  XL8                 File exclusive wait
MNR_FILE_VS_WT DS  XL8                 File VSAM string wait
               DS  XL8                 Reserved
MNR_FILE_LEN   EQU *-MNR_FILE_ENTRY    File entry data length
         SPACE ,
MNR_TSQUEUE_ENTRY     DSECT            TSQueue Entry
MNR_TSQUEUE_NAME      DS  CL16         TSQueue Name
MNR_TSQUEUE_GET       DS  XL8          TSQueue Get time/count
MNR_TSQUEUE_PUT_AUX   DS  XL8          TSQueue Put Aux time/count
MNR_TSQUEUE_PUT_MAIN  DS  XL8          TSQueue Put Main time/count
MNR_TSQUEUE_TOTAL     DS  XL8          TSQueue Total time/count
                      DS  XL4          Reserved
MNR_TSQUEUE_GET_ITEML DS  XL4          TSQueue Get Item length
MNR_TSQUEUE_PUT_AUX_ITEML  DS XL4      TSQueue Put Aux Item length
MNR_TSQUEUE_PUT_MAIN_ITEML DS XL4      TSQueue Put Main Item length
                      DS  XL8          Reserved
MNR_TSQUEUE_IO_WT     DS  XL8          TSQueue I/O wait time
MNR_SHR_TSQUEUE_IO_WT DS  XL8          Shared TSQueue I/O wait time
                      DS  XL8          Reserved
MNR_TSQUEUE_GET_SHR   DS  XL8          TSQueue Get Shr time/ct
MNR_TSQUEUE_PUT_SHR   DS  XL8          TSQueue Put Shr time/ct
MNR_TSQUEUE_GET_SHR_ITEML   DS  XL4          TSQueue Get Shr Item len
MNR_TSQUEUE_PUT_SHR_ITEML   DS  XL4          TSQueue Put Shr Item len
MNR_TSQUEUE_LEN EQU *-MNR_TSQUEUE_ENTRY TSQueue entry data length
         SPACE ,
MNR_DPL_ENTRY         DSECT            DPL Entry
MNR_DPL_PROGRAM_NAME  DS  CL8          DPL Program name
MNR_DPL_SYSID         DS  CL4          DPL sysid
                      DS  XL4          Reserved
                      DS  XL8          Reserved
MNR_DPL_LINKS_REQS    DS  XL4          DPL LINK requests
                      DS  XL4          Reserved
MNR_DPL_LEN       EQU *-MNR_DPL_ENTRY  DPL entry data length
Note: VTAM® is now z/OS® Communications Server.


dfht3_trandata.html | Timestamp icon Last updated: Sunday, 4 June 2017