Most DASH routines are for internal use only. The following routines may be called by the user.
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:
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.
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.
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.
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.
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.
This may be used to ask DASH to report the current run number (KEYWRD = 'RUN') or event number (KEYWRD = 'EVENT').