Konfigurationsscripts für Geschäftsanwendungen

Die Scripting-Bibliothek enthält mehrere Scriptprozeduren für die Automatisierung Ihrer Anwendungsserverkonfigurationen. Verwenden Sie die Scripts in diesem Artikel, um Geschäftsanwendungen (BLA, Business-level Application) zu erstellen, abzufragen und zu verwalten. Sie können jedes Script einzeln ausführen oder Prozeduren zu angepassten Automationsscripts kombinieren.

Die AdminBLA-Scriptprozeduren befinden sich im Verzeichnis "Stammverzeichnis_des_Anwendungsservers/scriptLibraries/application/V70".

Verwenden Sie die folgenden Scriptprozeduren, um Ihre Geschäftsanwendungen zu konfigurieren und zu verwalten:
Verwenden Sie die folgenden Scriptprozeduren, um Ihre Geschäftsanwendungskonfigurationen abzufragen:
Fehler vermeiden Fehler vermeiden: Die Befehle viewBLA, viewAsset und viewCompUnit zeigen ihre Ausgabe nur in der Konsole an und geben keine Daten an das aufrufende Jython-Script zurück. Diese Befehle können nicht in einem Script verwendet werden, um die Ausgabe des Befehls in einer Zeichenfolgevariablen zu speichern. Wenn Sie diese Befehle in einem Jython-Script verwenden, um die Ausgabe in einer Zeichenfolgevariablen zu speichern, enthält die Zeichenfolgevariable nur den Wert "Operation Successful!".

Wenn diese Befehle wie beabsichtigt mit der Jython-wsadmin-Schnittstelle aufgerufen werden, zeigen sie die Ausgabe ordnungsgemäß in der Konsole an.

gotcha

addCompUnit

Dieses Script fügt der leeren Geschäftsanwendung Assets, gemeinsam genutzte Bibliotheken oder weitere Geschäftsanwendungen als Kompositionseinheiten hinzu. Eine Kompositionseinheit stellt ein Asset in einer Geschäftsanwendung dar. Eine Konfigurationseinheit ermöglicht die Interaktion des Inhalts eines Assets mit anderen Assets in der Anwendung. Darüber hinaus ermöglicht sie der Produktlaufzeitumgebung, Assetinhalte zu laden und auszuführen.

Zum Ausführen des Scripts geben Sie gemäß der Definition in der folgenden Tabelle den Namen der Geschäftsanwendung und die Quelle der Kompositionseinheit als Argumente an:
Tabelle 1. Beschreibung der Argumente für "addCompUnit". Führen Sie das Script aus, um einer Geschäftsanwendung eine Kompositionseinheit hinzuzufügen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der Geschäftsanwendung an, der das System die Kompositionseinheit hinzufügt.
Kompositionseinheiten-ID Gibt den Namen der Kompositionseinheit an, die der gewünschten Geschäftsanwendung hinzugefügt werden soll.
implementierbare_Einheit (Optional) Gibt den Namen der implementierbaren Einheit für das Asset an. Eine implementierbare Einheit ist der kleinste Teil eines Assets, der gesondert für die Implementierung ausgewählt werden kann.
Kompositionseinheitenname (Optional) Gibt den Namen für die hinzuzufügende Kompositionseinheit an.
Kompositionseinheitenbeschreibung (Optional) Gibt eine Beschreibung für die neue Kompositionseinheit an.
Anfangswertigkeit (Optional) Gibt die Anfangswertigkeit für die Kompositionseinheit an.
Ziel (Optional) Gibt das Ziel an, dem die Kompositionseinheit zugeordnet wird.
Aktivierungsplan (Optional) Gibt den Aktivierungsplan für die Kompositionseinheit an.

Syntax

AdminBLA.addCompUnit(Name_der_Geschäftsanwendung, Kompositionseinheiten-ID,
implementierbare_Einheit, Kompositionseinheitenname,
 Kompositionseinheitenbeschreibung, Anfangswertigkeit, Ziel, Aktivierungsplan)

Verwendungsbeispiel

AdminBLA.addCompUnit("bla1", "asset1.zip", "default", "myCompositionUnit", "cu description", "1", 
"server1", "specname=actplan1")

createEmptyBLA

Dieses Script erstellt eine neue Geschäftsanwendung in Ihrer Umgebung. Erstellen Sie eine leere Geschäftsanwendung und fügen Sie dieser anschließend Assets, gemeinsam genutzte Bibliotheken oder Geschäftsanwendungen als Kompositionseinheiten hinzu.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 2. Beschreibung der Argumente für "createEmptyBLA". Führen Sie das Script aus, um eine Geschäftsanwendung zu erstellen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen für die neue Geschäftsanwendung an.
Beschreibung (Optional) Gibt eine Beschreibung für die Geschäftsanwendung an.

