Control data recording—DFHMCT TYPE=RECORD

The DFHMCT TYPE=RECORD macro identifies the performance class data fields which have been selected for monitoring.
Read syntax diagramSkip visual syntax diagram
>>-DFHMCT--TYPE=RECORD--,CLASS=PERFORM-------------------------->

>--+-----------------------------------+------------------------>
   '-,EXCLUDE=--+-ALL----------------+-'   
                '-(--n1--+------+--)-'     
                         '-,...-'          

>--+--------------------------+--------------------------------><
   '-,INCLUDE=(-m1-+------+-)-'   
                   '-,...-'       

TYPE=RECORD
Indicates that monitoring data for selected performance class data fields will be recorded.
CLASS=PERFORM
Code this if performance class data fields is to be recorded. You can abbreviate PERFORM to PER.
EXCLUDE={ALL∨(n1[,...])}
Code this to prevent one or more CICS® fields from being reported by the monitoring facility. By default, all documented performance class fields are reported.

The EXCLUDE operand is always honored before the INCLUDE operand, regardless of the order in which they are coded. (The INCLUDE operand is only relevant when the EXCLUDE operand is coded.)

ALL
This prevents all fields that are eligible for exclusion from being reported. Note that the following fields cannot be excluded:

1, 2, 4, 5, 6, and 89.

You can use the INCLUDE operand at the same time as EXCLUDE=ALL if you want to include some fields but exclude the majority.

Table 1 shows the fields that are eligible for exclusion. Each field has a group name associated with it, which identifies the group of fields to which it belongs. Each field also has its own numeric field identifier.

To exclude a group of fields you code the name of the group (a character string) as n1, for example, EXCLUDE=(DFHTASK).

To exclude a single field you code the numeric identifier of the field as n1, for example, EXCLUDE=(98,70).

Note: Do not code leading zeros on numeric identifiers. Do not code numeric identifiers of fields that are ineligible for exclusion.

You can code combinations of names and numeric identifiers, for example, EXCLUDE=(DFHFILE,DFHTERM,112,64).

