Transaction resource class data

Product-sensitive programming interface

Transaction resource records are produced at termination of the transaction for which the data is being collected. These records are variable length, depending on the number of resources for which data is being collected (for example, one transaction might access only 1 file, another 5 files and 2 temporary storage queues, and so on). For only one file, the record length is 188 bytes plus 96 bytes for the file data (284 bytes). Each additional file adds another 96 bytes. The maximum number of files for which you can collect transaction resource data is 64. For only one temporary storage queue, the record length is 188 bytes plus 96 bytes for the temporary storage queue data (284 bytes). Each additional temporary storage queue adds another 96 bytes. The maximum number of temporary storage queues for which you can collect transaction resource data is 64.

Start of changeTransaction resource class data for a file or temporary storage queue is collected and recorded only for local resources, not for remote resources. When an application accesses a remote file or temporary storage queue, a transaction resource record is produced in the CICS region where the resource is defined locally, but no record is produced in the application-owning region.End of change

The format of transaction resource records is shown by the DFHMNRDS copybook in Figure 12.

Figure 12. CICS transaction resource monitoring record DSECT
DFHMNRDS DSECT  ,                      Transaction resource monitoring record
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'02'               DSECT version mask       
MNR_DSECT_VERS DS  CL1                 DSECT version number     
               DS  CL3                 Reserved                 
*                                                               
MNR_HEADER     DS  0XL32               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_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                        
Start of changeMNR_ID_ACMETH_BTAM      EQU X'02'          BTAM (no longer supported)End of change 
MNR_ID_ACMETH_BSAM      EQU X'03'          BSAM                        
Start of changeMNR_ID_ACMETH_TCAM      EQU X'04'          TCAM/DCB (supported for remote 
                                           terminals only)End of change
Start of changeMNR_ID_ACMETH_TCAMSNA   EQU X'05'          TCAM/ACB (no longer supported)End of change
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 
               DS  XL3                 Reserved                        
               DS  XL8                 Reserved                        
               DS  XL8                 Reserved                        
               DS  XL8                 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                 Flie 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              
               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_LEN EQU *-MNR_TSQUEUE_ENTRY TSQueue entry data length          
End of Product-sensitive programming interface

Transaction resource monitoring data field descriptions

For information about transaction file accesses in performance class monitoring data, see Performance data in group DFHFILE.

Header fields

This section describes the transaction header fields in a transaction monitoring resource record.

Product-sensitive programming interface
MNR_ID_TRANID (TYPE-C, 4 BYTES)
Transaction identifier.
MNR_ID_TERMID (TYPE-C, 4 BYTES)
Terminal identifier. This field is null if the task is not associated with a terminal or session.
Start of changeMNR_ID_USERID (TYPE-C, 8 BYTES)End of change
User identification at task creation. This can also be the remote user identifier for a task created as the result of receiving an ATTACH request across an MRO or APPC link with attach-time security enabled.
MNR_ID_SYTPE (TYPE-C, 4 BYTES)
Transaction start type. The high-order byte (0 and 1) can have one of the following values:
"TO"
Attached from terminal input
"S "
Attached by automatic transaction initiation (ATI) without data
"SD"
Attached by automatic transaction initiation (ATI) with data
"QD"
Attached by transient data trigger level
"U "
Attached by user request
"TP"
Attached from terminal TCTTE transaction ID
"SZ"
Attached by Front End Programming Interface (FEPI).
MNR_ID_START (TYPE-T, 8 BYTES)
Start time of the transaction.
MNR_ID_STOP (TYPE-T, 8 BYTES)
Stop time of the transaction.
MNR_ID_TASKNO (TYPE-A, 4 BYTES)
The transaction identification number (the task number allocated to the transaction at task attach).
MNR_ID_LUNAME (TYPE-C, 8 BYTES)
VTAM® logical unit name (if available) of the terminal associated with this transaction. If the task is executing in an application-owning or file-owning region, the LUNAME is the generic applid of the originating connection for MRO, LUTYPE6.1, and LUTYPE6.2 (APPC). The LUNAME is blank if the originating connection is an external CICS® interface (EXCI).
MNR_ID_PGMNAME (TYPE-C, 8 BYTES)
The name of the first program invoked at attach-time. For more information, see field 071 (PGMNAME) in performance data group, DFHPROG.
MNR_ID_UOW_PX (TYPE-C, 20 BYTES)
This field contains the same information as the performance class data field NETUOWPX (see NETUOWPX, in group DFHTASK for details).
MNR_ID_UOW_SX (TYPE-C, 8 BYTES)
This field contains the same information as the performance class data field NETUOWSX (see NETUOWSX, in group DFHTASK for details).
MNR_ID_TRN_FLAGS (TYPE-A, 8 BYTES)
Transaction flags, a string of 64 bits used for signaling transaction definition and status information. For details, see field 164 (TRANFLAG) in performance data group, DFHTASK.
MNR_ID_RSYSID (TYPE-C, 4 BYTES)
The name (system ID) of the remote system to which this transaction was routed, either statically or dynamically. For more information, see field 130 (RSYSID) in performance data group, DFHCICS.
MNR_ID_FCTYNAME (TYPE-C, 4 BYTES)
Transaction facility name. This field is null if the transaction is not associated with a facility. You can identify the transaction facility type (if any) using byte 0 of the transaction flags (MNR_ID_TRN_FLAGS) field. For details, see field 163 (FCTYNAME) in performance data group DFHTASK.
MNR_ID_RTYPE (TYPE-C, 4 BYTES)
Transaction resource monitoring record type (low-order byte-3). Currently this can have only one value, T, indicating a record output for task termination. For more information about record types, see field 112 (RTYPE) in performance data group, DFHCICS.
TERMINFO (TYPE-A, 4 BYTES)
Terminal or session information for the task principal facility. For more information about terminal information, see field 165 (TERMINFO) in performance data group, DFHTERM.
MNR_ID_TERMCNNM (TYPE-C, 4 BYTES)
Terminal session connection name. If the terminal facility associated with this transaction is a session, this field is the name of the owning connection (system ID). For more information, see field 169 (TERMCNNM) in performance data group DFHTERM.
MNR_ID_RES_FLAGS (TYPE-A, 4 BYTES)
Resource flags, a string of 32 bits used for signaling resource status information.
Byte 0
Resource status information:
Bit 0
Maximum number of files to be monitored (defined in the MCT) has been exceeded by the transaction (X'80')
Start of changeBit 1End of change
Start of changeMaximum number of temporary storage queues to be monitored (defined in the MCT) has been exceeded by the transaction (X'40')End of change
Bits 2-7
Reserved.
Bytes 1-3
Reserved.
End of Product-sensitive programming interface

