Most DASH routines are for internal use only. The following routines may be called by the user.
DASH_DEC_MOD(MODNAM,ENTRYP,SUBROU)
This declares a module named by the character string MODNAM to
have an entrypoint specified by the character string ENTRYP that
is accessed through the address of SUBROU, which should be an
EXTERNAL routine (ENTRY or SUBROUTINE statement).
DASH_DEC_MOD should be called in the user-provided DASH_DECL
subroutine. The string ENTRYP should be one of the following
values (only the first two characters are significant): 'INIT',
'BEGINRUN', 'EVENT', 'ENDRUN', 'BOOK',
'TALK', 'FINI', 'OPEN or 'CLOSE'. Example:
EXTERNAL MYMODULE_EVENT
...
CALL DASH_DEC_MOD('MYMODULE','EVENT',MYMODULE_EVENT)
DASH_DEC_PAT(MODNAME)
This places the module MODNAME in the default analysis path (the
analysis path the executable will start-up with before any PATH
command is given. It may be overridden by a PATH command
given on the DASH command line. DASH_DEC_PAT should be called in the
user-provided DASH_DECL subroutine.
DASH_DEC_FLT(MODNAME)
This turns filtering on for module MODNAME by default. It may be
overridden with FILTER <ON/OFF> commands given on the DASH command
line. DASH_DEC_FLT should be called in the user-provided
DASH_DECL subroutine.
DASH_DEC_REA(MODNAME)
DASH_DEC_WRI(MODNAME)
This declares the module MODNAME to be the default read/write
module. It may be overridden with the commands SET/READ or
SET/WRITE, although this will only be necessary in executables
with more than one possible read-module or write-module (such as
programs which translate between ZEBRA and binary DST files). These
calls should be made in DASH_DECL.
DASH_PASS_EVT()
DASH_FAIL_EVT()
These subroutines are called in the event entrypoint of an analysis
module. DASH_PASS_EVT tells DASH to continue analyzing the event with
the next module. DASH_FAIL_EVT tells DASH to discontinue analyzing
this event and to restart the analysis with the next event. These
actions will be enabled if filtering is turned on (either through
the FILTER ON command or by default with DASH_DEC_FLT. These
actions will be ignored if filtering is off for this module.
INTEGER FUNCTION DASH_PRI_LEV()
This function should be called from within analysis modules.
DASH_PRI_LEV returns an integer equal to the print-level set on
the command line with SET/PRINT command. If the print-level
is greater than zero, the module may print out informative information.
INTEGER FUNCTION DASH_DBG_LEV()
This function should be called from within analysis modules.
DASH_DBG_LEV returns an integer equal to the debug-level set on
the command line with SET/DEBUG command. If the debug-level
is greater than zero, the module may execute alternative code that
is helpful in debugging.
DASH_DEPOSIT(KEYWRD,VALUE)
This function is usually only called by read-modules and write-modules.
It is used to report to tell DASH the current run number (KEYWRD =
'RUN'), event number (KEYWRD = 'EVENT'). Other keywords are:
'TYPREC', the record type; and READOK and WRITOK, which
reports if the i/o for reading or writing an event was successful.
DASH_INQUIRE(KEYWRD,VALUE)
This may be used to ask DASH to report the current run number (KEYWRD =
'RUN') or event number (KEYWRD = 'EVENT').