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.