File entry fields

This section describes the fields in each file entry in a transaction resource monitoring record.

Product-sensitive programming interface
MNR_FILE_NAME (TYPE-C, 8 BYTES)
The CICS 8-character name of the file to which the following data fields refer.
MNR_FILE_GET (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of GET requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of GET requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_PUT (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of PUT requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of PUT requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_BRWSE (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of BROWSE requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of BROWSE requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_ADD (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of ADD requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of ADD requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_DEL (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of DELETE requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of DELETE requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_TOTAL (TYPE-S, 8 BYTES)
The total elapsed time that the user task waited for completion of all requests issued by the user task for this file. The count part of this field (the low order 24 bits) contains the number of all requests issued against the file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_FILE_AM_RQ (TYPE-A, 4 BYTES)
Number of times the user task invoked file access-method interfaces. See also field FCAMCT in group DFHFILE.
MNR_FILE_IO_WT (TYPE-S, 8 BYTES)
The total I/O wait time on this file.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_RLS_FILE_IO_WT (TYPE-S, 8 BYTES)
Elapsed time in which the user task waited for RLS file I/O on this file. For more information, see Clocks and time stamps, and Wait (suspend) times.
MNR_CFDT_IO_WT (TYPE-S, 8 BYTES)
Elapsed time in which the user task waited for a data table access request to the coupling facility data table server to complete for this file. For more information, see Clocks and time stamps, and Wait (suspend) times.
End of Product-sensitive programming interface

Temporary storage queue entry fields

This section describes the fields in each temporary storage queue entry in a transaction resource monitoring record.

For information about transaction temporary storage queue accesses in performance class monitoring data, see Performance data in group DFHTEMP.

Product-sensitive programming interface
MNR_TSQUEUE_NAME (TYPE-C, 16 BYTES)
The CICS 16-character name of the temporary storage queue to which the following data fields refer.
MNR_TSQUEUE_GET (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of GET requests issued by the user task for this temporary storage queue. The count part of this field (the low order 24 bits) contains the number of GET requests issued against the temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_TSQUEUE_PUT_AUX (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of PUT requests to auxiliary temporary storage, issued by the user task for this temporary storage queue. The count part of this field (the low order 24 bits) contains the number of PUT requests to auxiliary temporary storage issued against the temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_TSQUEUE_PUT_MAIN (TYPE-S, 8 BYTES)
The elapsed time that the user task waited for completion of PUT requests to main temporary storage, issued by the user task for this temporary storage queue. The count part of this field (the low order 24 bits) contains the number of PUT requests to main temporary storage issued against the temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_TSQUEUE_TOTAL (TYPE-S, 8 BYTES)
The total elapsed time that the user task waited for completion of all requests issued by the user task for this temporary storage queue. The count part of this field (the low order 24 bits) contains the number of all requests issued against the temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_TSQUEUE_GET_ITEML (TYPE-S, 4 BYTES)
The total length of all items obtained from this temporary storage queue.
MNR_TSQUEUE_PUT_AUX_ITEML (TYPE-S, 4 BYTES)
The total length of all items written to the auxiliary temporary storage queue.
MNR_TSQUEUE_PUT_MAIN_ITEML (TYPE-S, 4 BYTES)
The total length of all items written to the main temporary storage queue.
MNR_TSQUEUE_IO_WT (TYPE-S, 8 BYTES)
The total I/O wait time on this temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

MNR_SHR_TSQUEUE_IO_WT (TYPE-S, 8 BYTES)
The total I/O wait time on the shared temporary storage queue.

For more information, see Clocks and time stamps, and Wait (suspend) times.

End of Product-sensitive programming interface
[[ Contents Previous Page | Next Page Index ]]