Returns info of about a remote EDMdatabase from a thick EDMclient. The info returned is;
The database version number.
The database block size.
The maximum number of models that may be stored in the database.
The EDMdatabase needs not be open when this function is invoked.
The main purpose of this function is to enable retrieval of this info from an EDMdatabase that cannot be opened due to incompatible block sizes and/or incompatible database versions within the EDMinterface of the EDMserver and the remote EDMdatabase.
If an EDMdatabase cannot be opened due to incompatible block sizes, the block size of the EDMserver must be set equal to that of the remote EDMdatabase.
If an EDMdatabase cannot be opened due to incompatible database versions, the remote EDMdatabase must be dumped by the EDMinterface of an EDMserver that supports the remote EDMdatabase version. Then it must be restored by the EDMinterface of the new EDMserver. For details, see the EDMsupervisor commands Database>Dump and Database>Restore
When using the edmiRemoteGetDatabaseVersion on EDMdatabases older than version 4.7, the returned maxModelsInDB will be zero. This is because this feature was not implemented until version 4.7.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteGetDatabaseVersion (SdaiServerContext serverContextId,
SdaiString location,
SdaiString databaseName,
SdaiInteger *databaseVersion,
SdaiInteger *databaseBlockSize,
SdaiInteger *maxModelsInDB,
SdaiInvocationId *edmiInvocationId);
Arguments:
serverContextId |
Context identification, from edmiDefineServerContext |
location |
The full path to the directory where the remote database files are located on the remote _EDMserver{_}. |
databaseName |
The name of the remote _EDMdatabase{_}. _EDMdatabase_ names are case sensitive on UNIX platforms and case insensitive on Windows platforms. |
databaseVersion |
A variable that will receive the version number of the remote _EDMdatabase{_}. |
databaseBlockSize |
A variable that will receive the block size of the remote _EDMdatabase{_}. |
maxModelsInDB |
A variable that will receive the maximum number of models that may coexist in the remote EDMdatabase. |
edmiInvocationId |
Currently not used. |
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:
. . .