next up previous 372
Next: NBS_FIND_NOTICEBOARD - Find a named noticeboard and return an identifier to it
Up: Description of Individual NBS Routines
Previous: NBS_RESTORE_NOTICEBOARD - Restore a noticeboard definition and data from file and create the noticeboard


NBS_SAVE_NOTICEBOARD - Save a noticeboard to its noticeboard definition file

Description:
Check that the ID is not NIL.
Check that the caller owns the noticeboard.
Check that the noticeboard was restored from a file which has room for the noticeboard data.
Check that the file is open for write access.
Write the noticeboard data to it.

Invocation:
(Int) = NBS_SAVE_NOTICEBOARD (ID,STATUS)

Arguments:

ID = INTEGER (Given)
Identifier of noticeboard or of any item in the noticeboard whose data is to be saved.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID     		 NIL ID 

NBS__CANTOPEN Can't open the definition file
NBS__NOTOWNER Caller does not own the noticeboard
NBS__DATANOTRESTORED Noticeboard data was not restored
from the definition file (so can't save it)

Prior Requirements
None.



next up previous 372
Next: NBS_FIND_NOTICEBOARD - Find a named noticeboard and return an identifier to it
Up: Description of Individual NBS Routines
Previous: NBS_RESTORE_NOTICEBOARD - Restore a noticeboard definition and data from file and create the noticeboard

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