next up previous 372
Next: NBS_GET_POINTER - Return a pointer to the first byte of the data of a primitive item associated with the specified
Up: Description of Individual NBS Routines
Previous: NBS_GET_MODIFIED_POINTER - Get a pointer to the noticeboard modified count or an item modified count depending on whether this is


NBS_GET_UPDATED - Determine whether a primitive item or the noticeboard has been updated since the noticeboard was found or this routine was last called

Description:
Check that the ID is not NIL.
If the item is structured get the noticeboard modified count.
If the item is primitive get the item's modified count.
Return TRUE (1) if the modified count is greater than the count the last time that this routine was called.
Return FALSE (0) otherwise.
Remember the modified count for next time.

For structured items, always use the same ID, since the remembered count is associated with the ID and not with the noticeboard.


Invocation:
(Int) = NBS_GET_UPDATED (ID,UPDATED,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of the item for which to determine whether it has been updated since the last call on its behalf.
UPDATED = INTEGER (Returned)
Whether updated (1) or not (0).
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID   		 NIL ID 




next up previous 372
Next: NBS_GET_POINTER - Return a pointer to the first byte of the data of a primitive item associated with the specified
Up: Description of Individual NBS Routines
Previous: NBS_GET_MODIFIED_POINTER - Get a pointer to the noticeboard modified count or an item modified count depending on whether this is

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