Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp avec les outils de script de wsadmin

La présente rubrique répertorie les options disponibles pour les commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp.

Vous pouvez utiliser les commandes de l'objet AdminApp pour installer, éditer, mettre à jour et gérer les configurations de vos applications. Cette rubrique propose des options supplémentaires pour les commandes install, installInteractive, edit, editInteractive, update et updateInteractive pour administrer les applications. Sauf indication contraire, les options indiquées dans cette rubrique s'appliquent à toutes les commandes mentionnées ci-dessus.

Vous pouvez paramétrer ou mettre à jour une valeur de configuration à l'aide des options en mode de traitement par lots. Pour identifier l'objet de configuration à paramétrer ou mettre à jour, les valeurs des zones de lecture seule sont utilisées pour trouver l'objet de configuration correspondant. Toutes les valeurs des zones de lecture seule doivent correspondre à un objet de configuration existant, sinon la commande échoue.

Vous pouvez utiliser la reconnaissance de masques pour simplifier la tâche de spécification des valeurs requises pour certaines options complexes. La reconnaissance de masques ne s'applique qu'aux champs requis ou en lecture seule.

Avertissement : Si une application est en cours d'exécution, la modification de ses paramètres entraîne son redémarrage. Sur les serveurs autonomes, l'application est redémarrée une fois les modifications sauvegardées. Sur les produits utilisant des serveurs multiples, l'application redémarre une fois les modifications sauvegardées et les fichiers sont synchronisés sur le noeud où l'application est installée. Pour contrôler la survenue de la synchronisation sur des produits utilisant plusieurs serveurs, désélectionnez Synchroniser les modifications avec les noeuds sur la page Préférences de la console.
Les options suivantes sont disponibles pour les commandes install, installInteractive, edit, editInteractive, update et updateInteractive :

ActSpecJNDI

L'option ActSpecJNDI lie des spécifications d'activation J2C (Java™ 2 Connector) à des noms JNDI (Java Naming and Directory Interface). Si vous le souhaitez, vous pouvez lier les spécifications d'activation J2C, dans votre application ou module, à un nom JNDI de destination. Vous pouvez affecter une valeur à chacun des éléments suivants de l'option ActSpecJNDI : RARModule, uri, j2cid, zone j2c.jndiName. Le contenu de l'option après l'exécution des liaisons par défaut est le suivant :
  • RARModule : <nom module rar>
  • uri : <nom rar>,META-INF/ra.xml
  • ID objet : <messageListenerType>
  • Nom JNDI : null
Pour utiliser cette option, vous devez indiquer la propriété Destination dans le fichier ra.xml et définir le type analysé de la propriété Destination sur javax.jms.Destination

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}} 
En langage Jacl avec appariement de formes :
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}} 
En langage Jython :
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]]) 
Avec Jython avec appariement de formes :
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]]) 

allowDispatchRemoteInclude

L'option allowDispatchRemoteInclude permet à une application d'entreprise de distribuer des demandes d'inclusion à des ressources entre des modules Web qui se trouvent dans des machines virtuelles Java différentes, dans un environnement de noeud géré par le biais du répartiteur de demandes standard.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs
En langage Jython :
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

L'option allowPermInFilterPolicy indique que le processus du déploiement d'application doit continuer, même si l'application contient des droits basés sur des règles, qui se trouvent dans les règles de filtrage. Cette option ne nécessite pas de valeur.

allowServiceRemoteInclude

L'option allowServiceRemoteInclude permet à une application d'entreprise d'initier une demande d'inclusion à partir d'une application d'entreprise dont l'option allowDispatchRemoteInclude a la valeur true.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs
En langage Jython :
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr] 
AdminConfig.modify (deploymentObject, attrs) 

appname

L'option appname indique le nom de l'application. La valeur par défaut est le nom affiché de l'application.

BackendIdSelection

L'option BackendIdSelection indique l'ID dorsal pour les modules JAR (Java archive) de bean enterprise contenant des beans à persistance gérée par conteneur (CMP). Un module JAR de bean enterprise peut prendre en charge plusieurs configurations de dorsal selon les indications à l'aide d'un outil d'assemblage d'application. Utilisez cette option pour modifier l'ID dorsal lors de l'installation.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1}}} 
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}} 
En langage Jython :
AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1]]]')
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

L'option BindJndiForEJBBusiness lie avec des noms JNDI des modules EJB à interfaces métier. Chacun de ces modules EJB doit être lié à un nom JNDI.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Ejb1
  • Bean : MessageBean
  • URI : sample.jar,META-INF/ejb-jar.xml
  • Interface métier : com.ibm.sample.business.bnd.LocalTargetOne
  • Nom JNDI : []: ejblocal:ejb/LocalTargetOne

Si vous spécifiez le nom JNDI de la ressource cible avec l'option BindJndiForEJBNonMessageBinding, ne spécifiez pas de nom JNDI d'interface métier dans l'option BindJndiForEJBBusiness. Si vous ne spécifiez pas de nom JNDI pour la ressource cible, spécifiez un nom JNDI d'interface métier. Si vous ne spécifiez aucun nom JNDI d'interface métier, l'environnement d'exécution fournit un conteneur par défaut.

Pour une vue sans interface, la valeur de l'interface métier est une chaîne vide ("").

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}
En langage Jacl avec appariement de formes :
$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}
En langage Jython :
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')
Avec Jython avec appariement de formes :
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

L'option BindJndiForEJBMessageBinding lie les beans enterprise gérés par message à des noms de port d'écoute ou à des noms JNDI (Java Naming and Directory Interface) de spécification d'activation. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche. Lorsqu'un bean MDB est lié à un nom JNDI de spécification d'activation, vous pouvez également indiquer l'alias d'authentification et le nom JNDI de la destination.

Chaque élément de l'option BindJndiForEJBMessageBinding comprend les zones suivantes : EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest et actspec.auth. Certaines zones peuvent recevoir des valeurs : listenerPort, JNDI, jndi.dest et actspec.auth.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Ejb1
  • Bean : MessageBean
  • URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Port d'écoute : [null]:
  • Nom JNDI : [eis/MessageBean]:
  • Nom JNDI de destination : [jms/TopicName]:
  • Alias d'authentification ActivationSpec : [null]:

Si une propriété de configuration d'activation destinationLookup n'est pas fournie en tant qu'annotation ni dans un descripteur de déploiement et qu'un nom JNDI de destination ne figure pas dans le fichier de liaison IBM, le nom JNDI de destination par défaut est collecté à partir de la référence de message correspondante.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}} 
En langage Jacl avec appariement de formes :
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
En langage Jython :
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]]) 
Avec Jython avec appariement de formes :
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

