# Synopsis

PDX_MSGT map_DbgSetTracing(int level)

# Purpose

Enables tracing information during mapping.

# Description

Enables the display of tracing information from the map subsystem. Trace information is disabled by default. The tracing information is written to stdout. Various levels of tracing information can be produced as as shown below:

.IP 0 Disables all tracing. .IP 1 Enables display of the database pointer being processed at the top (non-recursive) level of map_DispatchEntity. .IP 2 Same as level 1 plus enables verbose display of mapping process. .LP

For level 1, a line like the following will be displayed for each top level entity being mapped:

.RS 2 .nf *** Mapping #1:10 (0x800000a), dtf: iges:130:0 .fi .RE

This indicates that map_DispatchEntity was called from the application dispatcher or map_DispatchList with the specified entity. Note that recursive calls to map_DispatchEntity will not display any output.

For level 2, an entry like the following will be displayed for each top level entity being mapped:

.RS 2 .nf *** Mapping #1:10 (0x800000a), dtf: iges:130:0 @1 "iges_130_0 -> gdx_offset_curve" db_ptr: #1:10 (0x800000a), orig_db_ptr: 0x800000a dtf: iges:130:0, dst mdl: 0 ** Invoking map_DispatchEntity with #0:1 (0x1) @2 "gdx_offset_curve -> gdx_nurb_curve" db_ptr: #0:1 (0x1), orig_db_ptr: 0x800000a dtf: gdx:6:0, dst mdl: 0 ** Invoking map_DispatchEntity with #0:2 (0x2) @3 "gdx_nurb_curve -> iges_126" db_ptr: #0:2 (0x2), orig_db_ptr: 0x8000009 dtf: gdx:1:0, dst mdl: 2 ** Invoking application dispatcher with #2:10 (0x1000000a) ## Committing #2:10 (0x1000000a) ## Deleting #0:2 (0x2) ## Deleting #0:1 (0x1) .fi .RE

The first line is the same as that generated for level 1. The following lines show information at each recursive invokation of map_DispatchEntity. This information starts with an "@n" which indicates the recursion depth of the mapping (i.e. how many times map_DispatchEntity is on the call stack). A value of 1 indicates that this is the top call to map_DispatchEntity.

Following the depth is the name of the mapping which will be applied to the entity. This is followed by additional information about the entity being mapped. The "dst mdl" field specifies what model the mapped entities will be created in. If the mapping was not enabled with the MAP_COMMIT option, a trace message will be displayed showing if the results are passed to an application dispatcher or to map_DispatchEntity.

If this is the final mapping to be applied to the entity (either the application dispatcher called map_CommitEntity or the mapping was enabled with the MAP_COMMIT option), a line will be printed indicating that the mapping results are being committed to the database. Transient entities that have been deleted are displayed last.

# Input

## level

level of mapping: level = 0 Disables all tracing level = 1 Enables display of Database pointer at top level level = 2 same as one, plus enables verbose display of mapping process

# Return

MAP error code