Tâches et des points d'extension pour le code personnalisé

Propriétés communes

Ces attributs sont un reflet des attributs similaires présents dans la tâche WsAdmin. Pas tous les attributs de la tâche WsAdmin sont utilisés et certains ont une plage de valeurs limitée. Aucune de ces valeurs n'est écrite dans le profil dynamique.

Tableau 1. Propriétés WPLC communes Ce tableau répertorie les propriétés communes que vous pouvez utiliser avec vos points d'extension.
Attribut	Description	Requise	Portée
wasuser	Contient l'ID utilisateur permettant de s'authentifier auprès du serveur.	Oui	Global
waspassword	Contient le mot de passe qui est associé à l'ID utilisateur wasuser pour l'authentification auprès du serveur.	Oui	Global
conntype	Indique le type de connexion serveur. Les valeurs admises sont les suivantes : `SOAP` : Permet d'activer une connexion SOAP. Il s'agit de la valeur par défaut. `NONE` : Aucune connexion serveur n'est utilisée. En revanche, une connexion directe au référentiel de configuration WebSphere® Application Server local est utilisée.	Non	Global
properties	Le fichier de propriétés Java contenant des attributs à définir dans les propriétés système JVM. La valeur par défaut est `${EngineInstallLocation}/config/work/was/jacl.properties`.	Non	Global
script	Fournit l'emplacement du fichier de script de déploiement. Ce fichier contient un ensemble de commandes à transmettre au processeur de script WsAdmin. Définissez l'attribut lang pour déterminer le processeur de script. S'il n'est pas spécifié, chaque tâche de déploiement attribue un emplacement de script par défaut. Celui-ci est généré à partir du répertoire de base du moteur de configuration et un nom spécifique à la tâche. Par exemple, wplc_deployEar. Reportez-vous à la tâche individuelle pour ce nom. Définissez l'attribut lang pour déterminer l'extension de fichier.	Non	Global
lang	Contient le langage à utiliser pour interpréter les scripts. Les valeurs admises sont les suivantes : `jacl` : Utiliser l'interpréteur Jacl. Il s'agit de la valeur par défaut. `jpython` : Utiliser l'interpréteur Jacl Python.	Non	Global

Attributs spécifiques au cadre

Ces attributs fournissent des informations sur l'environnement d'exécution associé au moteur de configuration.

Tableau 2. Les attributs spécifiques au cadre Attributs de l'environnement d'exécution.
Attribut	Description	Requise	Portée
engineinstalllocation	L'emplacement du répertoire de base du moteur de configuration. Cet emplacement est utilisé comme racine lorsque vous construisez la plupart des emplacements par défaut. La valeur par défaut est la valeur de la propriété Ant : engineInstallLocation.	Non	Global
engineinstalllocation	Emplacement d'un fichier de déploiement contenant tous ou une partie des attributs de déploiement des ressources ciblées. Ce fichier est un fichier XML dont la syntaxe reflète celui de la tâche Ant qui fait référence au fichier.	Non	non applicable

La balise de formatage intégrée

Les balises de formatage suivantes sont prises en charge.

La balise de formatage de commentaires

Utilisez la balise de formatage de commentaire pour intégrer un commentaire dans une valeur de tâche. Le texte du commentaire est affiché au cours de la tâche de sortie de trace, délimité par des parenthèses. Il n'est pas inclus dans la valeur qui est transmise à la tâche d'exécution. Utilisez <c> ou <comment> pour commencer un commentaire. Cette balise n'a pas d'attribut.

La balise de formatage par défaut

Utilisez la balise de formatage par défaut pour imposer une valeur par défaut comme valeur de tâche. La valeur par défaut est choisie si la valeur cible correspond à une chaîne vide. Sinon, elle est ignorée. Utilisez <d> ou <default> pour délimiter le texte qui est défini par défaut. Cette balise comprend l'attribut unique suivant :

value : Valeur par défaut. Cet attribut est obligatoire.

Balise de formatage <lower>

Utilisez la balise de formatage de minuscules pour imposer le texte en minuscule. Utilisez <l> ou <lower> pour délimiter la casse de texte à minuscule. Cette balise n'a pas d'attribut.

La balise de formatage de mot de passe

Utilisez la balise de formatage de mot de passe pour indiquer une partie de texte qui doit rester masquée (ou dissimulée) chaque fois que la valeur de texte est consignée. Utilisez <p>, <pw>, ou <password> pour indiquer le début du texte de mot de passe. Cette balise n'a pas d'attribut. La valeur par défaut est de substituer la chaîne, PASSWORD_REMOVED, correspondant à la valeur de texte lors de la consignation. Vous pouvez substituer cette valeur avec l'attribut log.

log : la valeur qui est remplacée par le mot de passe réel lors de la consignation de la tâche. La valeur par défaut est PASSWORD_REMOVED. Cet attribut est obligatoire.

La balise de formatage de majuscules

Utilisez la balise de formatage de majuscules pour imposer le texte en majuscule. Utilisez <u> ou <upper> pour délimiter la casse de texte à majuscule. Cette balise n'a pas d'attribut.

Exemples

L'exemple suivant illustre l'utilisation pour chacune des balises prises en charge. La dernière instance incorpore une balise non définie. Cette balise entraîne l'arrêt de l'analyse et se traduit par une valeur qui n'est pas modifiée.

<wplc-create-variable server="server"
      node="node"
      wasuser="${WasUserid}"
      waspassword="${WasPassword}"
      testbeanclass="com.ibm.wplc.deploy.tasks.impl.TestAdminBeanImpl">
      <resource name="r1" value="&lt;cValue for r1&lt;/>v1"/>       
				<resource name="r2" value="&lt;dvalue=&quot;xxx&quot;> &lt;/>"/>     
				<resource name="r3" value="<u>uPpEr</u>"/>       
				<resource name="r4" value="<l>LoWeR</l>"/>       
				<resource name="r5" value="<p>password</p>"/>       
				<resource name="r6" value="<p log="SECRET">password</p>"/>       
				<resource name="r7" value="<undefined attr="Attribute">password</undefined>"/>     
</wplc-create-variable>

