WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Aus ESQL und Java aufrufbare Brokereigenschaften

Es kann aus ESQL und Java™ auf Broker-, Nachrichtenfluss- und Knoteneigenschaften zugegriffen werden.

Die folgende Tabelle zeigt die Eigenschaften, auf die über die CMP-Schnittstelle aus ESQL- und Java-Code zugegriffen werden kann.

Der Java-Code wird (soweit zutreffend) in der zweiten Tabellenspalte angezeigt.

Beachten Sie, dass die Klassen BrokerProxy, ExecutionGroupProxy, MessageFlowProxy und LocalBrokerUtilities alle zur CMP-Schnittstelle (ConfigManagerProxy.jar) gehören. Auf diese JAR-Datei muss aus Ihrem Java-Projekt in Ihrem WebSphere Message Broker Toolkit verwiesen werden, sie muss jedoch nicht beim Broker implementiert werden.

Eine vollständige Übersicht über die Brokereigenschaften finden Sie im Abschnitt Brokereigenschaften.

Tabelle 1. Allgemeine Brokereigenschaften.
Anmerkung: Die einzigen brokerspezifischen Eigenschaften, die in einem Trace-Knoten verwendet werden können, sind die Eigenschaften in der Gruppe "Allgemeine Brokereigenschaften". Beispielsweise können Sie für die Einstellung Muster in einem Trace-Knoten Folgendes definieren:
#### Start Trace Input Message
  Time: ${AKTUELLE_ZEITMARKE}
  Broker: ${BrokerName}  Version: ${BrokerVersion}  Platform: ${Family}
  ProcessID: ${ProcessId}  BrokerUserId: ${BrokerUserId}
  ExecutionGroupLabel: ${ExecutionGroupLabel}
  nTransaction: ${Transaction}
  Root Tree: ${Root} 
#### End Trace Input Message
ESQL-Eigenschaftsname Java-Zugriffsmethode Beschreibung
BrokerName (Zeichen) Zugänglich über:
  1. MbNode.getBroker()
  2. MbBroker.getName()
Den Namen des Brokers
BrokerUserId (Zeichen) Verwenden Sie

System.getProperty("user.name");

zum Abruf des Namens der Benutzer-ID, unter der der Broker gestartet wurde.
Die Benutzer-ID, unter welcher der Broker ausgeführt wird (also die Benutzer-ID, die durch das Attribut -i im Befehl mqsicreatebroker unter Windows angegeben ist, oder die Benutzer-ID, mit welcher der Broker über den Befehl mqsistart auf Linux- und UNIX-Systemen gestartet wird).
BrokerVersion (Zeichen) Verwenden Sie

BrokerProxy b = BrokerProxy.getLocalInstance();
int v = b.getBrokerVersion();

Die vierstellige Versionszahl des Brokers (siehe BrokerVersion).
ExecutionGroupLabel (Zeichen) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  eg.getName();

Die Bezeichnung der Ausführungsgruppe (vom Benutzer lesbarer Name).
ExecutionGroupName (Zeichen) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  eg.getUUID();

Der Name der Ausführungsgruppe (oftmals eine UUID-Kennung).
Family (Zeichen) Verwenden Sie

System.getProperty("os.name")

zur Rückgabe des Betriebssystemnamens aus Java.
Der generische Name der Softwareplattform, auf der der Broker ausgeführt wird ('WINDOWS', 'UNIX' oder 'ZOS').
ProcessId (Integer) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  String processId =
   eg.getRuntimeProperty(AttributeConstants.EG_THIS_PROCESSID_PROPERTY);

Die Prozess-Kennung (PID) der Ausführungsgruppe.
QueueManagerName (Zeichen)   Der Name des WebSphere MQ-Warteschlangenmanagers, mit dem der Broker verbunden ist.
WorkPath (Zeichen) Zur Rückgabe eines vom Standard abweichenden Arbeitspfads in Java verwenden Sie Folgendes:

String wp = LocalBrokerUtilities.getLocalBrokerWorkpath(brokerName);

(Optional) Verzeichnis, in dem Arbeitsdaten für diesen Broker gespeichert werden.

Tabelle 2. Flusseigenschaften
ESQL-Eigenschaftsname Java-Zugriffsmethode Beschreibung
AdditionalInstances (Integer) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  MessageFlowProxy mf = eg.getMessageFlowByName("mf1");
  int i = mf.getAdditionalInstances();

