Customizing the Path to the Essbase CLIENT Directory

The API uses the CLIENT directory to store any local application or database related files (such as database outlines or report scripts). The directory structure within the CLIENT directory mirrors that of the \Appdirectory on the Essbase Server. Each application has its own sub-directory, and within each application sub-directory, each database in that application has a separate sub-directory. The list of applications and databases need not match that of any particular server.

Although the structure of the application and database sub-directories is fixed, you can customize the client directory under which the application directories are created.

Setting the Local Path Field of the Initialization Structure

The primary way to set the client directory path is to explicitly set the LocalPath field in the API initialization structure to point to a string indicating the full path name of the CLIENT directory. This setting causes the API to look in this directory for all client application and database related files. For example, to set the CLIENT directory to D:\PRODUCT\CLIENT, make the following change to the initialization structure: ESS_INIT_T InitStruct;Initstruct.LocalPath = "D:\PRODUCT";

For Visual Basic, Dim pInit as eSB_INIT_TpInit.LocalPath="D:\PRODUCT"

A secondary way to set the client directory path is to set LocalPath to NULL. By default, Essbase then uses the ESSBASEPATH environment variable to determine the path to the CLIENT directory.