Specifying the Type of Information

Depending on how you code the IXCQUERY macro, you can obtain information about:

The name of the sysplex
Every system in the sysplex
Every group in the sysplex
Every member in a specific group
A specific member in a specific group
Every application in the sysplex that is using automatic restart management
Every application on a certain system that is using automatic restart management
Every application in a certain restart group (a group of applications that the automatic restart manager is to restart together on a certain system)
A particular application using automatic restart management
Whether the sysplex is in XCF-local mode
Whether the sysplex is in monoplex mode
The maximum number of systems allowed in the sysplex for this XCF release level
The current maximum number of systems allowed in the sysplex as defined by the installation in the couple data sets
Software features available on a system in the sysplex
Every coupling facility in the sysplex
A specific coupling facility
Every coupling facility structure in the sysplex
Every coupling facility structure in a specific coupling facility
A specific coupling facility structure in a specific coupling facility.
Pending policy information for a specific coupling facility structure (available with QUAALEVEL=2).
Site affiliation of the coupling facility, if applicable.

Table 1 summarizes the parameters you code on the IXCQUERY macro to obtain the required information.

Table 1. IXCQUERY Macro Parameters
Parameter on IXCQUERY	Information Returned	Structure in IXCYQUAA
REQINFO=SYSPLEX	Header record	QUAHDR
REQINFO=SYSPLEX	One record for each system in the sysplex	QUASYS QUASYS1 (when QUAALEVEL=1) QUASYS2 (when QUAALEVEL=4)
REQINFO=GROUP (the default)	Header record	QUAHDR
REQINFO=GROUP (the default)	One record for each group in the sysplex	QUAGRP
REQINFO=GROUP, GRPNAME=grpname	Header record	QUAHDR
REQINFO=GROUP, GRPNAME=grpname	One record for each member of the specified group	QUAMEM, QUAMEM1, and QUAMEM2
REQINFO=GROUP, GRPNAME=grpname, MEMNAME=memname	Header record	QUAHDR
REQINFO=GROUP, GRPNAME=grpname, MEMNAME=memname	One record for the specified member	QUAMEM, QUAMEM1, and QUAMEM2
REQINFO=COUPLE, LOCAL=local	Whether the sysplex is in XCF-local mode	N/A
REQINFO=COUPLE, MONOPLEX=monoplex	Whether the sysplex is in monoplex mode
REQINFO=COUPLE, MAXSYS=maxsys	The maximum number of systems allowed in the sysplex as specified by the XCF release level
REQINFO=COUPLE, CURRMAXSYS=currmaxsys	The current maximum number of systems allowed in the sysplex as specified in the sysplex couple data set
REQINFO=COUPLE, SYSPLEXID=sysplexid	The unique sysplex identifier for the sysplex
REQINFO=COUPLE, SYSTEMID=systemid	The unique system identifier for the system on which the IXCQUERY was invoked.
REQINFO=COUPLE, PLEXNAME=plexname	The name of the sysplex
REQINFO=COUPLE, CFLEVEL=cflevel	The maximum CFLEVEL supported by the system
REQINFO=COUPLE, ND=nd	The node descriptor of the system
REQINFO=FEATURES	XCF and XES software features available on this system.	QUREQFEATURES
REQINFO=CF	Header record	QUAHDR
REQINFO=CF	One record for each coupling facility in the sysplex.	QUACF QUACF1
REQINFO=CF, CFNAME=cfname	Header record	QUAHDR
	One record for the specified coupling facility.	QUACF QUACF1
	System connectivity to the coupling facility.	QUACFSC QUACFSC1
	Coupling facility structures assigned resources in the coupling facility.	QUACFSTR QUACFSTR1
REQINFO=CF_ALLDATA	Header record	QUAHDR
	One record for each coupling facility in the sysplex.	QUACF QUACF1
	One record for each coupling facility in the sysplex for system connectivity information.	QUACFSC QUACFSC1
	One record for each coupling facility in the sysplex for information about structures assigned resources in the coupling facility.	QUACFSTR QUACFSTR1
REQINFO=STR	Header record	QUAHDR
REQINFO=STR	One record for each coupling facility structure in the sysplex.	QUASTR QUASTR1 QUASTRPPINFO (when QUAALEVEL=2)
REQINFO=STR, STRNAME=strname	Header record	QUAHDR
	One record for the specified coupling facility structure.	QUASTR QUASTR1 QUASTRPPINFO (when QUAALEVEL=2)
	Names of coupling facilities in the structure's preference list.	QUASTRPL QUASTRPL1 When QUAALEVEL=2, the system returns preference list information for the pending policy also, if applicable.
	Names of structures in the structure's exclusion list.	QUASTRXL QUASTRXL1 When QUAALEVEL=2, the system returns exclusion list information for the pending policy also, if applicable.
	Names of the coupling facilities where the structure is allocated.	QUASTRCF QUASTRCF1
	Connectors to the coupling facility structure.	QUASTRUSER QUASTRUSER1
REQINFO=STR_ALLDATA	Header record	QUAHDR
	One record for each coupling facility structure in the sysplex.	QUASTR QUASTR1 QUASTRPPINFO (When QUAALEVEL=2)
	Names of coupling facilities in each structure's preference list.	QUASTRPL QUASTRPL1 When QUAALEVEL=2, the system returns preference list information for the pending policy also, if applicable.
	Names of structures in each structure's exclusion list.	QUASTRXL QUASTRXL1 When QUAALEVEL=2, the system returns exclusion list information for the pending policy also, if applicable.
	Names of the coupling facilities where each structure is allocated.	QUASTRCF QUASTRCF1
	Connectors to each coupling facility structure	QUASTRUSER QUASTRUSER1
REQINFO=ARMSTATUS	Header record	QUAHDR
REQINFO=ARMSTATUS	One record for each application specified that is using automatic restart managment	QUAARMS
REQINFO=ARMS_ALLDATA	Header record	QUAHDR
REQINFO=ARMS_ALLDATA	One record for each application in the sysplex that is using automatic restart management	QUAARMS

You can also specify, on IXCQUERY REQINFO=GROUP, whether you want the status that XCF has readily available (REQTYPE=IMMEDIATE parameter), or whether you want XCF to suspend your work unit while it obtains the most current data available (the default, REQTYPE=DEFER parameter). If you specify REQTYPE=DEFER, XCF serializes updates to the requested group data and retrieves the most current data. However, XCF cannot guarantee that updates will not occur before the requestor uses the data. For example, when the IXCQUERY service returns to the caller, the caller could then be swapped out. By the time the caller is swapped back in, updates could have been made, and the data that was returned by IXCQUERY is no longer the latest data.