When changing filters, slits, etc., on ESI, you will need to then reconfigure the database with information on the new positions: name, raw position, and ordinal position, generally. To do this log in as the esieng account and select the "ESI Configuration Tool" menu item under "ESI Control Menu" on the desktop pull-down menu. If you start this tool from the command line you must be logged onto koki as esieng. Then set your DISPLAY environment variable and type "inconfig -s esi".

The "inconfig" tool will pop up on your screen. There are two lines of buttons at the top (we will come back to these) and a table below. The table is actually two separate tables: the three columns under ``Default Settings'' are a separate table from the rightmost four columns, which are the ``Current Settings''. Ignore the Deafult Settings table!

• First, use the top left button (``Pick a Stage'') to select the appropriate wheel. The upper wheel is ``SLMSK'', the middle is ``APMSK'', and the lower is ``DWFIL''. The table will probably update with the new stage parameters.

• Next, identify any items which have been removed. Note that individual holders may contain one or more than one filter or slit. The echelle slit holder contains 6 slits and 2 pinholes, or 8 total named settings. Identify the names of the settings (``positions'') which correrspond to the slot (1 through 5) you are removing. It can help here to type "configure stage" on a koki xterm here. "Stage" should be one of upper, middle, lower, tvfoc, or tvfil. The output will contain all named positions, the raw values, and the holder value. This lets you see which named positions are in which holder.

• Once the names to be removed are determined, click the ``Edit Detentes'' button in the top row to activate it. Then click the ``Drop'' buttons in the rightmost column of the table to remove only the named positions you have identified.

• To add positions for the new holder you have inserted you must calculate the raw positions.
  Table 1. RAW positions for the centers of the five holders in each wheel

  Wheel	Slot 1	Slot 2	Slot 3	Slot 4	Slot 5
  upper	74,170	173,290	272,410	371,530	470,650
  middle	24,750	123,870	222,990	322,100	421,230
  lower	45,640	144,760	243,880	343,000	442,120

  This table assumes 99,120 raw counts between slot positions, so the formula is:

  C(i) = C(1) + 99,120 x (i-1)

  for the center of slot i. C(1) is the center of slot 1, which varies from wheel to wheel.

  To calculate other positions:

  3-up (2x2-inch) holder	add and subtract 17,200 for the outer positions
  2-up (4x4-inch) holder	add and subtract 17,200 for the two positions. (In this case there is no center position.)
  facility filter	subtract 8000 from the nominal position

• Type in the new names and raw encoder positions. Make sure that each named position has a unique Detente number. The Detente numbers and raw numbers do not have to be in the same order.

• Once you have the new filters/slits defined, click ``Drop'' on all of the remaining unused name slots that have `???'' in them.

• Commit the changes by clicking the button ``Commit Stage'' on the right side of the second row of buttons.

• Once all the stages have been modified (assuming that there is more than one), reconfigure the database by clicking ``Config Dispatcher'' on the right side of the top row of buttons.

• After this process completes you will see a message at the bottom of the window asking you to restart the dispatcher. Under ``Engineering'' on the desktop pull-down menu select ``Restart Dispatcher 0''.

• Click the ``Quit'' button on inconfig.

• If you have Dashboard running, you should quit and restart it so that it reads the new values.

ESI Master
7 February 2000