Customizing the Run-Time Environment

The Essbase API allows you to customize access to some of the API features, so you can integrate these features with your programs. Besides customizing the memory management and message handling, you can customize the items described in the these topics:

You can change each of these paths by passing an entry into the appropriate field of the Essbase API initialization structure when you call EsxInit(). Because you can change these paths, you can install these directories and files anywhere you like and rename them if you desire.

You might want to place the files associated with your program in a specific directory. If this is the case, you should set these paths explicitly in ESX_INIT_T.

An alternative to setting the paths explicitly is to rely on the user's ESSBASEPATH and ARBORMSGPATH environment variables. When you call EsxInit(), the API can define the paths in the initialization structure based on the root directory of any pre-existing Essbase files (ESSBASEPATH) or on ARBORMSGPATH.