EssCreateStorageTypedApplication

Creates a new application with the option of data storage mode: block (multidimensional) or aggregate.

Syntax

ESS_FUNC_M EssCreateStorageTypedApplication (hCtx, AppName, StorageType);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
AppName	ESS_STR_T	Name of application to create. See Application Name Limits.
StorageType	ESS_DATA_STORAGE_T	The data storage type of the new application. The valid values for StorageType are: ESS_DEFAULT_DATA_STORAGE ESS_MULTIDIM_DATA_STORAGE—Block storage (multidimensional), the default storage type ESS_ASO_DATA_STORAGE—Aggregate storage

Parameter

Data Type

Description

hCtx

ESS_HCTX_T

API context handle.

AppName

ESS_STR_T

Name of application to create. See Application Name Limits.

StorageType

ESS_DATA_STORAGE_T

The data storage type of the new application.

The valid values for StorageType are:

ESS_DEFAULT_DATA_STORAGE
ESS_MULTIDIM_DATA_STORAGE—Block storage (multidimensional), the default storage type
ESS_ASO_DATA_STORAGE—Aggregate storage

Notes

The new application is created in non-Unicode mode.
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(), EssCreateApplicationEx(), EssCreateStorageTypedApplication(), or EssCreateStorageTypedApplicationEx() to keep subsequent functions, such as EssRestructure(), from operating on the wrong database or application (the application or database that is already active).

Return Value

Returns 0 if successful; otherwise, returns an error.

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);
}