L'option BindJndiForEJBNonMessageBinding lie les beans enterprise à des noms JNDI (Java Naming and Directory Interface). Veillez à ce que chaque bean enterprise géré par messages de votre application ou module soit lié à un nom JNDI. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Ejb1
  • Bean : MessageBean
  • URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Nom JNDI de la ressource cible : [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
  • Nom JNDI home local : [null]
  • Nom JNDI home distant : [null]

Il existe des contraintes spéciales pour les modules Enterprise JavaBeans (EJB) versions 3.0 et ultérieures. Si vous spécifiez le nom JNDI de la ressource cible, ne spécifiez pas de nom JNDI pour les interfaces home locale ou distante. Vous ne pouvez pas non plus spécifier de JNDI pour la zone interfaces métier de l'option BindJndiForEJBBusiness option. Si vous ne spécifiez pas de nom JNDI pour la ressource cible, les zones de noms JNDI pour les interfaces home d'interface ne sont pas obligatoires. Si vous ne spécifiez pas de nom JNDI pour les interfaces home locale et distante, le module d'exécution fournira un conteneur par défaut.

Si vous n'utilisez pas de modules EJB 3.0, vous devez spécifier le nom JNDI pour la ressource cible.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

En langage Jython :

[Windows]
AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

L'option blaname permet de spécifier le nom de l'application de niveau métier sous laquelle le système crée l'application Java EE. Cette option est facultative. Si vous ne spécifiez pas de valeur, le système définit lui-même le nom de l'application Java EE. Cette option n'est disponible qu'avec la commande install.

buildVersion

L'option buildVersion affiche la version de compilation d'un fichier EAR d'application. Vous ne pouvez pas modifier cette option car elle est en lecture seule. Cette option renvoie les informations de version de compilation d'un EAR d'application si vous avez spécifié cette version dans le fichier EAR MANIFEST.MF de l'application.

cellule

L'option cell spécifie le nom de la cellule dans laquelle installer ou actualiser une application entière, ou dans laquelle mettre à jour une application afin d'ajouter un nouveau module. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

En langage Jython :

[Windows]
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

clientMode

L'option clientMode indique si des modules client doivent être déployés sur une cible de déploiement isolée (isolé), un noeud fédéré d'un gestionnaire de déploiement, (fédéré) ou un serveur d'applications (déployé sur le serveur). Si vous indiquez cette option, vous installez les modules client uniquement sur une cible de déploiement version 8.0 ou version ultérieure.

La valeur par défaut est isolé.

Le choix du mode de déploiement du client affecte le traitement des recherches java:. Tous les espaces de noms d'URL Java (global, application, module et composant) sont des noms locaux dans les processus client isolés. Les espaces de noms résident sur un serveur dans des processus client de type Serveur déployé et Fédéré. Le serveur ou cluster choisi comme cible d'un module client détermine l'endroit où ces espaces de noms sont créés. Toutes les recherches java: des modules client de type Serveur déployé ou Fédéré sont redirigées vers le serveur ou cluster cible. Le module client ne s'exécute pas vraiment dans le serveur ou cluster cible. Plusieurs instances du même module client partagent le même espace de noms de composant dans les modes Fédéré et Serveur déployé. Le choix du mode Fédéré revient à déclarer que vous avez l'intention de lancer le module client à l'aide de JNLP (Java Network Launching Protocol), mais les mécanismes JNDI (Java Naming and Directory Interface) des modes Fédéré et Serveur déployé sont identiques.

cluster

L'option cluster spécifie le nom de cluster dans lequel installer ou mettre à jour une application entière, ou mettre à jour une application afin d'ajouter un nouveau module. Cette option ne s'applique que dans un environnement WebSphere Application Server, Network Deployment. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation. Vous ne pouvez pas utiliser ensemble les options -cluster et -server.

Si vous souhaitez déployer une application et spécifier le serveur HTTP lors du déploiement, afin que l'application apparaisse dans le fichier plugin-cfg.xml généré, vous devez d'abord installer l'application avec une cible de -cluster. Une fois que vous avez installé l'application, et avant d'enregistrer les changements, utilisez la commande edit de l'objet AdminApp pour ajouter le mappage supplémentaire au serveur Web.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install "C:/myapp.ear" {-cluster clusterName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "myapp.ear" {-cluster clusterName}

En langage Jython :

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')

contents

L'option contents indique le fichier stockant le contenu à mettre à jour. Par exemple, en fonction du type de contenu, le fichier peut être un fichier EAR, un module, un fichier zip partiel ou un fichier unique. Le chemin du fichier doit être défini en local par rapport au client de scriptage. L'optioncontents est obligatoire sauf si vous avez indiqué l'option delete.

contenturi

L'option contenturi indique l'identificateur URI du fichier que vous ajoutez, mettez à jour ou supprimez de l'application. Cette option s'applique uniquement à la commande update. L'option contenturi est obligatoire si le type de contenu est file ou modulefile. Cette option est ignorée pour les autres types de contenu.

contextroot

L'option contextroot indique la racine de contexte à utiliser pour installer un fichier WAR d'application Web autonome.

CorrectOracleIsolationLevel

L'option CorrectOracleIsolationLevel indique le niveau d'isolement du fournisseur de type Oracle. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour. La dernière zone des entrées correspond au niveau d'isolement. Les valeurs de niveau d'isolement admises sont 2 ou 4.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous n'avez à fournir que des données pour les lignes ou que les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}
En langage Jython :
AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

L'option CorrectUseSystemIdentity remplace le système RunAs par des rôles RunAs. Les beans enterprise que vous installez contiennent une identité système RunAs. Vous pouvez éventuellement changer cette identité en rôle RunAs. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar"
 Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2} 
 {Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-CorrectUseSystemIdentity
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2}
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}
En langage Jython :
AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity
 [[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue()
 RunAsUser2 user2 password2] 
 [Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2]]]')
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
 [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

L'option createMBeansForResources indique que des beans gérés sont créés pour tous les actifs (servlets, fichiers JSP et beans enterprise) définis dans une application lorsque l'application démarre sur une cible de déploiement. Cette option ne nécessite pas de valeur. Le réglage par défaut est l'option nocreateMBeansForResources.

CtxRootForWebMod

L'option CtxRootForWebMod édite la racine de contexte du module Web. Cette option vous permet d'éditer une racine de contexte qui est définie dans le fichier application.xml. Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module Web : xxx
  • URI : xxx
  • Racine de contexte : <racine de contexte>
Si le module Web est un servlet 2.5, cette option ne contient que des données provenant du descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

En langage Jython :

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

custom

L'option custom indique une paire nom/valeur selon le format nom=valeur. Utilisez l'option custom pour transmettre les options aux extensions de déploiement de l'application. Pour connaître les options disponibles, consultez la documentation de l'extension de déploiement de l'application.

CustomActivationPlan

L'option CustomActivationPlan indique les composants d'exécution à ajouter ou à supprimer des composants par défaut utilisés pour exécuter l'application. N'utilisez cette option que lorsque le serveur d'applications ne peut pas obtenir tous les composants d'exécution nécessaires en inspectant l'application.

Exemple d'utilisation en mode de traitement par lots

En langage Jython :
AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Avec Jython avec appariement de formes :
AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Tableau 1. Composants CustomActivationPlan à ajouter. Définissez une valeur pour WS_ComponentToAdd dans la commande.
Composant Valeur de WS_ComponentToAdd
Conteneur EJB WS_EJBContainer
Conteneur de portlet WS_PortletContainer
JavaServer Faces (JSF) WS_JSF
Conteneur SIP WS_SipContainer
Portée du service de compensation WS_Compensation
Profil d'application WS_AppProfile
Session d'activité WS_ActivitySession
Internationalisation WS_I18N
Beans de démarrage WS_StartupService

DataSourceFor10CMPBeans

L'option DataSourceFor10CMPBeans indique les sources de données facultatives pour les beans CMP 1.x individuels. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Lorsqu'une source de données spécifique est mappée vers un bean CMP, elle remplace la source de données par défaut pour le module qui contient le bean enterprise. Chaque élément de l'option DataSourceFor10CMPBeans comprend les zones suivantes : EJBModule, EJB, uri, JNDI, userName, password, login.config.name et auth.props. Parmi ces zones, les zones JNDI, userName, password, login.config.name et auth.props peuvent être associées à des valeurs.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Increment CMP 1.1 EJB
  • Bean : IncCMP11
  • URI : IncCMP11.jar,META-INF/ejb-jar.xml
  • Nom JNDI de la ressource cible : [DefaultDatasource]:
  • Nom d'utilisateur : [null]:
  • Mot de passe : [null]:
  • Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.

Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

En langage Jacl avec appariement de formes :

[Windows]
$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

En langage Jython :

[Windows]
AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]]) 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]]) 

Avec Jython avec appariement de formes :

[Windows]
AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

L'option DataSourceFor20CMPBeans indique les sources de données facultatives pour les beans CMP 2.x individuels. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Lorsqu'une source de données spécifique est mappée vers un bean CMP, elle remplace la source de données par défaut pour le module qui contient le bean enterprise. Chaque élément de l'option DataSourceFor20CMPBeans comprend les zones suivantes EJBModule, EJB, uri, JNDI, resAuth, login.config.name et auth.props. Parmi ces zones, les zones JNDI, resAuth, login.config.name et auth.props peuvent être associées à des valeurs.

A l'issue de l'exécution des liaisons, le contenu en cours de l'option inclut les éléments suivants :
  • Module : Increment enterprise bean
  • Bean : Increment
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nom JNDI de la ressource cible : [null]:
  • Autorisation ressources : [par application]:
  • Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.

Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp. Vous n'avez à fournir que des données pour les lignes ou que les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}} 
En langage Jacl avec appariement de formes :
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}
En langage Jython :
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])
Avec Jython avec appariement de formes :
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

L'option DataSourceFor10EJBModules indique la source de données par défaut pour le module de bean enterprise qui contient les beans CMP 1.x. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.

Chaque élément de l'option DataSourceFor10EJBModules comprend les zones suivantes : EJBModule, uri, JNDI, userName, password, login.config.name et auth.props. Parmi ces zones, les zones JNDI, userName, password, login.config.name et auth.props peuvent être associées à des valeurs.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Increment CMP 1.1 enterprise bean
  • uri : IncCMP11.jar,META-INF/ejb-jar.xml
  • Nom JNDI de la ressource cible : [DefaultDatasource]:
  • Nom d'utilisateur : [null]:
  • Mot de passe : [null]:
  • Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.

Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
 IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}} 
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}
En langage Jython :
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]]) 
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

L'option DataSourceFor20EJBModules indique la source de données par défaut pour le module de bean enterprise 2.x qui contient des bean CMP (container managed persistence) 2.x. Utilisez cette option pour indiquer des données manquantes ou mettre à jour une tâche.

Chaque élément de l'option DataSourceFor20EJBModules comprend les zones suivantes : EJBModule, uri, JNDI, resAuth, login.config.name et auth.props. Parmi ces zones, les zones JNDI, resAuth, login.config.name et auth.props et les propriétés étendues des sources de données peuvent se voir attribuer des valeurs.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : Increment enterprise bean
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nom JNDI de la ressource cible : [DefaultDatasource]:
  • Autorisation ressources : [par application]:
  • Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés étendues de sources de données : []: utilisez cette option pour qu'une source de données utilisant un pool de connexions hétérogène puisse se connecter à une base de données DB2. Le masque de la propriété est propriété1=valeur1+propriété2=valeur2.

La dernière zone des entrées de cette tâche indique la valeur des droits d'accès aux ressources. Les valeurs admises pour les droits d'accès aux ressources sont Par fabrique de connexions ou Conteneur.

Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de chaîne est websphere:name= <name1>,value=<value1>,description=<desc1>. Spécifiez plusieurs propriétés à l'aide du signe "+".

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou une mise à jour est nécessaire.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}} 
En langage Jacl avec appariement de formes :
$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}
Remarque : Si vous utilisez plusieurs valeurs pour les propriétés étendues de la source de données, vous devez les affecter à une variable et utiliser cette dernière pour la valeur des propriétés. Par exemple :
set s \"value1,value2\"
Dans la substitution de commande, référencez la variable comme indiqué dans l'exemple suivant :
"clientApplicationInformation=value1,value2" avec "clientapplication=$s"
En langage Jython :
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])
Avec Jython avec appariement de formes :
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])
Remarque : Si vous utilisez plusieurs valeurs pour les propriétés étendues de la source de données, placez ces valeurs entre guillemets. Par exemple :
'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

