EssSetEasLocation

Set or change the Essbase Administration Server location that will be registered with Shared Services upon application creation or migration.

Syntax

ESS_FUNC_M EssSetEasLocation (hCtx, EasLocation);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
EasLocation	ESS_STR_T	The name (or IP address) and port number of the computer on which Essbase Administration Server runs. Examples: Aspen:10080 127.0.0.1:10080

Parameter

Data Type

Description

hCtx

ESS_HCTX_T

API context handle.

EasLocation

ESS_STR_T

The name (or IP address) and port number of the computer on which Essbase Administration Server runs. Examples:

Aspen:10080
127.0.0.1:10080

Notes

After changing the Essbase Administration Server location, you must use EssReRegisterApplication to re-register any existing applications with Shared Services.

Return Value

Returns 0 if successful; otherwise, returns an error.

Access

This function requires the caller to be an Administrator.

Example

ESS_FUNC_M ESS_SS_SetEasLocation(ESS_HCTX_T  hCtx, ESS_HINST_T hInst)
{
   ESS_STS_T         sts = ESS_STS_NOERR;
   ESS_STR_T         easLoc = ESS_NULL;
   
   /* Eas Location */
   sts = EssAlloc(hInst, sizeof(ESS_PATHLEN), &easLoc);
   if(sts)
      return (sts);        
   memset(easLoc, 0, sizeof(ESS_PATHLEN));
   strcpy( easLoc, "localhost:10080");   
   
   sts = EssSetEasLocation(hCtx, easLoc); 

   if (sts)
      printf("Failed to set EAS Location.\n");

   if (easLoc)
      EssFree(hInst, easLoc);

   return (sts);   
}