## 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:

- 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)

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()