NEWFIRM OBSERVATION HEADER SYSTEM (NOHS)
----------------------------------------

DRAMA Streams and Commands

History
-------
v1.0.0:
 - 29-Jan-2004 P. N. Daly (pnd@noao.edu)
 - original version

Instrument File (nohs.inst)
---------------------------
nohs
nohs DRAMA nohs enable

Dictionary (nohs.dict)
----------------------
ready		0
wait		1
resume		0
pause		0
break		0 -cmd pause
breakPoint	0
abort		0
title		1
set		2
iadd		2
fadd		2
nohs_endobs	0 -t nohs -tout 10 -put nohs_msd -end ready
nohs_exit	0 -t nohs -tout 10
nohs_getmd	1 -t nohs -tout 10 -get nohs_gmd
nohs_help	0 -t nohs -tout 10
nohs_init	0 -t nohs -tout 10
nohs_newobs	0 -t nohs -tout 10 -get nohs_msd -end ready
nohs_setmd	1 -t nohs -tout 10
nohs_status	0 -t nohs -tout 10
nohs_version	0 -t nohs -tout 10
endDictionary

Test EXEC (nohs.exec)
---------------------
nohs_init
nohs_help
nohs_status
nohs_version
nohs_newobs
ready
nohs_setmd GDRUPDAT=2.0
nohs_setmd F8FOCUS=12528.0
nohs_setmd tcs.dome.status=vignette
nohs_getmd DOMESTAT
nohs_getmd tcs.time.st
nohs_getmd tcs.dome.status
nohs_setmd tcs.dome.status=vignette
nohs_endobs
ready
nohs_newobs
ready
nohs_endobs
ready

Notes
-----

Actions
-------

All tasks support exit, help, status and version commands in a generic
way. All tasks also support a specific init command which must be
executed prior to other commands being issued. Also see the section
"Test EXEC" above.

The named DRAMA actions give the following results:

 Action(s):
  Dtcl> drama::obey nohs_endobs
 Result:
  Stops an observation and flushes meta data to disk
  
 Action(s):
  Dtcl> drama::obey nohs_getmd tcs.instrument.name
 Result:
  Gets an item of meta data (in this case GWC stream tcs.instrument.name)
  
 Action(s):
  Dtcl> drama::obey nohs_newobs
 Result:
  Start new observation and return unique star date
  
 Action(s):
  Dtcl> drama::obey nohs_setmd ASTRONOM="Phil Daly"
 Result:
  Sets an item of meta data (in this case FITS header ASTRONOM)