Types of Information Available

With the IXLMG macro, you specify whether you want usage information reported by facility (either all coupling facilities or a particular coupling facility) or for a single named coupling facility structure. You can also request control information for a structure and measurement information for each coupling facility. Control and measurement information, when requested, is retrieved from the coupling facility itself.

The IXLYAMDA macro provides the following mappings related to the type of information requested:

IXLYAMDAREA

Data area that contains header information used to determine the scope of data returned by IXLMG. The information includes:

The total length of the output data area needed to contain all the requested information. This length includes the area for the records that were already returned on this call.
The total number of entries of all kinds included in the record.
Version number of the IXLYAMDA information.

IXLYAMDHD

Header record returned for all entry mapping types. The information includes:

Type of entry
Length of entry
Address of next entry.

IXLYAMDCF and IXLYAMDCF1

Coupling facility usage and control information, which includes:

Configuration data
Accounting and measurement data
Control information
If applicable, pointer to the first CF remote facility record

IXLYAMDSLL and IXLYAMDSLL1

List structure limit information

IXLYAMDSLC and IXLYAMDSLC1

Cache structure limit information

IXLYAMDCFMI

Coupling facility capacity measurement information entry (the header to set up an array of elements mapped by IXLYAMDCFMINFO)

IXLYAMDCFMINFO

Coupling facility capacity measurement information element

IXLYAMDCFRF

Coupling facility remote facility entry

IXLYAMDSTRL and IXLYAMDSTRL1

List structure usage and control information. Following the header information are:

Configuration data
List measurement data
List control structure information

IXLYAMDSTRC and IXLYAMDSTRC1

Cache structure usage and control information. Following the header information are:

Configuration data
Cache measurement data
Control information

IXLYAMDSCSC and IXLYAMDSCSC1

Storage class information (cache structure only)

IXLYAMDSCOC

Cast-out class information (cache structure only) (the header to set up an array of elements mapped by IXLYAMDCFMINFO).

IXLYAMDSCOCSTATS

Cast-out class information element

IXLYAMDSC and IXLYAMDSC1

Subchannel information

IXLYAMDSSCC

Structure copy controls information End of change

IXLYAMDCFCP

Coupling facility channel path header information End of change

IXLYAMDCFCPINFO

Coupling facility channel path information End of change

IXLYAMDSSCM

Storage-class memory information for a structure End of change

If the specified structure is in the process of structure rebuild or duplexing rebuild, IXLMG returns information for both the old structure and the new structure.

The layout of the IXLYAMDA information is depicted in Figure 1. If you specified AMDALEVEL=1 on the IXLMG macro, you will receive level-1 IXLYAMDA records.

Note that in z/OS® Release 2, the IXLYAMDSTRL1 and IXLYAMDSTRC1 records contain additional new information.

Count of “CF-to-CF link not available” conditions, per structure
Count of “execution suppressed” conditions, per structure
Count, sum of times, and sum of squares of times, for peer wait for subchannel conditions in which a request is waiting for a peer subchannel to become available for use, without any reserved subchannel held for the operation to the current structure. (System-managed duplexing rebuild uses a “peer subchannel” to drive the second half of a duplexed request to the associated coupling facility.)
Count, sum of times, and sum of squares of times, for peer wait with reserve conditions in which a request is waiting for a peer subchannel to become available for use, with a reserved subchannel held for the operation to the current structure. The subchannel is not available for use during this time.
Count, sum of times, and sum of squares of times, for peer wait for completion conditions in which a subchannel for a duplexed operation is waiting for the completion of the operation to the other structure instance. The subchannel is not available for use during this time.

The layout of the IXLYAMDA information is depicted in Figure 1. If you specified AMDALEVEL=1 on the IXLMG macro, you will receive level-1 IXLYAMDA records.

For each coupling facility specified on the IXLMG request, the following information could potentially be returned. Note that the symbol “...” indicates that there could be more than one of that type of entry. For example, IXLMG could return a AMDSTRL entry for each eligible list structure in a coupling facility.

Figure 1. Layout of IXLYAMDA

For a complete description of IXLYAMDA, see z/OS MVS™ Data Areas in the z/OS Internet library.