Paramètres d'Up ! Java

Tous les modules en technologie Up ! Virtual Technical Machine ou dans une autre supportée peuvent être aussi exposés en technologie Java.

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

• Compilés par les paramètres de AdaptateurClientJava et AdaptateurServeurJava de Up ! Compiler.
• Interprétés par les paramètres AdaptateurClientJava et AdaptateurServeurJava de Up ! Script Engine.

Up ! Java est automatiquement invoqué si :

• Le paramètre UpsMmr.Java est activé pour référencer ou déréférencer les objets Java correspondant aux modules en technologie Up ! Virtual Technical Machine.
  
  
• Une application développée par exemple avec WebSphere Application Development (WSAD) utilise un module Java correspondant à un module en technologie Up ! Virtual Technical Machine.
  Le service Java, qui est l'adaptateur serveur d'un module en technologie Up ! Virtual Technical Machine, est chargé par la machine virtuelle Java pour l'application WebSphere Application Development (WSAD).
  
• L'application en technologie Up ! Virtual Technical Machine charge un module correspondant à un module Java.
  Le service Java est chargé par la machine virtuelle Java pour l'application en technologie Up ! Virtual Technical Machine.

Pour utiliser les classes Java à distance via les Entreprise Java Beans (EJB), il faut enregistrer les composants comme suit :

• Fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/ejb-jar.xml.
  Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/ejb-jar.xml en fusionnant le contenu des fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}-ejb-jar.xml de tous les modules à distribuer.
  Modifier la section relative au déploiement si besoin.
  Ajouter le fichier à l'archive avec la commande jar -uf ${NomArchive}.jar -C META-INF ./META-INF/ejb-jar.xml
  
• Selon le serveur applicatif utilisé :
  
  • JBoss.
    Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/jboss.xml en fusionnant le contenu des fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}-jboss-ejb-jar.xml de tous les modules à distribuer et faisant partie de l'archive.
    Modifier la section relative au déploiement si besoin.
    Ajouter le fichier à l'archive avec la commande jar -uf ${NomArchive}.jar -C META-INF ./META-INF/jboss.xml
    Déployer l'archive ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomArchive}.jar en vous référant à la documentation de JBoss.
    
  • JOnAS.
    Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/jonas-ejb-xml.xml en fusionnant les fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}-jonas-ejb-jar.xml de tous les modules à distribuer et faisant partie de l'archive.
    Modifier la section relative au déploiement si besoin.
    Ajouter le fichier à l'archive avec la commande jar -uf ${NomArchive}.jar -C META-INF ./META-INF/jonas-ejb-jar.xml
    Déployer l'archive ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomArchive}.jar en vous référant à la documentation de JOnAS.
    
  • WebLogic.
    Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/weblogic-ejb-xml.xml en fusionnant les fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}-weblogic-ejb-jar.xml de tous les modules à distribuer et faisant partie de l'archive.
    Modifier la section relative au déploiement si besoin.
    Ajouter le fichier à l'archive avec la commande jar -uf ${NomArchive}.jar -C META-INF ./META-INF/weblogic-ejb-jar.xml
    Déployer l'archive ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomArchive}.jar en vous référant à la documentation de WebLogic.
    
  • WebSphere.
    Créer le fichier ${UPS_HOME}/upsjav/${UPS_LANGUE}/websphere-ejb-xml.xml en fusionnant les fichiers ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomModule}-websphere-ejb-jar.xml de tous les modules à distribuer et faisant partie de l'archive.
    Modifier la section relative au déploiement si besoin.
    Ajouter le fichier à l'archive avec la commande jar -uf ${NomArchive}.jar -C META-INF ./META-INF/websphere-ejb-jar.xml
    Déployer l'archive ${UPS_HOME}/upsjav/${UPS_LANGUE}/${NomArchive}.jar en vous référant à la documentation de WebSphere.
    

Pour lancer un serveur Java, 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.Java=Executer Module=finance
upssrv UpsMmr.Java=Executer Module1=finance Module2=rh

Quel que soit son mode d'invocation, Up ! Java 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}

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 UpsJav.
  
• 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 UpsJav.

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

ClassesJava

ClassesJava=${UPS_HOME}/upsjav/upsjav/french/upsvtm.jar;${UPS_HOME}/demo/upsjav/french/libf_sjv.jar

TracerJava

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

TracerJava=Oui

Exemple de configuration d'Up ! Java