J2C-Konfigurationsscripts
Die Scripting-Bibliothek enthält zahlreiche Scriptprozeduren für die Verwaltung von J2C-Konfigurationen (Java™ 2 Connector). Verwenden Sie die Scripts in diesem Artikel, um Aktivierungsspezifikationen, Verwaltungsobjekte und Verbindungsfactorys zu erstellen und um Ressourcenadapter zu installieren. Sie können jedes Script einzeln ausführen oder mehrere Prozeduren kombinieren, um angepasste Automationsscripts für Ihre Umgebung zu erstellen.
Alle Scriptprozeduren für die J2C-Verwaltung befinden sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/scriptLibraries/resources/J2C.
createJ2CActivationSpec
Dieses Script erstellt eine J2C-Aktivierungsspezifikation in Ihrer Konfiguration. Das Script gibt die Konfigurations-ID der neuen J2C-Aktivierungsspezifikation zurück.
Argument | Beschreibung |
---|---|
ID_des_Ressourcenadapters | Gibt die Konfigurations-ID des gewünschten Ressourcenadapters an. |
Name_der_Aktivierungsspezifikation | Gibt den Namen an, der der neuen Aktivierungsspezifikation zugeordnet werden soll. |
Nachrichten-Listener-Typ | Gibt den Nachrichten-Listener-Typ an. |
JNDI-Name | Gibt den JNDI-Namen (Java Naming and Directory Interface) an. |
Attribute | (Optional) Gibt weitere Attribute in einem bestimmten Format an:
|
Attribute | Beschreibung | Beispiel |
---|---|---|
authenticationAlias | Gibt den Authentifizierungsalias der erstellten J2C-Aktivierungsspezifikation an. |
|
Beschreibung | Gibt die Beschreibung für die erstellte J2C-Aktivierungsspezifikation an. |
|
destinationJndiName | Gibt den Ziel-JNDI-Namen der erstellten J2C-Aktivierungsspezifikation an. |
|
Syntax
AdminJ2C.createJ2CActivationSpec(Ressourcenadapter-ID,
Name_der_Aktivierungsspezifikation, Nachrichten-Listener-Typ, JNDI-Name,
Attribute)
Verwendungsbeispiel
Das folgende Beispielscript enthält nur erforderliche Attribute:
AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578))", "J2CASTest", "javax.jms.MessageListener2", "jndiAS")
AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)",
"J2CASTest","javax.jms.MessageListener", "jndi/as1",
"description=this is my J2C ActivationSpecification,
destinationJndiName=jndi/J2CAS, authenticationAlias=J2CASTest")
Das folgende Beispielscript enthält optionale Attribute in einem Listenformat:
AdminJ2C.createJ2CActivationSpec(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CAC1", "javax.jms.MessageListener", "jndi/as", [['description','new j2cActivationSpec'], ['destinationJndiName','ds/jndi'], ['authenticationAlias','test']])
createJ2CAdminObject
Dieses Script erstellt ein J2C-Verwaltungsobjekt in Ihrer Konfiguration. Das Script gibt die Konfigurations-ID des neuen J2C-Verwaltungsobjekts zurück.
Argument | Beschreibung |
---|---|
ID_des_Ressourcenadapters | Gibt die Konfigurations-ID des gewünschten Ressourcenadapters an. |
Name_der_Aktivierungsspezifikation | Gibt den Namen an, der der neuen Aktivierungsspezifikation zugeordnet werden soll. |
Verwaltungsobjektschnittstelle | Gibt den Namen der Verwaltungsobjektschnittstelle an. |
JNDI-Name | Gibt den JNDI-Namen (Java Naming and Directory Interface) an. |
Attribute | (Optional) Gibt weitere Attribute in einem bestimmten Format an:
|
Attribute | Beschreibung | Beispiel |
---|---|---|
Beschreibung | Gibt die Beschreibung für das erstellte J2C-Verwaltungsobjekt an. |
|
Syntax
AdminJ2C.createJ2CAdminObject(Ressourcenadapter-ID,
Name_der_Aktivierungsspezifikation, Verwaltungsobjektschnittstelle, JNDI-Name,
Attribute)
Verwendungsbeispiel
Das folgende Beispielscript enthält nur erforderliche Attribute:
AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578)",
"J2CAOTest", "fvt.adapter.message.FVTMessageProvider2", "jndiAO")
AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)",
"J2CAOTest", "fvt.adapter.message.FVTMessageProvider", "jndi/ao1", "description=this is my J2C AdminObject")
Das folgende Beispielscript enthält optionale Attribute in einem Listenformat:
AdminJ2C.createJ2CAdminObject(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CAO1", "fvt.adapter.message.FVTMessageProvider", "jndi/ao", [['description','new j2cAdminObject']])
createJ2CConnectionFactory
Dieses Script erstellt eine neue J2C-Verbindungsfactory in Ihrer Konfiguration. Das Script gibt die Konfigurations-ID der neuen J2C-Verbindungsfactory zurück.
Argument | Beschreibung |
---|---|
ID_des_Ressourcenadapters | Gibt die Konfigurations-ID des gewünschten Ressourcenadapters an. |
Name_der_Verbindungsfactory | Gibt den Namen an, der der neuen Verbindungsfactory zugeordnet werden soll. |
Verbindungsfactory-Schnittstelle | Gibt die Verbindungsfactory-Schnittstelle an. |
JNDI-Name | Gibt den JNDI-Namen (Java Naming and Directory Interface) an. |
Attribute | (Optional) Gibt weitere Attribute in einem bestimmten Format an:
|
Attribut | Beschreibung | Beispiel |
---|---|---|
authDataAlias | Gibt den komponentengesteuerten Authentifizierungsdatenalias der erstellten Verbindungsfactory an. |
|
Beschreibung | Gibt die Beschreibung der erstellten J2C-Verbindungsfactory an. |
|
Syntax
AdminJ2C.createJ2CConnectionFactory(Ressourcenadapter-ID,
Name_der_Verbindungsfactory, Verbindungsfactory-Schnittstelle, JNDI-Name,
Attribute)
Verwendungsbeispiel
AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_11840917675
578)", "J2CCFTest", "javax.sql.DataSource2", "jndiCF")
AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)",
"J2CCFTest", "javax.sql.DataSource", "jndi/j2ccftest", "description=this is my J2CConnectionFactory, authDataAlias=J2CTest")
Das folgende Beispielscript enthält optionale Attribute in einem Listenformat:
AdminJ2C.createJ2CConnectionFactory(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)",
"J2CCFTest", "javax.sql.DataSource2", "jndi/cf", [['description', 'new j2ccf'], ['authDataAlias', 'test']])
installJ2CResourceAdapter
Dieses Script installiert einen J2C-Ressourcenadapter in Ihrer Konfiguration. Das Script gibt die Konfigurations-ID des neuen J2C-Ressourcenadapters zurück.
Argument | Beschreibung |
---|---|
Knotenname | Gibt den Namen des gewünschten Knotens an. |
RAR-Datei | Gibt den vollständig qualifizierten Dateipfad für die zu installierende RAR-Datei an. |
Name_des_Ressourcenadapters | Gibt den Namen an, der dem neuen Ressourcenadapter zugeordnet werden soll. |
Attribute | (Optional) Gibt weitere Attribute in einem bestimmten Format an:
|
Attribute | Beschreibung |
---|---|
rar.desc | Gibt die Beschreibung des J2C-Ressourcenadapters an. |
rar.archivePath | Gibt den Namen des Pfads an, in den die Datei extrahiert wird. Wenn Sie diesen Pfad nicht angeben, wird das Archiv in das Verzeichnis $CONNECTOR_INSTALL_ROOT extrahiert. |
rar.classpath | Gibt den zusätzlichen Klassenpfad an. |
rar.nativePath | Gibt den nativen Pfad an. |
rar.threadPoolAlias | Gibt den Alias des Thread-Pools an. |
rar.propertiesSet | Gibt die Eigenschaftengruppe des J2C-Ressourcenadapters an. |
rar.DeleteSourceRar | Gibt an, ob die RAR-Quellendatei gelöscht werden soll. |
rar.isolatedClassLoader | Gibt den booleschen Wert des isolierten Klassenladeprogramms an. |
rar.enableHASupport | Gibt den booleschen Wert der aktivieren Hochverfügbarkeit an. |
rar.HACapability | Gibt die ARt der Hochverfügbarkeitsfunktion an. |
Syntax
AdminJ2C.installJ2CResourceAdapter(Knotenname, RAR-Datei,
Name_des_Ressourcenadapters, Attribute)
Verwendungsbeispiel
Das folgende Beispielscript enthält nur erforderliche Attribute:
![[Windows]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("myNode",
"C:\temp\jca15cmd.rar", "J2CTest")
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")
Das folgende Beispielscript enthält optionale Attribute im Zeichenfolgeformat:
![[Windows]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "c:\ears\jca15cmd.rar", "J2CTest", "rar.desc=this is J2C,
rar.archivePath=c:\temp\test.rar, rar.classpath=c:\temp, rar.isolatedClassLoader=false, rar.enableHASupport=true,
rar.DeleteSourceRar=false")
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "/ears/jca15cmd.rar", "J2CTest", "rar.desc=this is J2C,
rar.archivePath=/temp/test.rar, rar.classpath=/temp, rar.isolatedClassLoader=false, rar.enableHASupport=true,
rar.DeleteSourceRar=false")
Das folgende Beispielscript enthält optionale Attribute in einem Listenformat:
![[Windows]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "c:\ears\jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'],
['rar.archivePath', 'c:\temp\test.rar'], ['rar.classpath', 'c:\temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'],
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "/ears/jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'],
['rar.archivePath', '/temp/test.rar'], ['rar.classpath', '/temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'],
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])