IBM MQ-Eigenschaften

IBM® MQ-Eigenschaften gelten global für die gesamte IBM MQ-Installation.

In den folgenden Tabellen werden die Eigenschaften aufgeführt, die in IBM MQ festgelegt werden können:

Für jede Eigenschaft wird kurz beschrieben, wann ihre Konfiguration erforderlich oder sinnvoll sein kann. Die Eigenschaften im Dialog mit den Eigenschaften von IBM MQ beziehen sich auf Zeilengruppen in den Konfigurationsdateien.

Seite 'Allgemein'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Allgemein im Dialog mit den Eigenschaften für IBM MQ festlegen können.

Eigenschaft Beschreibung Zeilengruppenschlüssel
Standardpräfix Wenn Sie den Pfad des Verzeichnisses ändern möchten, in dem alle Daten des Warteschlangenmanagers gespeichert sind, müssen Sie den vollständigen Pfad des neuen Verzeichnisses eingeben. DefaultPrefix
Standardname für WS-Manager Wenn Sie einen Standardnamen für neue Warteschlangenmanager angeben möchten, müssen Sie den Namen in diesem Feld eingeben. Name

Seite 'Erweitert'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Erweitert im Dialog mit den Eigenschaften für IBM MQ festlegen können.

Eigenschaft Beschreibung Zeilengruppenschlüssel
[V9.2.0 Juli 2020]Standardpräfix für ephemerische Daten Wenn Sie den Pfad des Verzeichnisses ändern möchten, in dem alle ephemerischen Daten des Warteschlangenmanagers gespeichert sind, müssen Sie den vollständigen Pfad des neuen Verzeichnisses eingeben. DefaultEphemeralPrefix
EBCDIC-Zeilenumbruch konvertieren EBCDIC-Codepages enthalten ein Zeichen für den Zeilenumbruch (NL-Zeichen), das von den ASCII-Codepages nicht unterstützt wird (obwohl einige ISO-Varianten von ASCII ein Äquivalent enthalten). Wenn Nachrichten von einem System, das EBCDIC-Codepages verwendet (z.B. einem z/OS-System), an ein System gesendet werden, das ASCII verwendet, können Sie steuern, wie das EBCDIC-Zeichen für Zeilenumbrüche in das ASCII-Format konvertiert wird. Der Standardwert lautet NL_TO_LF. Dies bedeutet, dass das EBCDIC-NL-Zeichen (X'15') bei allen Konvertierungen vom EBCDIC- in das ASCII-Format in das ASCII-LF-Zeichen für Zeilenvorschub (X'0A') konvertiert wird. Wenn das EBCDIC-NL-Zeichen gemäß den Konvertierungstabellen Ihres Betriebssystems konvertiert werden soll, klicken Sie auf TABLE. Hinweis: Die Ergebnisse einer TABLE-Konvertierung können je nach Plattform und Sprache variieren; selbst auf derselben Plattform können sich die Ergebnisse unterscheiden, wenn Sie andere CCSIDs (IDs codierter Zeichensätze) verwenden. Wenn Sie ISO-CCSIDs mithilfe der Methode TABLE konvertieren und die Methode NL_TO_LF für alle anderen CCSIDs verwenden möchten, klicken Sie auf ISO. ConvEBCDICNewline
Clusterauslastungsmodus Über den Exit für Clusterauslastung (CLWL) kann festgelegt werden, welche Clusterwarteschlange auf einen MQI-Aufruf (z. B. MQOPEN oder MQPUT) hin geöffnet werden soll. Der Standardwert lautet SAFE, was bedeutet, dass der CLWL-Exit in einem vom Warteschlangenmanager abgetrennten Prozess ausgeführt wird, damit im Fall von Problemen die Integrität des Warteschlangenmanagers gewahrt bleibt. Wird der CLWL-Exit als separater Prozess ausgeführt, kann sich dies jedoch negativ auf die Systemleistung auswirken. Wenn Sie zur Verbesserung der Leistung den CLWL-Exit in demselben Prozess ausführen möchten wie den Warteschlangenmanager, klicken Sie auf FAST. Verwenden Sie den Modus FAST nur, wenn Sie sicher sind, dass im Zusammenhang mit Ihrem CLWL-Exit keine Probleme bestehen. Falls im Modus FAST ein Problem auftritt, schlägt der Warteschlangenmanager fehl und die Integrität des Warteschlangenmanagers ist gefährdet. Dieser Wert kann für einzelne Warteschlangenmanager, die die Eigenschaft für den Clusterauslastungsmodus verwenden, überschrieben werden. Weitere Informationen finden Sie in Eigenschaften des WS-Managers. CLWLMode

