Description:
Check that the item name is legal.
Copy the current value of the item from the relevant noticeboard.
There is currently only one character item which can be returned.
SAVE_NAME =
Name of noticeboard file (character)
Invocation
(Int) = NBS_GET_CINFO (ID,NAME,VALUE,STATUS)
Arguments
ID = INTEGER (Given)
Identifier of noticeboard or of any item in the relevant noticeboard.
NAME =
CHARACTER()
(Given)
The name of the item to obtain. See the above list. Can be abbreviated
so long as it remains unambiguous but this is not recommended because new
items may be supported in the future. Case is not significant.
VALUE =
CHARACTER()
(Returned)
The item’s value.
STATUS = INTEGER (Given and returned)
The global status.
Possible return values are,
NBS__BADOPTION | Illegal item name |
Prior Requirements
NBS_FIND_NOTICEBOARD must have been called.