Die Anzahl der zusätzlichen Threads, die der Broker zur Pflege des Nachrichtenflusses verwenden kann.
CommitCount (Integer) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  MessageFlowProxy mf = eg.getMessageFlowByName("mf1");
  int i = mf.getCommitCount();

Die Anzahl der Eingabenachrichten, die von einem Nachrichtenfluss verarbeitet werden kann, bevor eine Synchronisationspunktsteuerung ausgelöst wird.
CommitInterval (Integer) Verwenden Sie

ExecutionGroupProxy eg = ExecutionGroupProxy.getLocalInstance();
  MessageFlowProxy mf = eg.getMessageFlowByName("mf1");
  int i = mf.getCommitInterval();

Das Zeitintervall, in dem eine COMMIT-Operation ausgeführt wird, wenn die Eigenschaft COMMIT-Zählung größer ist als 1 (d. h. wo der Nachrichtenfluss Nachrichten stapelt), aber die Anzahl der verarbeiteten Nachrichten den Wert der Eigenschaft COMMIT-Zählung nicht erreicht hat.
CoordinatedTransaction (Boolescher Wert) Nicht möglich Legt fest, ob der Nachrichtenfluss als eine XA-koordinierte Transaktion, koordiniert von WebSphere MQ, verarbeitet wird.
MessageFlowLabel (Zeichen) Nicht möglich Der Name des Flusses.

Tabelle 3. Knoteneigenschaften
ESQL-Eigenschaftsname Java-Zugriffsmethode Beschreibung
DataSource (Zeichen) Nicht möglich Der ODBC-Datenquellname (Data Source Name, DSN) der Datenbank, in der die Benutzertabellen erstellt werden.
DataSourceUserId (Zeichen) Nicht möglich Die Benutzer-ID, mit der der Broker auf die Datenbankbenutzertabellen zugreift.
MessageOptions (64-Bit-Integer)1 Nicht möglich Der Bitstrom und die aktiven Validierungsoptionen.
NodeLabel (Zeichen) Nicht zutreffend Der Name des Knotens.
NodeType (Zeichen) Nicht zutreffend Der Knotentyp (Compute, Datenbank oder Filter).
ThrowExceptionOnDatabaseError (Boolescher Wert)1 Nicht möglich Steuert, ob der Broker im Falle eines Datenbankfehlers eine Ausnahme generiert.
TransactionType (Zeichen)1 Nicht möglich Der Transaktionstyp (Automatic (automatisch) oder Commit (COMMIT-Operation), mit dem von diesem Knoten aus auf eine Datenbank zugegriffen wird.
TreatWarningsAsErrors (Boolescher Wert)1 Nicht möglich Steuert, ob Datenbankwarnmeldungen als Fehler behandelt werden und lässt die Ausgabenachricht an den Fehlerterminal (Failure) weitergeben.
Anmerkungen:
  1. Nicht anwendbar für den DatabaseInput-Knoten.

BrokerVersion

Die BrokerVersion-Eigenschaft enthält einen vierstelligen Code, der die Version des Brokers angibt. Dieser Code basiert auf dem VRMF-System (IBM® Version/Release/Modification/Fix pack) zur Produktnummerierung. Der VRMF-Code gliedert sich wie folgt:
V
Die Versionsnummer. Eine Version ist ein separates IBM Lizenzprogramm, das für gewöhnlich wichtigen neuen Code oder eine wichtige neue Funktion enthält. Jede Version hat ihre eigene Lizenz sowie eigene Geschäftsbedingungen.
R
Die Releasenummer. Unter einem Release versteht man den Vertrieb neuer Funktionen und APAR-Korrekturen (Authorized Program Analysis Report) für ein bestehendes Produkt.
M
Die Modifikationsnummer. Eine Bearbeitung (oder Modifikation) ist eine neue Funktion, die einem bestehenden Produkt hinzugefügt wurde, und die getrennt von einer angekündigten Version oder einem Release bereitgestellt wird.
F
Die Fixpack-Nummer. Fixpacks dienen der Korrektur von Fehlern und enthalten APAR-Korrekturen. Sie enthalten keine neuen Funktionen.

Ein Fixpack ist kumulativ, d. h., es enthält alle Korrekturen, die mit der früheren Verwaltung des Release bereitgestellt wurden, einschließlich früherer Fixpacks. Es kann zusätzlich zu allen zuvor ausgelieferten Verwaltungsprogrammen ausgeführt werden, um das System auf den aktuellen Fixpack-Stand zu bringen.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:28


ReferenzthemaReferenzthema | Version 8.0.0.5 | ak04897_