Seite 'Exits'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Exits im Dialog mit den Eigenschaften für IBM MQ festlegen können. Wenn Sie die Exits konfigurieren möchten, die auf diesem Computer von allen Warteschlangenmanagern gemeinsam verwendet werden, müssen Sie die Eigenschaften auf der Seite Exits bearbeiten.

Eigenschaft Beschreibung Zeilengruppenschlüssel
Standardpfad für Exits Wenn Sie den Pfad der Kanalexits für Clients sowie der Kanalexits und Datenkonvertierungsexits für Server ändern möchten, geben Sie den Pfad des neuen Verzeichnisses ein. ExitsDefaultPath
Allgemeine API-Exits Wenn Sie einen neuen allgemeinen API-Exit für IBM MQ konfigurieren möchten, klicken Sie im Dialog Eigenschaften auf Hinzufügen und geben Sie anschließend die Einzeldaten zum Exit ein. Wenn Sie einen allgemeinen API-Exit bearbeiten möchten, der in der Tabelle bereits angezeigt wird, klicken Sie auf Bearbeiten. Wenn Sie einen API-Exit aus der Tabelle entfernen möchten, klicken Sie auf Entfernen. ApiExitCommon
API-Exit-Schablonen Wenn Sie eine neue API-Exit-Schablone für IBM MQ konfigurieren möchten, klicken Sie im Dialog 'Eigenschaften' auf Hinzufügen und geben Sie anschließend die Einzeldaten zum Exit ein. Wenn Sie eine API-Exit-Schablone bearbeiten möchten, die in der Tabelle bereits angezeigt wird, klicken Sie auf Bearbeiten. Wenn Sie einen API-Exit aus der Tabelle entfernen möchten, klicken Sie auf Entfernen. ApiExitTemplate
Name Gibt den beschreibenden Namen des API-Exits an, der im Feld 'ExitInfoName' der MQAXP-Struktur an den API-Exit übergeben wird. Dieser Name muss eindeutig sein und darf nur aus maximal 48 Zeichen bestehen; er darf nur Zeichen enthalten, die für IBM MQ-Objekte gültig sind (beispielsweise Warteschlangennamen). Name
Typ Gibt die Art des Exits an: Allgemein oder Schablone. (Dies ist kein separater Zeilengruppenschlüssel.)
Sequence Diese Eigenschaft ist ein numerischer Wert ohne Vorzeichen, der definiert, wann dieser API-Exit unter mehreren API-Exits aufgerufen wird. Ein API-Exit mit einer niedrigen Folgenummer wird vor einem API-Exit mit einer höheren Folgenummer aufgerufen. Die Reihenfolge, in der verschiedene API-Exits mit derselben Folgenummer aufgerufen werden, ist nicht definiert. Zwischen den Folgenummern der API-Exits, die für einen Warteschlangenmanager definiert sind, können auch Lücken bestehen. Sequence
Module Gibt das Modul an, das den Code für den API-Exit enthält. Falls dieses Feld den vollständigen Pfadnamen des Moduls enthält, wird dieser unverändert verwendet. Enthält dieses Feld jedoch nur den Modulnamen, wird das Modul mit derselben Methode wie bei Kanalexits gesucht; hierbei wird der Wert verwendet, der im Feld 'Standardpfad für Exit' auf der Seite Exits des Dialogs mit den Warteschlangenmanagereigenschaften angegeben ist. Module
Function Gibt den Namen des Eingangspunkts der Funktion in dem Modul an, das den Code für den API-Exit enthält. Bei diesem Eingangspunkt handelt es sich um die MQ_INIT_EXIT-Funktion. Die Feldlänge ist auf den Wert von MQ_EXIT_NAME_LENGTH beschränkt. Function
Daten Falls diese Eigenschaft angegeben wird, werden führende und abschließende Leerzeichen entfernt, die verbleibende Zeichenfolge bei 32 Zeichen abgeschnitten und das Ergebnis an den Exit im Feld 'ExitData' der MQAXP-Struktur übergeben. Wird diese Eigenschaft nicht angegeben, wird der Standardwert (32 Leerzeichen) an den Exit im Feld 'ExitData' der MQAXP-Struktur übergeben. Daten

