Obtaining Sysplex, Group, and Member Information

A member of an XCF group, or any authorized routine, might need information about members, groups, and systems in an XCF sysplex under these circumstances:

A member of an XCF group might need to know which other members of the group are currently defined to XCF and what their member states are.
A member of an XCF group might need to request services (such as invoking IXCTERM or IXCSETUS) on behalf of another member of the group. The member must provide the target member's token to invoke these services.
A member of an XCF group might need to send a message to another member in the group. The sender must provide the target member's token to issue the IXCMSGOX macro.
A member of an XCF group did not identify a group user routine to be notified of changes to other members in the group. Occasionally, the member might need to know the status of the other members in the group.
An authorized routine that maintains or displays XCF data might need information about the systems, groups, and members in the sysplex.
An authorized routine might need to delete a member of an XCF group (place the member in a not-defined state). The routine must supply the target member's token to issue the IXCDELET macro.
At initialization, a multisystem application might need to know if the system it is started on is part of a multisystem sysplex, and the maximum number of systems supported in that sysplex.

The above are just a few examples of the many reasons why XCF group members and other authorized routines might request information about the systems, groups, and members in the XCF sysplex by invoking the IXCQUERY macro. The information provided by the IXCQUERY macro is mapped by the IXCYQUAA mapping macro.