edmiGetDatabaseVersion

EdmiError edmiGetDatabaseVersion(SdaiString  location,
                                  SdaiString  databaseName,
                                  SdaiInteger *databaseVersion, 
                                  SdaiInteger *databaseBlockSize,
                                  SdaiInteger *maxModelsInDB)

This function returns information about an EDMdatabase. The database may be either open or closed when invoking the function. When creating an EDMdatabase, the block size is the only configuration parameter that needs to be set by the user. Later, that block size must allways be used when addressing the database. The block size of an EDMdatabase will be returned by this function. Some EDM updates introduce changes in the way internal data is organized in the EDMdatabase. Such changes will result in database incompatibility. To open an EDMdatabase, one must ensure that the version of EDM is compatible with the database. Database versions are identified by a version sequence number. That version number will be returned by this function.If the EDMdatabase cannot be opened due to incompatible database versions, the actual EDMdatabase must be dumped by an EDMserver/EDMinterface that supports the actual EDMdatabase version, and then restored by the actual running EDMserver/EDMinterface.  Some users may need an EDMdatabase that allows creating a very high number of models. Others may need few models, but a huge number of instances within each model. To taylor such features, a special version of EDM must be generated by EPM. Databases generated by such special EDM versions will be incompatible with mainstream EDM versions. This function will return the maximum number of models that may be created in a database.   This number must match that of your EDM Version.

Arguments


TypeNameComment
SdaiString

Location

The path to the directory where the database is located. The <location> must be specified as an absolute path of the actual EDMserver. The <location> argument can be specified with and without the directory delimiter character as the last character in the directory path. The directory delimiter character is '\' on the Windows platforms and '/' on the Unix platforms.

SdaiString

databaseName

Name of the EDMdatabase.

SdaiInteger

databaseVersion

Address of a variable that will receive the EDMdatabase version identifier of the specified EDMdatabase.

SdaiInteger

databaseBlockSize

Address of a variable that will receive the database block size of the specified EDMdatabase.

SdaiInteger

maxModelsInDB

Address of a variable that will receive the maximum number of models in the specified EDMdatabase.

Return Value


Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options


 

Example


 

 EdmiError rstat;
 SdaiString location = "D:
databases";
 SdaiString databaseName = "PDM";
 SdaiInteger dataBaseVersion, databaseBlockSize, maxModelsInDB;
 . . .
 if (rstat = edmiGetDatabaseVersion(location,
 databaseName,
 &dataBaseVersion, 
 &databaseBlockSize,
 &maxModelsInDB)) {
 /* Error in operation */
 printf("\nError: %s in edmiGetDatabaseVersion \n", 
 edmiGetErrorText(rstat)); 
 goto error; 
 }
 printf("\nVersion: %d, BlockSize: %d, Max Models: %d\n",
 dataBaseVersion, databaseBlockSize, maxModelsInDB);
 . . .

 

See also

Filter by label

There are no items with the selected labels at this time.