Gets outline information stored on the Essbase Server. There is no requirement to open the outline in query mode before using this function.
Syntax
ESS_FUNC_M EssGetSrvOutlineInfo (hCtx, AppName, DbName, pSvrOutlineInfo);
| Parameter | Data Type | Description |
|---|---|---|
hCtx | ESS_HCTX_T | API context handle. |
AppName | ESS_STR_T | Application name. |
DbName | ESS_STR_T | Database name. |
pSvrOutlineInfo | ESS_SVROTLINFO_T | Pointer to structure containing outline information stored on the Essbase Server. |
Return Value
Returns 0 if successful; otherwise, returns an error.
Example
ESS_FUNC_M ESS_GetSrvOutlineInfo()
{
ESS_STS_T sts = 0;
ESS_INT_T i;
ESS_OBJDEF_T Object;
ESS_APPNAME_T szAppName;
ESS_DBNAME_T szDbName;
ESS_OBJNAME_T szFileName;
ESS_SVROTLINFO_T SvrOutlineInfo;
memset(&Object, '\0', sizeof(Object));
Object.hCtx = hCtx;
Object.ObjType = ESS_OBJTYPE_OUTLINE;
strcpy(szAppName, "Sample");
strcpy(szDbName, "Basic");
strcpy(szFileName, "Basic");
Object.AppName = szAppName;
Object.DbName = szDbName;
Object.FileName = szFileName;
sts = EssGetSrvOutlineInfo (hCtx, szAppName, szDbName, &SvrOutlineInfo);
if (!sts)
{
printf("\nCase sensitivity is set to: %d", (SvrOutlineInfo).fCaseSensitive);
printf("\nOutline type is set to: %d", (SvrOutlineInfo).usOutlineType);
printf("\nOutline allows duplicate names is set to: %d", (SvrOutlineInfo).fNonUniqueName);
printf("\nNumber of alias tables is: %d", (SvrOutlineInfo).usNumAliasTables);
printf("\nNames of the alias tables are:");
for (i= 0; i < (SvrOutlineInfo).usNumAliasTables; ++i)
printf("\n %s", (SvrOutlineInfo).pAliasTables[i]);
}
return sts;
}
The output of the above example is:
Case sensitivity is set to: 0 Outline type is set to: 0 Outline allows duplicate names is set to: 1 Number of alias tables is: 2 Names of the alias tables are: Default Long Names