Description

The IXCQUERY macro allows any authorized caller to request information about the resources the cross-system coupling facility (XCF) manages. The REQINFO parameter determines whether the information is about XCF groups, systems in the sysplex, the sysplex itself, coupling facility resources, or information related to the automatic restart manager.

REQINFO=GROUP returns information about groups and members defined to XCF. The information can be about all groups, a specific group, or a single member of a group. If you issue IXCQUERY without any parameters, you receive general information about each group defined to XCF.
REQINFO=SYSPLEX returns information about each system in the sysplex.
REQINFO=CF returns information about coupling facilities defined in the CFRM active policy. The information can be about all coupling facilities or a specific coupling facility.
REQINFO=CF_ALLDATA returns information about all coupling facilities.
REQINFO=STR returns information about coupling facility structures defined in the CFRM active policy. The information can be about all structures or a specific structure.
REQINFO=STR_ALLDATA returns information about all coupling facility structures.
REQINFO=COUPLE returns information about the sysplex. The scope of the output depends on the other parameters specified.
REQINFO=ARMSTATUS returns information about active elements. The scope of the output depends on the other parameters specified.
REQINFO=ARMS_ALLDATA returns information about all active elements.
REQINFO=FEATURES returns information about the XCF and XES software features installed on the system from which the request is made.

When you use REQINFO with all options except COUPLE and FEATURES, use the ANSAREA parameter to tell XCF where to return the information, and ANSLEN to tell XCF the length of the answer area. REQINFO=COUPLE and REQINFO=FEATURES generate an inline expansion.

Sections in the IXCYQUAA mapping macro provide the format for the data:

QUAHDR maps the offset and length of the other record types.
QUAGRP maps the group record.
QUAMEM, QUAMEM1, and QUAMEM2 map the member records.
QUASYS and QUASYS1 map system information records.
QUACF and QUACF1 map coupling facility records.
QUACFSC and QUACFSC1 map system connectivity to coupling facility records.
QUACFSTR and QUACFSTR1 map information about coupling facility structures allocated in a coupling facility.
QUASTR and QUASTR1 map the coupling facility structure record.
QUASTRPL and QUASTRPL1 map the coupling facility structure preference list records.
QUASTRXL and QUASTRXL1 map the coupling facility structure exclusion list records.
QUASTRCF and QUASTRCF1 map information about the coupling facility containing a coupling facility structure.
QUASTRUSER and QUASTRUSER1 map the connectors to coupling facility structure records.
QUASTRSYS maps information about system participation in a system-managed process for a coupling facility structure.
QUAARMS maps information about automatic restart manager elements.
QUREQFEATURES maps information about software features installed on a system.