Activating, Deactivating, and Querying Traces

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

Syntax: How to Activate CA-IDMS Data Adapter 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. You can also identify a ddname to associate with the trace. The syntax is one of the following

SET TRACEON = IDMSR [/ level] 

SET TRACEON = IDMSR / [level] [/ [ddname] ]  

where:

IDMSR

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

level

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

ddname

Is the ddname to be used. If omitted, any ddname previously associated with the trace level during the session is used. If no ddname has been associated with a trace level, the default ddname is used. The default ddname for level 1 is FSTRACE. The default ddname for level 2 is FSTRACEP. If both trace levels are activated, both types of trace information appear in the trace output.

Example: Activating the CA-IDMS Data Adapter Trace Facility

The following command turns on traces for all levels of the IDMSR component and uses their current ddnames. If no ddname has been specified, it uses the default ddnames:

SET TRACEON = IDMSR

The following example turns on the level 2 trace and associates it with the current ddname. If no ddname has been specified, it uses the default ddname, FSTRACEP:

SET TRACEON = IDMSR/2

The following example turns on the level 1 trace and associates it with ddname SYSPRINT:

SET TRACEON = IDMSR/1/SYSPRINT

Syntax: How to Deactivate CA-IDMS Data Adapter Traces

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

SET TRACEOFF = [IDMSR]  [ / level ] 

SET TRACEOFF = [IDMSR]  [ // ddname  ] 

where:

IDMSR

Indicates that the command applies to traces for the CA-IDMS Data Adapter. If omitted, the command applies to all components.

level

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

ddname

Turns off the trace levels associated with ddname.

Example: Deactivating CA-IDMS Data Adapter Traces

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

SET TRACEOFF = IDMSR/1

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

SET TRACEOFF = IDMSR

The following command turns off all traces allocated to ddname FSTRACE for all components:

SET TRACEOFF = //FSTRACE

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 = ?

(FOC1180) Name     Level DDName   Description          Set  Filedef  Active
(FOC1180) IDMSR     1    FSTRACE  IDMS The Calls Only  Y    Y        Y     
(FOC1180) IDMSR     2    FSTRACEP IDMS The Parameters  Y    Y        Y