Groupe de commandes RARUpdate

Utilisez l'assistant de mise à jour de fichier RAR (resource adapter archive) pour mettre à niveau la configuration des propriétés et le module RAR des adaptateurs de ressources J2C. Le serveur d'applications utilise les classes et d'autres codes inclus dans une archive d'adaptateur de ressources (RAR) pour prendre en charge les adaptateurs de ressources que vous configurez.

Pour éviter les incidents, utilisez l'assistant de mise à jour de fichier RAR de la console d'administration. Pour plus d'informations, voir la rubrique Mise à jour d'une archive d'adaptateur de ressources.

Le groupe de commandes RARUpdate contient les commandes suivantes :

compareResourceAdapterToRAR

La commande compareResourceAdapterToRAR détermine si un adaptateur de ressources est compatible avec un nouveau fichier RAR. Un adaptateur de ressources peut être mis à jour avec un fichier RAR uniquement si les deux sont compatibles.

Objet cible

ID objet d'adaptateur de ressources : Objet de configuration de l'adaptateur de ressources qui sera comparé avant la mise à jour.

Résultat

La commande renvoie la valeur true si l'adaptateur de ressources est compatible avec le fichier RAR spécifié. Elle affiche également les versions de l'adaptateur de ressources et du nouveau fichier RAR. Si l'adaptateur de ressources est incompatible avec le fichier RAR spécifié, la commande renvoie la valeur false et affiche un message qui en explique la raison.

Paramètres obligatoires

-rarPath
Chemin d'accès absolu du fichier RAR. (Chaîne, obligatoire)

Exemples

Exemple d'utilisation en mode de traitement par lots :

AdminTask.compareResourceAdapterToRAR("Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943"),
     '[-rarPath "c:\tra\rar\TRA.rar"]')

getNewRAObjectProperties

La commande getNewRAObjectProperties affiche la liste des nouvelles propriétés du fichier RAR qui peuvent être configurées pendant la mise à jour de l'adaptateur de ressources.

Objet cible

ID objet d'adaptateur de ressources : Objet de configuration de l'adaptateur de ressources qui sera mis à jour.

Résultat

La commande affiche la liste des nouvelles propriétés de l'adaptateur de ressources qui peuvent être configurées pendant la mise à jour du fichier RAR.

Paramètres requis

-rarPath
Chemin d'accès absolu du fichier RAR. (Chaîne, obligatoire)
-returnType
Type de valeur à renvoyer : String ou Hashtable. Quand returnType a pour valeur String, la commande renvoie une chaîne qui sera utilisée comme entrée avec la commande updateRAR. Si returnType a pour valeur Hashtable, la commande renvoie une valeur java.util.Hashtable qui sera utilisée dans la console d'administration. La valeur par défaut de returnType est String. (Chaîne, optionnelle)

Exemples

Exemple d'utilisation en mode de traitement par lots :
  • Avec Jython :
    AdminTask.getNewRAObjectProperties('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"',
         '[-rarPath c:/tra/RAR/TRA.rar -returnType String]')

findOtherRAsToUpdate

La commande findOtherRAsToUpdate recherche les autres adaptateurs de ressources de la configuration qui sont semblables à l'adaptateur de ressources à mettre à jour. Les adaptateurs de ressources indiqués doivent également être mis à jour.

Objet cible

ID objet d'adaptateur de ressources : Objet de configuration de l'adaptateur de ressources qui est comparé avant la mise à jour.

Résultat

La commande renvoie la liste des chaînes d'ID objet des adaptateurs de ressources qui peuvent être utilisées comme entrées en tant qu'objet cible des commandes RARUpdate.

Exemples

Exemple d'utilisation en mode de traitement par lots :
  • Avec Jython :
    AdminTask.findOtherRAsToUpdate('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"')

updateRAR

La commande updateRAR met à jour le fichier RAR et la configuration d'un adaptateur de ressources avec une portée définie.