Syntax

AdminBLA.createEmptyBLA(Name_der_Geschäftsanwendung, Beschreibung)

Verwendungsbeispiel

AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")

deleteAsset

Dieses Script entfernt ein registriertes Asset aus Ihrer Konfiguration.

Zum Ausführen des Scripts geben Sie die Asset-ID gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 3. Beschreibung des Arguments für "deleteAsset". Führen Sie das Script aus, um ein Asset zu löschen.
Argument Beschreibung
Asset-ID Gibt den Namen des zu löschenden Assets an.

Syntax

AdminBLA.deleteAsset(Asset-ID)

Verwendungsbeispiel

AdminBLA.deleteAsset("asset.zip")

deleteBLA

Dieses Script entfernt eine Geschäftsanwendung aus Ihrer Konfiguration.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 4. Beschreibung des Arguments für "deleteBLA". Führen Sie das Script aus, um eine Geschäftsanwendung zu löschen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der zu löschenden Geschäftsanwendung an.

Syntax

AdminBLA.deleteBLA(Name_der_Geschäftsanwendung)

Verwendungsbeispiel

AdminBLA.deleteBLA("myBLA")

deleteCompUnit

Dieses Script entfernt eine Kompositionseinheit aus einer bestimmten Geschäftsanwendungskonfiguration.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung und die Kompositionseinheit gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 5. Beschreibung der Argumente für "deleteCompUnit". Führen Sie das Script aus, um eine Kompositionseinheit aus einer Geschäftsanwendung zu löschen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der gewünschten Geschäftsanwendung an.
Kompositionseinheiten-ID Gibt die ID der zu löschenden Kompositionseinheit an.

Syntax

AdminBLA.deleteCompUnit(Name_der_Geschäftsanwendung, Kompositionseinheiten-ID)

Verwendungsbeispiel

AdminBLA.deleteCompUnit("myBLA", "asset.zip")

editAsset

Dieses Script bearbeitet die Metadaten eines bestimmten registrierten Assets.

Zum Ausführen des Scripts geben Sie die in der folgenden Tabelle definierten Argumente an:
Tabelle 6. Beschreibung der Argumente für "editAsset". Führen Sie das Script aus, um ein Asset zu ändern.
Argument Beschreibung
Asset-ID Gibt den Namen des zu bearbeitenden Assets an.
Assetbeschreibung (Optional) Gibt die neue Beschreibung des gewünschten Assets an.
Ziel-URL_des_Assets (Optional) Gibt die neue Ziel-URL für das gewünschte Asset an.
Assettypaspekte (Optional) Gibt die neuen Typaspekte für das gewünschte Asset an.
Assetbeziehungen (Optional) Gibt die neuen Beziehungskonfigurationen für das Asset an.
Dateiberechtigung (Optional) Gibt die neue Dateiberechtigungskonfiguration für das gewünschte Asset an.
Assetvalidierung (Optional) Gibt an, ob der Befehl das Asset validiert.

Syntax

AdminBLA.editAsset(Asset-ID, Assetbeschreibung, Ziel-URL_für_Asset,
Assettypaspekte, Assetbeziehungen, Dateiberechtigung, Assetvalidierung)

Verwendungsbeispiel

AdminBLA.editAsset("asset1.zip", "asset for testing", "c:/installedAssets/asset1.zip", 
"WebSphere:spec=sharedlib", "", ".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755", "true")

editCompUnit

Dieses Script bearbeitet eine bestimmte Kompositionseinheit in einer Geschäftsanwendung.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung und die ID der Kompositionseinheit gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 7. Beschreibung der Argumente für "editCompUnit". Führen Sie das Script aus, um eine Kompositionseinheit zu ändern.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der Geschäftsanwendung an, der die Kompositionseinheit zugeordnet ist.
Kompositionseinheiten-ID Gibt den Namen der zu bearbeitenden Kompositionseinheit an.
Kompositionseinheitenbeschreibung (Optional) Gibt eine neue Beschreibung für die Kompositionseinheit an.
Anfangswertigkeit (Optional) Gibt eine neue Anfangswertigkeit für die Kompositionseinheit an.
Ziel (Optional) Gibt ein neues Ziel an, dem die Kompositionseinheit zugeordnet wird.
Aktivierungsplan (Optional) Gibt einen neuen Aktivierungsplan für die Kompositionseinheit an.