L'exécution de la tâche précédente génère la trace suivante. Le deuxième ensemble de sortie pour chaque instance est généré par la classe de bean de test. Cette classe de bean est une implémentation de bean factice qui est utilisée pour répercuter la sortie transmise à un bean pour chaque tâche WPLC.

    [wplc-create-variable] Task parameters:
    [wplc-create-variable]   Global attributes:
    [wplc-create-variable]     cell=""
    [wplc-create-variable]     engineinstalllocation="directory_path"
    [wplc-create-variable]     pathseparator=";"
    [wplc-create-variable]     osarch="x86"
    [wplc-create-variable]     node="node"
    [wplc-create-variable]     server="server"

    [wplc-create-variable]   Instance attributes (Set 1 of 7):
    [wplc-create-variable]     name="r1"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="(Comment:  Value for r1)v1"
    [wplc-create-variable] name="r1"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="v1"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 2 of 7):
    [wplc-create-variable]     name="r2"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="xxx"
    [wplc-create-variable] name="r2"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="xxx"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 3 of 7):
    [wplc-create-variable]     name="r3"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="UPPER"
    [wplc-create-variable] name="r3"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="UPPER"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 4 of 7):
    [wplc-create-variable]     name="r4"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="lower"
    [wplc-create-variable] name="r4"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="lower"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 5 of 7):
    [wplc-create-variable]     name="r5"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="PASSWORD_REMOVED"
    [wplc-create-variable] name="r5"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 6 of 7):
    [wplc-create-variable]     name="r6"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="SECRET"
    [wplc-create-variable] name="r6"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

    [wplc-create-variable]   Instance attributes (Set 7 of 7):
    [wplc-create-variable]     name="r7"
    [wplc-create-variable]     description= *** NOT_SPECIFIED ***
    [wplc-create-variable]     value="password"
    [wplc-create-variable] name="r7"
    [wplc-create-variable] engineinstalllocation="directory_path"
    [wplc-create-variable] node="node"
    [wplc-create-variable] server="server"
    [wplc-create-variable] pathseparator=";"
    [wplc-create-variable] osarch="x86"
    [wplc-create-variable] value="password"
    [wplc-create-variable] cell=""
    [wplc-create-variable] description=""

wplc-create-application-library-ref

Définition et utilisation

Utilisez cette tâche Ant pour créer ou modifier la référence de bibliothèque spécifiée.

Paramètres obligatoires

Les paramètres suivants sont obligatoires :

appName : nom de l'application avec la référence de bibliothèque requise. La portée est l'instance.
libraryName : nom de la référence de bibliothèque. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

mode : mode du chargeur de classe. La portée est l'instance.
sharedClassloader : valeur booléenne utilisée pour indiquer s'il faut utiliser un chargeur de classe partagé. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationLibraryRefCreateImpl implémente cette tâche.

wplc-remove-application-library-ref

Définition et utilisation

Utilisez cette tâche Ant pour supprimer la référence de bibliothèque spécifiée.

Paramètres requis

Les paramètres suivants sont obligatoires :

appName : Nom de l'application avec la référence de bibliothèque requise. La portée est l'instance.
libraryName : Nom de la référence de bibliothèque. La portée est l'instance.

Paramètres facultatifs

Le paramètre suivant est facultatif :

mode : mode du chargeur de classe. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationLibraryRefRemoveImpl implémente cette tâche.

wplc-create-app-server-classloader

Description et utilisation

Utilisez cette tâche Ant pour créer le chargeur de classe de serveur d'applications spécifié.

Paramètres requis

Les paramètres suivants sont obligatoires :

mode : mode de fonctionnement du chargeur de classe du serveur d'applications. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type nœud de l'action de ressource. La portée est Global.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

Paramètre attribute générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerClassloaderCreateImpl implémente cette tâche.

wplc-remove-app-server-classloader

Description et utilisation

Utilisez cette tâche Ant pour créer le chargeur de classe de serveur d'applications spécifié.

Paramètres requis

Les paramètres suivants sont obligatoires :

mode : mode de fonctionnement du chargeur de classe du serveur d'applications. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type noeud de l'action de ressource. La portée est Global.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

Paramètre attribute générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerClassloaderCreateImpl implémente cette tâche.

wplc-create-app-server-custom-property

Description et utilisation

Utilisez cette tâche Ant pour créer ou modifier une propriété personnalisée.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la propriété à créer. La portée est l'instance.
value : valeur de la propriété à créer. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
description : description de la propriété que vous créez. La portée est l'instance.
node : portée de type nœud de l'action de ressource. La portée est Global.
required : valeur booléenne utilisée pour indiquer si la propriété est requise. La portée est l'instance.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerCustomPropertyCreateImpl implémente cette tâche.

wplc-remove-app-server-custom-property

Description et utilisation

Utilisez cette tâche Ant pour supprimer une propriété personnalisée.

Paramètres requis

Le paramètre suivant est requis :

name : nom de la propriété à retirer. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type noeud de l'action de ressource. La portée est Global.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

Paramètre attribute générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerCustomPropertyRemoveImpl implémente cette tâche.

wplc-create-app-server-library-ref

Description et utilisation

Utilisez cette tâche Ant pour créer ou modifier la référence spécifiée.

Paramètres requis

Les paramètres suivants sont obligatoires :

libraryName : indique la référence de bibliothèque à ajouter. La portée est l'instance.
mode : mode du chargeur de classe. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type nœud de l'action de ressource. La portée est Global.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerLibraryRefCreateImpl implémente cette tâche.

wplc-remove-app-server-library-ref

Description et utilisation

Utilisez cette tâche Ant pour supprimer la référence de bibliothèque spécifiée.

Paramètres requis

Les paramètres suivants sont obligatoires :

libraryName : indique la référence de bibliothèque à retirer. La portée est l'instance.
mode : mode du chargeur de classe. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type nœud de l'action de ressource. La portée est Global.
server : portée de type serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationServerLibraryRefRemoveImpl implémente cette tâche.

wplc-create-cmp-connection-factory

Description et utilisation

Utilisez cette tâche Ant pour ajouter une source de données à l'adaptateur CMP J2CResourceAdaptor spécifié.

Paramètres requis

Les paramètres suivants sont obligatoires :

authDataAlias : alias d'authentification utilisé dans cette procédure de liaison. La portée est l'instance.
datasourcename : nom de la source de données. La portée est l'instance.
j2cresourceadaptorname : nom de l'adaptateur de ressources J2C. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
containerauthalias : alias d'autorisation pour le conteneur. La portée est l'instance.
containermappingalias : alias de mappage pour le conteneur. La portée est l'instance.
description : description de la source de données. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être le cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.
usecontainer : utiliser le conteneur. La valeur doit être true ou false. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

customproperty - utilisé pour créer une propriété personnalisée sous cette source de données.

