Summary

The fesxctl program is used to control the FES system from an external system. It can be used to initiate, start, pause and terminate runs, as well as show the status of a run. It can display the contents of the message log file. It can also wait for the next PPS signal, to allow correct timing of a run start.

Synopsis

fesxctl command options parameters

Commands

The commands that can be executed by the program are listed below. Each may be abbreviated to its shortest unique form.

initrun	Initialize a run
startrun	Start a run
pause	Pause a run
termrun	Terminate a run
showrun	Show the status of a run
ppswait	Wait until the next PPS signal has arrived
logdisp	Display the contents of the message log file
help	Show usage information about commands

Options

The possible options and the commands that use them are described below. If multiple options conflict, the last one specified is used.

-A acd-path	ACD path (0 = primary, 1 = redundant) to use in run	initrun
-a	Display data for all sides of each board shown	showrun
-b	Display data for all boards in the system	showrun
-C	Use external clock during run	startrun
-c cfg-file	The configuration file name (if not default)	all
-d dist-type	The event time distribution type (default 0)	initrun
-E	Use external control to start run	startrun
-f format	The format version number (default 0)	gen
-g	Flag gamma events	initrun
-i intvl	The interval (50 ns units) between events (default 20K)	initrun
-m detc-mask	Use only boards with set bits in detc-mask	initrun
-n	Generate event numbers	initrun
-o oneshot	The trigger lines one-shot value (default 3)	initrun
-P	Don't start run until the next PPS signal	startrun
-p proc-cnt	The number of events or lines to process in the file	initrun, logdisp
-R	Report end of run to external system	startrun
-r rept-cnt	The number of times to repeat the file (default 0)	initrun
-S	Respond to CALSTROBE signal; needed for calibration run	initrun
-s skip-cnt	The number of events or lines to skip at the start of the file	initrun, logdisp
-t	Display information on the remote server instead of locally	showrun
-v	Display memory levels as values instead of percentages	showrun
-x expn-fctr	The intra-event time expansion factor (default 0)	initrun

Parameters

The possible parameters and the commands that use them are:

file-stem	The name of the file stem to be used. This is the absolute path name (no node or disk name) with the file type omitted.	initrun
command	The command name or its unique abbreviation.	help
timeout	The optional timeout (seconds). Defaults to 1.	ppswait

Detailed Command Descriptions

initrun [-ngS] [-c cfg-file] [-m detc-mask] [-i intvl] [-x expn-fctr] [-o one-shot] [-r rept-cnt] [-s skip-cnt] [-p proc-cnt] [-d dist-type] [-A acd-path] file-stem
	Initializes a run using the set of data files specified by file-stem. The set of boards to be used may be restricted via the -m option; the other boards in the system generate null data. Other options specify various parameters of the run.
startrun [-ECRP] [-c cfg-file]
	Starts a run that has been initialized or paused.
pauserun [-c cfg-file]
	Pauses a run that has been started.
termrun [-c cfg-file]
	Terminates a run.
showrun [-abtv] [-c cfg-file]
	Shows the status of a run.
ppswait [-c cfg-file] [timeout]
	Waits until the arrival of the next PPS signal.
logdisp [-c cfg-file] [-s skip] [-p proc]
	Displays the contents of the message log file. If the skip value is negative, the display starts that number of lines from the end of the file, instead of the beginning.
help [command]
	If command is specified, summarizes it. Otherwise gives a brief summary of all commands.