NBS_RESTORE_NOTICEBOARD

Restore a noticeboard definition and data from file and create the noticeboard

Description:

Open the file and determine the noticeboard size.
Create the noticeboard.
Read the file into the noticeboard.
Write the calling process’ id to the noticeboard to denote ownership and mark the noticeboard as being valid.
Close the file.
If the file only contained the definition and not the noticeboard, return a warning status.

If the noticeboard already existed, NBS__SECTIONEXISTED status is returned and the calling process becomes its owner.

Invocation

(Int) = NBS_RESTORE_NOTICEBOARD (NAME,SAVE_NAME,STATUS)

Arguments

NAME = CHARACTER∗(∗) (Given)
The name to give the noticeboard.
SAVE_NAME = CHARACTER∗(∗) (Given)
The name of the file from which to read the definition (with a default file type of .NBD)
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,
NBS__CANTOPEN Can’t create the definition file

NBS__CANTREAD Can’t read the definition file

NBS__BADVERSION Wrong version in definition file

NBS__SECTIONEXISTED Noticeboard of this name already

existed.

NBS__DATANOTSAVED Noticeboard data not saved to the

definition file, so not restored

SS$_* System service codes from SYS$CRMPSC or

SYS$DELTVA (VMS only).

Prior Requirements

None.