Activating the internal Trace facility

The IOA Online Monitor and each of the INCONTROL products has its own operator commands that initiate the internal Trace facility. Some products also differentiate between which operator commands are issued, depending on whether the product's monitor is active or inactive. For information on initiating the Trace facility for an INCONTROL product, see the chapter that discusses that product.

For example, to initiate the internal Trace facility in Control‑M, enter the command

F CONTROLM,TRACE=level

Similarly, to initiate the internal Trace facility for the IOA Online Monitor, enter the command

F IOAOMON,TRACE=level

In such a command, level is the list of trace levels to be activated or deactivated. Each INCONTROL product has different numbers of levels. For example, the Control‑M Trace facility has 128 levels (that is, from 1 through 128, inclusive).

Numbers are used to activate or deactivate the trace. Positive numbers activate the trace; negative numbers deactivate the trace. Valid level values are

any number between 1 and that product's maximum number of levels, or a range of numbers, such as 10:15, to activate the trace. The level is added to the levels already set.
any number between -1 and the negative value of that product's maximum number of levels, or a range of numbers, such as -20:-25, to deactivate the trace. The level is removed from the active levels.

The following table gives examples of how to specify the levels that are on or off:

Table 83 Examples of turning Trace levels on and off

Level	Example
x	Trace level to turn on.
x	Example: TRACE=3 turns on trace level 3.
‑x	Trace level to turn off.
‑x	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.
(x:y)	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.
(‑x:‑y)	Example: TRACE=(‑1:‑10) turns off trace levels 1 through 10.
(x,y,z,...)	Multiple trace levels to turn on.
(x,y,z,...)	Example: TRACE=(3,5,29) turns on trace levels 3, 5 and 29.
(‑x,‑y,‑z,...)	Multiple trace levels to turn off.
(‑x,‑y,‑z,...)	Example: TRACE=(‑3,‑5,‑29) turns off trace levels 3, 5 and 29.

When the trace level set is completed, the following messages are displayed on the console, along with other product-specific messages (depending on the parameters specified):

IOAD01I TRACE LEVELS SET AS FOLLOWS:

IOAD02I 00nn:00mm – TURNED on or off

Parent Topic

Internal Trace facility