NBS_INC_MODIFIED

Increment the noticeboard modified count or an item modified count depending on whether this is a structured or primitive item

Description:

Check that the ID is not NIL.
Check that the caller owns the noticeboard (or WORLD_WRITE is TRUE).
If the item is structured increment the noticeboard modified count.
If the item is primitive increment the items modified count.

Note that this is a very dangerous routine when called on behalf of primitive items. Calls to it must be paired. Any reader of an item will time out if the modified count for the item being read is an odd number.

Invocation

(Int) = NBS_INC_MODIFIED (ID,STATUS)

Arguments

ID = INTEGER (Given)
Identifier of the item whose modified count is be incremented.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,
NBS__NILID NIL ID

NBS__NOTOWNER Caller does not own the noticeboard