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.
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
- 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
- Chemin d'accès absolu du fichier RAR. (Chaîne, obligatoire)
- 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
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
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
- Chemin d'accès absolu du nouveau fichier RAR. (Chaîne, obligatoire)
Paramètres optionnels
- 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 :
- Nom de la propriété d'adaptateur de ressources. (Chaîne, optionnelle)
- Valeur de la propriété d'adaptateur de ressources. (Chaîne, facultatif)
- 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 :
- Nom JNDI (Java Naming and Directory Interface) de la fabrique de connexions. (Chaîne, optionnelle)
- Nom de la propriété de fabrique de connexions. (Chaîne, optionnelle)
- Valeur de la propriété d'adaptateur de ressources. (Chaîne, optionnelle)
- 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 :
- Nom JNDI (Java Naming and Directory Interface) de la spécification d'activation. (Chaîne, optionnelle)
- Nom de la propriété de spécification d'activation. (Chaîne, optionnelle)
- Valeur de la propriété de spécification d'activation. (Chaîne, facultatif)
- 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 :
- Nom JNDI (Java Naming and Directory Interface) de la spécification d'activation. (Chaîne, facultatif)
- Nom de la propriété d'objet géré. (Chaîne, facultatif)
- Valeur de la propriété d'objet géré. (Chaîne, optionnelle)
Exemples
Exemple d'utilisation en mode de traitement par lots :
Exemple d'utilisation en mode interactif :