# Synopsis

PDX_MSGT map_InvokeMapping(char *name, MDA_PTR db_ptr, MAP_INFO *info)

# Purpose

Invokes the specified mapping.

# Description

The mapping specified by name will be invoked. The given mapping must be a defined component of a given conditional mapping. Thus the name specified must exist within the definition of a conditional mapping. Conditional mappings are defined under the guidelines listed within the map_DefineConditionalMapping documentation. Alternatively, conditional mappings may be defined directly using the function map_DefineConditionalMapping. Attempting to call map_InvokeMapping on a mapping that is not a component of a conditional mapping is totally unsupported and will produce an error.

# Input

## name

Mapping to be invoked (MUST BE A DEFINED COMPONENT OF A CONDITIONAL MAPPING)

## db_ptr

Entity to be dispatched

## info

The mapping information structure

# Return

MAP error code