next up previous 372
Next: NBS Error Codes
Up: Description of Individual NBS Routines
Previous: NBS_GET_INFO - Get general non-character information on a given noticeboard


NBS_GET_CINFO - Get general character information on a given noticeboard

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__NILID   		 NIL ID 

NBS__BADOPTION Illegal item name

Prior Requirements
NBS_FIND_NOTICEBOARD must have been called.



next up previous 372
Next: NBS Error Codes
Up: Description of Individual NBS Routines
Previous: NBS_GET_INFO - Get general non-character information on a given noticeboard

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