ESS_APPINFO_T

This Application Info Structure returns information about a specific application. Fields in this structure cannot be modified using the API. See the ESS_APPSTATE_Tstructure, which contains additional application state parameters that can be modified. The fields are:

Note:

Refer also to the locale-specific extended Application Info structure, ESS_APPINFOEX_T.

typedef struct  ESS_APPINFO_T
{
   ESS_APPNAME_T      Name;                  
   ESS_SVRNAME_T      Server;                
   ESS_USHORT_T       Status;                
   ESS_USHORT_T,      AppType;
   ESS_CHAR_T,        AppLocale, ESS_LOCALESTRING_LENGTH;
   ESS_USHORT_T       nConnects;             
   ESS_TIME_T         ElapsedAppTime;        
   ESS_USHORT_T       nDbs;                  
   ESS_DATA_STORAGE_T StorageType;
   ESS_DBNAME_T       DbNames[1];            
} ESS_APPINFO_T, *ESS_PAPPINFO_T, **ESS_PPAPPINFO_T;
Data TypeFieldDescription
ESS_APPNAME_TNameThe application name
ESS_SVRNAME_TServerThe server name
ESS_USHORT_TStatusThe application load status (loaded or not loaded). This field can contain the following values:
  • ESS_STATUS_NOTLOADED

  • ESS_STATUS_LOADING

  • ESS_STATUS_LOADED

  • ESS_STATUS_UNLOADING

ESS_USHORT_TAppTypeThe type of application. Valid values are:
  • ESS_APP_UNICODE - 0x0003 - The program is a Unicode client program. The function fails if the server is not in Unicode mode. This is the default value.

  • ESS_APP_NONUNICODE - 0x0002 - The program is a non-Unicode mode client program.

ESS_CHAR_TAppLocaleThe application locale description, of type ESS_LOCALESTRING_LENGTH.
ESS_USHORT_TnConnectsThe number of users currently connected to the application
ESS_TIME_TElapsedAppTimeElapsed number of seconds since application loading
ESS_USHORT_TnDbsThe number of databases in this application
ESS_DATA_STORAGE_TStorageTypeThe storage type. The valid values are:
  • 0 - the default

  • 1 - multidimensional

  • 2 - DB2 relational

  • 3 - Oracle relational

  • 4 - aggregate storage (ASO)

  • 1000 - Undefined

ESS_DBNAME_TDbNames [1]A dynamic array (with nDb elements) of database name strings listing all the databases in the application.