This routine verifies the partition definition specified by ESS_PPARTSLCT_VALIDATE_T.
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 host 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_STR_T hostname, appname, dbname, filename;
ESS_USHORT_T usType,usdir;
ESS_USHORT_T rLoc;
ESS_PARTSLCT_VALIDATE_T SelectVerify;
ESS_PARTDEF_INVALID_T *pInvalidComponent;
ESS_ULONG_T ulInvalidComponentCount = 0;
ESS_STR_T pRemoteDDBFileName = "remotedb";
memset(&SelectVerify, 0, sizeof(ESS_PARTSLCT_VALIDATE_T));
rLoc = ESS_FILE_SERVER;
filename = "Src1";
hostname = "local";
appname = "App1";
dbname = "Trg1";
usType = ESS_PARTITION_OP_LINKED;
usdir = ESS_PARTITION_DATA_SOURCE;
SelectVerify.usLoc = rLoc;
SelectVerify.pszFileName = filename;
SelectVerify.Partition.usType = usType;
SelectVerify.Partition.usDirection = usdir;
SelectVerify.Partition.HostDatabase.pszHostName = hostname;
SelectVerify.Partition.HostDatabase.pszAppName = appname;
SelectVerify.Partition.HostDatabase.pszDbName = dbname;
sts = EssPartitionValidateDefinition (hCtx, &SelectVerify,
&ulInvalidComponentCount, &pInvalidComponent, &RemoteDDBFileName);
printf("EssPartitionValidateDefinition sts: %ld\n",sts);
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()