name : Nom de la propriété personnalisée.
value : valeur de la propriété personnalisée.

connectionpool - utilisé pour définir les propriétés de pool de connexions pour cette source de données.

name : nom du pool de connexions.
value : valeur du pool de connexions.

relationalresourceadapter - utilisé pour définir les propriétés d'adaptateur de ressources relationnelles pour cette source de données.

name : nom de l'adaptateur de ressources relationnelles.
value : valeur de l'adaptateur de ressources relationnelles.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.CMPConnectionFactoryCreateImpl implémente cette tâche.

wplc-remove-cmp-connection-factory

Description et utilisation

Utilisez cette tâche Ant pour supprimer une source de données de l'adaptateur CMP J2CResourceAdaptor spécifié.

Paramètres requis

Les paramètres suivants sont obligatoires :

containermappingalias : alias de mappage pour le conteneur.
datasourcename : Nom de la source de données. La portée est l'instance.
j2cresourceadaptorname : : nom de l'adaptateur de ressources J2C. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
containerauthalias : alias d'autorisation pour le conteneur. La portée est l'instance.
containermappingalias : alias de mappage pour le conteneur. La portée est l'instance.
description : description de la source de données. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être le cluster, s'il existe. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.
usecontainer : utiliser le conteneur. La valeur doit être true ou false. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

customproperty - utilisé pour créer une propriété personnalisée sous cette source de données.

name : Nom de la propriété personnalisée.
value : valeur de la propriété personnalisée.

connectionpool - utilisé pour définir les propriétés de pool de connexions pour cette source de données.

name : nom du pool de connexions.
value : valeur du pool de connexions.

relationalresourceadapter - utilisé pour définir les propriétés d'adaptateur de ressources relationnelles pour cette source de données.

name : nom de l'adaptateur de ressources relationnelles.
value : valeur de l'adaptateur de ressources relationnelles.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.CMPConnectionFactoryRemoveImpl implémente cette tâche.

wplc-create-datasource

Description et utilisation

Utilisez cette tâche Ant pour créer une source de données au niveau de la portée cible.

Paramètres requis

Les paramètres suivants sont obligatoires :

datasourcename : Nom de la source de données. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
containerauthalias : alias d'autorisation pour le conteneur. La portée est l'instance.
containermappingalias : alias de mappage pour le conteneur. La portée est l'instance.
DbDriverType : indique le type de pilote pour cette source de données. Il peut s'agir pilote de type 2 ou 4 pour cette base de données. La portée est l'instance.
DbType : type de base de données pour cette source de données. Utilisez ce paramètre pour spécifier le type de base de données, par exemple : db2, oracle, sqlserver, db2 for zOS. La portée est l'instance.
DbUrl : URL de la base de données Utilisez la source de données pour se connecter à la base de données. Le nom de la base de données s'affiche dans cette URL. La portée est l'instance.
description : description de la source de données. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
isPortalDatasource : indique si ce paramètre est un domaine source de données de Portal. Les domaines de source de données de portail sont régis par des règles spéciales pour la fonction config-split et de domaine de base de données dans Portal. Si votre source de données n'est pas régie par ces règles, entrez false. La valeur par défaut de cette propriété est true. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
portalDomain : requis uniquement pour les sources de données basées sur un domaine HCL Portal. Ce paramètre indique le nom du domaine de la source de données. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.
templatename : nom du modèle WebSphere à suivre lors de la création de la source de données. La portée est l'instance.
usecontainer : utiliser le conteneur. La valeur doit être true ou false. La portée est l'instance.
useXA : indiquez si cette source de données utilise des connexions XA. The value must be set to true or false. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

customproperty - utilisé pour créer une propriété personnalisée sous cette source de données.

name : Nom de la propriété personnalisée.
value : valeur de la propriété personnalisée.

connectionpool - utilisé pour définir les propriétés de pool de connexions pour cette source de données.

name : nom du pool de connexions.
value : valeur du pool de connexions.

relationalresourceadapter - utilisé pour définir les propriétés d'adaptateur de ressources relationnelles pour cette source de données.

name : nom de l'adaptateur de ressources relationnelles.
value : valeur de l'adaptateur de ressources relationnelles.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.DataSourceCreateImpl implémente cette tâche.

wplc-modify-datasource

Description et utilisation

Utilisez cette tâche Ant pour modifier une source de données au niveau de la portée cible.

Paramètres requis

Les paramètres suivants sont obligatoires :

datasourcename : Nom de la source de données. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
containerauthalias : alias d'autorisation pour le conteneur. La portée est l'instance.
containermappingalias : alias de mappage pour le conteneur. La portée est l'instance.
description : description de la source de données. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.
usecontainer : utiliser le conteneur. La valeur doit être true ou false. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

customproperty - utilisé pour créer une propriété personnalisée sous cette source de données.

name : Nom de la propriété personnalisée.
value : valeur de la propriété personnalisée.

connectionpool - utilisé pour définir les propriétés de pool de connexions pour cette source de données.

name : nom du pool de connexions.
value : valeur du pool de connexions.

relationalresourceadapter - utilisé pour définir les propriétés d'adaptateur de ressources relationnelles pour cette source de données.

name : nom de l'adaptateur de ressources relationnelles.
value : valeur de l'adaptateur de ressources relationnelles.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.DataSourceModifyImpl implémente cette tâche.

wplc-remove-datasource

Description et utilisation

Utilisez cette tâche Ant pour supprimer une source de données au niveau de la portée cible.

Paramètres requis

Les paramètres suivants sont obligatoires :

datasourcename : Nom de la source de données. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
portalDomain : requis uniquement pour les sources de données basées sur un domaine WebSphere Portal. Ce paramètre indique le nom du domaine de la source de données. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.DataSourceRemoveImpl implémente cette tâche.

wplc-create-host-alias

Description et utilisation

Utilisez cette tâche Ant pour créer l'alias d'hôte défini.

Paramètres requis

Les paramètres suivants sont obligatoires :

host : nom d'hôte de l'alias d'hôte. La portée est l'instance.
port : numéro de port de cet alias d'hôte. La portée est l'instance.
virtualHostName : nom d'hôte virtuel à utiliser pour l'alias de cet hôte. La portée est l'instance.

Paramètres facultatifs

Le paramètre suivant est facultatif :

cell : portée de type cellule de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.HostAliasCreateImpl implémente cette tâche.

wplc-remove-host-alias

Description et utilisation