L'option defaultbinding.cf.jndi indique le nom JNDI (Java Naming and Directory Interface) de la fabrique de connexions par défaut.

defaultbinding.cf.resauth

L'option defaultbinding.cf.resauth indique le RESAUTH pour la fabrique de connexions.

defaultbinding.datasource.jndi

L'option defaultbinding.datasource.jndi spécifie le nom JNDI pour la source de données par défaut.

defaultbinding.datasource.password

L'option defaultbinding.datasource.password indique le mot de passe pour la source de données par défaut.

defaultbinding.datasource.username

L'option defaultbinding.datasource.username spécifie le nom d'utilisateur pour la source de données par défaut.

defaultbinding.ee.defaults

Nouvelle fonction Nouvelle fonction:
newfeat
L'option defaultbinding.ee.defaults indique que l'option de ressources par défaut préconfigurées doit être utilisée pour Java EE.

defaultbinding.ejbjndi.prefix

L'option defaultbinding.ejbjndi.prefix indique le préfixe du nom JNDI (Java Naming and Directory Interface) du bean enterprise.

[z/OS] Pour utiliser l'option defaultbinding.ejbjndi.prefix sur la plateforme z/OS, vous devez également spécifier l'option usedefaultbindings. Si vous ne spécifiez pas l'utilisation de l'option usedefaultbindings, l'option par défaut est nousedefaultbindings.

defaultbinding.force

L'option defaultbinding.force indique que les liaisons par défaut remplacent les liaisons actuelles.

defaultbinding.strategy.file

L'option defaultbinding.strategy.file indique un fichier de stratégie de liaison par défaut personnalisé.

defaultbinding.virtual.host

L'option defaultbinding.virtual.host indique le nom par défaut d'un hôte virtuel.

depl.extension.reg (obsolète)

Fonction obsolète Fonction obsolète: L'option depl.extension.reg est obsolète. Aucune option de réplication n'est disponible.depfeat

deployejb

L'option deployejb indique l'exécution de l'outil EJBDeploy au cours de l'installation. Cette option ne nécessite pas de valeur. L'outil de déploiement EJBDeploy s'exécute pendant l'installation des modules EJB 1.x ou 2.x. L'outil de déploiement d'EJB ne fonctionne pas lors de l'installation des modules EJB 3.x.

Cette option est ignorée lorsque le fichier EAR ou le module à installer ou à mettre à jour contient un descripteur de déploiement d'application Java Platform, Enterprise Edition (Java EE) 7, un descripteur de déploiement de module EJB 3.2 ou un descripteur de déploiement de module Web 3.1.

Si vous prédéployez le fichier EAR à l'aide de l'outil EJBDeploy, la valeur par défaut est nodeployejb. Sinon, la valeur par défaut est deployejb.

Vous devez utiliser l'option deployejb dans les situations suivantes :
  • Le fichier EAR a été assemblé à l'aide d'un outil d'assemblage, tel que Rational Application Developer ; l'outil EJBDeploy n'a pas été lancé pendant l'assemblage.
  • Le fichier EAR n'a pas été assemblé à l'aide d'un outil d'assemblage, tel que Rational Application Developer.
  • Le fichier EAR a été assemblé à l'aide de versions de l'outil Application Assembly (AAT) antérieures à la version 5.0.

Si un module EJB est regroupé dans un fichier d'archive Web (WAR), vous n'avez pas besoin d'utiliser cette option deployejb.

Pour cette option, effectuez l'installation uniquement sur une cible de déploiement Version 9.0.

deployejb.classpath

L'option deployejb.classpath spécifie un chemin de classes supplémentaire pour l'outil EJBDeploy.

deployejb.complianceLevel

L'option deployejb.complianceLevel spécifie le niveau de conformité JDK pour l'outil EJBDeploy.

Les valeurs possibles sont les suivantes :
1.4 (default) 5.0 6.0

Pour obtenir la liste des niveaux de JDK actuellement pris en charge, exécutez la commande ejbdeploy -? d'administration.

deployejb.dbschema

L'option deployejb.dbschema indique le schéma de base de données pour l'outil EJBDeploy.

deployejb.dbtype

L'option deployejb.dbtype indique le type de base de données pour l'outil EJBDeploy.

Les valeurs possibles sont les suivantes :
DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9 
 DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61  DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115 
 MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125
Les bases de données suivantes prennent en charge le langage SQL (Structured Query Language) pour Java (SQLJ) : DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 et DB2UDBOS390_V8.

Pour obtenir la liste des types de fournisseurs de base de données pris en charge, exécutez la commande ejbdeploy -?. d'administration.

deployejb.dbaccesstype

L'option deployejb.dbaccesstype indique le type d'accès à la base de données pour l'outil EJBDeploy. Les valeurs valides sont SQLj et JDBC. La valeur par défaut est JDBC.

deployejb.rmic

L'option deployejb.rmic indique les options RMIC supplémentaires pour utiliser l'outil EJBDeploy.

deployejb.sqljclasspath

L'option deployejb.sqljclasspath indique l'emplacement des classes du traducteur SQLJ.

deployws

L'option deployws indique de déployer les services Web au cours de l'installation. Cette option ne nécessite pas de valeur.

La valeur par défaut est nodeployws.

deployws.classpath

L'option deployws.classpath indique le chemin de classe supplémentaire à utiliser lorsque vous déployez des services Web.

Pour spécifier plusieurs entrées, séparez-les avec le caractère habituellement utilisé dans la variable d'environnement CLASSPATH.

[Windows]Utilisez le point-virgule (;) pour séparer les entrées.

[AIX][HP-UX][Linux][Solaris][z/OS]Utilisez le signe deux-points (:) pour séparer les entrées.

deployws.jardirs

L'option deployws.jardirs indique les répertoires d'extensions supplémentaires à utiliser lorsque vous déployez des services Web.

distributeApp

L'option distributeApp indique que le composant de gestion d'applications distribue les binaires des applications. Cette option ne nécessite pas de valeur. Il s'agit du réglage par défaut.

EmbeddedRar

L'option EmbeddedRar lie des objets J2C (Java 2 Connector) à des noms JNDI. Vous devez lier chaque objet Java 2 Connector dans votre application ou module (par exemple, fabriques de connexions J2C, spécifications d'activation J2C ou objets administratifs J2C) à un nom JNDI. Chaque élément de l'option EmbeddedRar contient les zones suivantes : RARModule, uri, j2cid, j2c.name, j2c.jndiName. Vous pouvez affecter les valeurs suivantes aux zones : j2c.name, j2c.jndiName.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
Connector module: <rar module name> 
URI: <rar name>,META-INF/ra.xml 
Object identifier: <identifier of the J2C object> 
name: j2cid 
JNDI name: eis/j2cid
où j2cid prend la forme suivante :
J2C connection factory: connectionFactoryInterface
J2C admin object: adminObjectInterface
J2C activation specification: message listener type

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Si l'ID n'est pas unique dans le fichier ra.xml, -<numéro> est ajouté. Par exemple, javax.sql.DataSource-2.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml 
 javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource 
 Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2} 
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider 
 fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2 
 eis/fvt.adapter.message.FVTMessageProvider2}}} 
En langage Jacl avec appariement de formes :
$AdminApp install $embeddedEar {-EmbeddedRar {{.*  .*  .*  javax.sql.DataSource1  
 eis/javax.sql.javax.sql.DataSSource1} {.*  .*  .*  javax.sql.DataSource2  eis/javax.sql.DataSource2} {.*  .*  .*  
 javax.jms.MessageListener1  eis/javax.jms.MessageListener1} {.*  .*  .*  javax.jms.MessageListener2  
 eis/javax.jms.MessageListener2} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider1  
 eis/fvt.adapter.message.FVTMessageProvider1} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider2  
 eis/fvt.adapter.message.FVTMessageProvider2}}}
En langage Jython :
AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter", 
 'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT 
 Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], 
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1', 
 'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2', 
 'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml 
 fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 
 'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]]) 
Avec Jython avec appariement de formes :
AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1', 
 'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*', 
 '.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2', 
 'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

enableClientModule

L'option enableClientModule indique qu'il faut déployer les modules client. Sélectionnez cette option si le fichier à déployer contient un ou plusieurs modules client et que vous souhaitez déployer. Si vous sélectionnez cette option, vous installez les modules client uniquement sur une cible de déploiement version 8.0 ou version ultérieure.

Cette option ne nécessite pas de valeur. La valeur par défaut est noenableClientModule. Par défaut, l'option enableClientModule est ignorée pendant le déploiement et les modules client ne sont pas déployés.

EnsureMethodProtectionFor10EJB

