Using the TRACE facility
BMC AMI Defender and several related programs including CZASEND implement a diagnostic facility called TRACE. The TRACE facility might be used, generally at the direction of BMC Support, as an aid in diagnosing problems. The TRACE facility causes BMC AMI Defender to output specific types of additional diagnostic messages in the CZAPRINT data set.
Otherwise, BMC AMI Defender continues to run normally when TRACE is specified; however, TRACE should not be left switched on indefinitely in production due to the additional overhead and potential for large print volumes.
The TRACE option might be specified in identical form (except for slight differences in syntax due to the differing command environments) on BMC AMI Defender and CZASEND OPTIONs statement (see OPTIONS Statement as previously discussed), on BMC AMI Defender CONFIG statement (see CONFIG statement), on the OPTIONs or a similar statement of several related programs (see the documentation for the specific program), and on the BMC AMI Defender Start and modify commands (see START command and MODIFY command).
If TRACE is completely omitted, then it defaults to the previous state of TRACE; if TRACE is specified with no trace-types or with -ALL then all tracing is turned off.
Specify zero or more of the trace specifications in the following table (in any order). Prefix any of the specifications with - (a minus sign or hyphen) to indicate negation. The specifications are processed left to right.
TRACE types
Wherever TRACE is permitted, it accepts zero or more of the following Trace types:
Type | Diagnostic messages |
---|---|
ALL | All of the trace outputs listed. Use with caution; more trace output is not necessarily better. A high volume of messages might obscure the real problem. ‑ALL (negated ALL) is useful for turning off all enabled traces, whatever they might be. |
AUX | Functions related to Auxiliary programs. See the Auxiliary Statement as previously discussed. |
CICS | Functions related to CICS SMF Type 110 record processing, especially record flattening. |
COMP | SMF record compression-related processing |
CSA | CSA initialization |
DB2 | DB2-related processing |
ENV | The z/OS operating environment |
FILTER | Filter evaluation. See Troubleshooting in Filtering in and filtering out events. |
IPADDR | IP address processing |
IPGENL | IP general |
MEM | Certain memory allocations and de-allocations |
MEMFLD | Certain memory allocations and de-allocations related to Fields |
MISC | Miscellaneous |
PARMs | Parameters |
TAGS | Duplicate tags |
TIMER | Functions related to Timer processing. |
TLS | SSL/TLS-related events |
XDATA | Transmitted data (generates a fairly voluminous number of messages) |
XL | Translation (generates a fairly voluminous number of messages) |
Comments
Log in or register to comment.