EssPartitionValidateDefinition() verifies the local partition definition (specified by ESS_PPARTSLCT_VALIDATE_T) against the corresponding partition definition in pRemoteDDBFilename on the remote server.
ESS_FUNC_M EssPartitionValidateDefinition (hCtx, pSelectVerify, pulInvalidComponent, ppInvalidComponent, pRemoteDDBFileName);
ESS_HCTX_T | hCtx |
ESS_PPARTSLCT_VALIDATE_T | pSelectVerify |
ESS_PULONG_T | pulInvalidComponent |
ESS_PPPARTDEF_INVALID_T | ppInvalidComponent |
ESS_STR_T | pRemoteDDBFileName |
hCtx | Essbase API context handle. |
pSelectVerify | Description of the partition to verify. |
pulInvalidComponent | Number of errors and warnings resulting from validation. |
ppInvalidComponent | List of errors and warnings resulting from validation. |
pRemoteDDBFileName | Remote server partition definition file name. |
Returns zero if successful; error code if unsuccessful.
A call to this function requires database designer access privileges.
ESS_STS_T ESS_PartitionValidateDefinition(ESS_HCTX_T hCtx, ESS_HINST_T hInst) { ESS_STS_T sts = 0; ESS_PARTSLCT_VALIDATE_T SelectVerify; ESS_PARTDEF_INVALID_T *pInvalidComponent; ESS_ULONG_T ulInvalidComponentCount = 0; ESS_STR_T pRemoteDDBFileName = "src"; /* assume, logged into target database */ memset(&SelectVerify, 0, sizeof(ESS_PARTSLCT_VALIDATE_T)); SelectVerify.usLoc = ESS_FILE_SERVER; SelectVerify.pszFileName = "trg"; SelectVerify.Part.usType = ESS_PARTITION_OP_REPLICATED; SelectVerify.Part.usDirection = ESS_PARTITION_DATA_TARGET; SelectVerify.Part.HostDatabase.pszHostName = "Local" SelectVerify.Part.HostDatabase.pszAppName = "PartSrc"; SelectVerify.Part.HostDatabase.pszDbName = "Src"; sts = EssPartitionValidateDefinition (hCtx, &SelectVerify, &ulInvalidComponentCount, &pInvalidComponent, pRemoteDDBFileName); if (ulInvalidComponentCount > 0) printf("Validation resulted in warnings and errors.\n"); else printf ("Partition is valid.\n"); if (pInvalidComponent) EssFree(hInst, pInvalidComponent); return(sts); }
Constant and Structure Definitions for
Partitions
EssPartitionApplyOtlChangeFile()
EssPartitionApplyOtlChangeRecs()
EssPartitionCloseDefFile()
EssPartitionFreeDefCtx()
EssPartitionFreeOtlChanges()
EssPartitionGetAreaCellCount()
EssPartitionGetList()
EssPartitionGetOtlChanges()
EssPartitionGetReplCells()
EssPartitionNewDefFile()
EssPartitionOpenDefFile()
EssPartitionPurgeOtlChangeFile()
EssPartitionPutReplCells()
EssPartitionReadDefFile()
EssPartitionReadOtlChangeFile()
EssPartitionReplaceDefFile()
EssPartitionResetOtlChangeTime()
EssPartitionValidateLocal()
EssPartitionWriteDefFile()