Table 1. This table shows the data groups and fields that can be excluded/included
Group Name Field Id Description
DFHCBTS 200 CICS BTS process name
DFHCBTS 201 CICS BTS process type
DFHCBTS 202 CICS BTS process id
DFHCBTS 203 CICS BTS activity id
DFHCBTS 204 CICS BTS activity name
DFHCBTS 205 CICS BTS run process/activity synchronous count
DFHCBTS 206 CICS BTS run process/activity asynchronous count
DFHCBTS 207 CICS BTS link process/activity count
DFHCBTS 208 CICS BTS define process count
DFHCBTS 209 CICS BTS define activity count
DFHCBTS 210 CICS BTS reset process/activity count
DFHCBTS 211 CICS BTS suspend process/activity count
DFHCBTS 212 CICS BTS resume process/activity count
DFHCBTS 213 CICS BTS delete activity or cancel process/activity request count
DFHCBTS 214 CICS BTS acquire process/activity request count
DFHCBTS 215 CICS BTS total process/activity request count
DFHCBTS 216 CICS BTS delete/get/put process container count
DFHCBTS 217 CICS BTS delete/get/put activity container count
DFHCBTS 218 CICS BTS total process/activity container request count
DFHCBTS 219 CICS BTS retrieve reattach request count
DFHCBTS 220 CICS BTS define input event request count
DFHCBTS 221 CICS BTS timer associated event requests count
DFHCBTS 222 CICS BTS total event related request count
Start of changeDFHCHNLEnd of change Start of change321End of change Start of changeNumber of CICS requests for channel containersEnd of change
Start of changeDFHCHNLEnd of change Start of change322End of change Start of changeNumber of browse requests for channel containersEnd of change
Start of changeDFHCHNLEnd of change Start of change323End of change Start of changeNumber of GET CONTAINER requests for channel containers End of change
Start of changeDFHCHNLEnd of change Start of change324End of change Start of changeNumber of PUT CONTAINER requests for channel containers End of change
Start of changeDFHCHNLEnd of change Start of change325End of change Start of changeNumber of MOVE CONTAINER requests for channel containers End of change
Start of changeDFHCHNLEnd of change Start of change326End of change Start of changeLength of data in the containers of all GET CONTAINER CHANNEL commands End of change
Start of changeDFHCHNLEnd of change Start of change327End of change Start of changeLength of data in the containers of all PUT CONTAINER CHANNEL commandsEnd of change
DFHCICS 25 CICS OO foundation class request count
DFHCICS 103 Transaction exception wait time
DFHCICS 112 Performance record type
DFHCICS 130 Transaction routing sysid
DFHCICS 131 Performance record count
DFHCICS 167 MVS™ Workload Manager Service Class name
DFHCICS 168 MVS Workload Manager Report Class name
DFHDATA 179 IMS™ (DBCTL) request count
DFHDATA 180 DB2® request count
DFHDATA 186 IMS (DBCTL) wait time
DFHDATA 187 DB2 Readyq wait time
DFHDATA 188 DB2 Connection wait time
DFHDATA 189 DB2 wait time
DFHDEST 41 TD get count
DFHDEST 42 TD put count
DFHDEST 43 TD purge count
DFHDEST 91 TD total count
DFHDEST 101 TD I/O wait time
DFHDOCH 226 Document handler Create count
DFHDOCH 227 Document handler Insert count
DFHDOCH 228 Document handler Set count
DFHDOCH 229 Document handler Retrieve count
DFHDOCH 230 Document handler Total count
DFHDOCH 240 Document handler total created document length
DFHEJBS 311 CorbaServer for which the request processor instance is handling requests
DFHEJBS 312 Number of enterprise bean activations that have occurred in this request processor
DFHEJBS 313 Number of enterprise bean passivations that have occurred in this request processor
DFHEJBS 314 Number of enterprise bean creation calls that have occurred in this request processor
DFHEJBS 315 Number of enterprise bean removal calls that have occurred in this request processor
DFHEJBS 316 Number of enterprise bean method calls executed in this request processor
DFHEJBS 317 Total for this request processor of fields 312–316
DFHFEPI 150 FEPI allocate count
DFHFEPI 151 FEPI receive count
DFHFEPI 152 FEPI send count
DFHFEPI 153 FEPI start count
DFHFEPI 154 FEPI CHARS sent
DFHFEPI 155 FEPI CHARS received
DFHFEPI 156 FEPI suspend time
DFHFEPI 157 FEPI allocate time-out count
DFHFEPI 158 FEPI receive time-out count
DFHFEPI 159 FEPI total count
DFHFILE 36 FC get count
DFHFILE 37 FC put count
DFHFILE 38 FC browse count
DFHFILE 39 FC add count
DFHFILE 40 FC delete count
DFHFILE 63 FC I/O wait time
DFHFILE 70 FC access-method count
DFHFILE 93 FC total count
DFHFILE 174 RLS FC I/O wait time
DFHFILE 175 RLS File request CPU (SRB) time
DFHFILE 176 CFDT I/O wait time
DFHJOUR 10 Journal I/O wait time
DFHJOUR 58 Journal write count
DFHJOUR 172 Log stream write count
DFHMAPP 50 BMS MAP count
DFHMAPP 51 BMS IN count
DFHMAPP 52 BMS OUT count
DFHMAPP 90 BMS total count
DFHPROG 55 Program LINK count
DFHPROG 56 Program XCTL count
DFHPROG 57 Program LOAD count
DFHPROG 71 Program name
DFHPROG 72 Program LINK_URM count
DFHPROG 73 Program DPL count
DFHPROG 113 Original abend code
DFHPROG 114 Current abend code
DFHPROG 115 Program load time
Start of changeDFHPROGEnd of change Start of change286End of change Start of changeLength of data in the containers of all DPL requests with the CHANNEL optionEnd of change
Start of changeDFHPROGEnd of change Start of change287End of change Start of changeLength of data in the containers of all DPL RETURN CHANNEL commandsEnd of change
Start of changeDFHPROGEnd of change Start of change306End of change Start of changeNumber of local LINK requests with CHANNEL option End of change
Start of changeDFHPROGEnd of change Start of change307End of change Start of changeNumber of XCTL requests with CHANNEL option End of change
Start of changeDFHPROGEnd of change Start of change308End of change Start of changeNumber of DPL requests with CHANNEL optionEnd of change
Start of changeDFHPROGEnd of change Start of change309End of change Start of changeNumber of remote RETURN requests with CHANNEL option End of change
Start of changeDFHPROGEnd of change Start of change310End of change Start of changeLength of data in the containers of all remote RETURN CHANNEL commandsEnd of change
DFHSOCK 241 Inbound socket I/O wait time
DFHSOCK 242 Bytes encrypted for secure socket
DFHSOCK 243 Bytes decrypted for secure socket
DFHSOCK 244 Client IP address
DFHSOCK 245 TCP/IP service name
DFHSOCK 246 TCP/IP service port number
DFHSOCK 289 Socket extract request count
DFHSOCK 290 Create non-persistent socket request count
DFHSOCK 291 Create persistent socket request count
DFHSOCK 292 Non-persistent socket high-water-mark
DFHSOCK 293 Persistent socket high-water-mark
DFHSOCK 294 Socket receive request count
DFHSOCK 295 Socket characters received
DFHSOCK 296 Socket send request count
DFHSOCK 297 Socket characters sent
DFHSOCK 298 Socket total request count
DFHSOCK 299 Outbound socket I/O wait time
DFHSOCK 301 Inbound socket receive request count
DFHSOCK 302 Inbound socket characters received
DFHSOCK 303 Inbound socket send request count
DFHSOCK 304 Inbound socket characters sent
DFHSTOR 33 User-storage high-water-mark (UDSA)
DFHSTOR 54 User-storage get-count (UDSA)
DFHSTOR 87 Program-storage high-water-mark - total
DFHSTOR 95 User-storage-occupancy (bytes-ms) (UDSA)
DFHSTOR 105 User-storage get-count–above 16MB line (EUDSA)
DFHSTOR 106 User-storage high-water-mark–above 16MB line (EUDSA)
DFHSTOR 107 User-storage-occupancy (bytes-ms)–above 16MB line (EUDSA)
DFHSTOR 108 Program-storage high-water-mark–below 16MB line
DFHSTOR 116 User-storage high-water-mark–below 16MB line (CDSA)
DFHSTOR 117 User-storage get-count–below 16MB line (CDSA)
DFHSTOR 118 User-storage-occupancy (bytes-ms)–below 16MB line (CDSA)
DFHSTOR 119 User-storage high-water-mark–above 16MB line (ECDSA)
DFHSTOR 120 User-storage get-count–above 16MB line (ECDSA)
DFHSTOR 121 User-storage-occupancy (bytes-ms)–above 16MB line (ECDSA)
DFHSTOR 122 Program-storage high-water-mark (ERDSA)
DFHSTOR 139 Program-storage high-water-mark–above 16MB line
DFHSTOR 142 Program-storage high-water-mark (ECDSA)
DFHSTOR 143 Program-storage high-water-mark (CDSA)
DFHSTOR 144 Shared-storage getmain-count–below 16MB (CDSA and SDSA)
DFHSTOR 145 Shared-storage bytes getmained–below 16MB (CDSA and SDSA)
DFHSTOR 146 Shared-storage freemained–below 16MB (CDSA and SDSA)
DFHSTOR 147 Shared-storage getmain-count–above 16MB (ECDSA and ESDSA)
DFHSTOR 148 Shared-storage bytes getmained–above 16MB (ECDSA and ESDSA)
DFHSTOR 149 Shared-storage bytes freemained–above 16MB (ECDSA and ESDSA)
DFHSTOR 160 Program-storage high-water-mark (SDSA)
DFHSTOR 161 Program-storage high-water-mark (ESDSA)
DFHSTOR 162 Program-storage high-water-mark (RDSA)
DFHSYNC 60 Sync point count
DFHSYNC 173 Sync point elapsed time
DFHSYNC 177 CFDT server syncpoint wait time
DFHSYNC 196 Syncpoint delay time
DFHSYNC 199 OTS indoubt wait time
DFHTASK 7 User-task dispatch time
DFHTASK 8 User-task CPU time
DFHTASK 14 User-task suspend time
DFHTASK 31 Task number
DFHTASK 59 IC put/initiate count
DFHTASK 64 Error flag field
Start of changeDFHTASKEnd of change Start of change65End of change Start of changeNumber of local START requests with CHANNEL optionEnd of change
DFHTASK 66 IC total count
DFHTASK 82 Transaction group id
DFHTASK 97 Network name of the originating terminal or system
DFHTASK 98 Unit-of-work id on the originating system
DFHTASK 102 User-task wait-for-dispatch time
DFHTASK 109 Transaction priority
DFHTASK 123 Task global ENQ delay time
DFHTASK 124 3270 Bridge transaction id
DFHTASK 125 First dispatch delay time
DFHTASK 126 First dispatch delay time due to TRANCLASS
DFHTASK 127 First dispatch delay due to MXT
DFHTASK 128 Lock manager delay time
DFHTASK 129 Task ENQ delay time
DFHTASK 132 Recovery manager unit-of-work id
DFHTASK 163 Transaction facility name
DFHTASK 164 Transaction flags
DFHTASK 166 Transaction class name
DFHTASK 170 Resource Manager Interface–elapsed time
DFHTASK 171 Resource Manager Interface–suspend time
DFHTASK 181 EXEC CICS WAIT EXTERNAL wait time
DFHTASK 182 EXEC CICS WAITCICS and WAIT EVENT wait time
DFHTASK 183 Interval Control delay time
DFHTASK 184 “Dispatch Wait” wait time
DFHTASK 190 RRMS/MVS unit-of-recovery id (URID)
DFHTASK 191 RRMS/MVS wait time
DFHTASK 192 Request receiver wait time
DFHTASK 193 Request processor wait time
DFHTASK 194 OTS Transaction id (Tid)
DFHTASK 195 CICS BTS run process/activity synchronous wait time
DFHTASK 249 User-task QR TCB wait-for-dispatch time
DFHTASK 250 CICS MAXOPENTCBS delay time
DFHTASK 251 CICS TCB attach count
DFHTASK 252 User-task peak open TCB count
DFHTASK 253 CICS JVM elapsed time
DFHTASK 254 CICS JVM suspend time
DFHTASK 255 User-task QR TCB dispatch time
DFHTASK 256 User-task QR TCB CPU Time
DFHTASK 257 User-task MS TCB dispatch time
DFHTASK 258 User-task MS TCB CPU Time
DFHTASK 259 User-task L8 TCB CPU Time
DFHTASK 260 User-task J8 TCB CPU Time
DFHTASK 261 User-task S8 TCB CPU Time
DFHTASK 262 User-task key 8 TCB dispatch time
DFHTASK 263 User-task key 8 TCB CPU time
DFHTASK 264 User-task key 9 TCB dispatch time
DFHTASK 265 User-task key 9 TCB CPU time
DFHTASK 267 User-task J9 TCB CPU Time
DFHTASK 268 User-task TCB mismatch wait time
DFHTASK 269 User-task RO TCB dispatch time
DFHTASK 270 User-task RO TCB CPU Time
DFHTASK 273 CICS JVM initialize elapsed time
DFHTASK 275 CICS JVM reset elapsed time
DFHTASK 277 CICS MAXJVMTCBS delay time
Start of changeDFHTASKEnd of change Start of change279End of change Start of changeMVS storage constraint delay timeEnd of change
DFHTASK 285 3270 bridge partner wait time
Start of changeDFHTASKEnd of change Start of change345End of change Start of changeLength of data in the containers of all locally-executed START CHANNEL requests End of change
Start of changeDFHTASKEnd of change Start of change346End of change Start of changeNumber of interval control START CHANNEL requests to be executed on remote systems End of change
Start of changeDFHTASKEnd of change Start of change347End of change Start of changeLength of data in the containers of all remotely-executed START CHANNEL requests End of change
DFHTEMP 11 TS I/O wait time
DFHTEMP 44 TS get count
DFHTEMP 46 TS put auxiliary count
DFHTEMP 47 TS put main count
DFHTEMP 92 TS total count
DFHTEMP 178 Shared TS I/O wait time
DFHTERM 9 TC I/O wait time
DFHTERM 34 TC principal facility input messages
DFHTERM 35 TC principal facility output messages
DFHTERM 67 TC alternate facility input messages
DFHTERM 68 TC alternate facility output messages
DFHTERM 69 TC allocate count
DFHTERM 83 TC principal facility CHARS input
DFHTERM 84 TC principal facility CHARS output
DFHTERM 85 TC alternate facility CHARS input
DFHTERM 86 TC alternate facility CHARS output
DFHTERM 100 IR I/O wait time
DFHTERM 111 VTAM® terminal LU name
DFHTERM 133 TC I/O wait time - LU6.1
DFHTERM 134 TC I/O wait time - LU6.2
DFHTERM 135 TC alternate facility input messages - LU6.2
DFHTERM 136 TC alternate facility output messages - LU6.2
DFHTERM 137 TC alternate facility CHARS input - LU6.2
DFHTERM 138 TC alternate facility CHARS output - LU6.2
DFHTERM 165 Terminal information
DFHTERM 169 Terminal session connection name
DFHTERM 197 Network qualified name network ID
DFHTERM 198 Network qualified name network name
DFHWEBB 224 Web read request count
DFHWEBB 225 Web write request count
DFHWEBB 231 Web receive request count
DFHWEBB 232 Web characters received
DFHWEBB 233 Web send request count
DFHWEBB 234 Web characters sent
DFHWEBB 235 Web total request count
DFHWEBB 236 Web header or formfield read request count
DFHWEBB 237 Web header or formfield write request count
DFHWEBB 238 Web extract request count
DFHWEBB 239 Web browse request count
Start of changeDFHWEBBEnd of change Start of change331End of change Start of changeWeb header read request count, clientEnd of change
Start of changeDFHWEBBEnd of change Start of change332End of change Start of changeWeb header write request count, clientEnd of change
Start of changeDFHWEBBEnd of change Start of change333End of change Start of changeWeb client receive or converse request countEnd of change
Start of changeDFHWEBBEnd of change Start of change334End of change Start of changeWeb characters received, clientEnd of change
Start of changeDFHWEBBEnd of change Start of change335End of change Start of changeWeb client send or converse request countEnd of change
Start of changeDFHWEBBEnd of change Start of change336End of change Start of changeWeb characters sent, clientEnd of change
Start of changeDFHWEBBEnd of change Start of change337End of change Start of changeWeb client parse URL request countEnd of change
Start of changeDFHWEBBEnd of change Start of change338End of change Start of changeWeb client browse request countEnd of change
INCLUDE=(m1[,...])
Code this to enable one or more CICS fields to be reported by the monitoring facility. By default, all documented performance class fields are reported, so this operand is relevant only if you code the EXCLUDE operand in the same macro.

The fields that are eligible to be coded for inclusion on this operand are the same as those that are eligible for exclusion. (See the description of the EXCLUDE operand.) Each field has a numeric field identifier associated with it. To include a field, you code m1 as the numeric identifier of the field. You can code multiple numeric identifiers.

Note: Do not code leading zeros on numeric identifiers. Do not code numeric identifiers of fields that are ineligible for exclusion, and that are therefore included by default
.
The EXCLUDE operand is always honored first. The INCLUDE operand, if coded, then overrides some of its effects. For example, coding:
EXCLUDE=DFHFILE,
INCLUDE=(37,93)
would secure the collection and reporting of file control PUTs and the total number of file control requests, while file control browse count and other file control fields would be excluded.
If you want to exclude the majority of fields, but include a few, you can code, for example:
EXCLUDE=ALL,
INCLUDE=(DFHTERM,97,98)

This is more convenient than coding individually all the fields you want to exclude.

CICSTS31.SDFHSAMP provides the following sample monitoring control tables:

These samples show how to use the EXCLUDE and INCLUDE operands to reduce the size of the performance class record in order to reduce the volume of data written by CICS to SMF.