Utilisez cette tâche Ant pour supprimer l'alias d'hôte défini.

Paramètres requis

Les paramètres suivants sont obligatoires :

host : nom d'hôte de l'alias d'hôte. La portée est l'instance.
port : numéro de port de cet alias d'hôte. La portée est l'instance.
virtualHostName : nom d'hôte virtuel à utiliser pour l'alias de cet hôte. La portée est l'instance.

Paramètres facultatifs

Le paramètre suivant est facultatif :

cell : portée de type cellule de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.HostAliasRemoveImpl implémente cette tâche.

wplc-create-j2c-auth

Description et utilisation

Utilisez cette tâche Ant pour créer une entrée dans la table de sécurité de la cellule cible. Cette entrée peut être utilisée comme paire utilisateur-mot de passe pour votre configuration.

Paramètres requis

Les paramètres suivants sont obligatoires :

alias : alias utilisé pour identifier ces données d'authentification. La portée est l'instance.
password : mot de passe associé à l'ID utilisateur.
user : nom d'utilisateur permettant de créer une connexion avec ces données d'authentification.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : nom de la cellule dans laquelle ces données d'authentification J2C sont créées, retirées ou modifiées. La portée est Global.
description : description de l'objet de ces données d'authentification et de la connexion qui leur est associée. La portée est l'instance.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.J2CAuthCreateImpl implémente cette tâche.

wplc-modify-j2c-auth

Description et utilisation

Utilisez cette tâche Ant pour modifier une entrée dans la table de sécurité de la cellule cible. Cette entrée peut être utilisée comme paire utilisateur-mot de passe pour votre configuration.

Paramètres requis

Les paramètres suivants sont obligatoires :

alias : alias utilisé pour identifier ces données d'authentification. La portée est l'instance.
password : mot de passe associé à l'ID utilisateur.
user : nom d'utilisateur permettant de créer une connexion avec ces données d'authentification.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : nom de la cellule dans laquelle ces données d'authentification J2C sont créées, retirées ou modifiées. La portée est Global.
description : description de l'objet de ces données d'authentification et de la connexion qui leur est associée. La portée est l'instance.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.J2CAuthModifyImpl implémente cette tâche.

wplc-remove-j2c-auth

Description et utilisation

Utilisez cette tâche Ant pour supprimer une entrée dans la table de sécurité de la cellule cible.

Paramètres requis

Le paramètre suivant est requis :

alias : alias utilisé pour identifier ces données d'authentification. La portée est l'instance.

Paramètres facultatifs

Le paramètre suivant est facultatif :

cell : nom de la cellule dans laquelle ces données d'authentification J2C sont créées, retirées ou modifiées. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.J2CAuthRemoveImpl implémente cette tâche.

wplc-create-jvm-custom-property

Description et utilisation

Utilisez cette tâche Ant pour créer ou mettre à jour une propriété JVM personnalisée dans l'environnement WebSphere® Application Server.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la propriété personnalisée JVM. La portée est l'instance.
value : valeur de la propriété à créer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
description : description de la propriété personnalisée JVM. La portée est l'instance.
node : portée de type nœud de l'action de ressource.
required : valeur booléenne utilisée pour indiquer à WebSphere si la propriété est requise ou non.
server : portée de type serveur de l'action de ressource.
zosProcessDefType : z/OS® uniquement : indique la région pour laquelle cette propriété est créée : Serviteur, Contrôle, ou Adjoint. Valeurs par défaut de Serviteur.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.JVMCustomPropertyCreateImpl implémente cette tâche.

wplc-remove-jvm-custom-property

Description et utilisation

Utilisez cette tâche Ant pour supprimer une propriété personnalisée JVM dans l'environnement WebSphere® Application Server.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : : nom de la propriété personnalisée JVM. La portée est l'instance.
value : valeur de la propriété à créer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : portée de type nœud de l'action de ressource.
server : portée de type serveur de l'action de ressource.
zosProcessDefType : z/OS® uniquement : indique la région depuis laquelle cette propriété est retirée : Servant, Control, or Abjunct. Valeurs par défaut de Servant.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.JVMCustomPropertyRemoveImpl implémente cette tâche.

wplc-create-jdbc-provider

Description et utilisation

Utilisez cette tâche Ant pour créer une ressource de fournisseur JDBC dans la portée cible.

Paramètres requis

Le paramètre suivant est requis :

jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
DbDriverType : indique le type de pilote pour ce fournisseur JDBC. Il peut s'agir pilote de type 2 ou 4 pour cette base de données. La portée est l'instance.
DbType : type de base de données pour ce fournisseur JDBC. Utilisez ce paramètre pour spécifier le type de base de données, par exemple : db2, oracle, sqlserver, db2 for zOS. La portée est l'instance.
DbUrl : URL de la base de données Ce fournisseur JDBC est utilisé pour se connecter à la base de données. Le nom de la base de données s'affiche dans cette URL. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
implementationClassName : nom de classe utilisé pour créer ce fournisseur JDBC. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.
templatename : nom du modèle à suivre lors de la création du fournisseur JDBC. La portée est l'instance.
useXA : indiquez si ce fournisseur JDBC utilise des connexions XA. Définissez la valeur sur true ou false. La portée est l'instance.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.JDBCProviderCreateImpl implémente cette tâche.

wplc-modify-jdbc-provider

Description et utilisation

Utilisez cette tâche Ant pour créer une ressource de fournisseur JDBC dans la portée cible.

Paramètres requis

Le paramètre suivant est requis :

jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.JDBCProviderModifyImpl implémente cette tâche.

wplc-remove-jdbc-provider

Description et utilisation

Utilisez cette tâche Ant pour supprimer une ressource de fournisseur JDBC dans la portée cible.

Paramètres requis

Le paramètre suivant est requis :

jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.JDBCProviderRemoveImpl implémente cette tâche.

wplc-create-library

Description et utilisation

Utilisez cette tâche Ant pour créer ou modifier la bibliothèques spécifiée.

Paramètres requis

Le paramètre suivant est requis :

name : nom de la bibliothèque. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
classpath : indique les entrées de chemin d'accès aux classes à ajouter. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.LibraryCreateImpl implémente cette tâche.

wplc-remove-library

Description et utilisation

Utilisez cette tâche Ant pour supprimer la bibliothèque spécifiée.

Paramètres requis

Le paramètre suivant est requis :

name : nom de la bibliothèque. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.LibraryRemoveImpl implémente cette tâche.

