Using Component Data in the Dump Data Set

When coupling facility structure data is written to the dump data set, the data is organized into several different COMPDATA spaces. Each COMPDATA space contains a specific type of data. Figure 1 provides a diagram of the types of coupling facility structure data available in the dump data set.

Figure 1. Format of Coupling Facility Structure Data in Dump Data Set

Within the dump data set there is one master index COMPDATA space that identifies the structures in the dump and provides an index into the other COMPDATA spaces for the structure. The diagram shows that for a structure identified in the master index, there may be one or more structure, object header, and hash table COMPDATA space records.

The name of the master index COMPDATA space is CFD0000I. The naming convention for the other COMPDATA spaces containing coupling facility structure data allows you to index through each of the other types. Names are of the format CFDxxyy_, where:

CFD is the component prefix
xx is the sequence number of the space. All sequence numbers start at 00.
yy is the structure number that appears in the master index entry for the structure
_ is an alphabetic character indicating the type of data in the COMPDATA space.

To advance to the next type of COMPDATA space for a structure, increment the xx part of the COMPDATA space name by one.

All of the records in the COMPDATA spaces start at address X'1000'. The hash table compdata space is the only type not pointed to by another COMPDATA space. To access the hash table COMPDATA space, use its name (CFDxxyyH) and address (X'1000').

Table 1 lists each COMPDATA space by name and describes the contents of each.

Table 1. Coupling Facility Structure COMPDATA Space Descriptions
Data Type	Name	Description
Master Index	CFD0000I	Contains the index of all coupling facility structures that were requested to be dumped.
Structure	CFDxxyyS	Associated with each structure that is listed in the master index. Summarizes the contents of this space.
Object Header	CFDxxyyO	Contains the object headers for all of the objects that were dumped for the structure. Objects are castout classes, storage classes, list numbers, lock tables, and user controls.
Hash Table	CFDxxyyH	Provides a way to get to the entries in classes or list numbers by entry name or by entry identifier.
Lock Table	CFDxxyyL	Contains all the nonzero lock table entries from the lock table, if one was defined for the structure.
Event Monitor Controls	CFDxxyyE	Contains all the event monitor controls for the structure.
Event Queue Controls	CFDxxyyQ	Contains all the event queue controls for the structure.
User Control	CFDxxyyU	Contains user control information for the structure.
Entry Control	CFDxxyyC	Contains control information about the entries that were dumped for castout classes, storage classes, or list numbers.
Adjunct Data	CFDxxyyA	Contains the adjunct data for all the entries that have adjunct data associated with them.
Entry Data	CFDxxyyD	Contains the entry data for all the entries that have entry data associated with them.