EssListSSMigrFailedGroups

Displays groups that did not successfully migrate to Shared Services.

Syntax

ESS_FUNC_M EssListSSMigrFailedGroups (hCtx,  count, pNativeUserList);

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	API context handle.
count	ESS_PUSHORT_T	Address of variable to receive count of migration failed groups.
pNativeUserList	ESS_PPUSERNAME_T	Address of pointer to receive an allocated array of migration failed groups.

Notes

If Essbase has not been migrated to Shared Services, this function is not supported and returns an error.

Return Value

Returns 0 if successful; otherwise, returns an error.

Example

ESS_FUNC_M ESS_SS_ListSSMigrFailedGroups(ESS_HCTX_T  hCtx, ESS_HINST_T hInst)
{
   ESS_STS_T         sts = ESS_STS_NOERR;
   ESS_PUSERNAME_T   pNativeUserList = NULL;
   ESS_USHORT_T      Count = 0,
                     index;
   
   sts = EssListSSMigrFailedGroups(hCtx, &Count, &pNativeUserList);

   if (!sts)
   {
      if (Count && pNativeUserList)
      {
         printf ("\n------- Group List -------\n\n");

         for (index = 0; index < Count; index++)
         {
            if (pNativeUserList[index])
               printf ("%s\n", pNativeUserList[index]);
         }

         EssFree(hInst, pNativeUserList);
      }
      else
         printf("\nGroup list is empty\n\n");
   }
   else
      printf("Failed to get Shared Services migration failed Groups list.\n");

   return (sts);   
}