next up previous 372
Next: NBS_PUT_SIZE - Put a new size to a primitive item associated with a specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_PUT_CVALUE - Put a character string into a slice of a primitive item associated with a specified identifier


NBS_PUT_SHAPE - Put a new shape 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 has enough potential dimensions to accept all of the supplied dimensions.
Increment the modified count for this item.
Copy the dimensions to the noticeboard.
Increment the modified count once more.
Increment the noticeboard modified count.

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


Invocation:
(Int) = NBS_PUT_SHAPE (ID,NDIMS,DIMS,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of the item which the shape is to be put.
NDIM = INTEGER (Given)
Number of dimensions to be put.
DIMS = INTEGER(*) (Given)
Dimensions to be put.
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__TOOMANYDIMS NDIMS is greater than item max dims



next up previous 372
Next: NBS_PUT_SIZE - Put a new size to a primitive item associated with a specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_PUT_CVALUE - Put a character string into a slice of 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