next up previous 372
Next: NBS_PUT_TRIGGER - Specify a routine to be called whenever a primitive item is updated
Up: Description of Individual NBS Routines
Previous: NBS_PUT_SIZE - Put a new size to a primitive item associated with a specified identifier


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 item's 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



next up previous 372
Next: NBS_PUT_TRIGGER - Specify a routine to be called whenever a primitive item is updated
Up: Description of Individual NBS Routines
Previous: NBS_PUT_SIZE - Put a new size to a primitive item associated with a specified identifier

NBS The Noticeboard System
Starlink User Note 77
D.J. Allan
11 September 1995
E-mail:ussc@star.rl.ac.uk