Identity class data sections

Each identity class data section is made up of one or more identity class data records. Identity class data records are produced during transaction detach processing for each transaction that has identity propagation data.

Identity data is constructed using fields that are written only if the data is available, in a similar way to those fields used in the RACF® SMF records. Unlike other monitoring SMF 110 records, these records are not compressed. The identity records are buffered (one or more identity records are constructed into a single SMF 110 record) to minimize the number of SMF writes. Any unwritten identity data records remaining in the output buffer are recorded either when the monitoring identity class is set to inactive or when CICS® shuts down normally.

The format of the identity class monitoring records is shown in Figure 1.

Figure 1. Format of the identity class 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 identity data section. The middle rectangle is an expansion of the identity class data section in the top rectangle. It consists of a number of identity data records, numbered 1 to n. The bottom rectangle is an expansion of one of the identity records in the middle rectangle. It consists of a number of data fields, marked 'Data Entry 1' to 'Data Entry n'.
You can map the identity class data section using the DFHMNIDS copybook, details of which are shown in Figure 2.
DFHMNIDS DSECT  ,                      Monitoring Identity Record       
*                                                                       
         DS    0F                      Fullword allignment              
MNI_LENGTH     DS  H                   Length of identity data          
MNI_ID_EQUATE  EQU 51                  Monitoring domain id mask        
MNI_ID         DC  AL2(MNI_ID_EQUATE)  Monitoring domain id             
MNI_VERSION    EQU X'01'               DSECT version mask               
MNI_DSECT_VERS DS  CL1                 DSECT version number             
               DS  CL3                 Reserved                         
*                                                                       
MNI_HEADER     DS  0XL32               Header Data                      
MNI_HDRLEN     DS  H                   Length of header data            
               DS  XL2                 Reserved                         
               DS  XL8                 Reserved                         
MNI_TRN        DS  H                   Number of record triplets        
               DS  XL2                 Reserved                         
MNI_ISO        DS  XL4                 Offset to ID data                
MNI_ISL        DS  XL2                 Length of ID entry               
MNI_ISN        DS  XL2                 Number of ID entries             
MNI_DSO        DS  XL4                 Offset to Data entry             
MNI_DSL        DS  XL2                 Length of Data entry             
MNI_DSN        DS  XL2                 Number of Data entries           
MNI_HDR_LENGTH EQU *-MNI_HEADER        Header data length               
         SPACE ,                                                        
MNI_ID_DATA    DSECT                   Identification Data Entry        
MNI_ID_TRANID  DS  CL4                 Transaction id                   
MNI_ID_TERMID  DS  CL4                 Terminal id                      
MNI_ID_USERID  DS  CL8                 User id                          
MNI_ID_STYPE   DS  CL4                 Transaction Start type           
MNI_ID_START   DS  XL8                 Transaction Start time           
MNI_ID_STOP    DS  XL8                 Transaction Stop time            
MNI_ID_TASKNO  DS  XL4                 Transaction Sequence Number      
MNI_ID_LUNAME  DS  CL8                 VTAM Luname                      
MNI_ID_PGMNAME DS  CL8                 First program name               
MNI_ID_UOW_PX  DS  XL20                Network Unit-of-Work Prefix      
MNI_ID_UOW_SX  DS  XL8                 Network Unit-of-Work Suffix      
MNI_ID_RSYSID  DS  CL4                 Remote sysid routed to           
MNI_ID_TRN_FLAGS DS  XL8               Transaction flags                
MNI_ID_FCTYNAME  DS  CL4               Transaction Facility name        
MNI_ID_RTYPE     DS  CL4               Resource Record Type             
MNI_ID_TERMINFO  DS  0XL4              Terminal Information             
MNI_ID_NATURE    DS  XL1               Nature                           
MNI_ID_NATURE_NOTAPPLIC EQU X'00'          Not applic                   
MNI_ID_NATURE_TERMINAL  EQU X'01'          Terminal                     
MNI_ID_NATURE_SESSION   EQU X'02'          Session                      
MNI_ID_SESSTYPE  DS  XL1               Session Type                     
MNI_ID_SESSTYPE_NOTAPPLIC EQU X'00'        Not applic                   
MNI_ID_SESSTYPE_IRC       EQU X'01'        IRC                          
MNI_ID_SESSTYPE_IRC_XM    EQU X'02'        IRC XM                       
MNI_ID_SESSTYPE_IRC_XCF   EQU X'03'        IRC XCF                      
MNI_ID_SESSTYPE_LU61      EQU X'04'        LU61                         
MNI_ID_SESSTYPE_LU62_SING EQU X'05'        LU62 SINGLE                  
MNI_ID_SESSTYPE_LU62_PARA EQU X'06'        LU62 PARALLEL                
MNI_ID_ACMETH    DS  XL1               Access method                    
MNI_ID_ACMETH_NOTAPPLIC EQU X'00'          Not applic                   
MNI_ID_ACMETH_VTAM      EQU X'01'          VTAM                         
MNI_ID_ACMETH_BSAM      EQU X'03'          BSAM                         
MNI_ID_ACMETH_TCAM      EQU X'04'          TCAM                         
MNI_ID_ACMETH_BGAM      EQU X'06'          BGAM                         
MNI_ID_ACMETH_CONSOLE   EQU X'07'          CONSOLE                      
MNI_ID_DEVCODE   DS  XL1               Device type code                 
*                                          See TYPETERM RDO attribute   
MNI_ID_TERMCNNM  DS  CL4               Terminal Connection name         
               DS  XL4                 Reserved                         
