# EssCreateStorageTypedApplication

Description

EssCreateStorageTypedApplication() creates a new application with the option of data storage in Multidimensional or Aggregate Storage mode. Refer also to EssCreateApplication().

Syntax

    ESS_FUNC_M EssCreateStorageTypedApplication (hCtx, AppName, StorageType);

ESS_HCTX_T | hCtx
ESS_STR_T | AppName
ESS_DATA_STORAGE_T | StorageType

Parameters

hCtx | Essbase API context handle.
AppName | Name of application to create. Application names can be 8 characters long, and can contain all special characters allowed in DOS file names. No spaces, commas, tabs, slashes, backslashes, or periods are allowed. The use of some special characters is not recommended because they are often used by the operating system (for example, @, $, %, and &).
StorageType | The data storage type of the new application. The valid values for StorageType are : ESS_DEFAULT_DATA_STORAGE ESS_MULTIDIM_DATA_STORAGE - Multi-Dimensional, the default storage type ESS_ASO_DATA_STORAGE - Aggregate Storage

Return Value

None.

Notes

- The new application is created in non-Unicode mode. Unicode mode is not supported for Aggregate Storage applications.
- Creating a client application creates a directory to contain local application files.
- A newly created database or application is not automatically set to active. Call EssSetActive() after calling EssCreateDatabase(), EssCreateApplication() or EssCreateStorageTypedApplication() to keep subsequent functions, such as EssRestructure(), from operating on the wrong database or application (the application or database that is already active).

Access

For a server application, the caller must have Application Create/Delete/Edit privilege (ESS_PRIV_APPCREATE).

Example

    ESS_FUNC_M
    ESS_CreateASOApp (ESS_HCTX_T  hCtx)
    {
       ESS_FUNC_M          sts = ESS_STS_NOERR;
       ESS_STR_T           AppName;
       AppName = "Sample";
       sts = EssCreateStorageTypedApplication (hCtx, AppName, ESS_ASO_DATA_STORAGE);
       return(sts);
    }

See Also

EssCreateApplication()
EssCreateDatabase()
EssCreateObject()