wplc-create-res-env-custom-property

Description et utilisation

Utilisez cette tâche Ant pour créer ou réaffecter une propriété personnalisée de fournisseur d'environnement de ressources.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.
value : valeur de la propriété personnalisée. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
description : description de la propriété personnalisée. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
required : valeur booléenne utilisée pour indiquer si la propriété est requise. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyCreateImpl implémente cette tâche.

wplc-retrieve-res-env-custom-property

Description et utilisation

Utilisez cette tâche Ant pour retourner la valeur d'une propriété personnalisée de fournisseur d'environnement de ressources.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
propToSet : propriété qui est définie dans le projet Ant avec la valeur extraite de cette propriété. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyRetreiveImpl implémente cette tâche.

wplc-remove-res-env-custom-property

Description et utilisation

Utilisez cette tâche Ant pour supprimer une propriété personnalisée de fournisseur d'environnement de ressources.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCustomPropertyRemoveImpl implémente cette tâche.

wplc-create-res-env-entry

Description et utilisation

Utilisez cette tâche Ant pour créer ou modifier une entrée d'environnement de ressources.

Prérequis

Exécutez la tâche wplc-create-res-referenceable avant d'exécuter la tâche wplc-create-res-env-entry. L'entrée de ressource référencée dans la tâche wplc-create-res-env-entry n'est pas créée automatiquement. C'est la tâche wplc-create-res-referenceable qui crée la ressource.

Paramètres requis

Les paramètres suivants sont obligatoires :

jndiName : nom JNDI. La portée est l'instance.
name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.Class : classe du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.FactoryClass : classe de fabrique du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

category : Nom de la catégorie. La portée est l'instance.
cell : cellule de l'action de ressource. La portée est Global.
description : description de l'action de ressource. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCreateImpl implémente cette tâche.

wplc-remove-res-env-entry

Description et utilisation

Utilisez cette tâche Ant pour supprimer une entrée d'environnement de ressources.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryRemoveImpl implémente cette tâche.

wplc-create-res-env-entry-custom-property

Description et utilisation

Utilisez cette tâche Ant pour créer ou réaffecter une propriété SSL personnalisée dans la sécurité WebSphere® Application Server.

Paramètres requis

Les paramètres suivants sont obligatoires :

entryName : nom de l'entrée de ressource à mettre à jour. La portée est l'instance.
name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.
value : valeur de la propriété personnalisée. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
description : description de la propriété personnalisée. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
required : valeur booléenne utilisée pour indiquer si la propriété est requise. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCustomPropertyCreateImpl implémente cette tâche.

wplc-remove-res-env-entry-custom-property

Description et utilisation

Utilisez cette tâche Ant pour supprimer une propriété SSL personnalisée dans la sécurité WebSphere® Application Server.

Paramètres requis

Les paramètres suivants sont obligatoires :

entryName : nom de l'entrée de ressource à mettre à jour. La portée est l'instance.
name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.
providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvEntryCustomPropertyRemoveImpl implémente cette tâche.

wplc-create-resource-env-provider

Description et utilisation

Utilisez cette tâche Ant pour créer un fournisseur d'environnement de ressources au niveau de la portée définie.

Paramètres requis

Le paramètre suivant est requis :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
description : description de la propriété personnalisée. La portée est l'instance.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderCreateImpl implémente cette tâche.

wplc-remove-resource-env-provider

Description et utilisation

Utilisez cette tâche Ant pour supprimer un fournisseur d'environnement de ressources au niveau de la portée définie et avec le nom spécifié.

Paramètres requis

Le paramètre suivant est requis :

name : nom de la ressource à créer, mettre à jour ou modifier. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceEnvProviderRemoveImpl implémente cette tâche.

wplc-create-res-referenceable

Description et utilisation

Utilisez cette tâche Ant pour créer ou modifier une entrée de ressource que vous pouvez référencer.

Important : Exécutez cette tâche avant d'exécuter la tâche wplc-create-res-env-entry. La tâche wplc-create-res-referenceable crée la ressource référencée dans la tâche wplc-create-res-env-entry.

Paramètres requis

Les paramètres suivants sont obligatoires :

providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.Class : classe de référence du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.FactoryClass : classe de fabrique de référence du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être le cluster, s'il existe. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceReferenceableCreateImpl implémente cette tâche.

wplc-remove-res-referenceable

Description et utilisation

Utilisez cette tâche Ant pour supprimer une entrée de ressource que vous pouvez référencer.

Paramètres requis

Les paramètres suivants sont obligatoires :

providerName : nom du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.Class : classe de référence du fournisseur d'environnement de ressources. La portée est l'instance.
referenceable.FactoryClass : classe de fabrique de référence du fournisseur d'environnement de ressources. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ResourceReferenceableRemoveImpl implémente cette tâche.

wplc-create-variable

Description et utilisation

Utilisez cette tâche Ant pour créer ou réaffecter une variable et une valeur d'environnement WebSphere® Application Server.

Paramètres requis

Les paramètres suivants sont obligatoires :

name : Nom de la variable. La portée est l'instance.
value : valeur qui est affectée à la variable. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
description : description de la variable.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.VariableCreateImpl implémente cette tâche.

wplc-remove-variable

Description et utilisation

Utilisez cette tâche Ant pour supprimer une variable et une valeur d'environnement WebSphere® Application Server.

Paramètres requis

Le paramètre suivant est requis :

name : Nom de la variable. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.VariableRemoveImpl implémente cette tâche.

wplc-retrieve-variable

Description et utilisation

Utilisez cette tâche Ant pour extraire une variable et une valeur d'environnement WebSphere® Application Server.

Paramètres requis

Le paramètre suivant est requis :

name : Nom de la variable. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : cellule de l'action de ressource. La portée est Global.
node : nœud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.VariableRetrieveImpl implémente cette tâche.

wplc-create-res-env-directory

Description et utilisation

Utilisez cette tâche Ant pour créer des noms de fichier RP dans le répertoire.

Paramètres requis

Le paramètre suivant est requis :

rpPropertyDirectoryName : nom du répertoire de propriétés. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être un cluster existant. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
rpPrefix : nom du préfixe. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.REProviderCreateByDirectoryImpl implémente cette tâche.

wplc-cluster-sync-all-node

Description et utilisation

Utilisez cette tâche Ant pour synchroniser tous les nœuds du cluster.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ClusterSyncAllNodesImpl implémente cette tâche.

wplc-cluster-sync-single-node

Description et utilisation

