DMCREATECELL(5ICD)

NAME
dmCreateCell - create a new cell in the DDM system

SYNOPSIS

#include "dmincl.h"
DM_CELL *dmCreateCell (dmproject, cell, view)
DM_PROJECT *dmproject;
char *cell, *view;

PARAMETERS
is a valid DM_PROJECT as obtained from dmOpenProject. names the cell which has to be created. is the view in which the new cell has to be created. Valid views (as pre-defined in "dmincl.h") are:
LAYOUT - the layout view.
CIRCUIT - the circuit view.
SYSTEM - the system view.
CURRENT
- the current view as maintained by the DDM environment.

DESCRIPTION
Function dmCreateCell() must be used when an application has created an object which has to be stored as a new cell. It returns a cell access key. A 'scratch' node will be created where the information can be stored.

DIAGNOSTICS
If the call is successful, dmCreateCell() returns a pointer to a structure of type DM_CELL. If dmCreateCell() fails NULL will be returned, after a call to function dmError() is done, and dmerrno will be set to indicate the error.
This might happen in the following cases: Bad cell name given. Unknown view specified. Cell already exists in the specified view. Cannot execute system call, mkdir of cell directory.

SEE ALSO
dmCheckOut(5ICD).