Syntax

AdminBLA.editCompUnit(Name_der_Geschäftsanwendung, Kompositionseinheiten-ID, Kompositionseinheitenbeschreibung,
Anfangswertigkeit, Ziel, Aktivierungsplan)

Verwendungsbeispiel

AdminBLA.editCompUnit("bla1", "asset1.zip","cu description", "1", 
"server1", "specname=actplan1")

exportAsset

Dieses Script exportiert ein registriertes Asset in eine Datei auf Ihrem System.

Zum Ausführen des Scripts geben Sie die Asset-ID und den Dateinamen gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 8. Beschreibung der Argumente für "exportAsset". Führen Sie das Script aus, um ein Asset zu exportieren.
Argument Beschreibung
Asset-ID Gibt die ID des zu exportierenden Assets an.
Dateiname Gibt den vollständig qualifizierten Pfad an, in den das System das Asset exportiert.

Syntax

AdminBLA.exportAsset(Asset-ID, Dateiname)

Verwendungsbeispiel

[Windows]
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
[AIX][Linux][Solaris][HP-UX][IBM i][z/OS]
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")

importAsset

Dieses Script importiert und registriert ein Asset in einer Verwaltungsdomäne in Ihrer Konfiguration.

Zum Ausführen des Scripts geben Sie die Asset-ID, den Wert bezüglich der Anzeige der Beschreibung und der implementierbaren Einheit gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 9. Beschreibung der Argumente für "importAsset". Führen Sie das Script aus, um ein Asset zu importieren.
Argument Beschreibung
Asset-ID Gibt das zu importierende Asset an.
Beschreibung_anzeigen (Optional) Gibt an, ob das Script die Beschreibung des Assets anzeigt.
implementierbare_Einheit_anzeigen (Optional) Gibt an, ob das Script die implementierbaren Einheiten für das zu importierende Asset anzeigt.

Syntax

AdminBLA.importAsset(Asset-ID, Beschreibung_anzeigen, implementierbare_Einheit_anzeigen)

Verwendungsbeispiel

AdminBLA.importAsset("asset.zip", "true", "true")

startBLA

Dieses Script startet den Geschäftsanwendungsprozess in Ihrer Konfiguration.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 10. Beschreibung des Arguments für "startBLA". Führen Sie das Script aus, um eine Geschäftsanwendung zu starten.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der zu startenden Geschäftsanwendung an.

Syntax

AdminBLA.startBLA(Name_der_Geschäftsanwendung)

Verwendungsbeispiel

AdminBLA.startBLA("myBLA")

stopBLA

Dieses Script stoppt den Geschäftsanwendungsprozess in Ihrer Konfiguration.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 11. Beschreibung des Arguments für "stopBLA". Führen Sie das Script aus, um eine Geschäftsanwendung zu stoppen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der zu stoppenden Geschäftsanwendung an.

Syntax

AdminBLA.stopBLA(Name_der_Geschäftsanwendung)

Verwendungsbeispiel

AdminBLA.stopBLA("myBLA")

help

Dieses Script zeigt die Scriptprozeduren an, die von der Scriptbibliothek "AdminBLA" unterstützt werden. Wenn Sie die ausführliche Hilfe für ein bestimmtes Script anzeigen möchten, geben Sie den Namen des Scripts gemäß der Definition in der folgenden Tabelle an.
Tabelle 12. Beschreibung des Arguments für "help". Führen Sie das Script aus, um die Hilfe anzuzeigen.
Argument Beschreibung
Script Gibt den Namen des gewünschten Scripts an.

Syntax

AdminBLA.help(Script)

Verwendungsbeispiel

AdminBLA.help("createEmptyBLA")

listAssets

Dieses Script zeigt die registrierten Assets in Ihrer Konfiguration an.

Zum Ausführen des Scripts geben Sie die Asset-ID, den Wert bezüglich der Anzeige der Beschreibung und der implementierbaren Einheiten gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 13. Beschreibung der Argumente für "listAssets". Führen Sie das Script aus, um Assets aufzulisten.
Argument Beschreibung
Asset-ID (Optional) Gibt die Gruppen-ID an, für die die Berechtigungsgruppen angezeigt werden sollen.
Beschreibung_anzeigen (Optional) Gibt an, ob der Befehl eine Beschreibung für jedes Asset anzeigt. Geben Sie true an, um die Beschreibungen anzuzeigen.
implementierbare_Einheiten_anzeigen (Optional) Gibt an, ob der Befehl die implementierbaren Einheiten anzeigt, die den Assets zugeordnet sind. Geben Sie true an, um die implementierbaren Einheiten anzuzeigen.

