EssPartitionValidateLocal

Verifies all partition definitions associated with the database specified by ESS_HCTX_T.

Syntax

ESS_FUNC_M EssPartitionValidateLocal (hCtx, pusValidateResult);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
pusValidateResult	ESS_PUSHORT_T	Result of partition validation.

Notes

pusValidateResult can be one of these values:

ESS_DDB_VERIFY_ERROR (validation resulted in errors)
ESS_DDB_VERIFY_FAIL (validation failed)
ESS_DDB_VERIFY_NOERR (all partitions are valid)
ESS_DDB_VERIFY_WARNING (validation resulted in warnings)

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.

Access

A call to this function requires database designer access privileges.

Example

ESS_FUNC_M ESS_PartitionValidateLocal(ESS_HCTX_T hCtx)
{
   ESS_FUNC_M    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);
}