How to use BdbConfigBrw to update keys/aliases
=============================================

1) go to a online test release directory, and type 
   srtpath
   ir2boot

2) start BdbConfigBrw executable

3) the maps you are mainly interested in, for DAQ operations, are:
   
    Top->BdbConfigTopMap   : list of keys used for data taking/calibration
    Orc->BdbConfigAliasMap : list of aliases (run types) used for
                             data taking/calibration. Each alias corresponds
                             to a key from Top->BdbConfigTopMap list.
    Orc->BdbConfigMap:Orc  : list of Orc maps
        
    You should know that:
   a)  each top map key for physics runs looks like

                         top
                          |
           ----------------------------------
           |     |    |      |    |    |    |
          svt   dch  drc    ifr  emc  Orc  trig  

   b) each top map key for calibration runs looks like

                         top
                          |
                     ----------
                     |        |
                    subsys   Orc

    c) each Orc map key looks like

                          Orc
                           |
                  -------------------
                  |        |        |
              OrcCycle OrcConfigP OrcCPMask  
       
       where OrcCycle  : cycle xtc file with steps for dataflow
             OrcConfigP: contains crate mask, trigger mask
             OrcCPMask : contains component proxy mask

    d) each subsystem map key points to keys for FED, ODF config, etc..

4) To insert a new object in the ir2 Orc database you need to type:

    for OrcConfigP and OrcCPMask: OrcConfigPWriter -s Orc
    
    for OrcCycle  : createFileIdentifier Orc OrcCycle name_of_cycle_xtc
    
5) The browser display is made of two sections. In one you have diagrams drawn,
    for the configurations you are looking at, and 
   in another one (on right part of browser normally) you have the list of
   the maps and objects. Let's call the first one S1, and the last one
   S2. 
  
   in S2: single click with left botton of mouse to select an item
          double click with left botton of mouse to see the description
          of the key, or to see the different existing keys for a map or
          object.
          single click with left botton and then single click with right
          botton of mouse to display the key in S1

   in S1: single click with left  botton of mouse to select an item
          single click with right botton of mouse to expand the item  

   Changing things in the database:

   One can use the browser to make new maps (or configurations), or to 
   modify existing ones. Not to insert objects (see point 4).

   To replace an object with another one in a map, one needs to select the 
   object drawn in S1, which is the one to be replaced, then select the object 
   in S2, which is the one replacing, and then click on REPLACE in the bottom
   of the browser.
   Then click on COMMIT.

   To add/remove an object to a map, select the map in S1, select the object in
   S2, and then click on ADD/REMOVE.
   Then click on COMMIT.
   
   NOTE:
   =====

   Remember to set description of what you change (select the key you have 
   created, and then click on SET DESCRIPTION in the bottom of the 
   browser)

   any change applied, automatically gets assigned a new key. 
   In this way there is no risk to modify existing maps. 


   S.Xella 10/06/00