next up previous 372
Next: TIME Time Noticeboard Operations
Up: Demonstration Programs
Previous: Demonstration Programs


NBTRACE -- Trace Noticeboard Contents

NBTRACE lists the contents of a noticeboard definition file or of an active noticeboard.

The name of the definition file (assumed extension .NBD) or of a noticeboard item can be given as a command line parameter and will be prompted for if it is not given. The program first attempts to find the noticeboard and if that fails (because the noticeboard doesn't exist) it attempts to restore the noticeboard from the definition file. Then it locates the specified item and lists it and all items below it. VMS-style wild cards can be used. Thus

    $ nbtrace gct.ifl.enq*

might result in the following

    Noticeboard data not restored because it was not saved
    STRUC    IFL (140)  
       _CHAR    ENQ_DEV_DESCR   (0/132/0) 
       _CHAR    ENQ_DEV_TYPE    (0/132/0) 
       _CHAR    ENQ_VER_DATE    (0/132/0) 
       _CHAR    ENQ_VER_NUM     (0/132/0)

and

    $ nbtrace gct.fits.*.x

is a useful trick to suppress listing of lower level items (on the assumption that none of them are called X).

    Noticeboard data not restored because it was not saved
    STRUC   FITS (15)       
       DRT_STRUCT   ALT_OBS (3)     
       DRT_STRUCT   COMMENT (2)     
       DRT_STRUCT   HAEND (3)       
       DRT_STRUCT   HASTART (3)     
       DRT_STRUCT   INSTRUME (3)    
       DRT_STRUCT   LAT_OBS (3)     
       DRT_STRUCT   LONG_OBS (3)    
       DRT_STRUCT   OBJECT (3)      
       DRT_STRUCT   ORIGIN (3)      
       DRT_STRUCT   RUN (3) 
       DRT_STRUCT   SPEED (3)       
       DRT_STRUCT   UTDATE (3)      
       DRT_STRUCT   WINDOW (3)      
       DRT_STRUCT   ZDEND (3)       
       DRT_STRUCT   ZDSTART (3)

When no item name is given, general information about the noticeboard's size and owner is given, as in

    $ nbtrace words
    Software version   = 5 (5)
    Size of section    = 1080 (438)
    Size of definition = 1080 (438)
    Noticeboard owner  = 2959 (b8f)
    Modified count     = 0 (0)

    NOTICEBOARD WORDS (9)
       WORD     BROWN   (0/0/0)
       WORD     DOG     (0/0/0)
       WORD     FOX     (0/0/0)
       WORD     JUMPS   (0/0/0)
       WORD     LAZY    (0/0/0)
       WORD     OVER    (0/0/0)
       WORD     QUICK   (0/0/0)
       WORD     THE     (0/0/0)
       WORD     THE     (0/0/0)



next up previous 372
Next: TIME Time Noticeboard Operations
Up: Demonstration Programs
Previous: Demonstration Programs

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