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".

Die Befehlsgruppe "RARUpdate" enthält die folgenden Befehle:

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

-rarPath
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

-rarPath
Der absolute Pfad zu einer RAR-Datei. (String, erforderlich)
-returnType
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

Verwendungsbeispiel für den Stapelmodus
  • Mit Jython:
    AdminTask.getNewRAObjectProperties('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"',
         '[-rarPath c:/tra/RAR/TRA.rar -returnType String]')

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

Verwendungsbeispiel für den Stapelmodus
  • Mit Jython:
    AdminTask.findOtherRAsToUpdate('"Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943)"')

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

-rarPath
Der absolute Pfad der neuen RAR-Datei. (String, erforderlich)

Optionale Parameter

-ResourceAdapterProps
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:
-name
Der Name der Ressourcenadaptereigenschaft. (String, optional)
-value
Der Wert der Ressourcenadaptereigenschaft. (String, optional)
-ConnectionFactoryProps
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:
-id
Der JNDI-Name (Java Naming and Directory Interface) der Verbindungsfactory. (String, optional)
-name
Der Name der Eigenschaft einer Verbindungsfactory. (String, optional)
-value
Der Wert der Ressourcenadaptereigenschaft. (String, optional)
-ActivationSpecProps
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:
-id
Der JNDI-Name (Java Naming and Directory Interface) der Aktivierungsspezifikation. (String, optional)
-name
Der Name der Aktivierungsspezifikationseigenschaft. (String, optional)
-value
Der Wert der Aktivierungsspezifikationseigenschaft. (String, optional)
-AdminObjectProps
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:
-id
Der JNDI-Name (Java Naming and Directory Interface) der Aktivierungsspezifikation. (String, optional)
-name
Der Name der Eigenschaft für das verwaltete Objekt. (String, optional)
-value
Der Wert der Eigenschaft für das verwaltete Objekt. (String, optional)

Beispiele

Verwendungsbeispiel für den Stapelmodus

  • Mit 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]]]')

Verwendungsbeispiel für den Dialogmodus:

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

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rdat_updateRAR
Dateiname:rdat_updateRAR.html