Standardprotokolleinstellungen

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Standardprotokolleinstellungen im Dialog mit den Eigenschaften für IBM MQ festlegen können. Wenn Sie die Standardprotokolleinstellungen ändern möchten, müssen Sie die Eigenschaften auf der Seite Standardprotokolleinstellungen bearbeiten. Diese Einstellungen werden standardmäßig für alle neuen Warteschlangenmanager übernommen.

Eigenschaft Beschreibung Zeilengruppenschlüssel
Protokolltyp Wenn Sie die Option Rückwirkend (Umlaufprotokollierung) auswählen, kann der Warteschlangenmanager bei seinem Neustart wiederhergestellt werden. Wird vom Warteschlangenmanager die Umlaufprotokollierung verwendet, wird eine volle Protokolldatei vom Dateianfang her überschrieben. Wenn Sie die Option Linear verwenden, kann der Warteschlangenmanager bei seinem Neustart wiederhergestellt werden und die Datenträger- und Vorwärtswiederherstellung wird ermöglicht. Wenn der Warteschlangenmanager die lineare Protokollierung verwendet, wird eine neue Protokolldatei erstellt, sobald die alte Protokolldatei voll ist. LogType
Protokollpfad Wenn Sie den Standardpfad der Protokolle ändern möchten, geben Sie an dieser Stelle den vollständigen Pfad ein. Erfolgt an dieser Stelle keine Pfadangabe, wird standardmäßig das Unterverzeichnis 'Log' des Verzeichnisses 'Standardpräfix' verwendet. Hierbei steht 'Standardpräfix' für das Verzeichnis, das über die Eigenschaft Standardpräfix auf der Seite Allgemein im Dialog mit den IBM MQ-Eigenschaften angegeben wurde. LogPath
Dateiseiten protokollieren Geben Sie für die Protokolldatei die Anzahl der Seiten mit einer Größe von jeweils 4 KB ein (zulässig sind die Werte 32 bis 4095). Wenn Sie beispielsweise 256 eingeben, beträgt die Dateigröße 1 MB. LogFilePages
Protokollprimärdateien

Unter Windows müssen Sie für die Anzahl der primären Protokolldateien einen Wert zwischen 2 und 254 eingeben. Der Standardwert ist 3. Die Gesamtanzahl der primären und sekundären Protokolldateien darf nicht größer als 255 bzw. nicht kleiner als 3 sein.

Unter UNIX und Linux® müssen Sie für die Anzahl der primären Protokolldateien einen Wert zwischen 2 und 510 eingeben. Der Standardwert ist 3. Die Gesamtanzahl der primären und sekundären Protokolldateien darf nicht größer als 511 bzw. nicht kleiner als 3 sein.

LogPrimaryFiles
Protokollsekundärdateien

Unter Windows müssen Sie für die Anzahl der sekundären Protokolldateien einen Wert zwischen 1 und 253 eingeben. Der Standardwert ist 3. Die Gesamtanzahl der primären und sekundären Protokolldateien darf nicht größer als 255 bzw. nicht kleiner als 3 sein.

Unter UNIX und Linux müssen Sie für die Anzahl der sekundären Protokolldateien einen Wert zwischen 1 und 509 eingeben. Der Standardwert ist 3. Die Gesamtanzahl der primären und sekundären Protokolldateien darf nicht größer als 511 bzw. nicht kleiner als 3 sein.

LogSecondaryFiles
Pufferseiten protokollieren Geben Sie die Anzahl (von 0 bis 512) der Pufferseiten (mit je 4 KB) für Schreibvorgänge an. Wenn Sie 0 angeben, wählt der Warteschlangenmanager die Anzahl selbst aus.

