Delete all scratch instances of the specified schema, i.e., all scratch instances of entities defined in the actual Express schema.
Scratch instances are volatile instances that will never be written to the persistent EDMdatabase. No persistent instances can have relations to a scratch instance, but a scratch instance can have relations to persistent instances.
Scratch instances belongs to a session, hence scratch instances cannot be shared by concurrent users of an EDMdatabase.
All scratch instances created in a session will be permanently deleted when the actual session is closed or the database is closed.
Related functions: edmiCreateScratchInstance , edmiCreateScratchInstanceAndPutAttrs , edmiCreateScratchInstanceAndPutAttrsBN , edmiCreateScratchInstanceBN , edmiDeleteAllScratchInstancesOfSchema, sdaiDeleteInstance
Header:
#include "sdai.h"
Prototype:
EdmiError edmiDeleteAllScratchInstancesOfSchemaBN(SdaiSchema schemaName);
Arguments:
schemaName |
Name of an Express schema existing as a dictionary model in an EDMdatabase. All scratch instances defined by entities in the <schemaName> Express schema will be permanently deleted. Schema names are case insensitive. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0 : Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
EXAMPLE
EdmiError rstat;
...
if (rstat = edmiDeleteAllScratchInstancesOfSchemaBN ("Pdm_Schema")) {
/* Error in operation */
printf("\nError in edmiDeleteAllScratchInstancesOfSchema: %s\n",
edmiGetErrorText(rstat));
goto error;
}
. . .