L'option EnsureMethodProtectionFor10EJB sélectionne des protections pour les méthodes non protégées de beans enterprise 1.x. Indiquez que la méthode doit rester non protégée, ou affectez une protection refusant tout accès. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
 {{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
 {"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
 {{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
 methodProtection.denyAllPermission}}}
En langage Jython :
AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
 [["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
 ["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission]]]')
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

La dernière zone des entrées de cette tâche indique la valeur de la protection. Les valeurs de protection admises sont : methodProtection.denyAllPermission. Vous pouvez aussi laisser la zone vide pour que la méthode ne soit pas protégée.

EnsureMethodProtectionFor20EJB

L'option EnsureMethodProtectionFor20EJB sélectionne des protections pour les méthodes non protégées de beans enterprise 2.x. Indiquez d'affecter un rôle de sécurité à la méthode non protégée, ajoutez la méthode à la liste d'exclusion ou marquez la méthode comme effacée. Vous pouvez affecter plusieurs rôles à une méthode en séparant les noms des rôles à l'aide de virgules. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou une mise à jour est nécessaire.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
 {SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}

En langage Jacl avec appariement de formes :

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}
En langage Jython :
AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB 
 [[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck]
 [SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

La dernière zone des entrées de cette tâche indique la valeur de la protection. Les valeurs de protection possibles sont : methodProtection.uncheck, methodProtection.exclude, ou une liste de rôles de sécurité séparés par des virgules.

filepermission

L'option filepermission vous permet de définir les droits d'accès appropriés aux fichiers d'application qui se trouvent dans le répertoire d'installation. Les droits d'accès que vous spécifiez au niveau de l'application doivent être un sous-ensemble du droit d'accès de niveau noeud qui définit le droit d'accès le moins stricte pouvant être spécifié. Sinon, les valeurs de droit d'accès sont utilisées pour définir les droits d'accès à l'emplacement de destination de l'installation. Le modèle de nom de fichier est une expression régulière. La valeur par défaut est la suivante :
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -cell myCell -node myNode -server server1
 -filepermission .*\\.jsp=777#.*\\.xml=755}
En langage Jython :
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
 "-filepermission", ".*\\.jsp=777#.*\\.xml=755"])

installdir (déconseillé)

Fonction obsolète Fonction obsolète: L'option installdir est obsolète. Elle est remplacée par l'option installed.ear.destination.depfeat

installed.ear.destination

L'option installed.ear.destination indique le répertoire dans lequel les fichiers binaires de l'application doivent être placés.

JSPCompileOptions

L'option JSPCompileOptions spécifie les options de compilation JSP (Java ServerPages) applicables aux modules Web. Cette option n'est valide que si utilisez également l'option preCompileJSPs. Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module Web : xxx
  • URI : xxx
  • Chemin de classes JSP : <jsp class path>
  • Utiliser des noms de module complets : Oui | Non
  • Niveau de source de kit JDK : xx
  • Désactiver la compilation d'exécution JSP : Oui | Non

Pour Utiliser des noms de module complets et Désactiver la compilation d'exécution JSP, spécifiez la valeur Oui ou Non dans la langue de l'environnement local. Le produit prend en charge les valeurs AppDeploymentOption.Yes et AppDeploymentOption.No à la place de Oui et Non. Toutefois, il est recommandé de spécifier Oui ou Non dans la langue de votre environnement local.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}
En langage Jacl avec appariement de formes :
$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp Yes 15 No}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
 'Yes', 15, 'No']]])
Avec Jython avec appariement de formes :
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

L'option JSPReloadForWebMod édite les attributs de rechargement JSP pour le module Web. Vous pouvez spécifier les attributs de rechargement du servlet et JSP pour chaque module. A l'issue de l'exécution des liaisons par défaut, le contenu en cours de l'option inclut les éléments suivants :
  • Module Web : xxx
  • URI : xxx
  • Activation du rechargement de classe JSP : <Oui | Non>
  • Intervalle de rechargement JSP en secondes : <jsp reload internal number>

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Pour l'option Activer le rechargement des classes JSP, entrez la valeur Oui ou Non dans la langue définie dans les paramètres régionaux. Le produit prend en charge les valeurs AppDeploymentOption.Yes et AppDeploymentOption.No à la place de Oui et Non. Toutefois, il est recommandé de spécifier Oui ou Non dans la langue de votre environnement local.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])
Configurations prises en charge Configurations prises en charge: Pour les fichiers de liaison et d'extension IBM®, l'extension de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à Java EE 5 ou un module ou une application ultérieure à Java EE 5. Un fichier de liaison ou d'extension IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent :
  • Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
  • Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus dans l'application ou le module, le produit les ignore.

Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.

Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.

sptcfg

MapEJBRefToEJB

L'option MapEJBRefToEJB mappe des références Java enterprise vers des beans enterprise. Vous devez mapper chaque référence de bean enterprise définie dans votre application vers un bean enterprise. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Si la référence d'EJB provient d'un module EJB 3.x, Web 2.4 ou Web 2.5, le nom JNDI est facultatif. Si vous spécifiez l'option useAutoLink, le nom JNDI est facultatif. S'il n'est pas indiqué, l'environnement d'exécution fournit une valeur par défaut propre au conteneur. Un module EJB 3.0 ou version ultérieure ne peut pas contenir de beans d'entité CMP ou BMP. L'installation d'une application Java EE échoue si celle-ci contient un module EJB 3.x avec un ou plusieurs beans d'entité CMP ou BMP. Les beans d'entité CMP ou BMP doivent être empaquetés dans un module EJB 2.1 ou version antérieure.

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp. Il suffit d'indiquer des données pour les lignes ou les entrées où il manque des informations ou celles dans lesquelles les données doivent être mises à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}

En langage Jacl avec appariement de formes :

[Windows]
$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
En langage Jython :
AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')

Avec Jython avec appariement de formes :

[Windows]
AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

L'option MapEnvEntryForApp édite la valeur env-entry de l'application. Vous pouvez utiliser cette option pour éditer la valeur de env-entry dans le fichier application.xml.

Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Nom : xxx
  • Type : xxx
  • Description : xxx
    Eviter les incidents Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si vous conservez la valeur null, des exceptions sont émises lorsque vous exécutez la tâche MapEnvEntryForApp.gotcha
  • Valeur : <valeur env-entry>

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :

En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

L'option MapEnvEntryForClientMod édite la valeur env-entry du module. Vous pouvez utiliser cette option pour modifier la valeur des entrées d'environnement dans le fichier application-client.xml du module client.

Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module client : xxx
  • URI : xxx
  • Nom : xxx
  • Type : xxx
  • Description : xxx
  • Valeur : <valeur env-entry>

Pour obtenir des informations sur les données nécessaires à votre module client, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/myapp.ear
 {-appname MyApp -MapEnvEntryForClientMod {{"Client Module" client.jar,META-INF/application-client.xml
  clientObject String null newValue}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
  .* .* newValue}}} 
En langage Jython :
AdminApp.install('app_server_root/installableApps/myapp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Client Module",
 'client.jar,META-INF/application-client.xml', 'clientObject',
 'String', 'null', 'newValue']]])
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :

En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
 (?s).* newValue}}}
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

L'option MapEnvEntryForEJBMod édite la valeur env-entry du module EJB. Vous pouvez utiliser cette option pour modifier la valeur des entrées d'environnement dans le fichier EJB.xml du module EJB.

Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module : xxx
  • URI : xxx
  • Bean : xxx
  • Nom : xxx
  • Type : xxx
  • Description : xxx
    Eviter les incidents Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si la valeur null est conservée, les exceptions WASX7017E et WASX7111E se produisent lors de l'exécution de la tâche MapEnvEntryForEJBMod. gotcha
  • Valeur : <valeur env-entry>

Si le module EJB utilise la spécification EJB version 3.0 ou supérieure, cette option ne contient que les éléments fournis par le descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
  ivtEJBObject ejb/ivtEJBObject String null newValue}}}
En langage Jacl avec appariement de formes :
$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}} 
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
 'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
 'String', 'null', 'newValue']]])
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :

En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
 (?s).* newValue}}}
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

L'option MapEnvEntryForWebMod édite la valeur env-entry du module Web. Vous pouvez utiliser cette option pour modifier la valeur de env-entry dans le fichier web.xml.

Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module Web : xxx
  • URI : xxx
  • Nom : xxx
  • Type : xxx
  • Description : xxx
    Eviter les incidents Eviter les incidents: Si, après l'exécution des liaisons par défaut, la valeur est null, vous devez la remplacer par .* avant d'exécuter la tâche. La valeur .* est la valeur générique qui correspond à n'importe quelle description. Si la valeur null est conservée, les exceptions WASX7017E et WASX7111E se produisent lors de l'exécution de la tâche MapEnvEntryForWebMod. gotcha
  • Valeur : <valeur env-entry>

Si le module Web utilise un servlet 2.5, cette option ne contient que des données provenant du descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
 WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

Si la description comporte un caractère de passage à la ligne, utilisez la syntaxe suivante :

En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

L'option MapInitParamForServlet édite le paramètre initial d'un module Web. Vous pouvez utiliser cette option pour modifier le paramètre initial d'un servlet dans le fichier web.xml. Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module Web : xxx
  • URI : xxx
  • Servlet : xxx
  • Nom : xxx
  • Description: null
  • Valeur : <valeur de paramètre initiale>
Si le module Web utilise un servlet version 2.5 ou supérieure, cette option ne contient que les éléments fournis par le descripteur de déploiement XML. Cette option ne permet pas de récupérer des informations de déploiement provenant d'annotations.

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapInitParamForServlet {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml ivtservlet pName1 null MyInitParamValue}}} 
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

