next up previous 372
Next: NBS_GET_CHILDREN - Get the number of children of a structured item
Up: Description of Individual NBS Routines
Previous: NBS_GET_PRIMITIVE - Determine whether or not an item is primitive


NBS_GET_PARENT - Get the identifier of an item's parent structure

Description:
Check that the ID is not NIL.
Return the identifier of the item's parent.

If the item has no parent (ie, if it pertains to a noticeboard), then a zero ID will be returned.


Invocation:
(Int) = NBS_GET_PARENT (ID,PARENT,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of the item whose parent is to be got.
PARENT = INTEGER (Returned)
Identifier of item's parent. If the item has no parent then a NIL ID will be returned.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID   		 NIL ID 




next up previous 372
Next: NBS_GET_CHILDREN - Get the number of children of a structured item
Up: Description of Individual NBS Routines
Previous: NBS_GET_PRIMITIVE - Determine whether or not an item is primitive

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