Problem Determination using the Internal Trace Facility

IOA provides an internal Trace facility that can print internal trace records and the contents of internal data areas. Under normal circumstances, the Trace facility is dormant. However, if required (that is, BMC Customer Support has requested trace information), the Trace facility can be activated.

To use the Control‑M internal Trace facility, issue the following operator command:

where level indicates trace levels to be activated or deactivated. The Control‑M Trace facility has 128 levels (that is, from 1 through 128). Any number of these levels can be on at a given time. Valid values are

• x – Trace level to turn on
  Example: TRACE=3 turns on trace level 3.
• ‑x – Trace level to turn off
  Example: TRACE=‑3 turns off trace level 3.
• (x:y) – Range of trace levels to turn on, where x is the first level in the range and y is the last level in the range.
  Example: TRACE=(1:10) turns on trace levels 1 through 10.
• (‑x:‑y) – Range of trace levels to turn off, where x is the first level in the range and y is the last level in the range.
  Example: TRACE=(‑1:‑10) turns off trace levels 1 through 10.
• (x,y,z,...) – Multiple trace levels to turn on.
  Example: TRACE=(3,5,29) turns on trace levels 3, 5 and 29.
• (‑x,‑y,‑z,...) – Multiple trace levels to turn off.
  Example: TRACE=(‑3,‑5,‑29) turns off trace levels 3, 5 and 29.
• SHOW – Shows the current status of all trace levels.

Depending on which trace levels were turned on, trace information is written to one or more of the following locations:

• DD statement DATRACE of the Control‑M procedure
• DD statement DADUMP of the Control‑M procedure.
• SYSDATA of the Control‑M started task

When you finish performing the problem determination procedures, use the following operator command to turn off all trace levels:

Control‑M performance trace data can also be accumulated and processed in conjunction with the IOA Internal Trace facility. For more information, see Chapter 2, "IOA Administration."