L'option MapJaspiProvider spécifie l'application Web ou les modules Web pour lesquels vous voulez définir des réglages JASPI (Java Authentication SPI) autres que ceux de la configuration de sécurité globale ou du domaine. Le contenu de cette option est le suivant :
  • Module : xxx
  • URI : xxx
  • Utiliser JASPI : Oui | Non | Hériter
  • Nom du fournisseur JASPI : xxx

Pour Utiliser JASPI, spécifiez la valeur Oui, Non ou Hériter dans la langue de votre environnement local.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez indiquer des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
En langage Jython :
AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')

MapMessageDestinationRefToEJB

L'option MapMessageDestinationRefToEJB mappe les références de destination de message vers des noms JNDI (Java Naming and Directory Interface) des objets d'administration à partir des adaptateurs de ressources installés. Vous devez mapper chaque référence de destination de message définie dans l'application vers un objet d'administration. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : ejb-jar-ic.jar
  • Bean : MessageBean
  • URI : ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Objet de destination du message : jms/GSShippingQueue
  • Nom JNDI de la ressource cible : [jms/GSShippingQueue]:
Si la référence de destination des messages provient d'un module EJB 3.0 ou version ultérieure, le nom JNDI est optionnel ; s'il n'est pas indiqué, l'environnement d'exécution fournit un nom par défaut propre au conteneur.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}  
En langage Jacl avec appariement de formes :
$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}} 
En langage Jython :
AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )
Avec Jython avec appariement de formes :
AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

L'option MapModulesToServers indique le serveur d'applications sur lequel vous souhaitez installer les modules contenus dans votre application. Vous pouvez installer des modules sur le même serveur ou les répartir sur plusieurs serveurs. Utilisez cette option pour indiquer les données manquantes ou mettre à jour une tâche.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

L'exemple suivant installe Increment.jar sur un seul serveur :

A l'aide de Jacl :
$AdminApp install Increment.jar {-MapModulesToServers
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1}}}
En langage Jython :
AdminApp.install('Increment.jar', '[-MapModulesToServers
 [["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1] ]]')

L'exemple suivant installe Increment.jar et l'associe à deux serveurs gérés par un gestionnaire de déploiement :

A l'aide de Jacl :
$AdminApp install Increment.jar {-MapModulesToServers
 {{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}
En langage Jython :
AdminApp.install('Increment.jar', '[ -MapModulesToServers
 [[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')

L'exemple suivant ajoute server2 et server3 pour une application qui est déjà installée :

A l'aide de Jacl :
$AdminApp install myapp.ear {-MapModulesToServers {{.* .* 
 +WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
 -appname myapp -update -update.ignore.old} 
En langage Jython :
AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*', 
 '+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
 '-appname', 'myapp', '-update', '-update.ignore.old']) 

L'exemple suivant supprime server1 de l'application installée :

A l'aide de Jacl :
$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old} 
En langage Jython :
AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]]) 

MapResEnvRefToRes

L'option MapResEnvRefToRes mappe les références d'environnement de ressources vers des ressources. Vous devez mapper chaque référence d'environnement de ressource définie dans l'application vers une ressource. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
 -MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1}}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear', '[
 -BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
 -MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1 ]]]' ) 
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

L'option MapResRefToEJB mappe les références de ressource vers des ressources. Vous devez mapper chaque référence de ressource définie dans l'application vers une ressource. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Les paramètres de MapResRefToEJB sont les suivants :
  • Module : Ejb1
  • Bean : MailEJBObject
  • URI: deplmtest.jar,META-INF/ejb-jar.xml
  • Référence de ressource : jms/MyConnectionFactory
  • Type de ressource : javax.jms.ConnectionFactory
  • Nom JNDI de la ressource cible : [jms/MyConnectionFactory] :
  • Nom de configuration de connexion : [null] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés : [] : utilisez cette option pour créer une configuration de connexion personnalisée. Le client peut utiliser JAAS pour créer une conception de connexion.
  • Propriétés étendues de sources de données : []: utilisez cette option pour qu'une source de données utilisant un pool de connexions hétérogène puisse se connecter à une base de données DB2. Le masque de la propriété est propriété1=valeur1+propriété2=valeur2

La configuration de connexion DefaultPrincipalMapping est utilisée par les connecteurs J2C (Java 2 Connectors) pour associer les utilisateurs aux principaux définis dans les entrées de données d'authentification J2C. Si login.config.name prend la valeur DefaultPrincipalMapping, une propriété est créée avec le nom com.ibm.mapping.authDataAlias. La valeur de la propriété est définie par auth.props. Si le nom login.config ne prend pas la valeur DefaultPrincipalMapping, auth.props peut spécifier plusieurs propriétés. Le format de la chaîne est websphere:name= <nom1>,value=<valeur1>,description=<desc1>. Pour spécifier plusieurs propriétés, utilisez le signe Plus (+).

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
 javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9 
 javax.mail.Session jndi2 login2 authProps2 ""}}} 
En langage Jacl avec appariement de formes :
$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}
Remarque : Si vous utilisez plusieurs valeurs pour les propriétés étendues de la source de données, vous devez les affecter à une variable et utiliser cette dernière pour la valeur des propriétés. Par exemple :
set s \"value1,value2\"
Dans la substitution de commande, référencez la variable comme indiqué dans l'exemple suivant :
"clientApplicationInformation=value1,value2" avec "clientapplication=$s"
En langage Jython :
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
 mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
 'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]]) 
Avec Jython avec appariement de formes :
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])
Remarque : Si vous utilisez plusieurs valeurs pour les propriétés étendues de la source de données, placez ces valeurs entre guillemets. Par exemple :
'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

L'option MapRolesToUsers mappe les utilisateurs vers des rôles. Vous devez mapper chaque rôle défini dans l'application ou le module vers un utilisateur ou un groupe à partir du registre d'utilisateurs du domaine. Vous pouvez spécifier plusieurs utilisateurs ou groupes pour un rôle unique en les séparant par le signe "|". Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}
En langage Jython :
AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

{{"Tous les rôles" No Yes "" ""} ont la signification suivante :

Tableau 2. Description des options de MapRolesToUsers. Mappez chaque rôle à un utilisateur ou à un groupe.
Option Description
"Tous les rôles" Représente le nom du rôle.
Non Indique d'autoriser l'accès à tous les utilisateurs (oui/non)
Oui Indique d'autoriser l'accès à tous les utilisateurs non authentifiés (oui/non).
"" Indique les utilisateurs mappés.
"" Indique les groupes mappés.
"AllAuthenticatedInTrustedRealms" Indique que tous les utilisateurs valides définis dans le domaine sécurisé disposent du droit d'accès.
"ID des accès utilisateurs mappés" Identifiants des accès utilisateur mappés
"ID des accès groupes mappés" Identifiants des accès groupes mappés

MapRunAsRolesToUsers

L'option MapRunAsRolesToUsers mappe les rôles RunAs vers des utilisateurs. Les beans d'entreprise que vous installez contiennent des rôles d'exécution prédéfinis. Les rôles RunAs sont utilisés par les beans enterprise qui doivent s'exécuter en tant que rôle particulier pour être reconnus pendant l'interaction avec un autre bean enterprise. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

En langage Jython :

[Windows]
AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1][AdminRole administrator administrator]]]')

MapSharedLibForMod

L'option MapSharedLibForMod attribue des bibliothèques partagées à l'application ou à chaque module. Vous pouvez associer plusieurs bibliothèques partagées aux applications et modules. Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module : xxx
  • URI : META-INF/application.xml
  • Bibliothèques partagées : <share libraries>

Pour obtenir des informations sur les données nécessaires à votre application, utilisez la commande taskInfo de l'objet AdminApp.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
 sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

L'option MapWebModToVH sélectionne des hôtes virtuels pour les modules Web. Spécifiez l'hôte virtuel sur lequel vous souhaitez installer les modules Web contenus dans l'application. Vous pouvez installer des modules Web sur le même hôte virtuel ou les répartir sur plusieurs hôtes. Utilisez cette option pour indiquer les données manquantes ou mettre une tâche à jour.

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application. Vous devez fournir des données pour les lignes ou les entrées pour lesquelles il manque des informations ou qui nécessitent une mise à jour.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
En langage Jacl avec appariement de formes :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}
En langage Jython :
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]') 
Avec Jython avec appariement de formes :
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

L'option MetadataCompleteForModules permet à chaque module Java EE 5 ou de version ultérieure d'écrire le descripteur de déploiement complet, y compris les informations de déploiement des annotations. Le système marque alors le descripteur comme complet.

Eviter les incidents Eviter les incidents: Si votre application Java EE version 5 ou ultérieure utilise des annotations et une bibliothèque partagée, n'utilisez pas cette option. Lorsque l'application utilise des annotations et une bibliothèque partagée, si vous affectez à l'attribut metadata-complete la valeur true, le produit représente de manière incorrecte une annotation @EJB dans le descripteur de déploiement sous la forme <ejb-ref>> au lieu de <ejb-local-ref>>. Pour les modules Web, quand vous affectez à l'attribut metadata-complete la valeur true, il se produit des erreurs InjectionException. Si vous devez affecter à l'attribut metadata-complete la valeur true, pour éviter les erreurs, n'utilisez pas de bibliothèque partagée directement mais placez-la plutôt dans le répertoire classes ou lib du serveur d'applications, ou indiquez intégralement les métadonnées dans les descripteurs de déploiement.gotcha
Le contenu actuel de cette option après l'exécution des liaisons par défaut est le suivant :
  • Module : EJBDD_1.jar
  • URI : EJBDD_1.jar,META-INF/ejb-jar.xml
  • Verrouiller le descripteur de déploiement : [false]:
  • Module : EJBNoDD_2.jar
  • URI : EJBNoDD_2.jar,META-INF/ejb-jar.xml
  • Verrouiller le descripteur de déploiement : [false]:

