IBM MQ Eigenschaften
IBM® MQ -Eigenschaften gelten für die gesamte IBM MQ -Installation.
In den folgenden Tabellen sind die Eigenschaften aufgelistet, die für IBM MQfestgelegt werden können:
Für jede Eigenschaft wird kurz beschrieben, wann ihre Konfiguration erforderlich oder sinnvoll sein kann. Die Eigenschaften im IBM MQ -Eigenschaftendialog beziehen sich auf Zeilengruppen in den Konfigurationsdateien.
Seite 'Allgemein'
In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Allgemein im Dialog mit den Eigenschaften für IBM MQ festgelegt werden 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 Warteschlangenmanager | 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 |
---|---|---|
Ephemeres Standardpräfix | 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. ein z/OS® -System), an ein System gesendet werden, das ASCII verwendet, können Sie steuern, wie das EBCDIC-Zeilenvorschubzeichen 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 unter Eigenschaften des Warteschlangenmanagers. | 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. | Standardpfad für Exits |
Allgemeine API-Exits | Wenn Sie einen neuen allgemeinen API-Exit für IBM MQ konfigurieren wollen, klicken Sie auf Hinzufügen und geben Sie dann im Dialog Eigenschaften die Details des Exits 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 | Um einen neuen Vorlagen-API-Exit für IBM MQzu konfigurieren, klicken Sie auf Hinzufügen und geben Sie dann im Dialogfeld "Eigenschaften" die Details des Exits 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 ist auf eine Länge von 48 Zeichen begrenzt. Er darf nur Zeichen enthalten, die für den Namen von IBM MQ -Objekten gültig sind, z. B. Warteschlangennamen. | Name |
Typ | Gibt den Exittyp an: common oder template . |
(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 |
Modul | Gibt das Modul an, das den Code für den API-Exit enthält. Wenn dieses Feld den vollständigen Pfadnamen enthält, wird es unverändert übernommen. Wenn dieses Feld nur den Modulnamen enthält, wird das Modul mit derselben Methode wie Kanalexits lokalisiert, d. h. mit dem Wert im Feld Exit default path auf der Seite Exits des Dialogfelds mit den Eigenschaften des Warteschlangenmanagers. |
Modul |
Funktion | 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 Länge dieses Felds ist auf den Wert von MQ_EXIT_NAME_LENGTH beschränkt. | Funktion |
Data | 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. | Data |
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. Wenn Sie den Pfad hier nicht angeben, wird standardmäßig ein Unterverzeichnis namens 'Log' im Standardpräfix verwendet, wobei 'DefaultPrefix' dem Verzeichnis entspricht, das in der Eigenschaft Default prefix auf der Seite Allgemein des Dialogs 'Eigenschaften für IBM MQ' angegeben ist. |
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 Folgendes eingeben:256, ist die Dateigröße 1MB. | LogFilePages |
Primäre Protokolldateien | Geben Sie unter AIX® and Linux®die Anzahl der primären Protokolldateien von 2 bis 510 ein. Der Standardwert ist 3. Die Gesamtzahl der primären und sekundären Protokolldateien darf nicht größer als 511 und nicht kleiner als 3 sein. Geben Sie unter Windowsdie Anzahl der primären Protokolldateien von 2 bis 254 ein. Der Standardwert ist 3. Die Gesamtzahl der primären und sekundären Protokolldateien darf nicht größer als 255 und nicht kleiner als 3 sein. |
LogPrimaryFiles |
Sekundäre Protokolldateien | Geben Sie unter AIX and Linuxdie Anzahl der sekundären Protokolldateien von 1 bis 509 ein. Der Standardwert ist 3. Die Gesamtzahl der primären und sekundären Protokolldateien darf nicht größer als 511 und nicht kleiner als 3 sein. Geben Sie unter Windowsdie Anzahl der sekundären Protokolldateien von 1 bis 253 ein. Der Standardwert ist 3. Die Gesamtzahl der primären und sekundären Protokolldateien darf nicht größer als 255 und nicht kleiner als 3 sein. |
LogSecondaryFiles |
Seiten des Protokollpuffers | 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. Beachten Sie, dass Sie DoubleWrite auswählen können, aber wenn Sie dies tun, interpretiert das System diese Option als TripleWrite . Sie sollten SingleWritenur verwenden, wenn das Dateisystem oder die Einheit, die das IBM MQ -Wiederherstellungsprotokoll hostet, explizit die Atomizität von 4KB Schreibvorgängen garantiert. Das heißt, wenn ein Schreiben einer 4-KB-Seite aus irgendeinem Grund fehlschlägt, sind die einzigen beiden möglichen Status entweder das Vorimage oder das Nachimage. Ein Zwischenzustand sollte nicht 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 für LogManagement ändern, wird die Änderung erst wirksam, wenn der WS-Manager erneut gestartet wird. Es gibt drei Optionen. Bei der Option Manuell werden die Protokollspeicherbereiche manuell verwaltet. Die Angabe dieser Option bedeutet, dass der Warteschlangenmanager keine Protokollspeicherbereiche wiederverwenden oder löschen kann, selbst wenn sie nicht mehr für die Wiederherstellung benötigt werden. Bei der Option Automatisch werden Protokollspeicherbereiche automatisch vom Warteschlangenmanager verwaltet. Die Angabe dieser Option bedeutet, 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 Vergütung berücksichtigt. Bei der Option Archiv werden Protokollspeicherbereiche vom Warteschlangenmanager verwaltet. Allerdings müssen Sie den Warteschlangenmanager benachrichtigen, wenn die Archivierung der einzelnen Protokollspeicherbereiche abgeschlossen ist. Die Angabe dieser Option bedeutet, dass der Warteschlangenmanager keinen Protokollspeicherbereich wiederverwenden oder löschen kann, sobald der Warteschlangenmanager benachrichtigt wurde, dass ein Speicherbereich, der nicht mehr für die Wiederherstellung erforderlich ist, archiviert wurde. Der Standardwert ist Manuell. |
LogManagement |
Seite 'ACPI'
In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie im Dialog mit den Eigenschaften für IBM MQ auf der Seite ACPI festlegen können. ACPI (Advanced Configuration and Power ® Interface) ist eine Betriebssystemfunktion, die es dem Computer ermöglicht, bestimmte Aktivitätszustände zu erkennen und folglich in den Ruhezustand zu versetzen, d. h. in einen Modus mit geringer Leistung zu wechseln, ohne dass Programme ausgeführt werden, und in einer Weise, die ein schnelles "Aufwachen" ermöglicht.
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 antwortet, legen Sie die Eigenschaft Dialog ausführen auf der Seite ACPI fest.
Eigenschaft | Beschreibung | Zeilengruppenschlüssel |
---|---|---|
Ausführen | Der Standardwert Jabedeutet, dass IBM MQ eine Nachricht anzeigt, in der der Benutzer gefragt wird, ob die aktiven Warteschlangenmanager ausgesetzt werden sollen. Um IBM MQ auszusetzen, ohne diese Nachricht anzuzeigen, klicken Sie auf Nein. | DoDialog |
Aussetzen verweigern | Wenn die Eigenschaft Do dialog nicht festgelegt oder wenn sie zwar festgelegt ist, der Dialog jedoch nicht angezeigt werden kann (weil der Laptop beispielsweise zugeklappt ist), wird die Antworf von Deny suspend gesteuert. Der Standardwert Neinbedeutet, dass IBM MQ ausgesetzt wird, auch wenn der Dialog nicht angezeigt werden kann. Um zu verhindern, dass IBM MQ ausgesetzt wird, wenn der Dialog nicht angezeigt werden kann, klicken Sie auf Ja. Diese Eigenschaft kann durch die Eigenschaft Check channels running außer Kraft gesetzt werden. | DenySuspend |
Aktive Kanäle prüfen | Der Standardwert lautet Nein. Das bedeutet, dass IBM MQ nicht prüft, ob Kanäle aktiv sind, und antwortet wie durch die Eigenschaften Do dialog und Deny suspend angegeben. Wenn geprüft werden soll, ob Kanäle aktiv sind, müssen Sie auf Ja klicken. Wenn keine Kanäle aktiv sind, ignoriert IBM MQ die Eigenschaften Do dialog und Deny suspend. Wenn Kanäle aktiv sind, antwortet IBM MQ wie durch die Eigenschaften Do dialog und Deny suspend angegeben. | CheckChannelsRunning |
![[Windows]](ngwin.gif)
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 Alertmonitor 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 ist Nein, d. h., IBM MQ sendet keine Alerts an den Benutzer, wenn ein Problem auftritt. Um IBM MQ so zu konfigurieren, dass Alerts gesendet werden, wenn ein Fehler auftritt, klicken Sie auf Ja. | Aktivieren |
Alert-Monitor-Benutzer | Geben Sie den Computernamen oder den Benutzernamen ein, an den IBM MQ 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 Konfigurationsinformationen 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 dem 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. Dies ist die Version von IBM MQ , die auf diesem Computer installiert ist. |
Buildstufe | Schreibgeschützt. Dies ist die Buildnummer des IBM MQ -Produkts, das auf diesem Computer installiert ist. |
Build-Typ | Schreibgeschützt. Dies ist der Buildtyp des IBM MQ -Produkts, das auf diesem Computer installiert ist. |