next up previous 372
Next: NBS_INC_MODIFIED - Increment the noticeboard modified count or an item modified count depending on whether this is a structured or
Up: Description of Individual NBS Routines
Previous: NBS_PUT_SHAPE - Put a new shape to a primitive item associated with a specified identifier


NBS_PUT_SIZE - Put a new size to a primitive item associated with a specified identifier

Description:
Check that the ID is not NIL and that it pertains to a primitive item.
Check that the caller owns the noticeboard (or WORLD_WRITE is TRUE).
Check that the item is large enough to be the proposed size.
Increment the item's modified count.
Update the internal record of the item's size.
Increment the item's modified count again.
Increment the noticeboard modified count.

The item and noticeboard modified counts will not be incremented if INCREMENT_MODIFY is FALSE.


Invocation:
(Int) = NBS_PUT_SIZE (ID,NBYTES,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of the item which the shape is to be put.
NBYTES = INTEGER (Given)
new item size in bytes.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID   		 NIL ID 

NBS__NOTPRIMITIVE Item is not primitive
NBS__NOTOWNER Caller does not own the noticeboard
NBS__TOOMANYBYTES NBYTES is greater than item size



next up previous 372
Next: NBS_INC_MODIFIED - Increment the noticeboard modified count or an item modified count depending on whether this is a structured or
Up: Description of Individual NBS Routines
Previous: NBS_PUT_SHAPE - Put a new shape 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