Utilisez la commande taskInfo de l'objet AdminApp pour obtenir les données nécessaires à l'application.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

En langage Jacl avec appariement de formes :

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

En langage Jython :

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

Avec Jython avec appariement de formes :

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

L'option ModuleBuildID affiche l'identificateur de compilation d'un module dans un fichier EAR d'application. Vous ne pouvez pas modifier cette option car elle est en lecture seule. Cette option renvoie les informations de version de compilation d'un module si son identificateur de compilation a été indiqué dans le fichier MANIFEST.MF du module ou du fichier EAR de l'application. Les informations de compilation sont constituées du nom du module, de son URI et de son identificateur de compilation.

A l'issue de l'exécution des liaisons par défaut, le contenu en cours de l'option ressemble à ce qui suit :
  • Module: CacheClient
  • URI: CacheClient.jar,META-INF/application-client.xml
  • Build ID: alpha
  • Module: MailConnector
  • URI: Mail.rar,META-INF/ra.xml
  • Build ID: abc
  • Module: CacheWeb1
  • URI: CacheWeb1.war,WEB-INF/web.xml
  • Build ID: alpha
  • Module: JspWeb1
  • URI: JspWeb1.war,WEB-INF/web.xml
  • Build ID: v1.0
  • Module: Servlet
  • URI: Servlet.war,WEB-INF/web.xml
  • Build ID: 0.5

Exemple d'utilisation en mode de traitement par lots

En langage Jython :

[Windows]
print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

L'option noallowDispatchRemoteInclude désactive l'application d'entreprise qui distribue, via le répartiteur de demandes standard, des includes à des ressources situées dans des modules Web se trouvant sur des machines virtuelles Java différentes dans un environnement de noeuds gérés.

noallowPermInFilterPolicy

L'option noallowPermInFilterPolicy indique que le processus du déploiement d'application ne doit pas continuer si l'application contient des droits basés sur des règles, qui se trouvent dans les règles de filtrage. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.

noallowServiceRemoteInclude

L'option noallowServiceRemoteInclude désactive l'application d'entreprise qui initie une demande d'inclusion à partir d'une application d'entreprise dont l'option allowDispatchRemoteInclude a pour valeur true.

noeud

L'option node indique le nom de noeud pour installer ou mettre à jour une application entière, ou pour mettre à jour une application afin d'ajouter un nouveau module. Si vous souhaitez mettre à jour une application entière, cette option ne s'applique que si l'application contient un nouveau module qui n'existe pas dans l'application d'installation.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install "C:/myapp.ear" {-node nodeName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/myapp.ear" {-node nodeName}

En langage Jython :

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

L'option nocreateMBeansForResources indique qu'il n'est pas créé de beans gérés pour toutes les ressources (servlets, fichiers JSP et beans enterprise) définies dans une application lorsque l'application démarre sur une cible de déploiement. Cette option est le réglage par défaut et elle ne nécessite pas de valeur.

nodeployejb

L'option nodeployejb indique de ne pas exécuter l'outil EJBDeploy au cours de l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.

nodeployws

L'option nodeployws indique de ne pas déployer les services Web au cours de l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.

nodistributeApp

L'option nodistributeApp indique que le composant de gestion d'application ne distribue pas les fichiers binaires de l'application. Cette option ne nécessite pas de valeur. Le réglage par défaut est l'option distributeApp.

noenableClientModule

L'option noenableClientModule indique qu'il ne faut pas déployer les modules client. Cette option ne nécessite pas de valeur. Il s'agit de la valeur par défaut. Par défaut, les modules client ne sont pas déployés. Utilisez l'option enableClientModule pour déployer les modules client.

noreloadEnabled

L'option noreloadEnabled désactive le rechargement des classes. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur. Utilisez l'option reloadEnabled pour demander que le système de fichiers de l'application soit balayé afin d'y détecter les fichiers modifiés et de les recharger dynamiquement.

nopreCompileJSPs

L'option nopreCompileJSPs indique que les fichiers JavaServer Pages ne doivent pas être précompilés. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.

noprocessEmbeddedConfig

L'option noprocessEmbeddedConfig indique que le système doit ignorer les données de configuration incluses dans l'application. Cette option ne nécessite pas de valeur. Si le fichier EAR de l'application ne contient pas de données de configuration, l'option noprocessEmbeddedConfig constitue le réglage par défaut. Autrement, le réglage par défaut est l'option processEmbeddedConfig.

nouseAutoLink

L'option nouseAutoLink spécifie de ne pas utiliser l'option useAutoLink qui permet de résoudre automatiquement les références d'EJB (Enterprise JavaBeans) à partir des versions de modules EJB antérieures à la version 3.0, et de modules Web antérieures à la version 2.4.

nouseMetaDataFromBinary

L'option nouseMetaDataFromBinary indique que les métadonnées utilisées lors de l'exécution, par exemple, les descripteurs de déploiement, les liaisons, les extensions, etc. proviennent du référentiel de configuration. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur. Utilisez cette option pour indiquer que les métadonnées utilisées lors de l'exécution proviennent du fichier EAR (Enterprise Archive).

nousedefaultbindings

L'option nousedefaultbindings indique que les liaisons par défaut ne doivent pas être utilisées pour l'installation. Il s'agit de l'option par défaut et il n'est pas nécessaire d'indiquer de valeur.

novalidateSchema

L'option novalidateSchema indique qu'il ne faut pas valider les descripteurs de déploiement par rapport aux schémas de descripteur de déploiement Java EE. Cette option ne nécessite pas de valeur. Il s'agit de la valeur par défaut. Par défaut, il ne faut pas valider les descripteurs de déploiement.

operation

L'option operation indique l'opération à effectuer. Cette option s'applique uniquement à la commande update ou updateInteractive. Les valeurs valides sont les suivantes :
  • add - Ajoute un nouveau contenu.
  • addupdate - Ajoute ou met à jour un contenu en fonction de l'existence du contenu dans l'application.
  • delete - Supprime un contenu.
  • update - Met à jour un contenu existant.

L'option operation est nécessaire si le type de contenu est file ou modulefile. Si la valeur du type de contenu est app, la valeur de l'option operation doit être update. L'option contenturi est ignorée lorsque le type de contenu est app.

Exemple d'utilisation en mode de traitement par lots

Les exemples suivants indiquent comment utiliser les options de la commande update pour mettre à jour l'intégralité d'une application d'entreprise déployée :

A l'aide de Jacl :
$AdminApp update "IVT Application" app {-operation update
 -contents app_server_root/installableApps/ivtApp.ear}
A l'aide de la chaîne Jython :
AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents app_server_root/installableApps/ivtApp.ear ]' )

Les exemples suivants indiquent comment utiliser les options pour permettre à la commande update de mettre à jour un fichier unique dans une application déployée :

A l'aide de Jacl :

[Windows]
$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

A l'aide de la chaîne Jython :

[Windows]
AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

A l'aide de la liste Jython :

[Windows]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', ['-operation',  'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

AdminApp est l'objet de scriptage, update est la commande, app1 est le nom de l'application à mettre à jour, file est le type de contenu, operation est une option de la commande update, update est la valeur de l'option operation, contents est une option de la commande update, /apps/app1/my.xml est la valeur de l'option contents, contenturi est l'option de la commande update et app1.jar/my.xml est la valeur de l'option contenturi.

processEmbeddedConfig

L'option processEmbeddedConfig traite les données de configuration embarquées dans l'application. Cette option ne nécessite pas de valeur. Si le fichier EAR contient des données de configuration, cette option est le réglage par défaut. Dans le cas contraire, le réglage par défaut est l'option nonprocessEmbeddedConfig.

Ce paramètre concerne l'installation des fichiers EAR étendus. Vous obtenez un fichier EAR étendu quand vous exportez une application installée. Les fichiers EAR étendus embarquent une configuration qui est constituée de fichiers tels que resource.xml et variables.xml. Cette option charge une configuration embarquée à partir du fichier EAR et l'applique à la portée de l'application.

Si vous avez exporté l'application à partir d'une cellule autre que la cellule courante et que vous n'avez pas spécifié la variable $(CELL) pour l'option installed.ear.destination quand vous avez installé l'application, utilisez l'option nonprocessEmbeddedConfig pour décompacter le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_courante. Sinon, utilisez la présente option, processEmbeddedConfig, pour décompacter le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_origine, où nom_cellule_origine désigne la cellule où l'application a été installée au départ. Si, lors de la première installation de l'application, vous avez spécifié la variable $(CELL) dans l'option installed.ear.destination, l'installation décompacte le fichier EAR étendu dans le répertoire racine_profil/installedApps/nom_cellule_courante.

preCompileJSPs

