EssReRegisterApplication

Re-establishes one or all Essbase applications as Shared Services applications.

Syntax

ESS_FUNC_M EssReRegisterApplication (hCtx, AppName, AllApps);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
AppName	ESS_STR_T	Name of application to reregister.
AllApps	ESS_BOOL_T	If ESS_TRUE, all applications are reregistered; otherwise, only the named application is reregistered.

Return Value

Returns 0 if successful; otherwise, returns an error.

Access

This function requires the caller to be an Administrator, Application Manager, or Database Manager. For any applications for which the caller does not have sufficient permissions, the re-registration will be skipped with a warning.

Example

ESS_FUNC_M ESS_SS_ReRegisterApplication(ESS_HCTX_T  hCtx, ESS_HINST_T hInst)
{
   ESS_STS_T         sts = ESS_STS_NOERR;
   ESS_BOOL_T        allApps;
   ESS_STR_T         appName = ESS_NULL;

   sts = EssAlloc(hInst, sizeof(ESS_APPNAME_T), &appName);
   if(sts)
      return (sts);        
   memset(appName, 0, sizeof(ESS_APPNAME_T));
   strcpy( appName, "Sample");   
   
   /* Do you want All applications re-registered? 
    * Enter ESS_TRUE for Yes 
    *       ESS_FALSE for No 
    **/
   allApps = ESS_FALSE; /* Re-registering only 1 application */

   sts = EssReRegisterApplication(hCtx, appName, allApps); 

   if (sts)
      printf("Failed to Re-register Application %s.\n", appName);

   if (appName)
      EssFree(hInst, appName);

   return (sts);   
}