Paramètres d'Up ! Common Object Request Broker Architecture

Up ! Common Object Request Broker Architecture est l'adaptateur générique entre Up ! Application System et Corba pour des modules clients dans cette technologie.

Tous les modules en technologie Up ! Virtual Technical Machine ou dans une autre supportée peuvent être aussi exposés en technologie Common Object Request Broker Architecture (CORBA).

Up ! Common Object Request Broker Architecture n'est pas un programme mais un module complémentaire des adaptateurs :

Compilés par les paramètres de AdaptateurClientCorba et AdaptateurServeurCorba de Up ! Compiler.
Interprétés par les paramètres AdaptateurClientCorba et AdaptateurServeurCorba de Up ! Script Engine.

Up ! Common Object Request Broker Architecture est automatiquement invoqué si :

Le paramètre UpsMmr.Corba est activé pour référencer ou déréférencer les objets Corba correspondant aux modules en technologie Up ! Virtual Technical Machine.
Une application écrite par exemple en Visual C++ utilise un module Corba correspondant à un module en technologie Up ! Virtual Technical Machine.
Le service Corba, qui est l'adaptateur serveur d'un module en technologie Up ! Virtual Technical Machine, est chargé par l'Os Agent pour l'application Visual C++.
L'application en technologie Up ! Virtual Technical Machine charge un module correspondant à un module Corba écrit dans un langage quelconque.
Le service Corba est chargé par l'Os Agent pour l'application en technologie Up ! Virtual Technical Machine.

Pour utiliser les classes Corba à distance via les Corba Component Model (CCM), il faut enregistrer les composants comme suit :

Fichier ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomApplication}.cad.
Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomApplication}.cad en fusionnant le contenu des fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}.cad de tous les modules à distribuer.
Modifier la section relative à l'instanciation si besoin.
Ajouter le fichier à l'archive avec la commande gzip ${NomApplication}.cad >> ${NomArchive}.zip
Fichier ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomApplication}.ccd.
Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomApplication}.ccd en fusionnant le contenu des fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}.ccd de tous les modules à distribuer.
Modifier la section relative aux droits d'accès si besoin.
Ajouter le fichier à l'archive avec la commande gzip ${NomApplication}.ccd >> ${NomArchive}.zip
Fichier ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomApplication}.csd.
Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomApplication}.csd en fusionnant le contenu des fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}.csd de tous les modules à distribuer.
Modifier la section relative à l'auteur et à la license si besoin.
Ajouter le fichier à l'archive avec la commande gzip ${NomApplication}.csd >> ${NomArchive}.zip
Fichiers ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomModule}.idl.
Ajouter ces fichiers à l'archive avec la commande gzip ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomModule}.idl >> -uf ${NomArchive}.zip
Archive ${NomArchive}.zip.
Déployer l'archive ${UPS_HOME}/upscrb/${UPS_LANGUE}/${NomArchive}.zip en vous référant à la documentation de Mico.

Pour lancer un serveur Corba correspondant à un module en technologie Up ! Virtual Technical Machine, il suffit d'invoquer Up ! Virtual Technical Machine en mode serveur ou Up ! Server en passant en paramètre le nom du module dynamique. Voici un exemple :

upsmmr UpsMmr.Serveur=Oui UpsMmr.Corba=Executer Module=finance upssrv UpsMmr.Corba=Executer Module1=finance Module2=rh

Quel que soit son mode d'invocation, Up ! Common Object Request Broker Architecture possède les mêmes paramètres cités dans la section suivante.

Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les variables environnement.
Le fichier d'initialisation.
${UPS_HOME}/ini/${UPS_LANGUAGE}/upsaps.ini en mode mono-utilisateur ou ${UPS_HOME}/ini/${UPS_USER}/upsaps.ini en mode multi-utilisateur.
La section est UpsCrb.
Le fichier de paramètres.
S'il existe.
La ligne de commande.
Il s'agit soit de :
- La ligne de commande stricto sensu.
- La valeur de la variable environnement QUERY_STRING.
  En ce cas, le programme s'exécute automatiquement et obligatoirement en mode batch en respectant la norme Common Gateway Interface (CGI).
Les paramètres peuvent être préfixés par UpsCrb.

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Paramètres d'exécution

CheminFichiersRegistres

CheminFichiersRegistres permet de spécifier le chemin d'accès aux répertoires où sont rangés les fichiers registres d'extension reg. Il n'y a pas de valeur par défaut.

CheminFichiersRegistres=${UPS_HOME}/upscrb/upscrb:${UPS_HOME}/demo/upscrb

TracerCorba

TracerCorba permet de tracer l'activité de Up ! Common Object Request Broker Architecture. La valeur par défaut est Non.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upscrb-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${NomProgramme}-upscrb-${UPS_APPLICATION}.log en mode multi-utilisateur.

TracerCorba=Oui

Exemple de configuration d'Up ! Common Object Request Broker Architecture


; ------------------------------------------------------------------- 

; Fichier    : upsaps.ini                                             

; Objet      : Initialisation d'Up ! Virtual Technical Machine.        
   
;                                                                     

; Module      : Up ! Application System.                              

; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.                    

; ------------------------------------------------------------------- 

;                          Observations

;                                                                      

;                                                                      

; ------------------------------------------------------------------- 



[UpsCrb]

CheminFichiersRegistres=${UPS_HOME}/upscrb/upscrb:${UPS_HOME}/demo/upscrb

TracerCorba=Oui