CreatePersObject

CreatePersObject(CX_xxxxx), CreatePersObject(CX_xxxxx, pattern)

Parameter: Class identifier, inheritance BitPattern

CreatePersObject(STACK), CreatePersObject(STACK, pattern)

Parameter: BitPattern for inheritance

An object is generated in the database (in the persistent memory). The database layout definition in CLASSIX.INI defines, in which segment the object will be stored and which collection will include it. All settings by SetLayer, SetDomain(WRITE) and SetPattern are decisive (see image). For this command call, the second parameter - pattern - can overdrive the settings made in CLASSIX.INI / with SetPattern.

There can be multiple different object clustering strategies activated in the ClassiX^® system. Rules define, whether an object will be master- or a slave object.

Master objects know their database location. For slave objects, it takes an already saved object, which it is connected to via relations, to determine database location.

For slave objects, object creation gets delayed: CreatePersObject creates a CX_LAZY_CREATOR object. The "correct" persistent object gets created only after the CX_LAZY_CREATOR object has been connected to another one, e.g. with statements such as SetReference, Insert, etc..

To move an as CX_LAZY_CREATOR instantiated object before statements SetReference, Insert, etc., please use the object manager function Instantiate.

After all clustering strategies have been deactivated, there are only master objects.