MNI_ID_ISIPICNM DS XL8                 IPCONN name                      
               DS  XL8                 Reserved                         
               DS  XL8                 Reserved    
Figure 2. CICS identity class monitoring record DSECT
MNI_ID_CLIPADDR         DS CL40        Client IP Address                
MNI_ID_ORIGIN_NETWKID   DS CL8         Originating networkid            
MNI_ID_ORIGIN_APPLID    DS CL8         Originating applid               
MNI_ID_ORIGIN_ATT_TIME  DS CL8         Originating task start time      
MNI_ID_ORIGIN_TRANNUM   DS CL4         Originating tran seq no          
MNI_ID_ORIGIN_TRANID    DS CL4         Originating tran id              
MNI_ID_ORIGIN_USERID    DS CL8         Originating userid               
MNI_ID_ORIGIN_USER_CORR DS CL64        Originating user data            
MNI_ID_ORIGIN_TCPIPSERV DS CL8         Originating TCPIPSERVICE         
MNI_ID_ORIGIN_PORTNUM   DS XL4         Originating portnumber           
MNI_ID_ORIGIN_CLIPADDR  DS CL40        Originating Client IPaddress     
MNI_ID_ORIGIN_CLIPPORT  DS XL4         Originating Client portnum       
MNI_ID_ORIGIN_TRANFLAG  DS XL8         Originating transaction flags    
MNI_ID_ORIGIN_FCTYNAME  DS CL8         Originating facility name
                        DS CL8         Reserved
MNI_PHD_NETWKID         DS CL8         Previous Hop data networkid
MNI_PHD_APPLID          DS CL8         Previous Hop data applid
MNI_PHD_ATTACH_TIME     DS CL8         Previous Hop data task start
MNI_PHD_TRANNUM         DS CL4         Previous Hop data tran seqno
MNI_PHD_TRANID          DS CL4         Previous Hop data tranid
MNI_PHD_COUNT           DS XL4         Previous Hop data count
                        DS CL4         Reserved
                        DS CL8         Reserved
MNI_PTD_ATTACH_TIME     DS CL8         Previous Tran task start
MNI_PTD_TRANNUM         DS CL4         Previous Tran tran seqno
MNI_PTD_TRANID          DS CL4         Previous Tran tranid
MNI_PTD_COUNT           DS XL4         Previous tran count
                        DS CL4         Reserved
                        DS CL8         Reserved
MNI_ID_LENGTH  EQU *-MNI_ID_DATA       Identification entry data length 
         SPACE ,                                                        
MNI_DATA_ENTRY     DSECT               Data Entry                       
MNI_ENTRY_IDENT    DS  XL2             Data entry ident                 
MNI_ENTRY_LENGTH   DS  XL2             Data entry length                
MNI_ENTRY_FIELD    DS  0C              Data entry field                  
Note: VTAM® is now z/OS® Communications Server.