Dictionary data sections

Dictionary data sections describe all the fields in the performance data records that are gathered during this CICS® run.

Dictionary data sections describe all the system-provided data fields (whether you have excluded any or not), plus any user-provided data fields, which CICS takes at initialization time from the MCT entries you have coded. This means that the descriptions of the system-provided data fields never change, though the user data fields can be changed each time CICS is initialized. The contents of the dictionary data sections cannot be changed while CICS is running.

Dictionary data sections contain a variable number of 26-byte dictionary entries. Each dictionary entry provides the following information about a single performance record data field:
CMODNAME
The identifier of the group to which the field belongs.
CMODTYPE
The field type.
CMODIDNT
The field identifier.
CMODLENG
The length of the field.
CMODCONN
The connector value assigned to the field.
CMODOFST
The offset of the field.
CMODHEAD
The informal name of the field.
You can map the dictionary entries by generating a DSECT with the DFHMCTDR macro, as shown in Figure 1.
Figure 1. CICS monitoring dictionary entry DSECT
DFHMCTDR TYPE=(PREFIX,CMO)

CMO is the default label prefix.  The DSECT is as follows:

CMODNAME DS    CL8     + 0    NAME OF OWNER (entry name)
CMODTYPE DS    C       + 8    OBJECT TYPE
*                           'S' = STOPWATCH (CLOCK)
*                           'A' = ACCUMULATOR (COUNT)
*                           'C' = BYTE-STRING FIELD
*                           'T' = TIMESTAMP (STCK FORMAT)
*                           'P' = PACKED-DECIMAL FIELD
CMODIDNT DS    CL3     +9     ID WITHIN TYPE
*                             CLOCK-, COUNT-, OR FIELD-NO.
CMODLENG DS    H       +12    LENGTH OF OBJECT
CMODCONN DS    XL2     +14    ASSIGNED CONNECTOR
CMODOFST DS    XL2     +16    ASSIGNED OFFSET
CMODHEAD DS    CL8     +18    INFORMAL NAME
CMODNEXT EQU   *

Whenever the monitoring of performance class data is switched on, whether at CICS initialization or while CICS is running, a dictionary data section is written. So, if the monitoring of performance class data is switched on and off three times during a single CICS run, there are three separate, but identical, dictionary data sections for that run. The dictionary data section is passed to SMF, together with any performance data sections, when the first buffer of performance data sections for a performance class data monitoring session is output to SMF. Any offline utility should use the most recent dictionary record encountered when processing CICS monitoring records.

The format of dictionary data sections is shown in Figure 2.
Figure 2. Format of the CICS monitoring dictionary data section
The picture shows 3 rectangles, one above the other. The top rectangle represents an SMF type 110 monitoring record. It consists of 3 sections: an SMF header, an SMF product section, and a dictionary data section. The middle rectangle is an expansion of the dictionary data section in the top rectangle. It consists of a number of dictionary entries, numbered 1 to n. The bottom rectangle is an expansion of one of the dictionary entries in the middle rectangle. It consists of the following fields: Field owner; Field type; Field identifier; Field length; Field connector; Field offset; Field title.


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