# Synopsis

(macro) PDX_MSGT mda_ReserveEntity(long option, MDA_PTR *db_ptr)

# Purpose

Reserve a new entity in the current model.

# Description

A database pointer will be reserved for future use. The reserved database pointer can be allocated as an entity by using the MDA_RESERVED option to mda_AllocateEntity, mda_AllocateEntity2, or mda_CreateEntity. Until the entity has been allocated with one of these functions, it will not actually exist in the database. Thus the reserved pointer will not be passed to a function called from mda_TraverseModel and can not be locked or used in any way until it has been allocated.

# Input

## option

Options (not used)

# Output

## db_ptr

The reserved database pointer.

# Return

MDA error code