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)