IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

PIPE XCFQUERY
Usage Notes
Examples
272 Programming: Pipes
group_name
Returns detailed information about the specified group and its members.
The value for group_name canbe1–8characters in length.
member_name
Returns detailed information about the specified member. The value for
group_name canbe1–16characters in length. This option is only valid if
group_name is specified.
SYSTEMS
Returns a list of systems in the sysplex.
v Query failures generally produce return codes from the IXCQUERY macro that
are returned in the CNM273I message. Return codes are documented in the
z/OS V1R9.0 MVS Programming: Sysplex Services Reference, SA22–7618.
v The XCFQUERY stage command returns the query results to the primary output
stream.
v The output of the XCFQUERY stage is unformatted data (including binary data)
that is returned by the z/OS IXCQUERY macro instruction. You can use the
EDIT stage to reformat the data to character data. The CF, GROUPS, and
SYSTEMS output is mapped by the QUASYS1, QUAGRP, QUAMEM1 and
QUACF1 mappings in the IXCYQUAA z/OS system macro. The CFGINFO
output consists of the data in Table 9 (in the order listed).
Table 9. CFGINFO output
Number of
IXCQUERY z/OS system
bytes Data
macro parameter
4 maximum number of systems possible in the
sysplex
MAXSYS
4 current maximum number of systems in the
sysplex
CURRMAXSYS
8 sysplex name PLEXNAME
4 coupling facility level CFLEVEL
32 node descriptor ND
8 sysplex token SYSPLEXID
8 sysplex token SYSTEMID
1 XCF-local mode flag (X'00' if false, X'01' if true) LOCAL
1 monoplex mode flag (X'00' if false, X'01' if
true)
MONOPLEX
Example: Displaying all the XCF Groups in a Sysplex
The following example displays all the XCF groups in a sysplex:
PIPE XCFQUERY GROUPS | CONS
Example: Displaying all the Members in a Group
The following example displays all the members in the DSIPLX01 NetView group:
PIPE XCFQUERY GROUPS DSIPLX01 | CONS