IXGQUERY: Get information about a log stream or system logger

Use the IXGQUERY service to retrieve information about a log stream in the sysplex, or retrieve the system logger ZAI SERVER and PORT values pertaining to the z/OS® IBM zAware server location.

When using the IXGQUERY service to retrieve information about a log stream in the sysplex, the information is returned in a buffer mapped by IXGQBUF. The information returned by IXGQUERY for a log stream includes:

Safe import point. See The safe import point: Using IXGQUERY and IXGIMPRT together.
Control information size: This value shows the number of bytes that system logger adds to each log block written to the log stream.
Structure version number for coupling facility log streams. See The coupling facility list structure version number.
For DASD-only log streams, this value shows the STCK format time stamp that the staging data set for the DASD-only log stream was allocated.
Group information about the log stream. Every log stream is in either group TEST or PRODUCTION. See the QBUF_GROUPVALUE field in the IXGQBUF mapping macro. TEST indicates that the log stream is a test log stream. PRODUCTION indicates that the log stream is a production log stream. Note that you must specify a BUFFLEN value of 200 bytes or more to retrieve the group data for the log stream. See the GROUP keyword in the IXGINVNT service in z/OS MVS Programming: Assembler Services Reference IAR-XCT.
Information related to the size of the current offload data set and staging data set in the IXGQBUF. Note that the maximum value returned in fields QBUF_LS_DS_SIZE and QBUF_STG_DS_SIZE is 2GB-1 ('7FFFFFFF'x ). For data set sizes greater than 2GB, '7FFFFFFF'X will be returned, but the full value will be available in fields QBUF_FULL_LS_DS_SIZE and QBUF_FULL_STG_DS_SIZE.
When QBUF_LS_Offload_Returned is turned on in the IXGQBUF, the fields QBUF_LS_HighOffload and QBUF_LS_LowOffload are filled in with the log stream definitional HIGHOFFLOAD and LOWOFFLOAD fields.
Information about the log stream definition values for the elevated and imminent capacity points, which correspond to the IXGWRITE ANSAA flags ANSAA_WRITEELEVATEDCAPACITY and ANSAA_WRITEIMMINENTCAPACITY. See Write triggers for more information on the how the ANSAA_WRITEELEVATEDCAPACITY and ANSAA_WRITEIMMINENTCAPACITY fields are set.

When using the IXGQUERY service to retrieve system logger parameter options, the information is returned in a buffer mapped by IXGQZBUF. The information returned by IXGQUERY includes system logger parameter options for:

ZAI SERVER value and significant length of value.
ZAI PORT value and significant length of value.

Since the system logger parameter options can change as a result of (SET or SETLOGR) commands, refer to topic Using ENF event code 48 in system logger applications for details on keeping informed of when changes to these parameters occur.

You must be in task mode to issue the IXGQUERY service or else the request is rejected.

For information about the IXGQBUF and IXGQZBUF fields, see z/OS MVS Data Areas in the z/OS Internet library.