Bei der Angabe von 1 bis 17 wird der Mindestwert 18 verwendet. Bei der Angabe von 18 bis 512 wird diese Seitenanzahl verwendet. Wenn Sie den Wert dieser Eigenschaft ändern, muss der Warteschlangenmanager erneut gestartet werden, damit die Änderung erkannt wird.

LogBufferPages
Schreibintegrität protokollieren Dies ist die Methode, die von der Protokollfunktion zur zuverlässigen Erstellung von Protokollsätzen verwendet wird.

Der Standardwert ist TripleWrite. Hinweis: Sie können DoubleWrite zwar auswählen, in diesem Fall interpretiert das System diese Einstellung jedoch als TripleWrite.

Sie sollten SingleWrite nur verwenden, wenn das Dateisystem oder das Gerät mit dem IBM MQ-Wiederherstellungsprotokoll explizit die Atomizität von 4-KB-Schreibvorgängen garantiert.

Wenn also das Schreiben einer 4-KB-Seite aus irgendeinem Grund fehlschlägt, gibt es nur zwei mögliche Status: vor dem Image oder nach dem Image. Es sollte kein Zwischenstatus möglich sein.

LogWriteIntegrity
Protokollverwaltung Die Methode, die für die Verwaltung Ihrer Protokolle verwendet wird. LogManagement findet nur Anwendung, wenn LINEAR als LogType festgelegt ist.

Wenn Sie den Wert von LogManagement ändern, tritt die Änderung erst nach dem Neustart des Warteschlangenmanagers in Kraft.

Es gibt drei Optionen.

Bei der Option Manuell werden die Protokollspeicherbereiche manuell verwaltet. Wenn Sie diese Option angeben, hat das zur Folge, dass der Warteschlangenmanager Protokollspeicherbereiche nicht wiederverwendet oder löscht. Dies gilt selbst dann, wenn sie nicht mehr für die Wiederherstellung benötigt werden.

Bei der Option Automatisch werden Protokollspeicherbereiche automatisch vom Warteschlangenmanager verwaltet. Wenn Sie diese Option angeben, hat das zur Folge, dass der Warteschlangenmanager Protokollspeicherbereiche wiederverwenden oder löschen kann, sobald sie nicht mehr für die Wiederherstellung benötigt werden. Für die Archivierung wird keine Kapazität reserviert.

Bei der Option Archiv werden Protokollspeicherbereiche vom Warteschlangenmanager verwaltet. Allerdings müssen Sie den Warteschlangenmanager benachrichtigen, wenn die Archivierung der einzelnen Protokollspeicherbereiche abgeschlossen ist.

Wenn Sie diese Option angeben, hat das zur Folge, dass der Warteschlangenmanager einen Protokollspeicherbereich wiederverwenden oder löschen kann, sobald der Warteschlangenmanager darüber benachrichtigt wurde, dass ein Speicherbereich, der für die Wiederherstellung nicht mehr benötigt wird, archiviert wurde.

Der Standardwert ist Manuell.

LogManagement

Seite 'ACPI'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite ACPI im Dialog mit den Eigenschaften für IBM MQ festlegen können. ACPI (Advanced Configuration and Power Interface) ist eine Funktion des Betriebssystems, über die der Computer den Status bestimmter Vorgänge ermitteln kann, um anschließend in den Ruhezustand, d. h. in den Stromsparmodus zu wechseln, in dem keine Programme aktiv sind, der jedoch eine schnelle Aktivierung zulässt.

Bevor der Computer in den Stromsparmodus wechselt, sendet ACPI an alle Anwendungen eine Anforderung zum Aussetzen der aktiven Programme. Um zu steuern, wie IBM MQ auf diese Anforderung reagiert, müssen Sie die Eigenschaft Ausführen auf der Seite ACPI festlegen.

