Befehlsgruppe "RARUpdate"
Verwenden Sie den Assistenten für die Aktualisierung von RAR-Dateien (Ressourcenadapterarchiv), um das RAR-Modul und die Eigenschaftenkonfiguration von J2C-Ressourcenadaptern zu aktualisieren. Der Anwendungsserver verwendet die Klassen und anderen Code, der ein Ressourcenadapterarchiv für die Unterstützung der zu konfigurierenden Ressourcenadapter enthält.
Zur Vermeidung von Problemen verwenden Sie den Assistenten für die Aktualisierung von RAR-Dateien in der Administrationskonsole. Weitere Informationen finden Sie im Artikel "Ressourcenadapterarchiv aktualisieren".
compareResourceAdapterToRAR
Der Befehl "compareResourceAdapterToRAR" bestimmt, ob ein Ressourcenadapter mit einer neuen RAR-Datei kompatibel ist. Ein Ressourcenadapter kann nur dann mit einer RAR-Datei aktualisiert werden, wenn die beiden Komponenten kompatibel sind.
Zielobjekt
Objekt-ID des Ressourcenadapters - Das Konfigurationsobjekt des Ressourcenadapters, das für die Aktualisierung verglichen wird.Ergebnis
Der Befehl gibt "true" zurück, wenn der Ressourcenadapter mit der angegebenen RAR-Datei kompatibel ist. Er zeigt auch die Versionen des Ressourcenadapters und der neuen RAR-Datei an. Wenn der Ressourcenadapter nicht mit der angegebenen RAR-Datei kompatibel ist, gibt der Befehl "false" zurück und zeigt eine Nachricht an, in der erläutert wird, warum die beiden Komponenten nicht kompatibel sind.Erforderliche Parameter
- Der absolute Pfad zu einer RAR-Datei. (String, erforderlich)
Beispiele
Verwendungsbeispiel für den Stapelmodus
AdminTask.compareResourceAdapterToRAR("Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943"),
'[-rarPath "c:\tra\rar\TRA.rar"]')
getNewRAObjectProperties
Der Befehl "getNewRAObjectProperties" ruft eine Liste neuer Eigenschaften in einer RAR-Datei ab, die bei der Aktualisierung eines Ressourcenadapters konfiguriert werden können.
Zielobjekt
Objekt-ID des Ressourcenadapters - Das Konfigurationsobjekt des Ressourcenadapters, das aktualisiert wird.Ergebnis
Sie erhalten eine Liste neuer Eigenschaften, die Sie im Ressourcenadapter konfigurieren können, wenn eine RAR-Datei aktualisiert wird.Erforderliche Parameter
- Der absolute Pfad zu einer RAR-Datei. (String, erforderlich)
- Der Typ des Rückgabewerts: "String" oder "Hashtable". Wenn "returnType" auf "String" gesetzt ist, gibt der Befehl eine Zeichenfolge zurück, die als Eingabe für den Befehl "updateRAR" bestimmt ist. Wenn "returnType" auf "Hashtable" gesetzt ist, gibt der Befehl ein java.util.Hashtable-Objekt zurück, das für die Verwendung in der Administrationskonsole bestimmt ist. Der Standardwert von "returnType" ist "String". (String, optional)
Beispiele
findOtherRAsToUpdate
Der Befehl "findOtherRAsToUpdate" sucht andere Ressourcenadapter in der Konfiguration, die dem zu aktualisierenden Ressourcenadapter gleichen. Die gefundenen Ressourcenadapter sollten ebenfalls aktualisiert werden.
Zielobjekte
Objekt-ID des Ressourcenadapters - Das Konfigurationsobjekt des Ressourcenadapters, das für die Aktualisierung verglichen wird.Ergebnis
Der Befehl gibt eine Liste mit Objekt-ID-Zeichenfolgen für Ressourcenadapter zurück, die als Zielobjekt für RARUpdate-Befehle eingegeben werden können.Beispiele
updateRAR
Der Befehl "updateRAR" aktualisiert die RAR-Datei und die Konfiguration eines Ressourcenadapters in einem bestimmten Geltungsbereich.
Zielobjekt
Objekt-ID des Ressourcenadapters - Das Konfigurationsobjekt des Ressourcenadapters, das aktualisiert wird.Ergebnis
Dieser Befehl gibt nach Abschluss eine Erfolgs- oder Fehlernachricht aus.Erforderliche Parameter
- Der absolute Pfad der neuen RAR-Datei. (String, erforderlich)
Optionale Parameter
- Eine Liste mit [Name/Wert-]Paaren neuer Eigenschaften, die in der ResourceAdapter-Implementierungsklasse gesetzt werden sollen.
Sie können für diesen Schritt die folgenden Parameter angeben:
- Der Name der Ressourcenadaptereigenschaft. (String, optional)
- Der Wert der Ressourcenadaptereigenschaft. (String, optional)
- Eine Liste mit von Triplets [ID Name Wert] neuer Eigenschaften, die in den Verbindungsfactorys
in der Ressourcenadapterkonfiguration gesetzt werden sollen.
Sie können für diesen Schritt die folgenden Parameter angeben:
- Der JNDI-Name (Java Naming and Directory Interface) der Verbindungsfactory. (String, optional)
- Der Name der Eigenschaft einer Verbindungsfactory. (String, optional)
- Der Wert der Ressourcenadaptereigenschaft. (String, optional)
- Eine Liste mit von Triplets [ID Name Wert] neuer Eigenschaften, die in den Aktivierungsspezifikationen
in der Ressourcenadapterkonfiguration gesetzt werden sollen.
Sie können für diesen Schritt die folgenden Parameter angeben:
- Der JNDI-Name (Java Naming and Directory Interface) der Aktivierungsspezifikation. (String, optional)
- Der Name der Aktivierungsspezifikationseigenschaft. (String, optional)
- Der Wert der Aktivierungsspezifikationseigenschaft. (String, optional)
- Eine Liste mit von Triplets [ID Name Wert] neuer Eigenschaften, die in den verwalteten Objekten
in der Ressourcenadapterkonfiguration gesetzt werden sollen.
Sie können für diesen Schritt die folgenden Parameter angeben:
- Der JNDI-Name (Java Naming and Directory Interface) der Aktivierungsspezifikation. (String, optional)
- Der Name der Eigenschaft für das verwaltete Objekt. (String, optional)
- Der Wert der Eigenschaft für das verwaltete Objekt. (String, optional)
Beispiele
Verwendungsbeispiel für den Stapelmodus
Verwendungsbeispiel für den Dialogmodus: