Standard recorder log record mapping
When the IMS Connect line trace facility is activated by the IMS Connect WTOR command nnRECORDER OPEN, the IMS Connect type-2 command UPDATE IMSCON TYPE(CONFIG) START(RECORDER), or the z/OS® modify command UPDATE MEMBER TYPE(IMSCON) START(TRACE), IMS Connect writes the log records to the HWSRCDR data set. If the trace facility is activated with a BPE data set, these records are written to the specified BPE data set instead.
The following examples provide mapping information to help you navigate and interpret the contents of the HWSRCDR data set, or an external BPE data set that contains the HWSUSTAT log records. The DSECT for this mapping is located in the HWSUSTAT macro of the IMS.SDFSMAC data set. The DSECT name is HWSUSTAT. When the trace level for an external data set is set to HIGH, the data set contains both standard log records (mapped by the HWSUSTAT DSECT) and extended log records (mapped by the HWSLRCTR DSECT).
This topic contains Diagnosis, Modification, and Tuning information.
**********************************************************************
* COMMON SECTION 32_BYTES
**********************************************************************
USTAT_NEXT DS F NEXT POINTER
USTAT_EYE DS CL4'ICON' EYECATCHER
USTAT_CALLID DS CL2 CALLER ID
* CHARS "AE" - ADAPTER MSG ERROR
* CHARS "AR" - ADAPTER MSG RECEIVE
* CHARS "AX" - ADAPTER MSG SEND
* CHARS "ER" - IMS TM MSG READ ERROR
* CHARS "ME" = MSC ERROR
* CHARS "MR" = MSC RECEIVE
* CHARS "MS" = MSC SEND
* CHARS "OE" - IMS DB MSG READ ERROR
* CHARS "OR" - IMS DB MSG RECEIVE
* CHARS "OX" - IMS DB MSG SEND
* CHARS "RC" - IMS TM MSG RECEIVE
* CHARS "RE" = OTMA REMOTE ALTPCB
* ERROR
* CHARS "RR" = OTMA REMOTE ALTPCB
* RECEIVE
* CHARS "RS" = OTMA ALTPCB IMS to IMS
* SEND
* CHARS "SN" - IMS TM MSG SEND
* CHARS "TO" = TIMEOUT EVENT
*
USTAT_SMFHDR DS 0C SMF HEADER
SMFITOCLEN DS CL2 SMF LENGTH
SMFITOCSEG DS CL2 INTERNAL WORK
SMFITOCFLG DS X INTERNAL FLAG
SMFITOCRTY DS X RECORD TYPE
SMFITOCTME DS CL4 TIME OF TRACE
SMFITOCDTE DS CL4 SEQUENCE NUMBER
SMFITOCSID DS CL4 RESERVED
DS CL4 RESERVED
**********************************************************************
* UOW PROGRESSION TIME STAMP SECTION
**********************************************************************
SMFITOCCID DS CL8 CLIENT NAME
USTAT_TSMREC DS D TIME HWSW MSG RECEIVED
USTAT_TSMNQ DS D TIME HWSW MSG ENQUEUED
USTAT_TDMDQ DS D TIME 1ST DST MSG DEQUEUED
USTAT_TCLRDQ DS D TIME DST CLR DENQUEUED
USTAT_TERROR DS D TIME ERROR OCCURRED
USTAT_NMSGX DS H NUMBER OF MSGS TRANSMITTED
USTAT_NMSGR DS H NUMBER OF MSGS RECEIVED
USTAT_LTOKEN DS CL8 SOCKET LOGON TOKEN
USTAT_SMFITOCL EQU *-USTAT_SMFHDR LENGTH OF SMF
**********************************************************************
* INPUT MSG
**********************************************************************
USTAT_IN_EYE DS CL4'*IPB' EYECATCHER
* *IPB IS THE INPUT TO THE EXIT
* FOR EITHER RECEIVE OR SEND
* USTAT_CALLID = AE - ADAPTER ERROR
* AR - ADAPTER RECEIVE
* AX - ADAPTER SEND
* ER - TM READ ERROR
* ME - MSC ERROR
* MR - MSC RECIEVE
* MS - MSC SEND
* OE - DB ERROR
* OR - DB RECIEVE
* OX - DB SEND
* RC - TM RECEIVE
* RE - OTMA REMOTE
* ALTPCB ERROR
* RR - OTMA REMOTE
* ALTPCB RECIEVE
* RS - OTMA REMOTE
* ALTPCB SEND
* SN - TM SEND
* for ICONRC and *IPB
* (USTAT_CALLID = "RC")
*
* THE LOGGED DATA STARTING AT OFFSET X'60' IS AS FOLLOWS:
* (INPUT TO EXIT FROM CLIENT)
* llll
* IRM
* llzzTRANCODEDATA
* X'00040000'
**********************************************************************
* for ICONSN and *IPB
* (USTAT_CALLID = "SN")
*
* THE LOGGED DATA STARTING AT OFFSET X'60' IS AS FOLLOWS:
* (INPUT TO EXIT FROM IMS APPLICATION)
* OTMA CONTROL HEADER followed by
* OTMA STATE DATA HEADER (if present) followed by
* OTMA SECURITY DATA HEADER (if present) followed by
* OTMA USER DATA HEADER (if present) followed by
* DATA TO BE SENT
* llzzTRANCODEDATA
*
USTAT_MSG_I DS CL202 MSG
**********************************************************************
* for ICONAR and *IPB
* (USTAT_CALLID = "AR")
*
* THE LOGGED DATA STARTING AT OFFSET X'60' IS AS FOLLOWS:
* (INPUT TO EXIT FROM CLIENT)
* llll
* IRM
* XML
*
**********************************************************************
* for ICONAX and *IPB
* (USTAT_CALLID = "AX")
*
* THE LOGGED DATA STARTING AT OFFSET X'60' IS AS FOLLOWS:
* (INPUT TO EXIT FROM OUTPUT FROM EXIT OF APPLICATION OUTPUT DATA)
* llll
* llzzDATA
* CSM
*
USTAT_MSG_I DS CL202 MSG
**********************************************************************
* OUTPUT MSG
**********************************************************************
USTAT_OUT_EYE DS CL4'*OPB' EYECATCHER
* *OPB IS THE OUTPUT FROM THE EXIT
* FOR EITHER RECEIVE OR SEND
* USTAT_CALLID = AE - ADAPTER ERROR
* AR - ADAPTER RECEIVE
* AX - ADAPTER SEND
* ER - TM READ ERROR
* ME - MSC ERROR
* MR - MSC RECIEVE
* MS - MSC SEND
* OE - DB ERROR
* OR - DB RECIEVE
* OX - DB SEND
* RC - TM RECEIVE
* RE - OTMA REMOTE
* ALTPCB ERROR
* RR - OTMA REMOTE
* ALTPCB RECIEVE
* RS - OTMA REMOTE
* ALTPCB SEND
* SN - TM SEND
* for ICONRC and *OPB
* (USTAT_CALLID = "RC")
*
* THE LOGGED DATA STARTING AT OFFSET X'300' IS AS FOLLOWS:
* (OUTPUT FROM USER EXIT OF CLIENT INPUT DATA)
* OTMA CONTROL HEADER followed by
* OTMA STATE DATA HEADER (if present) followed by
* OTMA SECURITY DATA HEADER (if present) followed by
* OTMA USER DATA HEADER (if present) followed by
* APPLICATION DATA TO BE SENT
* llzzTRANCODEDATA
**********************************************************************
* FOR ICONSN AND *OPB
* (USTAT_CALLID = "SN")
*
* THE LOGGED DATA STARTING AT OFFSET X'300' IS AS FOLLOWS:
* (OUTPUT FROM USER EXIT OF APPLICATION OUTPUT DATA)
* OTMA CONTROL HEADER followed by
* OTMA STATE DATA HEADER (if present) followed by
* OTMA SECURITY DATA HEADER (if present) followed by
* OTMA USER DATA HEADER (if present) followed by
* DATA TO BE SENT (ONE OF THE FOLLOWING STRUCTURES
* 'RMM'LLZZDATA.................'CSM'
* LLZZDATA.................'CSM'
* 'RSM'
*
* RMM is the *REQMOD* structure
* CSM is the *CSMOKY* structure
* RSM is the *REQSTS* structure
*
**********************************************************************
* FOR ICONAR AND *OPB
* (USTAT_CALLID = "AR")
*
* THE LOGGED DATA STARTING AT OFFSET X'300' IS AS FOLLOWS:
* (OUTPUT FROM USER EXIT OF CLIENT INPUT DATA)
* llll
* IRM
* llzzTRANCODEDATA
* X'00040000'
*
**********************************************************************
* FOR ICONAX AND *OPB
* (USTAT_CALLID = "AX")
*
* THE LOGGED DATA STARTING AT OFFSET X'300' IS AS FOLLOWS:
* (OUTPUT FROM USER EXIT OF APPLICATION OUTPUT DATA)
* llll
* XML
* CSM
*
USTAT_END_EYE DS CL4'*END' EYECATCHER