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.