Utilisez cette tâche Ant pour synchroniser un seul nœud un cluster.

Paramètres requis

Le paramètre suivant est requis :

syncNode : nom du nœud à synchroniser. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ClusterSyncSingleNodeImpl implémente cette tâche.

wplc-extract-ear-local-or-remote

Description et utilisation

Utilisez cette tâche Ant pour extraire les fichiers EAR localement ou a distance.

Paramètres requis

Les paramètres suivants sont obligatoires :

appName : nom de l'application du fichier EAR. La portée est l'instance.
earFile : répertoire local et fichier de destination de l'exportation du fichier EAR. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ExtractEarLocalOrRemoteImpl implémente cette tâche.

wplc-query-application-list

Description et utilisation

Utilisez cette tâche Ant pour demander la liste des applications installées dans la cellule et la renvoyer dans une chaîne délimitée par des virgules. La liste des applications est placée dans une propriété Ant nommée ${filteredAppList}.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
filter : filtre qui est utilisé pour la requête d'application. Par exemple : PA_.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ApplicationsQueryImpl implémente cette tâche.

wplc-retrieve-datasource-custom-property

Description et utilisation

Utilisez cette tâche Ant pour extraire une valeur des propriétés personnalisées d'une source de données.

Paramètres requis

Les paramètres suivants sont obligatoires :

datasourcename : Nom de la source de données. La portée est l'instance.
jdbcprovidername : nom du fournisseur JDBC qui identifie cette ressource. La portée est l'instance.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
forceScope : affectez la valeur true à ce paramètre si la portée ne doit pas être le cluster existant. La portée est l'instance.
node : noeud de l'action de ressource. La portée est Global.
propertyName : nom de la propriété personnalisée dont la valeur doit être extraite. La portée est l'instance.
propToSet : propriété qui est définie dans le projet Ant avec la valeur extraite de WebSphere® Application Server. La portée est l'instance.
server : serveur de l'action de ressource. La portée est Global.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.DataSourceRetrieveCustomPropertyValue implémente cette tâche.

wplc-wait-for-sync-to-complete

Description et utilisation

Utilisez cette tâche Ant pour attendre la fin de l'extension et de la distribution EAR.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cell : portée de type cellule de l'action de ressource. La portée est Global.
maxAppTimeToWait : délai d'exécution maximal (en minutes) de chaque processus d'extension d'application.
maxTimeToWait : délai d'exécution maximal (en minutes) du processus d'extension.
node : noeud de l'action de ressource. La portée est Global.
server : serveur de l'action de ressource. La portée est Global.
waitTime : délai d'attente entre deux vérifications du déploiement de l'application.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.impl.ClusterWaitForSyncToCompleteImpl implémente cette tâche.

wplc-create-ear

Description et utilisation

Utilisez cette tâche Ant pour déployer une ressource EAR sur l'application cible ou le serveur de portail.

Paramètres requis

Les paramètres suivants sont obligatoires :

appname : nom de l'application du fichier EAR.
earfile : emplacement du fichier EAR à déployer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

cluster : définit le nom de cluster. N'incluez pas d'espaces avec cette valeur. Si le paramètre n'est pas défini, la valeur par défaut est le contexte qui a été défini dans le fichier application.xml du fichier EAR.
classloadermode : définit le mode de délégation du chargeur de classe, également appelé ordre du chargeur de classe. Cette valeur détermine si un chargeur de classe délègue le chargement des classes au chargeur de classe parent. Valeurs prises en charge :
- PARENT_FIRST : délègue le chargement des classes au chargeur parent avant de charger la classe à partir de son chemin local. Il s'agit de la valeur par défaut pour la règle du chargeur de classe et pour les chargeurs de classe de machine virtuelle standard.
- PARENT_LAST : le chargeur de classe tente de charger les classes à partir du chemin d'accès aux classes local avant que vous déléguiez le chargement des classes au chargeur parent. A l'aide de cette règle, un chargeur de classe d'application peut remplacer la classe qui existe dans le chargeur de classe parent et fournir sa propre version.
startingweight : définit le poids de départ de l'application. Le poids de départ indique l'ordre dans lequel les applications sont démarrées lorsque le serveur est lancé. L'application dotée du poids de départ le plus bas est démarrée en premier.
server : le nom du serveur d'applications pour HCL.
node : le nom du nœud WebSphere® Application Server.
cell : le nom de la cellule pour WebSphere® Application Server.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc. Ce paramètre est utilisé pour transmettre les attributs associés à la mesure sur les ressources.

name : Nom de l'attribut.
value : Valeur de l'attribut.

option : les options de déploiement EAR disponibles ne sont pas toutes prises en charge par la syntaxe wplc-create-ear en tant qu'attributs. L'élément option transmet des informations supplémentaires à la structure sous-jacente dans le profil WsAdmin. Cette fonction est similaire à la façon dont les autres paramètres sont transmis au fichier de script WsAdmin. Toutefois, dans ce cas, le jeu complet d'options est regroupé dans une chaîne correspondant à la syntaxe du langage de script.

Ne codez pas des paramètres qui sont inclus en tant qu'attributs sur la tâche en tant qu'options. Utilisez l'attribut correspondant pour éviter les redondances ainsi qu'une exception d'exécution pendant l'analyse syntaxique de la tâche.

La syntaxe de l'élément option imbriqué autorise les trois formats suivants : mot clé uniquement, paire mot clé/valeur, ou mot clé avec liste de valeurs.

key : nom de l'option.
value : valeur de l'option. Si aucune valeur n'est présente et que l'option ne contient d'élément de valeur imbriqué, cette clé ne prend pas de valeur.

Si un mot clé peut adopter une liste de valeurs, un seul élément value imbriqué est utilisé pour chaque valeur dans la liste.

Tableau 3. Exemples du mot clé uniquement, de la paire mot clé/valeur, ou du mot clé avec les formats de la liste de valeurs. Ce tableau explique comment utiliser le mot clé uniquement, la paire mot clé/valeur ou le mot clé avec la liste de valeurs pour l'élément options.
Type de paramètre	Exemple (avec la syntaxe AdminApp)	Syntaxe de l'élément option
Mot clé uniquement	`-nodeployejb`	`<option key="nodeployejb"/>`
Mot clé avec une valeur simple	`-custom value`	`<option key="custom" value="value"/>`
Mot clé avec une liste de valeurs	`-MapresrefToEJB {{value1} {value2} {value3}}`	`<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>`

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarCreate implémente cette tâche.

