How the string of field connectors is constructed:
When CICS is initialized, a
unique connector value is assigned to every dictionary entry. CICS then examines
the MCT entries for this run to see if you have excluded any system-defined
performance data. If you have, the offset values for their corresponding dictionary
entries are set to X'FFFF'. CICS then constructs a sequence of field connectors that
excludes those with offsets of X'FFFF'. In this way, the connectors tell you which
system- and user-data fields are going to occur in your performance records for this
run. If you have not excluded any system-defined performance data, there is one
field connector for every dictionary entry.
Please note the following:
Field connectors
link the fields in a performance record with their dictionary entries. They are
unique values that are assigned at initialization time. They may, therefore,
change from one run of CICS to the next.
Field identifiers
allow you to exclude specific system-defined performance data from being
collected during a CICS run. They are unique within a group name and
record type, and they do not change between CICS runs. There is more
information about field identifiers in the
CICS Resource Definition Guide
.
Field offsets
in the performance record allow you to build a table for fast selection of
required fields in your monitoring data processing programs.
Dictionary Record
Dictionary Dictionary Dictionary Dictionary Dictionary
Entry 1 Entry 2 Entry 3 Entry 4 Entry n
Field 001 002 004 nnn
Connectors
Performance Data for Data for Data for Data for
Record 1 field 1 field 2 field 4 field n
Performance Data for Data for Data for Data for
Record 2 field 1 field 2 field 4 field n
Performance Data for Data for Data for Data for
Record 3 field1 field2 field4 fieldn
Performance Data for Data for Data for Data for
Record 4 field 1 field 2 field 4 field n
Figure 90. Relationship between the dictionary record and the performance records. In this
example, the data that is defined by Dictionary Entry 3 has been excluded, so there is no
field connector value for it and it does not appear in the performance records.
monitoring record formats
Chapter 24. CICS monitoring 673