Syntax

AdminBLA.listAssets(Asset-ID, Beschreibung_anzeigen, implementierbare_Einheiten_anzeigen)

Verwendungsbeispiel

AdminBLA.listAssets("asset.zip", "true", "true")

listBLAs

Dieses Script zeigt alle oder bestimmte Geschäftsanwendungen in Ihrer Konfiguration an.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung und den Wert bezüglich der Anzeige der Beschreibung gemäß der Definition in der folgenden Tabelle als Argumente an.
Tabelle 14. Beschreibung der Argumente für "listBLAs". Führen Sie das Script aus, um Geschäftsanwendungen aufzulisten.
Argument Beschreibung
Name_der_Geschäftsanwendung (Optional) Gibt den Namen einer gewünschten Geschäftsanwendung an.
Beschreibung_anzeigen (Optional) Gibt an, ob der Befehl eine Beschreibung für jede Geschäftsanwendung anzeigt. Geben Sie true an, um die Beschreibungen anzuzeigen.

Syntax

AdminBLA.listBLAs(Name_der_Geschäftsanwendung, Beschreibung_anzeigen)

Verwendungsbeispiel

AdminBLA.listBLAs("", "true")

listCompUnits

Dieses Script zeigt Kompositionseinheiten in einer Geschäftsanwendung an.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 15. Beschreibung der Argumente für "listCompUnits". Führen Sie das Script aus, um Kompositionseinheiten aufzulisten.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der gewünschten Geschäftsanwendung an.
Beschreibung_anzeigen (Optional) Gibt an, ob der Befehl eine Beschreibung für jede Kompositionseinheit anzeigt. Geben Sie true an, um die Beschreibungen anzuzeigen.

Syntax

AdminBLA.listCompUnits(Name_der_Geschäftsanwendung, Beschreibung_anzeigen)

Verwendungsbeispiel

AdminBLA.listCompUnits("myBLA", "true")

viewBLA

Dieser Befehl zeigt den Namen und die Beschreibung der gewünschten Geschäftsanwendung an.

Zum Ausführen des Scripts geben Sie die Konfigurations-ID der gewünschten Geschäftsanwendung gemäß Definition in der folgenden Tabelle als Argument an:
Tabelle 16. Beschreibung des Arguments für "viewBLA". Führen Sie das Script aus, um Informationen zu einer Geschäftsanwendung anzuzeigen.
Argument Beschreibung
Geschäftsanwendungs-ID Gibt die Konfigurations-ID der gewünschten Geschäftsanwendung an.

Syntax

AdminBLA.viewBLA(Geschäftsanwendungs-ID)

Verwendungsbeispiel

AdminBLA.viewBLA("bla01.zip")

viewAsset

Dieses Script zeigt die Konfigurationsattribute für ein bestimmtes registriertes Asset an.

Zum Ausführen des Scripts geben Sie die Asset-ID gemäß der Definition in der folgenden Tabelle als Argument an:
Tabelle 17. Beschreibung des Arguments für "viewAsset". Führen Sie das Script aus, um Informationen zu einem Asset anzuzeigen.
Argument Beschreibung
Asset-ID Gibt den Namen des gewünschten Assets an.

Syntax

AdminBLA.viewAsset(Asset-ID)

Verwendungsbeispiel

AdminBLA.viewAsset("asset.zip")

viewCompUnit

Dieses Script zeigt die Konfigurationsattribute für eine bestimmte Kompositionseinheit in einer Geschäftsanwendung an.

Zum Ausführen des Scripts geben Sie den Namen der Geschäftsanwendung und die ID der Kompositionseinheit gemäß der Definition in der folgenden Tabelle als Argumente an:
Tabelle 18. Beschreibung der Argumente für "viewCompUnit". Führen Sie das Script aus, um Informationen zu einer Kompositionseinheit anzuzeigen.
Argument Beschreibung
Name_der_Geschäftsanwendung Gibt den Namen der gewünschten Geschäftsanwendung an.
Kompositionseinheiten-ID Gibt die ID der gewünschten Kompositionseinheit an.

Syntax

AdminBLA.viewCompUnit(Name_der_Geschäftsanwendung, Kompositionseinheiten-ID)

Verwendungsbeispiel

AdminBLA.viewCompUnit("myBLA", "asset.zip")

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=rxml_7libbla
Dateiname:rxml_7libbla.html