Synopsis

PDX_MSGT mda_DeleteBackPtrs(long option, MDA_PTR db_ptr)

Purpose

Delete backpointer references.

Description

Backpointer references to db_ptr will be removed from the backpointer lists for all entities referenced from db_ptr. This function must be used with care as it simply deletes the reference from the referenced entity back to db_ptr. The reference in db_ptr is left unchanged so it will reference an entity which does not have db_ptr in its backpointer list. Entities which are referenced from db_ptr but have been deleted are simply ignored.

Note that this function traverses db_ptr. This means that db_ptr MUST be a properly initialized entity (count fields set properly and PTR fields initialized to either MDA_NULL_PTR or a valid database pointer). This can be done by either invoking mda_DefaultEntity after allocating an entity or by explicitly initializing the entity in the application.

Input

option

Options (not used)

db_ptr

Entity to remove backpointer references to

Return

MDA error code