The DATABASE-menu

   Commands for I/O with set-up database.  

      The set-up database holds parameters for CAMAC control
      of high voltages and constant fraction discriminators, and
      the mapping of Fastbus addresses onto physical detectors.



 * DATABASE/INIT FilNam

   FilNam     C 'name of RZ-diskfile'

   Initialize ZEBRA-banks and get master table from RZ-diskfile.  


 * DATABASE/CLOSE

   Close current database file.  


 * DATABASE/SAVE SetSpc DetSpc DetNam

   SetSpc     C 'set-up parameter(s)   '
   DetSpc     C 'detector specification'
   DetNam     C 'ID of detector        '

   Save set-up parameter(s) from ZEBRA-banks onto RZ-diskfile.  

      'SetSpc' specifies a single set-up parameter (like THR_CF)
      or a group of set-up parameters (like THR = THR_CF + THR_LE).
      'DetSpc' & 'DetNam' specify either a single signal
      (like SIG_PLA FPLA1231, SIG_ZER FZER098) or a group
      of signals (like SECTOR 1, RING_ZER 5).



 * DATABASE/TRANSFER SetNam TraSpc TraNam TraOpt VecNam

   SetNam     C 'name of set-up parameter        '
   TraSpc     C 'specification of detector/module'
   TraNam     C 'ID of detector/module           '
   TraOpt     C 'transfer option                 '
   VecNam     C 'name of vector                  '

   Possible TraOpt values are:

    FRVECTOR  
    TOVECTOR  
    FR        
    TO        

   Transfer values of a parameter between vector and ZEBRA-banks.  

      'SetNam' specifies a single set-up parameter (like THR_CF).
      'TraSpc' & 'TraNam' specify either of two possibilities:
      1  some sort of detector, which may be a single signal
         (like SIG_PLA FPLA1231, SIG_ZER FZER098) or
         a group of signals (like SECTOR 1, RING_ZER 5)
      2  an electronics module which is identified by
         type and ID (e.g. TDC_ID A81818)
      TraOpt indicates whether the values are to be read from
      the vector or to be written into it.
      VecNam is the name of an existing (!) vector which may
      have more or less components than there are values to be
      transferred. It is the user's responsibility to worry
      about lost data or extra zeroes.



 * DATABASE/MOVEMOD modid branch crate slot

   modid      C 'ID of module'
   branch     I 'branch number (<0 for FB)'
   crate      I 'crate number             '
   slot       I 'slot number              '

   Move a module from one location to another.  

      This command prints the old location of the module
      specified and asks for the new branch, crate and slot.
      It checks whether that location is empty, and updates the
      tables if that is the case.



 * DATABASE/SWAPMOD modid1 modid2 [ chopt ]

   modid1     C 'ID of old module'
   modid2     C 'ID of new module'
   chopt      C 'verbose option  ' D=' '

   Swap modules of the same type at one location.  

      Exchange a module and reconnect the signals to
      the new module in the same location as the old one.
      NOTE: This command requires the program 'table_manager'
      to enter the new module into all tables in which the
      swapped modules are the key attribute
      NOTE: This command saves the updated entries that concern
      the mapping of signals to electronics addresses
      IMMEDIATELY to disk - think about what you are doing!
      set-up parameters (TDC slopes, CFD thresholds) are also
      saved, even if they are first guesses only, so you have
      something to work with.



 * DATABASE/CHKLOC mod_id [ chopt ]

   mod_id     C 'ID of module'
   chopt      C 'verbose option  ' D=' '

   Perform a minimal consistency check of the database.  

      Obtain a list of all signals connected to the
      module and check that there are no duplicate
      addresses and that the total number of signals does
      not exceed the number of channels of that module
      When 'chopt' contains a 'V' ( = Verbose), a list of
      signals is printed. When 'chopt' contains an 'S'
      ( = Sort), the list is sorted by address. 'S' without
      'V' is meaningless.



 * DATABASE/ERRMESS ErrFlg

   ErrFlg     I 'flag for error messages' D=0

   Switch on/off error messages from database-utilities.  

      ErrFlg = 0: no error messages
      ErrFlg = 1: some error messages from database-utilities
      ErrFlg = 2: more error messages from database-utilities
      ErrFlg =-1: detailed CAMAC-action from HV drivers

 * DATABASE/LISATT TabNam

   TabNam     C 'name of table'

   List all attributes of a table.  (A list of tables is obtained by the 
   command "rz/stat //top_dir/data_base") 


 * DATABASE/LISDET [ DetSpc DetNam ]

   DetSpc     C 'detector specification' D='?'
   DetNam     C 'ID of signal/group    ' D='?'

   List all detector specifications known to the database.  

      If 'DetSpc'='?', the table DET_CONF is searched, and the
      command produces a list of the key attributes specifying
      single signals as well as of the attributes specifying
      larger units of detectors (like planes, sectors,
      rings etc.)
      If 'DetSpc' is given, but 'DetNam' is left at the default
      question mark, the command distinguishes two cases:
      1. If 'DetSpc' specifies a group of signals (e.g. SECTOR,
         RING_ZER, N_PLANE, 8PACK, etc.), the command produces
         a complete a list of values 'DetSpc' may have.
         LISDET RING_ZER for example will produce the numbers
         one through seven as possible values of RING_ZER.
      2. If 'DetSpc' specifies single signals (e.g. SIG_PLA,
         SIG_LAND), the command will produce the full list.
      If 'DetSpc' and 'DetNam' are both given, the command will
      just print a list of the signals specified by that
      combination.



 * DATABASE/SHODET SetSpc DetSpc DetNam

   SetSpc     C 'set-up parameter(s)   '
   DetSpc     C 'detector specification'
   DetNam     C 'ID of signal/group    '

   Print set-up parameter(s) for specific detector.  

      'SetSpc' specifies a single set-up parameter (like THR_CF)
      or a group of set-up parameters (like THR = THR_CF + THR_LE).
      'DetSpc' & 'DetNam' specify either a single signal
      (like SIG_PLA FPLA1231, SIG_LAND N05_14_1) or a group
      of signals (like SECTOR 1, N_PLANE 5).



 * DATABASE/SHOMOD mod_id

   mod_id     C 'ID of module'

   Get type and location (branch/crate/slot) of a module.  


 * DATABASE/SHOGEN attr_g attr_s name [ d_name ]

   attr_g     C 'attribute to search for   '
   attr_s     C 'search attribute          '
   name       C 'value of search attr.     '
   d_name     C 'tolerance in search value ' D='1.0'

   General show-comand for diagnostic purposes.  

      ATTR_G is the attribute whose value you want to know,
      ATTR_S is the attribute for whom you want to know ATTR_G,
      NAME is the actual value of ATTR_S.

      examples :
                ATTR_G   ATTR_S  NAME
         shogen cfdaddr  sector  1
         shogen thr_le   sig_pla fpla1212
         shogen pmt_type plane   15