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 :

Up ! Component Object Module est automatiquement invoqué si :

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 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