Eigenschaft Beschreibung Zeilengruppenschlüssel
Ausführen Der Standardwert lautet Ja, was bedeutet, dass der Benutzer von IBM MQ in einer Nachricht gefragt wird, ob die aktiven Warteschlangenmanager ausgesetzt werden sollen. Wenn IBM MQ ohne Anzeige dieser Nachricht ausgesetzt werden soll, klicken Sie auf Nein. DoDialog
Aussetzen verweigern Wenn die Eigenschaft Ausführen nicht festgelegt wurde oder wenn die Eigenschaft festgelegt wurde, der Dialog jedoch nicht angezeigt werden kann (weil beispielsweise ein Laptop zugeklappt ist), wird die Reaktion über die Eigenschaft Aussetzen verweigern gesteuert. Der Standardwert lautet Nein. Dies bedeutet, dass IBM MQ auch ausgesetzt wird, wenn der Dialog nicht angezeigt werden kann. Wenn IBM MQ nicht ausgesetzt werden soll, falls der Dialog nicht angezeigt werden kann, müssen Sie auf Ja klicken. Diese Eigenschaft kann durch die Eigenschaft Aktive Kanäle prüfen außer Kraft gesetzt werden. DenySuspend
Aktive Kanäle prüfen Der Standardwert lautet Nein, was bedeutet, dass von IBM MQ nicht überprüft wird, ob Kanäle aktiv sind. Stattdessen wird die Reaktion von WebSphere MQ über die Eigenschaften Ausführen und Aussetzen verweigern gesteuert. Wenn geprüft werden soll, ob Kanäle aktiv sind, müssen Sie auf Ja klicken. Wenn keine Kanäle aktiv sind, werden die Eigenschaften Ausführen und Aussetzen verweigern von IBM MQ ignoriert. Wenn Kanäle aktiv sind, reagiert IBM MQ gemäß der Angaben für die Eigenschaften Ausführen und Aussetzen verweigern. CheckChannelsRunning
[Windows]

Seite 'Alert-Monitor'

Der Alert-Monitor steht nur unter Windows zur Verfügung.

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Alert-Monitor im Dialog mit den Eigenschaften für IBM MQ festlegen können. Der Alert-Monitor ist bei der Fehlerbestimmung hilfreich. Alerts werden beim Auftreten von Fehlern durch die Services ausgegeben; z. B. wenn ein Kanalinitiatorservice nicht gestartet werden kann, weil eine von ihm benötigte Warteschlange gelöscht wurde. Zur Konfiguration des Alert-Monitors müssen Sie die Eigenschaften auf der Seite Alert-Monitor bearbeiten.

Eigenschaft Beschreibung Zeilengruppenschlüssel
Alert-Monitor benachrichtigt Benutzer Der Standardwert lautet Nein. Dies bedeutet, dass von IBM MQ beim Auftreten eines Problems keine Alerts an den Benutzer gesendet werden. Wenn Sie IBM MQ so konfigurieren möchten, dass beim Auftreten von Problemen Alerts gesendet werden, klicken Sie auf Ja. Enable
Alert-Monitor-Benutzer Geben Sie den System- oder Benutzernamen ein, an den IBM MQ die Alerts senden soll. Recipient
Symbol für Alert-Monitor zur Taskleiste hinzugefügt Der Standardwert lautet Nein. Dies bedeutet, dass das Alert-Monitor-Symbol in der Windows-Taskleiste nicht angezeigt wird. Wenn das Alert-Monitor-Symbol in der Windows-Taskleiste angezeigt werden soll, klicken Sie auf Ja. TaskBar

Seite 'Konfigurationsdaten'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Konfigurationsdaten im Dialog mit den Eigenschaften für IBM MQ angezeigt werden. Die Eigenschaften auf der Seite Konfigurationsdaten sind schreibgeschützt.

Eigenschaft Beschreibung
Installationstyp Schreibgeschützt. Diese Eigenschaft gibt an, ob Sie die Server- oder Clientversion von IBM MQ auf diesem Computer installiert haben.
mqjbnd05 geladen Schreibgeschützt. Hierbei handelt es sich um die Bibliothek, die für die Herstellung einer Verbindung zu lokalen Warteschlangenmanagern erforderlich ist.
MQ-Version Schreibgeschützt. Hierbei handelt es sich um die auf diesem Computer installierte Version von IBM MQ.
Buildstufe Schreibgeschützt. Hierbei handelt es sich um die Buildnummer des auf diesem Computer installierten IBM MQ-Produkts.
Build-Typ Schreibgeschützt. Hierbei handelt es sich um den Build-Typ des auf diesem Computer installierten IBM MQ-Produkts.