Documentation  02/04/2002    Puech Dominique  Météo-France  CNRM/GMAP/OBS

   Ce module fonctionne sur kami (en batch) ou sur andante (interactif et beaucoup plus rapide)
   commande  ~mrpa660/util/mandaodb  ->  fic_odb.lst

I. Les fonctionnalites
    I.1. Descriptif général de la base
    I.2. Sélections personnelles
    I.3. Sélections pré-définies
      1.3.1. géopoints (laelalo)
    I.4. Update de subtype@hdr

II. L'utilisation
    II.1. L'environnement
    II.2. La procédure  ~mrpa660/util/mandaodb

III. Le programme
    III.1. Les sources
    III.2. L'exécution


I. Les fonctionnalites

I.1 Descriptif général de la base

      - date et heure du réseau - type de base
      - répartition des données par type d'obs
      - répartition des données par time-slot
      - information sur les données satellites présentes
      - répartition des données par variables : toutes, actives et blacklisted

I.2 Sélections personnelles

      création d'un requete mandalay.sql personnelle

      CREATE VIEW mandalay
      SELECT xxxxxxxx
      FROM xxxxxxx
      [ WHERE xxxxxx ]

      3 formats d'ecriture en sortie :  F12.2    E12.2   ou  *

I.3 Sélections pré-définies

I.3.1  Géopoints  (laelalo)

      Sortie de type géopoint (metview) pour obstype (obstype@hdr), code message
      (obschar@hdr) ou code station (ident@hdr)

I.4 Update de subtype@hdr

      création d'un requete manda_update.sql personnelle

      CREATE VIEW manda_update
      SELECT subtype
      FROM hdr,xxxxxxx
      WHERE xxxxxx

      En sortie, substype@hdr=1 pour l'ensemble des lignes sélectionnées
      Ensuite effectuer une réduction avec odbtools


II. L'utilisation

II.1. L'environnement

Répertoire des données : ${WORKDIR}/DATA     ou     ${UTEMP}/DATA

II.2. La procédure    ~mrpa660/util/mandaodb

pour le VPP, en fin de procédure job soumis (édition de lien et exécution)
     la compilation de la requête sql est effectuée en interactif

en fin d'exécution ou de job  un listing   fic_odb.lst   est retourné sous votre répertoire local
l'exécutable, ainsi que la requête sont archivés sous le répertoire de la base de données
****  ceci afin de ne pas compiler inutilement
sur andante   ne pas oublier de faire du ménage

Les questions
derniere mise a jour : 04/12/2001         edition des modifs ?   (n/o)
choix de la version    generalites (0)    [ défaut = 0 ]
                                  perso (1)  -   pre-definie (2)  -  update(3)
        0  ->   descriptif du contenu
        1  ->   utilisation de la requête locale    mandalay.sql
        2  ->   utilisation de requêtes prédéfinies
                        option LAELALO de mandalay         avec obstype, code message ou code station
        3  ->   update   subtype=1  suivant les conditions    ->  réduction de base avec Odbtools
type de table  1=ECMA  (def)  2=CCMA  3=ECMASCR  (pour compiler)
nom de la base
Pour les options 1 et 2
format      0=F   (def)     1 = E     2 = *
         format                     :       0 ->  format fortran     10F12.3
                                                 1 ->  format fortran     10E12.3
                                                 2 ->  format implicite  (*)
lat/lon en degres   (o/n)               défaut = o

La requête
mandalay.sql   :   sous le répertoire local             (voir xxxxx)

CREATE VIEW mandalay AS
SELECT   xxx,xxx
FROM  xxxx
Manda_update.sql   :   sous le répertoire local

CREATE VIEW manda_update AS
SELECT   subtype
FROM  hdr
WHERE           compléter    (ne pas oublier d'ajouter les tables correspondantes)



III. Le programme

III.1.  Les sources

      manda_odb_visu.f90 : programme générique
      ctxinitdb.f90 : version météo-france simplifiée
      manda_gene_body.sql, manda_gene_hdr.sql : requêtes de la version "généralités"
      manda_laelalo.sql : requete geopoints

III.2.  L'exécution

      Versions "généralités" et "géopoints" lancées à partir de l'exécutable de base,
          sans recompilation

      Versions "sélection personnelle" ou "update"
          compilation : la réquête et l'executable sont archivées sous le répertoire
          de la base de données
          La compilation n'est refaite que s'il y a un changement de requete, ou si
          l'exécutable n'est plus disponible
         **** attention aux requêtes anciennes et programmes qui traineraient ****

      Cycles différents entre la base de données et le programme
          Nouvelle édition de lien pour "généralités" et "géopoints"
          Dans le cas des versions "sélection personnelle" ou "update" application
          des règles précédentes -> attention si run "généralités" ou "géopoints"
          entre temps (l'exécutable ne correspondra pas à la requête)