Tune Measurement Notes
----------------------

DISPLAY_TUNES
=============

Queries the spectrum analyser in the outer periphery of the Control
Room (CRF 02) to obtain the peaks in the spectrum for the horizontal
and vertical planes and loads the results into the MPM.

To set up for IBS measurements
------------------------------

In a VMS terminal window, type

$ PATH [CESR.DISP_TUNES]
$ COPY CTA_LET_DISPLAY_TUNES_2BETA.INP DISPLAY_TUNES.INP

Make sure that the center frequency and span are set to see both tunes
(have been using center of 235 kHz and span of 40 kHz).  Adjust the
center frequency (by editing DISPLAY_TUNES.INP) or the span (via the
sprectrum analyser front panel) if needed.  The span must be a power
of 2 time a base number for the FFT (?).

To restore conditions at the end of the shift
---------------------------------------------

Delete the new version(s) of DISPLAY_TUNES.INP.  The program will load
the old version of DISPLAY_TUNES.INP when it starts a new measurement
cycle.  (The program should be allowed to continue running.)


TUNE_MON
========

Queries the spectrum analysers in the central Control Room (CRB 15) to
obtain the marker frequencies for the horizontal (or longitudinal) and
vertical planes and loads the results into the MPM.

To set up for IBS measurements
------------------------------

Set up the spectrum analysers to measure the desired peaks.  Make sure
the center and span are suitable for the range of currents to be
measured.  Adjust the bandwidth if needed to get adequate signals.

Turn on peak tracking (under marker function).

In a VMS terminal window, type

$ PATH [CESR.WHH.TUNE_MON]
$ RUN TUNE_MON

If you need to control the spectrum analysers locally, press any key
to stop the program.  After you are finished with local control, turn
peak tracking back on and restart the program.

To restore conditions at the end of the shift
---------------------------------------------

In the VMS terminal window, press any key to stop the program.

Additional Notes
----------------

The program uses the "CSR PROGRMIN" node, elements 31 and 32.  If
another process writes to these elements, problems will ensue.  Hence
the program checks that the values are zero when it starts and sets
the values to zero when it stops.  If the values are not zero when the
program starts, it will not run.  In such an instance, you should
check whether another process is writing to these elements.  If not,
you should set the values to zero and run the program again.

DIMTEL
======

The DIMTEL feedback system takes spectra for all three planes and
tracks the max (or min) frequencies with markers.  A service queries
the DIMTEL parameters, including marker frequencies, and loads the
values into the MPM.

To set up for IBS measurements
------------------------------

In a VMS terminal window, load the appropriate conditions.  At
present, can do this via

$ RESTORE BIGGRP 136571

If you load other conditions that override these (for example, if you
do a Loop), you will need to load the Big Group again.

To restore conditions at the end of the shift
---------------------------------------------

No action needed.


Additional Notes
----------------

If the MPM values are not being updated, the service might need to be
restarted.  To do this, open a Linux control system terminal window
and type

$ service_restart dimread

If this works, inform MJF (e.g. by e-mail) about restarting the
service.  If this does not work, call MJF to request additional
instructions.