# EsbPartitionValidateDefinition

Description

EsbPartitionValidateDefinition() verifies the local partition definition (specified by ESS_PPARTSLCT_VALIDATE_T) against the corresponding partition definition in pRemoteDDBFilename on the remote server.

Syntax

    EsbPartitionValidateDefinition (hCtx, pSelectVerify, pszDefFile, pInvalidComponentCount, InValidComponentsHandle, pRemoteDDBFileName)

    ByVal hCtx As Long
    ByRef pSelectVerify As ESB_PARTSLCT_VALIDATE_T
    ByVal pszDefFile As String
    ByRef pInvalidComponentCount As Long
    ByRef InValidComponentsHandle As Long
    ByVal pRemoteDDBFileName As String

Parameters

hCtx | Essbase API context handle.
pSelectVerify | Description of the partition to verify.
pszDefFile | Identifier for the definitions file.
pInvalidComponentCount | Number of errors and warnings resulting from validation.
InValidComponentsHandle | List of errors and warnings resulting from validation.
pRemoteDDBFileName | Remote server partition definition file name.

Return Value

Returns zero if successful; error code if unsuccessful.

Notes

- Call the function EsbFree() to free the invalid component when pulInvalidComponent is not 0.
- The remote partition definition file can reside locally or on the remote host. If the partition definition file is local, pRemoteDDBFileName must specify the full path, including the file name with extension. If the partition definition file is remote, pRemoteDDBFileName must specify the file name without extension (the extension is assumed to be .DDB).
- The server uses the following rule to find the partition definition file on the system:
  - If pSelectVerify->pszFileName = DbName, the server looks for DbName.DDN.
  - If pSelectVerify->pszFileName != DbName, the server looks for pSelectVerify->pszFileName.DDB.

Access

A call to this function requires database designer access privileges.

Example

See Also

EsbPartitionApplyOtlChangeFile
EsbPartitionApplyOtlChangeRecs
EsbPartitionCloseDefFile
EsbPartitionFreeDefCtx
EsbPartitionFreeOtlChanges
EsbPartitionGetAreaCellCount
EsbPartitionGetList
EsbPartitionGetOtlChanges
EsbPartitionGetReplCells
EsbPartitionNewDefFile
EsbPartitionOpenDefFile
EsbPartitionPurgeOtlChangeFile
EsbPartitionPutReplCells
EsbPartitionReadDefFile
EsbPartitionReadOtlChangeFile
EsbPartitionResetOtlChangeTime
EsbPartitionReplaceDefFile
EsbPartitionValidateLocal
EsbPartitionWriteDefFile