Activating, Deactivating, and Querying Traces

How to:

Each trace is assigned a level and must be associated with a component name. For the Adapter for CA-IDMS, the component name is IDMSR.

Prior to activating a trace, you must issue the SET TRACEUSER=ON command. You can issue this request at the command level, in a FOCEXEC, or in any supported profile.
Top of page
x
Syntax: How to Enable or Disable Trace Activation
SET TRACEUSER = {ON|OFF}

where:

ON

Must be issued prior to activating any trace.

OFF

Prevents trace activation.
Top of page
x
Syntax: How to Activate Adapter for CA-IDMS Traces

You can activate both trace levels or one specific trace level with the SET TRACEON command. You can issue this request at the command level, in a FOCEXEC, or in any supported profile. You must issue this command prior to running the request for which you want the trace generated. The syntax is 

SET TRACEON = IDMSR /[level]/{CLIENT|FSTRACE}

where:

IDMSR

Indicates that the command applies to traces for the Adapter for CA-IDMS.

level

Is an integer that identifies the trace level to activate. Valid values are 1 and 2. If omitted, all trace levels are activated.

CLIENT

Sends trace output to the screen.

FSTRACE

Sends trace output to data set allocated to DDNAME FSTRACE.
Example: Activating the Adapter for CA-IDMS Trace Facility

The following command turns on traces for all levels of the IDMSR component and sends them to the terminal: 

SET TRACEON = IDMSR //CLIENT

The following example turns on the level 2 trace and sends it to the file allocated to DDNAME FSTRACE:

SET TRACEON = IDMSR/2/FSTRACE
Top of page
x
Syntax: How to Control Trace Timestamps

By default, a timestamp is prepended to each line of trace output. You can turn off the trace timestamps using the SET TRACESTAMP command. 

SET TRACESTAMP = {ON|OFF|TLEFT}

where:

ON

Prepends a timestamp to each line of trace output.

OFF

Omits the timestamp from the trace output.

TLEFT

Prepends a timestamp to each line of trace output. Includes microseconds in the timestamp.
Top of page
x
Syntax: How to Deactivate Adapter for CA-IDMS Traces

You can deactivate all trace levels or one specific trace level with the SET TRACEOFF command. The syntax is 

SET TRACEOFF = {IDMSR|ALL}  [/level]

where:

IDMSR

Indicates that the command applies to traces for the Adapter for CA-IDMS.

ALL

Deactivates all traces.

level

Deactivates the specified trace level.
Example: Deactivating Adapter for CA-IDMS Traces

The following command turns off trace level 1 for the Adapter for CA-IDMS: 

SET TRACEOFF = IDMSR/1

The following command turns off all traces for the Adapter for CA-IDMS:

SET TRACEOFF = IDMSR

The following command turns off all traces:

SET TRACEOFF = ALL
Top of page
x
Syntax: How to Query Traces

The trace query commands tell you which trace levels are either activated or deactivated for every component. Be aware that these commands may show information that does not pertain to IDMS.

To list all of the trace level/component combinations currently active, issue the following command:

SET TRACEON = ?

To list all of the trace level/component combinations not currently active, issue the following command:

SET TRACEOFF = ?

Note: Be aware that this command may produce a voluminous display listing information about components in which you have no interest.
Example: Querying Traces
 
SET TRACEON = IDMSR
>  > SET TRACEON = ?
Name     Level Description                       Set  Comp.ID
IDMSR     1    IDMS Basic Traces                             
IDMSR     2    IDMS Extended Traces
Information Builders