somEnvironmentNew

From EDM2
Jump to: navigation, search

This function initializes the SOM runtime environment.

Syntax

SOMClassMgr    rc;
rc = somEnvironmentNew();

Parameters

rc (SOMClassMgr)
A pointer to the single class manager object active at run time. This class manager can be referred by the global variable SOMClassMgrObject.

Return Code

Remarks

This function creates the four primitive SOM objects (SOMObject, SOMClass, SOMClassMgr, and SOMClassMgrObject) and initializes global variables used by the SOM run-time environment. This function must be called before using any other SOM functions or methods (with the exception of somSetExpectedIds). If the SOM run-time environment has already been initialized, calling this function has no harmful effect.

Although this function must be called before using other SOM functions or methods, it needn't always be called explicitly, because the New macros, the Renew macros, the new operator, and the NewClass procedures defined by the SOM C and C++ language bindings call somEnvironmentNew if needed.

Related

Functions