EssPartitionValidateLocal

Description

This routine verifies all partition definitions associated with the database specified by ESS_HCTX_T.

Syntax

ESS_FUNC_M EssPartitionValidateLocal (hCtx, pusValidateResult);

ESS_HCTX_T hCtx;
ESS_PUSHORT_T pusValidateResult;

Parameters

hCtx Essbase API context handle.
pusValidateResult Result of partition validation.

Return Value

Returns zero if the function completes successfully; error code if the function completes unsuccessfully. Returns zero if the function operates on a database with no partition definition.

Notes

pusValidateResult can be one of these values:

Access

A call to this function requires database designer access privileges.

Example

ESS_STS_T ESS_PartitionValidateLocal(ESS_HCTX_T hCtx)
{
   ESS_STS_T    sts = ESS_STS_NOERR;
   ESS_USHORT_T usValidateRes = (ESS_USHORT_T)ESS_DDB_VERIFY_NOERR;
   
   sts = EssPartitionValidateLocal(hCtx, &usValidateRes);
   
   if (!sts) 
   {
      switch (usValidateRes)
      {
      case ESS_DDB_VERIFY_WARNING:
         printf("Validation resulted in warning(s) - see server log for details\n");
         break;
      case ESS_DDB_VERIFY_ERROR:
         printf("Validation resulted in error(s) - see server log for details\n");
         break;
      default:
         printf("\nPartition(s) validated\n");
         break;
      }
   }
   else
   {
      printf("Call to EssPartitionValidateLocal() failed.\n");
   }

   return (sts);
}

See Also

Constant and Structure Definitions for Partitions
EssPartitionApplyOtlChangeFile()
EssPartitionApplyOtlChangeRecs()
EssPartitionCloseDefFile()
EssPartitionFreeDefCtx()
EssPartitionFreeOtlChanges()
EssPartitionGetAreaCellCount()
EssPartitionGetList()
EssPartitionGetOtlChanges()
EssPartitionGetReplCells()
EssPartitionNewDefFile()
EssPartitionOpenDefFile()
EssPartitionPurgeOtlChangeFile()
EssPartitionPutReplCells()
EssPartitionReadDefFile()
EssPartitionReadOtlChangeFile()
EssPartitionReplaceDefFile()
EssPartitionResetOtlChangeTime()
EssPartitionValidateDefinition()
EssPartitionWriteDefFile()