Every system logger service issued must include an answer area
output field specified on the ANSAREA parameter. In this answer area,
mapped by the IXGANSAA macro, system
logger returns status and diagnostic data.
Some generic answer area fields include:
- ANSAA_PREFERRED_SIZE
- The optimal size for the answer area field specified on
the ANSAREA parameter. IXGCONN REQUEST=CONNECT returns this value.
The
answer area must be at least 40 bytes long. If you specify a field
that is less than that, the service fails with a non-zero return code.
To ascertain the optimal answer area size, look at the ANSAA_PREFERRED_SIZE
field of the answer area returned by the first system logger service
your application issues, either the IXGINVNT or IXGCONN REQUEST=CONNECT
service.
- ANSAA_ASYNCH_RETCODE
- For asynchronously processed requests, system logger returns the
return code in this field.
- ANSAA_ASYNCH_RSNCODE
- For asynchronously processed requests, system logger returns the
reason code in this field.
- ANSAA_DIAGx
- Diagnostic data. The content of these fields depend on any return
and reason codes returned for a request.
Specific service indicators include:
- ANSAA_BLKFROMINACTIVE
- Indicates that the log block returned from an IXGBRWSE request
came from the inactive portion of the log stream. For MULTIBLOCK=YES
requests, this flag indicates that at least one log block returned
in the buffer came from an inactive portion of the log stream. Flag
IXGBRMLT_FROMINACTIVE in IXBRMLT (from the IXGBRMLT macro) indicates
which log blocks were in the inactive portion. This field is only
valid for IXGBRWSE requests that result in a log block being returned.
- ANSAA_DYNMGMTOFENTRYTOELACTIVE
- Indicates that system logger is dynamically managing the entry-to-element
ratio for the coupling facility structure. The structure was defined
in a LOGR couple data set. This field is only valid for IXGCONN requests,
and is undefined when ANSA_DASDONLYLOGSTREAM is on.
- ANSAA_DASDONLYLOGSTREAM
- This flag in ANSAA_FLAGS1 indicates whether a log stream is DASD-only.
It is output from an IXGCONN REQUEST=CONNECT service.
- ANSAA_BROWSEMULTIBLOCK
- This flag in ANSAA_FLAGS1 indicates whether this level of system
logger supports IXGBRWSE MULTIBLOCK=YES requests. It is valid only
for an IXGBRWSE REQUEST=START service.
- ANSAA_BLKFROMDASD
- This flag in ANSAA_FLAGS1 indicates that the log block returned
from an IXGBRWSE request came from a log stream DASD offload data
set. For MULTIBLOCK=YES requests, this flag indicates that at least
one log block returned in the buffer came from a log stream DASD offload
data set. Flag IXGBRMLT_FROMDASD in IXBRMLT (from the IXGBRMLT macro)
indicates which log blocks were read from DASD. This field is only
valid for IXGBRWSE requests that result in a log block being returned.
For a complete description of the IXGANSAA macro, see z/OS
MVS Data Areas in the z/OS Internet library.