TM1DataReservationAcquire

Solicita un DR para un cubo, usuario y tupla específicos de IBM® Cognos® TM1® .

Si ya existe una reserva que es propiedad de un usuario diferente cuya región solapa la reserva solicitada, la solicitud de reserva se rechazará a menos que se utilice el distintivo bForce. Si el distintivo bForce es verdadero y el usuario que ejecuta la API tiene la función DataReservationOverride, las reservas conflictivas se liberarán y se otorgará la reserva nueva.

Sintaxis

TM1DataReservationAcquire(TM1P hPool, TM1V hCube, TM1VhClient, TM1V bForce, TM1V elementArray);

Parámetro

Descripción

hPool

Agrupación de memoria estándar utilizada por todos los comandos de la API.

hCube

Descriptor de contexto del cubo al que desea acceder.

hClient

Propietario que se utilizará para la reserva.

bForce

Valor booleano que determina el comportamiento si la reserva solicitada entra en conflicto con una reserva existente.

Si se establece en 0 (falso), la solicitud se rechaza si entra en conflicto con una reserva existente.

Si se establece en 1 (verdadero), la función reemplaza las reservas conflictivas.

elementArray

Matriz de descriptores de contexto de elementos que definen la tupla; el orden debe coincidir con el de las dimensiones.

Valor de retorno

Valor booleano verdadero si se ha otorgado la solicitud; falso en caso contrario.

Errores posibles

  • TM1ErrorCubeNumberOfKeysInvalid
  • TM1ErrorObjectHandleInvalid
  • TM1ErrorCubeKeyInvalid
  • TM1ErrorObjectSecurityNoReserveRights