Paramètres d'Up ! Component Object Module

Up ! Component Object Module est l'adaptateur générique entre Up ! Application System et Component Object Module (COM) 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 Component Object Module (COM).

Up ! Component Object Module n'est pas un programme mais un module complémentaire des adaptateurs :

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

Up ! Component Object Module est automatiquement invoqué si :

Le paramètre UpsMmr.Com est activé pour référencer ou déréférencer les objets Com correspondant aux modules en technologie Up ! Virtual Technical Machine.
Une application telle Visual .NET utilise un ActiveX correspondant à un module en technologie Up ! Virtual Technical Machine.
- Le service Com Inproc Server, qui est une Dll, qui est l'adaptateur serveur d'un module dynamique en technologie Up ! Virtual Technical Machine, est chargé dans l'application Visual .NET.
- Le service Com Outproc Server, qui est un programme exécutable, qui est l'adaptateur serveur d'un module statique en technologie Up ! Virtual Technical Machine, est chargé par Windows pour l'application Visual .NET.
L'application en technologie Up ! Virtual Technical Machine charge un module correspondant à un ActiveX écrit dans un langage quelconque.
- Le service Com Inproc Server, qui est une Dll, est chargé dans l'application en technologie Up ! Virtual Technical Machine.
- Le service Com Outproc Server, qui est programme exécutable, est chargé par Windows pour l'application en technologie Up ! Virtual Technical Machine.

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

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

Quel que soit son mode d'invocation, Up ! Component Object Module 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 UpsCom.
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 UpsCom.

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 et le sous-répertoire des fichiers Types Library des ActiveX correspoant aux modules dont il faut enregistrer ou désenregistrer l'adaptateur serveur Com d'extension tlb. Il n'y a pas de valeur par défaut.

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

TracerCom

TracerCom permet de tracer l'activité de Up ! Component Object Module. La valeur par défaut est Non.

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

TracerCom=Oui

Exemple de configuration d'Up ! Component Object Module


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

; Fichier    : upsaps.ini                                             

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

; Module      : Up ! Application System.                              

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

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

;                          Observations

;                                                                      

;                                                                      

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



[UpsCom]

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

TracerCom=Oui