tibasMetaspace_RecoverSpaceEx()

Restarts a space that is suspended. Optionally recovers data from persistence files.

Declaration

tibas_status tibasMetaspace_RecoverSpaceEx(
    tibasMetaspace       metaspace,
    const char*          spaceName,
    tibasRecoveryOptions recoveryOptions)

Parameters

Parameter Description
metaspace The TIBCO ActiveSpaces entity on which the function is invoked.
spaceName The space name used by the function.
recoveryOptions This argument is a boolean value.

The default value (TIBAS_TRUE) specifies recovery with data; if you specify TIBAS_FALSE, recovery without data is set.

If you specify recovery with data, data is read from disk when the space is recovered. If you specify recovery without data, the space is recovered, but data is not read from disk.

Remarks

Use the tibasMetaspace_RecoverSpaceEx() function to restart a space that is in the SUSPENDED state and specify options for data recovery.

This is useful if the space has lost data due to the system going down or during system maintenance.

Unlike the tibasMetaspace_RecoverSpace() function, (tibasMetaspace_RecoverSpaceEx() specifies a recovery option. Recovery is possible if the space has been set up with persistence set to shared-all persistence.

If the specified space name is incorrect, the function returns SPACE_NAME_INVALID.