EssGetSrvOutlineInfo

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);
ParameterData TypeDescription

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