HowTo Run the Mags Program.

	written on 5/30/2003 by zms

	This note outlines how to start the spectrometer magnets control program, mags.
	It pertains to the new mags program, which requests io operations to be performed
	by the ioserv program.  ioserv runs on esagpib and performs ios requested by
	the following three programs: DAQCntrl, HV, and mags.  It performs io operations
	on CAMAC modules.  The CAMAC system is interfaced to the esagpib computer via
	a gpib interface.  Note that the executable file name is mags whereis its "networking"
	name is DAQMAGB (this name was chosen for backward compatibility in DAQCntrl).
	In other words, if you look in a list of processes with the ps command you will
	see it as mags, however if you look which processes are connected to netserv program,
	you will see it as DAQMAGB.

	To launch the mags program you need to:
	1. login as esaexp on a linux computer,
	2. type the runmags command.

	Note that if the mags program is already running on the computer on which you are
	attempting to run it, your attempt will fail and the message
	 "mags is already running, no action taken"
	will be displayed.  This is a limited protection only.
	It is important that only one instance of the mags program configured to connect
	to ioserv on esagpib is running on any computer.  Multiple mags programs
	issuing commands to ioserv to control the magnets circuits will cause trouble.

	This is an interactive program.  The visuals of the program consist of a number of
	display and dialog windows.  The program is commanded to perform action with
	the mouse clicks and input from keyboard.  "Online" help is available, which is
	accessed by pressing Help push buttons in most display and dialog windows, which
	are part of the mags interactive program.

	The program is configured from a number of setup files.  Two of these files are of
	interest to an average operator: setup.dat and mags.dat.  The first of the two
	contains setup data which configures the mags program for the actions it is to
	perform.  In this file the location of the log file, initial states of some of
	the toggle buttons, and how to connect to the ioserv and netserv program are
	specified.  The second of the two files, has the data which defines components
	for all magnet circuits to be used.