next up previous 372
Next: Defining the Noticeboard Contents
Up: NBS The Noticeboard System
Previous: Terminology

Examples of Using the NBS Routines

This section takes the form of a tutorial. Starting with a listing of a noticeboard contents, we present the calls necessary to define that noticeboard, to put the required values into it and for another process to access those values.

Suppose that we wish to create and access a simple noticeboard. We will use as an example a subset of the noticeboard that is maintained by the AUTOFIB control software. The notation used is the same as that used by the NBTRACE (Trace Noticeboard) program (see Section C.1) -- each structure entry is of the form:

    type name (children)

and each primitive entry is of the form:

    type name[(maxd) dim1,dim2...] (actb/maxb/mod) val1,val2,...

with appropriately indented entries. The shape information is shown only if the maximum number of dimensions (maxd) is greater than zero. The three slash-separated numbers are actual number of bytes, maximum number of bytes and modified count.

The result of running NBTRACE on this noticeboard might be:

    Software version   = 5 (5)
    Size of section    = 13284 (33e4)
    Size of definition = 8952 (22f8)
    Noticeboard owner  = 405 (195)
    Modified count     = 2 (2)

    NOTICEBOARD AUTOFIB (3)
        _CHAR            CURRENT_CONFIG         (18/132/2) "current.fib"
        CURRENT_STATUS   CURRENT_STATUS[(1) 72] (0/4608/0)
        FIBRE_PARAMETERS FIBRE_PARAMETERS (1)
            _INTEGER     TRANS_MATRIX[(2) 2,2]  (16/16/2)  1,0,0,1





next up previous 372
Next: Defining the Noticeboard Contents
Up: NBS The Noticeboard System
Previous: Terminology

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