tibasMetaspace_GetSpace()

Attempts to join a metaspace or get a reference to a currently joined metaspace. Returns a Space object.

Declaration

tibas_status tibasMetaspace_GetSpace(
    tibasMetaspace         metaspace,
    tibasSpace*            space,
    const char*            spaceName,
    tibas_distributionRole distributionRole)

Parameters

Parameter Description
metaspace Specifies a Metaspace object that identifies the metaspace to join.
space The returned Space object.
spaceName The name to be assigned to the space when the metaspace is joined.
distributionRole The distribution role to join the space as. Can be one of the following: 
TIBAS_DISTRIBUTION_ROLE_LEECH
TIBAS_DISTRIBUTION_ROLE_SEEDER

Remarks

Use the tibasMetaspace_GetSpace() function to join a specified space and specify a distribution role for the space member.

The distribution role can be one of the following:

TIBAS_DISTRIBUTION_ROLE_SEEDER
Specifies that the space member is a seeder—an application that participates in the storing of data in the space, and can read and write data. When seeder applications join or leave the space, ActiveSpaces redistributes the data in the space as necessary to maintain even data distribution.
TIBAS_DISTRIBUTION_ROLE_LEECH
Specifies that the space member is a leech—an application that passively participates in the space and does not read and write data or cause redistribution of space data when it joins or leaves the space.

See Also

tibasMetaspace_GetSpaceEx()