nn::nex::IDGenerator::SetRequestedRangeSize Member Function

Syntax

void SetRequestedRangeSize(
     qUnsignedInt32 uiRangeSize
);

Parameters

Name Description
uiRangeSize [in] Specifies the range of local IDs. When generated by IDGenerator, the ID range is initialized to that specified using SetDefaultRequestedRangeSize. If SetDefaultRequestedRangeSize has not been called even once, a default of 256 is used.

Return Values

None.

Description

Sets the range of IDs that can be requested of a duplication master by a duplica.

All IDGenerator objects (including duplication masters and duplicas) hold a local pool of IDs that can each be used. Before this pool becomes empty (when about 25 IDs have been used), a local pool of new IDs is requested by the duplication master. This function sets the size of the pool. This function can be called by an IDGenerator duplication master or duplica.

If all valid IDs in the ID pool are used up, the station requests the duplication master for a new ID pool. At this time, ID generation (the GenerateID function) blocks for a certain amount of time (an amount of time roughly equivalent to round trip time for communication with the duplication master). The number of times this phenomena occurs can be minimized by increasing the size set here.

See Also

GetRequestedRangeSize, SetDefaultRequestedRangeSize

Revision History

2011/01/27
Initial version.

CONFIDENTIAL