wplc-edit-ear

Description et utilisation

Utilisez cette tâche Ant pour modifier les attributs de l'application cible.

Paramètres requis

Le paramètre suivant est requis :

appname : nom de l'application du fichier EAR.

Paramètres spécifiés en tant qu'éléments imbriqués

option : les options de déploiement EAR disponibles ne sont pas toutes prises en charge par la syntaxe wplc-create-ear en tant qu'attributs. L'élément option transmet des informations supplémentaires à la structure sous-jacente dans le profil WsAdmin. Cette fonction est similaire à la façon dont les autres paramètres sont transmis au fichier de script WsAdmin. Toutefois, dans ce cas, le jeu complet d'options est regroupé dans une chaîne correspondant à la syntaxe du langage de script.

Ne codez pas des paramètres qui sont inclus en tant qu'attributs sur la tâche en tant qu'options. Utilisez l'attribut correspondant pour éviter les redondances ainsi qu'une exception d'exécution pendant l'analyse syntaxique de la tâche.

La syntaxe de l'élément option imbriqué autorise les trois formats suivants : mot clé uniquement, paire mot clé/valeur, ou mot clé avec liste de valeurs.

key : nom de l'option.
value : valeur de l'option. Si aucune valeur n'est présente et que l'option ne contient d'élément de valeur imbriqué, cette clé ne prend pas de valeur.

Si un mot clé peut adopter une liste de valeurs, un seul élément value imbriqué est utilisé pour chaque valeur dans la liste.

Tableau 4. Exemples du mot clé uniquement, de la paire mot clé/valeur, ou du mot clé avec les formats de la liste de valeurs. Ce tableau explique comment utiliser le mot clé uniquement, la paire mot clé/valeur ou le mot clé avec la liste de valeurs pour l'élément options.
Type de paramètre	Exemple (avec la syntaxe AdminApp)	Syntaxe de l'élément option
Mot clé uniquement	`-nodeployejb`	`<option key="nodeployejb"/>`
Mot clé avec une valeur simple	`-custom value`	`<option key="custom" value="value"/>`
Mot clé avec une liste de valeurs	`-MapresrefToEJB {{value1} {value2} {value3}}`	`<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>`

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarEdit implémente cette tâche.

wplc-update-ear

Description et utilisation

Utilisez cette tâche Ant pour mettre à jour un fichier EAR déjà déployé vers une nouvelle version ou une version modifiée.

Paramètres requis

Les paramètres suivants sont obligatoires :

appname : nom de l'application du fichier EAR.
earfile : emplacement du fichier EAR à déployer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

classloadermode : définit le mode de délégation du chargeur de classe, également appelé ordre du chargeur de classe. Cette valeur détermine si un chargeur de classe délègue le chargement des classes au chargeur de classe parent. Valeurs prises en charge :
- PARENT_FIRST: délègue le chargement des classes à son parent avant que vous chargiez la classe à partir du chemin d'accès aux classes local. Il s'agit de la valeur par défaut pour la règle du chargeur de classe et pour les chargeurs de classe de machine virtuelle standard.
- PARENT_LAST : le chargeur de classe tente de charger les classes à partir du chemin d'accès aux classes local avant que vous déléguiez le chargement des classes au chargeur parent. A l'aide de cette règle, un chargeur de classe d'application peut remplacer la classe qui existe dans le chargeur de classe parent et fournir sa propre version.
startingweight : définit le poids de départ de l'application. Le poids de départ indique l'ordre dans lequel les applications sont démarrées lorsque le serveur est lancé. L'application dotée du poids de départ le plus bas est démarrée en premier.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc. Ce paramètre est utilisé pour transmettre les attributs associés à la mesure sur les ressources.

name : Nom de l'attribut.
value : Valeur de l'attribut.

option : les options de déploiement EAR disponibles ne sont pas toutes prises en charge par la syntaxe wplc-create-ear en tant qu'attributs. L'élément option transmet des informations supplémentaires à la structure sous-jacente dans le profil WsAdmin. Cette fonction est similaire à la façon dont les autres paramètres sont transmis au fichier de script WsAdmin. Toutefois, dans ce cas, le jeu complet d'options est regroupé dans une chaîne correspondant à la syntaxe du langage de script.

Ne codez pas des paramètres qui sont inclus en tant qu'attributs sur la tâche en tant qu'options. Utilisez l'attribut correspondant pour éviter les redondances ainsi qu'une exception d'exécution pendant l'analyse syntaxique de la tâche.

La syntaxe de l'élément option imbriqué autorise les trois formats suivants : mot clé uniquement, paire mot clé/valeur, ou mot clé avec liste de valeurs.

key : nom de l'option.
value : valeur de l'option. Si aucune valeur n'est présente et que l'option ne contient d'élément de valeur imbriqué, cette clé ne prend pas de valeur.

Si un mot clé peut adopter une liste de valeurs, un seul élément value imbriqué est utilisé pour chaque valeur dans la liste.

Tableau 5. Exemples du mot clé uniquement, de la paire mot clé/valeur, ou du mot clé avec les formats de la liste de valeurs. Ce tableau explique comment utiliser le mot clé uniquement, la paire mot clé/valeur ou le mot clé avec la liste de valeurs pour l'élément options.
Type de paramètre	Exemple (avec la syntaxe AdminApp)	Syntaxe de l'élément option
Mot clé uniquement	`-nodeployejb`	`<option key="nodeployejb"/>`
Mot clé avec une valeur simple	`-custom value`	`<option key="custom" value="value"/>`
Mot clé avec une liste de valeurs	`-MapresrefToEJB {{value1} {value2} {value3}}`	`<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>`

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarUpdate implémente cette tâche.

wplc-modify-ear

Description et utilisation

Utilisez cette tâche Ant pour modifier une ressource EAR déployé précédemment dans l'application cible ou l'instance de serveur de portail.

Paramètres requis

Les paramètres suivants sont obligatoires :

appname : nom de l'application du fichier EAR.

Paramètres facultatifs

Les paramètres suivants sont facultatifs :

