next up previous 372
Next: NBS_GET_NAME - Get the name of an item associated with the specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_GET_UPDATED - Determine whether a primitive item or the noticeboard has been updated since the noticeboard was found or this


NBS_GET_POINTER - Return a pointer to the first byte of the data of a primitive item associated with the specified identifier

Description:
Check that the ID is not NIL and that it pertains to a primitive item.
Return the address of the start of the item's noticeboard data.

Invocation:
(Int) = NBS_GET_POINTER (ID,POINTER,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of the item for which the pointer to its noticeboard data is to be got.
POINTER = INTEGER (Returned)
The address of the first byte of this item's noticeboard data.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID   		 NIL ID 

NBS__NOTPRIMITIVE Item is not primitive



next up previous 372
Next: NBS_GET_NAME - Get the name of an item associated with the specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_GET_UPDATED - Determine whether a primitive item or the noticeboard has been updated since the noticeboard was found or this

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