L'option preCompileJSPs indique de précompiler les fichiers JSP. Cette option ne nécessite pas de valeur. La valeur par défaut est nopreCompileJSPs. Si vous souhaitez précompiler les fichiers JavaServer Pages, spécifiez-les en tant qu'élément de l'installation. Par défaut, les fichiers JavaServer Pages ne sont pas précompilés. L'option preCompileJSPs est ignorée lors du déploiement et les fichiers JavaServer Pages ne sont pas précompilés. L'indicateur est défini automatiquement à l'aide des outils d'assemblage.

reloadEnabled

L'option reloadEnabled indique les fichiers mis à jour seront recherchés sur le système de fichiers afin que les modifications soient rechargées de manière dynamique. Si cette option est activée, lorsque les classes de l'application sont modifiées, l'application est arrêtée et redémarrée afin de charger les classes mises à jour. Cette option n'est pas le réglage par défaut et elle ne nécessite pas de valeur. Le réglage par défaut est l'option noreloadEnabled.

reloadInterval

L'option reloadInterval indique la période pendant laquelle les fichiers mis à jour sont recherchés sur le système de fichiers afin que les modifications soient rechargées de manière dynamique. La plage valide correspond à une valeur supérieure à zéro. La valeur par défaut est 3 secondes.

SharedLibRelationship

L'option SharedLibRelationship attribue des ID d'actifs ou d'unités de composition en tant que bibliothèques partagées pour chaque module Java EE.

Le contenu actuel de l'option après l'exécution des liaisons par défaut est le suivant :
  • Module : EJB3BNDBean.jar
  • URI : EJB3BNDBean.jar,META-INF/ejb-jar.xml
  • ID de relations : spécifiez l'ID des actifs ou des unités de composition (par exemple, [WebSphere:cuname=sharedLibCU1,cuedition=1.0] ou WebSphere:assetname=sharedLibAsset1.jar)
  • Noms des unités de composition : vous pouvez éventuellement spécifier des noms d'unités de composition pour les ID de relations d'actifs. Le système utilise le nom de l'actif si vous ne spécifiez pas de nom d'unité de composition. []
  • Correspondance de cible : [Yes]:
Vous pouvez spécifier des ID d'actifs et d'unités de composition dans la relation, en sachant que les règles suivantes seront mises en oeuvre :
  • Si vous spécifiez un actif, le système crée une unité de composition avec cet actif dans l'application de niveau métier à laquelle appartient l'application Java EE.
  • Si vous indiquez une valeur pour les noms d'unités de composition, le système fait correspondre chaque nom avec les ID de relations correspondants.
  • Si l'ID de relation est celui d'une unité de composition,le système ignore le nom de l'unité correspondante.
  • Si l'ID de relation est celui d'un actif,le système crée l'unité de composition en utilisant le nom de l'unité correspondante.

Pour spécifier plusieurs ID d'actifs ou d'unités de composition, séparez chaque valeur par le signe Plus (+).

En utilisant la commande edit pour l'application Java EE, vous pouvez substituer à la relation un nouvel ensemble d'ID d'unités de composition, et vous pouvez également ajouter ou supprimer des relations existantes d'unités de composition. La commande edit ne permet pas de spécifier de relation d'actifs. Pour ajouter la relation, faites débuter l'ID de l'unité de composition par un signe Plus (+) et, pour le supprimer des relations existantes, indiquez un dièse (#). Ainsi, la syntaxe +cuname=cu2.zip ajoute à la relation l'unité de composition cu2. #cuname=cu1.zip+cuname=cu2.zip supprime de la relation les unités de composition cu1 et cu2.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar 
 EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}

En langage Jacl avec appariement de formes :

$AdminApp install myapp.ear {-SharedLibRelationship {{.*
 EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}

En langage Jython :

AdminApp.install('myapp.ear', ['-SharedLibRelationship',
 [['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
 'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])

Avec Jython avec appariement de formes :

AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
 'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]

server

L'option server spécifie le nom du serveur sur lequel vous voulez exécuter l'une des actions suivantes :
  • Installer une nouvelle application.
  • Remplacer une application par une version mise à jour. Dans cette situation, cette option ne s'applique que si la mise à jour de l'application contient un nouveau module qui n'existe pas dans l'application déjà installée.
  • Ajouter un nouveau module à une application existante.

Vous ne pouvez pas utiliser ensemble les options -cluster et -server. Si vous souhaitez déployer une application et spécifier le serveur HTTP lors du déploiement, afin que l'application apparaisse dans le fichier plugin-cfg.xml généré, vous devez d'abord installer l'application avec une cible de -cluster. Une fois que vous avez installé l'application, et avant d'enregistrer les changements, utilisez la commande edit de l'objet AdminApp pour ajouter le mappage supplémentaire au serveur Web.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-server server1}

En langage Jython :

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-server server1]')

target

L'option target indique la cible des fonctions d'installation de l'objet AdminApp. Vous trouverez ci-après un exemple d'option cible : WebSphere:cell=mycell,node=mynode,server=myserver

Vous pouvez spécifier plusieurs cibles en les délimitant avec un signe plus (+). Par défaut, les cibles que vous spécifiez lorsque vous installez ou éditez une application remplacent les définitions de cible existantes dans l'application. Vous pouvez utiliser le signe plus (+) au début ou le signe moins (-) respectivement pour ajouter ou supprimer des cibles sans devoir spécifier les cibles qui ne sont pas changées.
Remarque : La syntaxe de mappage cible complète doit être utilisée avec l'option MapModulesToServers s'il existe plusieurs domaines. Vous ne pouvez pas utiliser de signe + au début de la syntaxe pour ajouter une nouvelle cible avec l'option MapModulesToServers lorsqu'il existe plusieurs domaines ; l'environnement d'exécution ne peut pas résoudre correctement les domaines mappés aux cibles de déploiement.

Exemple d'utilisation en mode de traitement par lots

L'exemple suivant spécifie server1 comme serveur cible pour l'installation de l'application :

A l'aide de Jacl :

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}

En langage Jython :

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])

L'exemple suivant spécifie server1 et server2 comme serveurs cible pour l'installation de l'application :

A l'aide de Jacl :
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target
 WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
En langage Jython :
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target",
 "WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])

L'exemple suivant supprime server3 de l'application installée :

A l'aide de Jacl :
$AdminApp install
 app_server_root/binaries/DefaultApplication.ear {-appname MyApp
 -target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
 -update -update.ignore.old}
En langage Jython :
AdminApp.install("app_server_root/binaries/DefaultApplication.ear",
 ["-appname", "MyApp",
 "-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
 "-update", "-update.ignore.old"])

L'exemple suivant ajoute server4 à l'application installée :

A l'aide de Jacl :
$AdminApp update app {-appname MyApp
 -target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
 -contents app_server_root/binaries/DefaultApplication.ear
 -operation update -update.ignore.old}
En langage Jython :
AdminApp.update("app", ["-appname", "MyApp",
 "-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
 "-contents", "app_server_root/binaries/DefaultApplication.ear",
 "-operation", "update", "-update.ignore.old"]) 

update

L'option update met à jour l'application installée à l'aide d'une nouvelle version du fichier EAR. Cette option ne nécessite pas de valeur.

L'application à mettre à jour, spécifiée par l'option appname, doit déjà être installée dans la configuration WebSphere Application Server. L'action de mise à jour fusionne les liaisons de la nouvelle version avec celles de l'ancienne version, désinstalle l'ancienne version puis installe la nouvelle. Les informations de liaison de la nouvelle version du fichier EAR ou du module ont la préférence par rapport aux informations correspondantes de l'ancienne version. Si un élément de liaison est manquant dans la nouvelle version, l'élément correspondant de l'ancienne version est utilisé.

update.ignore.new

L'option update.ignore.new indique que, lors de la mise à jour, les informations de liaison de l'ancienne version de l'application ou du module sont préférées par rapport aux informations de liaison correspondantes de la nouvelle version. Si un élément de liaison est manquant dans l'ancienne version, l'élément de la nouvelle version est utilisé. C'est-à-dire que les liaisons de la nouvelle version de l'application ou du module sont ignorées si une liaison existe dans l'ancienne version. Autrement, les nouvelles liaisons sont acceptées et non pas ignorées. Cette option ne nécessite pas de valeur.

Cette option ne s'applique que si vous spécifiez l'un des éléments suivants :
  • L'option update pour la commande install.
  • Le type de contenu modulefile ou app pour la commande update.

update.ignore.old

L'option update.ignore.old indique que, pendant l'action de mise à jour, les informations de liaison de la nouvelle version de l'application ou du module sont préférées par rapport aux informations de liaison correspondantes de l'ancienne version. Les liaisons de l'ancienne version de l'application ou du module sont ignorées. Cette option ne nécessite pas de valeur. Cette option ne s'applique que si vous spécifiez l'un des éléments suivants :
  • L'option update pour la commande install.
  • Le type de contenu modulefile ou app pour la commande update.

useAutoLink

L'option useAutoLink permet de résoudre automatiquement les références d'EJB (Enterprise JavaBeans) à partir des versions de modules EJB antérieures à la version 3.0, et de modules Web antérieures à la version 2.4. Si vous activez l'option useAutoLink, vous pouvez, si vous le voulez, spécifier le nom JNDI pour l'option MapEJBRefToEJB. Chacun des modules de l'application doit partager une cible commune pour activer la prise en charge d'autolink.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :

[Windows]
$AdminApp install C:/myapp.ear {-useAutoLink} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-useAutoLink} 

