Using the TRACE facility

BMC AMI Datastream 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 Datastream to output specific types of additional diagnostic messages in the CZAPRINT data set. Otherwise, the product 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.

Related topics

Using

TRACE-facility-syntax

The TRACE option might be specified in identical form (except for slight differences in syntax due to the differing command environments) on BMC AMI Datastream and CZASEND OPTIONS-statement, on  CONFIG-statement, on the OPTIONs or a similar statement of several related programs (see the documentation for the specific program), and on the 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.

Example

TRACE(ALL ‑XL ‑ENV) indicates all TRACE output except that the former is related to translation and the operating environment.

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

CICS

Functions related to CICS SMF record type 110 record processing, especially record flattening

COMP

SMF record compression-related processing

CSA

CSA initialization

DB2

(Does not apply to Datastream for Ops)DB2-related processing 

ENV

The z/OS operating environment

FILTER

Filter evaluation, see Troubleshooting-filtering-events

IPADDR

IP address processing

IPGENL

IP general

MEM

Certain memory allocations and deallocations

MEMFLD

Certain memory allocations and deallocations related to Fields

MISC

Miscellaneous

PARMs

Parameters

SQLite statements executed for the VM tables on the BMC AMI Security Policy Manager database.

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)

BMC AMI zAdviser interface processing

To use this type you must enable zAdviser interface processing. For more information, see Sample-CZAGENT-JCL-for-running-BMC-AMI-Datastream-as-a-started-task.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*