tibasMetaspace_AlterSpace()

Alters a specified space definition for a specified metaspace.

Declaration

tibas_status tibasMetaspace_AlterSpace(
    tibasMetaspace metaspace,
    tibasSpaceDef spaceDef)

Parameters

Parameter Description
metaspace Specify the tibasMetaspace object that identifies the metaspace that the spaceDef you want to change is associated with.
spaceDef Specifies the spaceDef object that you want to modify, or if you are adding a new space definition, specifies the new spaceDef.

Remarks

Use the tibasMetaspace_AlterSpace() function to alter a space definition for a specified space. You can add new fields to the space definition; however, any new fields that you specify must be set as nullable.

When you specify the spaceDef object to pass to the function, you can specify an existing spaceDef or specify a new spaceDef.

If the spaceDef that you pass to the function is not defined, then tibasMetaspace_AlterSpace() defines it. If there is an existing spaceDef, then the function attempts to modify the existing one, and if the new space definition is not compatible with the existing one, an exception is generated indicating the cause of the error.

If you are you are calling tibasMetaspace_AlterSpace() to modify an existing spaceDef, then you can use the tibas_spaceDef functions to set up the spaceDef and the tibasFieldDef functions to define the field definitions for the space. Then pass the spaceDef object that you have created to tibasMetaspace_AlterSpace().

See Also

tibasSpaceDef_Create(), tibasSpaceDef_SetName(), tibasSpaceDef_SetReplicationCount(), tibasSpaceDef_SetCapacity(), tibasSpaceDef_SetEvictionPolicy(), tibasSpaceDef_SetLockScope(), tibasSpaceDef_SetKey(), tibasFieldDef_Create(), tibasFieldDef_SetNullable()