classloadermode : définit le mode de délégation du chargeur de classe, également appelé ordre du chargeur de classe. Ce paramètre détermine si un chargeur de classe délègue les classes en cours de chargement au chargeur de classe parent. Valeurs prises en charge :
- PARENT_FIRST: délègue le chargement des classes à son parent avant que vous chargiez la classe à partir du chemin d'accès aux classes local. Il s'agit de la valeur par défaut pour la règle du chargeur de classe et pour les chargeurs de classe de machine virtuelle standard.
- PARENT_LAST : le chargeur de classe tente de charger les classes à partir du chemin d'accès aux classes local avant que vous déléguiez le chargement des classes au chargeur parent. A l'aide de cette règle, un chargeur de classe d'application peut remplacer la classe qui existe dans le chargeur de classe parent et fournir sa propre version.
startingweight : définit le poids de départ de l'application. Le poids de départ indique l'ordre dans lequel les applications sont démarrées lorsque le serveur est lancé. L'application dotée du poids de départ le plus bas est démarrée en premier.
server : le nom du serveur HCL.
node : le nom du noeud WebSphere® Application Server.
cell : le nom de la cellule pour WebSphere®HCL.

Paramètres spécifiés en tant qu'éléments imbriqués

attribute - attribut générique pour cette ressource. Les utilisateurs peuvent utiliser cet attribut pour spécifier des paires nom-valeur supplémentaires qui ne sont pas déjà couvertes par la tâche wplc.

name : Nom de l'attribut.
value : Valeur de l'attribut.

option : les options de déploiement EAR disponibles ne sont pas toutes prises en charge par la syntaxe wplc-create-ear en tant qu'attributs. L'élément option transmet des informations supplémentaires à la structure sous-jacente dans le profil WsAdmin. Cette fonction est similaire à la façon dont les autres paramètres sont transmis au fichier de script WsAdmin. Toutefois, dans ce cas, le jeu complet d'options est regroupé dans une chaîne correspondant à la syntaxe du langage de script.

Ne codez pas des paramètres qui sont inclus en tant qu'attributs sur la tâche en tant qu'options. Utilisez l'attribut correspondant pour éviter les redondances ainsi qu'une exception d'exécution pendant l'analyse syntaxique de la tâche.

La syntaxe de l'élément option imbriqué autorise les trois formats suivants : mot clé uniquement, paire mot clé/valeur, ou mot clé avec liste de valeurs.

key : nom de l'option.
value : valeur de l'option. Si aucune valeur n'est présente et que l'option ne contient d'élément de valeur imbriqué, cette clé ne prend pas de valeur.

Si un mot clé peut adopter une liste de valeurs, un seul élément value imbriqué est utilisé pour chaque valeur dans la liste.

Tableau 6. Exemples du mot clé uniquement, de la paire mot clé/valeur, ou du mot clé avec les formats de la liste de valeurs. Ce tableau explique comment utiliser le mot clé uniquement, la paire mot clé/valeur ou le mot clé avec la liste de valeurs pour l'élément options.
Type de paramètre	Exemple (avec la syntaxe AdminApp)	Syntaxe de l'élément option
Mot clé uniquement	`-nodeployejb`	`<option key="nodeployejb"/>`
Mot clé avec une valeur simple	`-custom value`	`<option key="custom" value="value"/>`
Mot clé avec une liste de valeurs	`-MapresrefToEJB {{value1} {value2} {value3}}`	`<option key="MapResRefToEJB"/> <value>value1</value> <value>value2</value> <value>value3</value> </option>`

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarModify implémente cette tâche.

wplc-update-file-in-ear

Description et utilisation

Utilisez cette tâche Ant pour mettre à jour un fichier dans le fichier EAR déployé.

Paramètres requis

Les paramètres suivants sont obligatoires :

appname : nom de l'application du fichier EAR.
classloadermode : définit le mode de délégation du chargeur de classe, également appelé ordre du chargeur de classe. Cette valeur détermine si un chargeur de classe délègue le chargement des classes au chargeur de classe parent. Valeurs prises en charge :
- PARENT_FIRST: délègue le chargement des classes à son parent avant que vous chargiez la classe à partir du chemin d'accès aux classes local. Il s'agit de la valeur par défaut pour la règle du chargeur de classe et pour les chargeurs de classe de machine virtuelle standard.
- PARENT_LAST : le chargeur de classe tente de charger les classes à partir du chemin d'accès aux classes local avant que vous déléguiez le chargement des classes au chargeur parent. A l'aide de cette règle, un chargeur de classe d'application peut remplacer la classe qui existe dans le chargeur de classe parent et fournir sa propre version.
- startingweight : définit le poids de départ de l'application. Le poids de départ indique l'ordre dans lequel les applications sont démarrées lorsque le serveur est lancé. L'application dotée du poids de départ le plus bas est démarrée en premier.

Paramètres spécifiés en tant qu'éléments imbriqués

option : les options de déploiement EAR disponibles ne sont pas toutes prises en charge par la syntaxe wplc-create-ear en tant qu'attributs. L'élément option transmet des informations supplémentaires à la structure sous-jacente dans le profil WsAdmin. Cette fonction est similaire à la façon dont les autres paramètres sont transmis au fichier de script WsAdmin. Toutefois, dans ce cas, le jeu complet d'options est regroupé dans une chaîne correspondant à la syntaxe du langage de script.

Ne codez pas des paramètres qui sont inclus en tant qu'attributs sur la tâche en tant qu'options. Utilisez l'attribut correspondant pour éviter les redondances ainsi qu'une exception d'exécution pendant l'analyse syntaxique de la tâche.

La syntaxe de l'élément option imbriqué autorise les trois formats suivants : mot clé uniquement, paire mot clé/valeur, ou mot clé avec liste de valeurs.

key : nom de l'option.
value : valeur de l'option. Si aucune valeur n'est présente et que l'option ne contient d'élément de valeur, cette clé ne prend pas de valeur.

Si un mot clé peut adopter une liste de valeurs, un seul élément value imbriqué est utilisé pour chaque valeur dans la liste.

Ajoutez les deux clés <option> :

Un élément d'option avec une clé de contents indique l'emplacement sur le disque du fichier à mettre à jour option key="contents" value="locationOfFileOnDisk"/>.
Un élément d'option avec une clé de contenturi indique l'emplacement dans un fichier .ear du fichier à mettre à jour option key="contenturi" value="locationOfFileInEar"/

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarCreate implémente cette tâche.

wplc-remove-ear

Description et utilisation

Utilisez cette tâche Ant pour supprimer ou désinstaller une ressource EAR de l'application cible ou de l'instance de serveur de portail.

Paramètres requis

Le paramètre suivant est requis :

appname : nom de l'application du fichier EAR.

Bean d'implémentation

La classe com.ibm.wplc.deploy.tasks.EarRemove implémente cette tâche.