En langage Jython :

[Windows]
AdminApp.install('C:/myapp.ear','[-useAutoLink]') 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear','[-useAutoLink]') 

usedefaultbindings

L'option usedefaultbindings indique que les liaisons par défaut doivent être utilisées pour l'installation. Cette option ne nécessite pas de valeur. Le réglage par défaut est nousedefaultbindings.

Pour utiliser le port d'écoute existant au lieu d'utiliser ou de créer une spécification d'activation, déterminez si la version JAR d'EJB est inférieure à 2.1. Le système crée et utilise automatiquement une spécification d'activation que vous spécifiez à l'aide de l'option -usedefaultbindings pour déployer une application. Si une spécification d'activation existe, le système ignore le port d'écoute, mais utilise la spécification d'activation. Pour déployer une application avec une version JAR d'EJB supérieure ou égale à 2.1 utilisant les ports d'écoute définis au lieu d'une nouvelle spécification d'activation, attribuez la valeur true à la propriété système com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting dans le fichier wsadmin.properties figurant dans le répertoire des propriétés du profil concerné.

useMetaDataFromBinary

L'option useMetaDataFromBinary indique que les métadonnées utilisées lors de l'exécution, par exemple, les descripteurs de déploiement, les liaisons, les extensions, etc. proviennent du fichier EAR. Cette option ne nécessite pas de valeur. La valeur par défaut est nouseMetaDataFromBinary, qui signifie que les métadonnées utilisées lors de l'exécution proviennent du référentiel de configuration.

validateinstall

L'option validateinstall indique le niveau de validation de l'installation de l'application. Les valeurs d'option possibles sont les suivantes :
  • off - Spécifie l'absence de validation de déploiement d'application. Il s'agit de la valeur par défaut.
  • warn - Effectue une validation de déploiement d'application et poursuit le processus de déploiement d'application même si des messages d'avertissement ou d'erreur ont été générés.
  • fail - Effectue une validation de déploiement d'application mais ne poursuit pas le processus de déploiement d'application si des messages d'avertissement ou d'erreur sont générés.

validateSchema

L'option validateSchema indique qu'il faut valider les descripteurs de déploiement par rapport aux schémas de descripteur de déploiement Java EE. Lorsque cette option de déploiement d'application est sélectionnée, le produit analyse chaque descripteur de déploiement pour déterminer la version de la spécification Java EE pour le descripteur de déploiement, sélectionne le schéma approprié, puis vérifie le descripteur de déploiement par rapport au schéma du descripteur de déploiement Java EE. Les erreurs de validation génèrent des messages d'erreur.

Cette option ne nécessite pas de valeur. La valeur par défaut est novalidateSchema. Par défaut, l'option validateSchema est ignorée pendant le déploiement et le produit ne valide pas les descripteurs de déploiement.

verbose

L'option verbose permet l'affichage de messages supplémentaires au cours de l'installation. Cette option ne nécessite pas de valeur.

WebServicesClientBindDeployedWSDL

L'option WebServicesClientBindDeployedWSDL identifie le service Web client que vous modifiez. Les zones de portée sont les suivantes : Module, EJB et Service Web. La valeur unique variable pour cette tâche est le nom de fichier WSDL déployé. Elle indique le langage de description de services Web (WSDL) utilisé par le client.

La zone Module identifie le module EJB ou Web dans l'application. Si le module est un bean enterprise, la zone EJB identifie un bean enterprise déterminé dans le module. La zone Service Web identifie le service Web dans le bean enterprise ou dans le module d'application Web. Cet identifiant correspond à l'attribut wsdl:service dans le fichier WSDL, dont le préfixe est service/. Exemple : service/WSLoggerService2.

L'attribut WSDL déployé nomme un fichier WSDL par rapport au module client. Voici un exemple de fichier WSDL déployé pour une application Web : WEB-INF/wsdl/WSLoggerService.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}} 
En langage Jacl avec appariement de formes :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}
L'exemple suivant illustre les options BindJndiForEJBNonMessageBinding, Hermaphrodite et WebServicesClientBindDeployedWSDL :
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
En langage Jython :
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]') 
Pour installer le fichier WebServicesSamples.ear, vous devez spécifier les options BindJndiForEJBNonMessageBinding et MapWebModToVH, ainsi que l'option WebServicesClientBindDeployedWSDL :
$AdminApp install WebServicesSamples.ear', '[ 
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' ) 
Avec Jython avec appariement de formes :
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*',  'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

L'option WebServicesClientBindPortInfo identifie le port d'un service Web client que vous modifiez. Les zones de portée sont les suivantes : Module, EJB, Service Web et Port. Les valeurs modifiables de cette tâche comprennent Sync Timeout, BasicAuth ID, BasicAuth Password, SSL Config et Overridden Endpoint URI. Les zones Authentification de base et Secure Sockets Layer (SSL) concernent la sécurité au niveau du transfert et non au niveau des services Web.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig 
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}} 
Pour installer le fichier WebServicesSamples.ear, vous devez spécifier les options BindJndiForEJBNonMessageBinding et MapWebModToVH, ainsi que l'option WebServicesClientBindPortInfo :
$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
 jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
 EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
En langage Jacl avec appariement de formes :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
En langage Jython :
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
 newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]') 
Pour installer le fichier WebServicesSamples.ear, vous devez spécifier les options BindJndiForEJBNonMessageBinding et MapWebModToVH, ainsi que l'option WebServicesClientBindPortInfo :
AdminApp.install('WebServicesSamples.ear', '[ 
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
Avec Jython avec appariement de formes :
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

L'option WebServicesClientBindPreferredPort associe un port préféré (implémentation) à un type de port (interface) pour un service Web client. Les valeurs non modifiables de cette fonction identifient le type de port du service Web client que vous modifiez. Les zones de portée sont les suivantes : Module, EJB, Service Web et Type de port. La valeur modifiable de cette tâche est Port.
  • Type de port - QName ("{namespace} localname") d'un type de port défini par l'attribut wsdl:portType dans le fichier WSDL qui identifie une interface.
  • Port - QName d'un port défini par l'attribut wsdl:port dans un attribut wsdl:service dans un fichier WSDL qui identifie une implémentation qui prévaut.

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}} 
Pour installer le fichier WebServicesSamples.ear, vous devez spécifier les options BindJndiForEJBNonMessageBinding et MapWebModToVH, ainsi que l'option WebServicesClientBindPreferredPort :
$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 
En langage Jacl avec appariement de formes :
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}
En langage Jython :
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]') 
Pour installer le fichier WebServicesSamples.ear, vous devez spécifier les options BindJndiForEJBNonMessageBinding et MapWebModToVH, ainsi que l'option WebServicesClientBindPreferredPort :
AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )
Avec Jython avec appariement de formes :
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

L'option WebServicesServerBindPort définit deux attributs d'un port de service Web. Les valeurs non modifiables identifient le port d'un service Web que vous modifiez. Les zones de portée sont les suivantes : Module, Service Web et Port. Les valeurs modifiables incluent WSDL Service Name et Scope.

La portée détermine le cycle de vie de l'implémentation du bean Java. Les valeurs admises comprennent Request (nouvelle instance pour chaque demande), Application (une instance pour chaque Web-app) et Session (nouvelle instance pour chaque session HTTP).

L'attribut scope ne concerne pas les services Web transférés par un service JMS (Java Message Service). L'attribut de la portée ne s'applique pas aux beans enterprise.

Le nom de service WSDL identifie un service lorsque plusieurs services possèdent le même nom de port. Le nom de service WSDL est représenté sous forme de chaîne QName. Par exemple, {namespace}localname .

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}
En langage Jacl avec appariement de formes :
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}
En langage Jython :
AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
 [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')
Avec Jython avec appariement de formes :
AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

L'option WebServicesClientCustomProperty prend en charge la configuration du paramètre nom/valeur pour la description du fichier de liaison client d'un service Web. Les valeurs non modifiables identifient le port du service Web que vous modifiez. Les zones de portée sont les suivantes : Module, Service Web et Port. Les valeurs modifiables incluent name et value.

Le format des valeurs name et value inclut une chaîne représentant plusieurs paires nom/valeur et utilisant le signe + comme séparateur. Par exemple, name = "n1+n2+n3" value = "v1+v2+v3" génère les paires nom/valeur {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
 STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}
En langage Jacl avec appariement de formes :
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}
En langage Jython :
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote',
 'propname2', 'propValue2']]])
Avec Jython avec appariement de formes :
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

L'option WebServicesServerCustomProperty prend en charge la configuration du paramètre nom/valeur pour la description du fichier de liaison du serveur d'un service Web. Les zones de portée sont les suivantes : Module, EJB et Service Web. Les valeurs modifiables pour cette tâche incluent name et value.

Le format de ces valeurs inclut une chaîne représentant plusieurs paires nom/valeur en utilisant le signe "+" comme séparateur. Par exemple, name = "n1+n2+n3" value = "v1+v2+v3" génèrent les paires nom/valeur {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}

Exemple d'utilisation en mode de traitement par lots

A l'aide de Jacl :
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
En langage Jacl avec appariement de formes :
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
En langage Jython :
AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
 [[AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')
Avec Jython avec appariement de formes :
AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_taskoptions
Nom du fichier : rxml_taskoptions.html