Objet cible

ID objet d'adaptateur de ressources : Objet de configuration de l'adaptateur de ressources qui est mis à jour.

Résultat

Cette commande renvoie un message qui indique la réussite ou l'échec de l'opération une fois celle-ci terminée.

Paramètres obligatoires

-rarPath
Chemin d'accès absolu du nouveau fichier RAR. (Chaîne, obligatoire)

Paramètres optionnels

-ResourceAdapterProps
Renvoie la liste des paires [nom/valeur] des nouvelles propriétés à définir dans la classe d'implémentation ResourceAdapter. Vous pouvez définir les paramètres suivants pour cette étape :
-name
Nom de la propriété d'adaptateur de ressources. (Chaîne, optionnelle)
-value
Valeur de la propriété d'adaptateur de ressources. (Chaîne, facultatif)
-ConnectionFactoryProps
Renvoie la liste des trios [id/nom/valeur] des nouvelles propriétés à définir dans les fabriques de connexions définies dans la configuration de l'adaptateur de ressources. Vous pouvez définir les paramètres suivants pour cette étape :
-id
Nom JNDI (Java Naming and Directory Interface) de la fabrique de connexions. (Chaîne, optionnelle)
-name
Nom de la propriété de fabrique de connexions. (Chaîne, optionnelle)
-value
Valeur de la propriété d'adaptateur de ressources. (Chaîne, optionnelle)
-ActivationSpecProps
Renvoie la liste des trios [id/nom/valeur] des nouvelles propriétés à définir dans les spécifications d'activation définies dans la configuration de l'adaptateur de ressources. Vous pouvez définir les paramètres suivants pour cette étape :
-id
Nom JNDI (Java Naming and Directory Interface) de la spécification d'activation. (Chaîne, optionnelle)
-name
Nom de la propriété de spécification d'activation. (Chaîne, optionnelle)
-value
Valeur de la propriété de spécification d'activation. (Chaîne, facultatif)
-AdminObjectProps
Renvoie la liste des trios [id/nom/valeur] des nouvelles propriétés à définir dans les objets gérés définis dans la configuration de l'adaptateur de ressources. Vous pouvez définir les paramètres suivants pour cette étape :
-id
Nom JNDI (Java Naming and Directory Interface) de la spécification d'activation. (Chaîne, facultatif)
-name
Nom de la propriété d'objet géré. (Chaîne, facultatif)
-value
Valeur de la propriété d'objet géré. (Chaîne, optionnelle)

Exemples

Exemple d'utilisation en mode de traitement par lots :

  • Avec Jython :
    AdminTask.updateRAR('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"', 
         '[-rarPath c:/tra/RAR/TRA.rar -ResourceAdapterProps [[RAProp1 RAProp1Val] [RAProp2 RAProp2Val]] 
         -ConnectionFactoryProps [[eis/TRA_CF_1 CFProp1 CFProp1Val] [eis/TRA_CF_2 CFProp1 CFProp1Val2] [eis/TRA_DIF_CF CFProp2 CFProp2val]] 
         -ActivationSpecProps [[eis/TRA_AS_1 ASProp1 ASProp1Val] [eis/TRA_AS_1 ASProp2 ASProp2Val] [eis/TRA_AS_2 ASProp3 ASProp3val] [eis/TRA_AS_2 ASProp4 ASProp4Val]] 
         -AdminObjectProps [[eis/TRA_AO_1 AOProp1 AOProp1Val] [eis/TRA_AO_1 AOProp2 AOProp2Val] [eis/TRA_AO_2 AOProp1 AOProp1Val] [eis/TRA_AO_3 AOProp2 AOProp2Val]]]')

Exemple d'utilisation en mode interactif :

  • Avec Jython :
    AdminTask.updateRAR('-interactive')

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=rdat_updateRAR
Nom du fichier : rdat_updateRAR.html