Trigmon User Guide 8-Jan-2002 (Trigmon V1.2.A) Summary of operation -------------------- Trigmon requests monitoring data samples from TCC and produces a formatted display consisting of a set of background labels and foreground numbers. Trigmon will request a new data sample when requested by the user (with the option of an automatic update). Trigmon can generate several types of display pages where each page type concentrates on a different aspect or resources of the L1 and L2 Framework. A number on a display page can be representing (this is not an exhaustive list): - a raw data sub-field of the current monitoring sample, displayed as an integer, hexadecimal number, a time stamp, or an enumerated value string. - the increment of a data field between the current and a previous data sample - a derived quantity like a rate or a percentage of increment of a data field as compared to the increment of the Beam Crossing Scaler embedded in the same Monitoring data samples (or the increment of another data field). - Note: the data field extracted from the monitoring data can be 1, 2, 4, 8 byte long or can be obtained with an arbitrary bitmask. When a number becomes too big for the alloted field size on the formatted display trigmon will automatically switch to using an exponent in the form of 'k' for kilo, 'M' for Mega, or 'G' for Giga. Whenever the data cannot be displayed (e.g. an enumerated value for which a corresponding string was not given) Trigmon will display a string of stars (e.g. '***') of the same length as the data field. Whenever a non zero reference increment as needed for displaying a rate or a percentage cannot be determined, trigmon will display a string of dashes (e.g. '---') of the same length as the data field. Percentages are treated as a special case and Trigmon will make sure to detect numbers that are exactly 0 and 100%, i.e. where the data increment was exaclty zero, or exaclty equal to the reference increment. - A number that is ROUNDED OFF to 0 % (respecively 100 %) will be represented as a floating point number 0.0 (respecively 100.0) - while a number that is EXACLTY 0 % (respecively 100 %) will be represented as an integer number 0 (respecively 100). This feature allows for noticing whether a source of disable was active nearly all the time, or precisely for every single beam crossing during a particular time increment. Command Line Options -------------------- Command line options are NOT case-sensitive usage: trigmon [-a|g|h|m|s] [-u] [-t ] [-r ] [-h ] [-p ] [-?] -a : Start with Andor Term Display -g : Start with Geographic Section Display -s : Start with Specific Trigger Display -m : Start with Multiple Display = concatenated SpTrg & GeoSect & Andor Term Displays -h : Start with L2 Hardware Scalers Display -u : Start in Auto-Update Mode -t : Specify a time period between successive auto-update samples -r : Specify a file to be overwritten with the output of every display update. -h : Specify a Host Name for TCC monitoring server -p : Specify an ITC Port Number for TCC monitoring server -? : Show this usage information Interactive commands -------------------- Interactive commands are NOT case-sensitive Display Page Selection A : Switch to the Andor Term Summary Display Page G : Switch to the Geographic Section Summary Display Page S : Switch to the Specific Trigger Summary Display Page O : Switch to the Overall Quantities Display Page H : Switch to the L2 Hardware Scaler Display Page M : Switch to the "Multiple" Display Page This is the SpTrg & GeoSect & Andor Term Display Pages used for generated and output suitable for the www display. 0..255 : Switch to the Detailed Display Page for the specified object. This command is valid for SpTrg, GeoSect, and Andor Term Displays only. The allowed range depends on the object type (0..127 for SpTrg & GeoSect Displays and 0..255 for the Andor Term Display) The 'A', 'G', and 'S' and 'M' displays start up using the eTcc_Block_Type_Fw_Info_Brief Monitoring block from TCC. This is the same block type as is used by the DAQ_MONITOR program. See the '&&' command for switching block type. The 'O' display uses the eTcc_Block_Type_Fw_Info_Full Monitoring Data Block Type. The 'H' display uses the eTcc_Block_Type_L2HardScalers Monitoring Data Block Type. Displaying a different page from the same data sample (or scroll the same page) x& (i.e. append '&' to the end of any of the page selection or Scroll commands, as in A&, G&, S&, O&, H&, M&, 0&, ...255& or U&, D&) : This will cause trigmon to switch to the requested display page while using use the same data set (current and previous samples), and without asking TCC for new monitoring data. && : Switch the 'A', 'G', 'S', and 'M' display to use the eTcc_Block_Type_Fw_Info_Full monitoring block instead of the default eTcc_Block_Type_Fw_Info_Brief block as used by the Daq_Monitor program. This command need only to be issued once. Issuing '&&' is a pre-requirement to using the '&' command suffix for switching between any of the Summary and Detail Displays, as they would otherwise be using different, inconsistent monitoring data sets. Screen capture to a file C : Copy current display to a file. No new data is requested from TCC when using this command. The first use of this command will prompt for a file name to open. Subsequent use of this command will offer to change the output file name. If the file already exists, its content will be overwritten. Sending several successive display content to the same file, already open, will cause the data to be appended to the end of the file. Automatic Update AUTO : Switch to Auto-Update Mode where current page is automatically refreshed every 5 seconds (or other time interval specified with 'P' command) P : Specify a new time period between successive auto-update automatic update will automatically stops as soon as a new command is entered. Limiting the display size and "scrolling" up/down D : Scroll page down U : Scroll page up Scrolling here means re-displaying the same page with a different set of body lines. The first use of this command will ask for a screen size. All pages displayed after that will always display the top header summary section of the display, but will only display as many lines of the display body as will fit in the given screen size. Changing the Integration period (as a multiple of the sampling/refresh period) The trigmon engine starts up by using successive samples for the current and previous snapshots from which to derive scaler count increments. These commands let the user increase the sample spread between the current and previous snapshots. Note that when increasing the sample spread, trigmon will ramp up the actual sample spread towards the desired sample spread one sample at a time. The data buffer ring can hold and remember the last 12 samples. +1..11 : Increment... -1..11 : ... or decrement the spread in number of samples between what is used for "Current" and "Previous" data samples. Exit Q : Quit Test and development Options SIZE : Display the size of the various monitoring blocks and components for debugging purposes TEST : Display the "test" page For development and debugging purposes