Synopsis

PDX_MSGT map_ProcessEntity(long option, MDA_PTR db_ptr, MAP_INFO *info)

Purpose

Process a mapped entity.

Description

This function is called to process the entities generated by mapping functions. Processing of db_ptr depends on several conditions. If an application dispatcher is defined, it will be invoked with db_ptr. The application dispatcher can then elect to commit the entity by calling map_CommitEntity and can then further modify the entity. See the map_CommitEntity function for a description of the saving operation.

If an application dispatcher is not defined and info->mapping was enabled with MAP_COMMIT, the entity is not mapped any further (the MAP_COMMIT flag indicates that the entity is to be saved and not mapped any further). The function map_CommitEntity will be called with the entity to perform the saving operation. If the application dispatcher is not defined and info->mapping was not enabled with MAP_COMMIT, map_DispatchEntity will be invoked with db_ptr.

If the dispatcher does not call map_CommitEntity, db_ptr will be recursively deleted unless the MAP_NO_DELETE option is specified.

See the map_intro manual page for restrictions on db_ptr.

Input

option

MAP_NO_DELETE

Do not delete db_ptr after it has been processed.

db_ptr

Entity to be mapped

info

The mapping information structure

Return

MAP error code