Description

The IXCMG macro provides a cross-system coupling facility (XCF) installation with information that can help system programmers plan tuning activities and capacity requirements for the sysplex.

The data that IXCMG generates consists of one header, followed by zero or more data records. The IXCYAMDA mapping macro maps the data that IXCMG returns, including the header record.

The header information returned in the DATAAREA is mapped differently depending on the IXCMG GATHERFROM specification. If GATHERFROM is not specified, AMDAREA is used. For GATHERFROM=LOCAL and GATHERFROM=TOKEN, AMDAGFD is used. For GATHERFROM=OTHER, AMDAGFO is used.

The GATHERFROM parameter specifies which system you want to gather the information from:

GATHERFROM=LOCAL, the default, is used to request the gathering of data from the local system.
GATHERFROM=OTHER is used to request the gathering of data from some other system in the sysplex.
GATHERFROM=TOKEN is used to obtain the result of a previous IXCMG GATHERFROM=OTHER request.

The TYPE parameter specifies which of the five types of data records you can request:

TYPE=PATH returns one record for each signalling path that XCF is using.
TYPE=MSGPEND returns one record for each pending or delayed message.
TYPE=SYSTEM returns records summarizing message traffic for the system.
TYPE=SRCDST returns counts of messages sent and received by members in the system.
TYPE=MEMBER returns one record for each active member on the target system.

TYPE=ALL, the default, returns all possible types of data records.

Note: For AMDALEVEL 0 requests, ALL is equivalent to having specified PATH, MSGPEND, SYSTEM, and SRCDST for TYPE. For AMDALEVEL > 0 requests, ALL is equivalent to having specified PATH, MSGPEND, SYSTEM, SRCDST, and MEMBER for TYPE.

Two required parameters, DATAAREA and DATALEN, specify the area where IXCMG is to return the data.