IBM MQ -Warteschlangeneigenschaften
Welche Eigenschaften für eine Warteschlange festgelegt werden können, ist abhängig vom Warteschlangentyp. Verschiedene Typen von IBM® MQ -Warteschlangen haben unterschiedliche Eigenschaften. Einige Eigenschaften gelten nicht für alle Warteschlangentypen, einige Eigenschaften gelten speziell für Clusterwarteschlangen und einige Eigenschaften gelten speziell für z/OS® -Warteschlangen.
In der folgenden Tabelle werden alle Eigenschaften aufgeführt, die für sämtliche Warteschlangentypen festgelegt werden können:
Für jede Eigenschaft wird kurz beschrieben, wann ihre Konfiguration erforderlich oder sinnvoll sein kann. In der Tabelle werden auch die entsprechenden MQSC-Parameter für die Befehle DEFINE, ALTER und DISPLAY QUEUE genannt. Weitere Informationen zu MQSC-Befehlen finden Sie unter MQSC-Befehle in der IBM -Dokumentation.
Seite 'Allgemein'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Allgemein des Dialogs Warteschlangeneigenschaften festlegen können.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Warteschlangenname | Schreibgeschützt. Der Name der Warteschlange kann nach deren Erstellung nicht geändert werden. | QNAME |
Warteschlangentyp | Schreibgeschützt. Der Typ der Warteschlange kann nach deren Erstellung nicht geändert werden. | QTYPE |
QSG-Disposition | (Nur gemeinsam genutzte z/OS-Warteschlange) Schreibgeschützt. Die Disposition der Gruppe mit gemeinsamer Warteschlange der Warteschlange. Gibt die Disposition des Objekts an (wo es definiert ist bzw. welches Verhalten es aufweist). Die Disposition einer Warteschlange kann nach deren Erstellung nicht geändert
werden. Queue manager bedeutet, dass die Objektdefinition nur für den Warteschlangenmanager verfügbar ist, der sie hostet. Group bedeutet, dass die Objektdefinition im gemeinsam genutzten Repository gespeichert ist und jeder Warteschlangenmanager in der Gruppe mit gemeinsamer Warteschlange über eine Kopie der Definition verfügt. Copy bedeutet, dass es sich bei der Objektdefinition um die Kopie des Warteschlangenmanagers einer Definition im gemeinsamen Repository handelt. Shared bedeutet, dass die Objektdefinition in der Coupling-Facility der Gruppe mit gemeinsamer Warteschlange gespeichert ist und allen Warteschlangenmanagern in der Gruppe mit gemeinsamer Warteschlange zur Verfügung steht. |
QSGDISP |
Beschreibung | Geben Sie für die Warteschlange eine aussagekräftige Beschreibung des Zwecks an. Siehe Zeichenfolgen in Eigenschaftendialogen. | DESCR |
Nachrichten einreihen | Wenn es möglich sein soll, Nachrichten in die Warteschlange einzureihen, wählen Sie Zulässig aus; wenn die Einreihung von Nachrichten in die Warteschlange verhindert werden soll, wählen Sie Unterdrückt aus. | PUT |
Nachrichten abrufen | Wenn es möglich sein soll, Nachrichten aus der Warteschlange abzurufen, wählen Sie Zulässig aus; wenn der Abruf von Nachrichten aus der Warteschlange verhindert werden soll, wählen Sie Unterdrückt aus. | GET |
Standardpriorität | Geben Sie die Standardpriorität (von 0 bis 9) für Nachrichten ein, die in die Warteschlange eingereiht werden. Dabei steht 0 für die niedrigste Priorität. | DEFPRTY |
Standardpermanenz | Eine neue Warteschlange hat jeweils die Standardpermanenz Nicht permanent. Wählen Sie Permanent aus, wenn Nachrichten permanent sein sollen, die von Anwendungen erstellt werden, die MQPER_PERSISTENCE_AS_Q_DEF verwenden. Wählen Sie Nicht permanent aus, wenn Nachrichten nicht permanent sein sollen, die von Anwendungen erstellt werden, die MQPER_PERSISTENCE_AS_Q_DEF verwenden. | DEFPSIST |
Bereich | Wenn die Warteschlange in das Zellenverzeichnis gestellt werden soll und alle Warteschlangenmanager in der Zelle von der Warteschlange in Kenntnis gesetzt werden sollen, wählen Sie Zelle aus. Wenn der Bereich der Warteschlange auf ihren Warteschlangenmanager eingegrenzt werden soll, wählen Sie Warteschlangenmanager aus. | SCOPE |
Verwendung | Wenn die Warteschlange als lokale Warteschlange definiert werden soll, wählen Sie Normal aus. Wenn sie als Übertragungswarteschlange fungieren soll, wählen Sie Übertragung aus. Die Eigenschaft 'Verwendung' darf nicht geändert werden, solange sich Nachrichten in der Warteschlange befinden. | Verwendung |
Basistyp | Wählen Sie den Objekttyp aus (Warteschlange oder Thema), in den die Aliaswarteschlange aufgelöst wird. Der Standardwert ist Queue. | TARGTYPE |
Ferne Warteschlange | Geben Sie den Namen der Warteschlange ein, auf die die Definition der fernen Warteschlange zeigt. | RNAME |
Ferner Warteschlangenmanager | Geben Sie den Namen des Warteschlangenmanagers ein, der die ferne Warteschlange enthält. | RQMNAME |
Übertragungswarteschlange | Geben Sie den Namen der Übertragungswarteschlange ein, die vom lokalen Warteschlangenmanager zum Senden von Nachrichten an den fernen Warteschlangenmanager verwendet wird. | XMITQ |
Seite 'Erweitert'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Erweitert des Dialogs Warteschlangeneigenschaften festlegen können.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Maximal zulässige Warteschlangenlänge | Geben Sie die maximal zulässige Anzahl Nachrichten in dieser Warteschlange an. Geben Sie einen Wert zwischen 0 und 999.999.999 an. | MAXDEPTH |
Maximale Nachrichtenlänge | Geben Sie (in Bytes) die Nachrichtenlänge ein, die höchstens in der Warteschlange zulässig ist. Geben Sie auf allen Plattformen außer z/OSeinen Wert von 0 bis zur maximalen Nachrichtenlänge für den Warteschlangenmanager an. Siehe Eigenschaft Maximum message length in Eigenschaften des Warteschlangenmanagers. Geben Sie unter z/OSeinen Wert von 0 bis 100 MB ein. |
MAXMSGL |
Gemeinsame Nutzung | Wenn die Warteschlange gemeinsam genutzt werden soll, damit diese Warteschlange von mehr als nur einer Anwendungsinstanz zur Eingabe geöffnet werden kann, wählen Sie Gemeinsam nutzbar aus; Wenn die Nutzung der Warteschlange eingeschränkt werden soll, so dass sie jeweils nur von einer Anwendungsinstanz geöffnet werden kann, wählen Sie Nicht gemeinsam nutzbar aus. | SHARE |
Standardoption für die Öffnung zur Eingabe | Wenn Anwendungen, die die Warteschlange zur Eingabe öffnen, exklusiven Zugriff auf die Nachrichten in der Warteschlange haben sollen, wählen Sie Exklusiv aus; wenn die Nachrichten in der Warteschlange allen Anwendungen zur Verfügung stehen sollen, von denen die Warteschlange zur Eingabe geöffnet wird, wählen Sie Gemeinsam genutzt aus. | DEFSOPT |
Reihenfolge bei der Nachrichtenübertragung | Wählen Sie Priorität aus, um anzugeben, dass die Nachrichten in der Reihenfolge ihrer Priorität aus der Warteschlange abgerufen werden. Wenn Sie angeben möchten, dass Nachrichten in der Reihenfolge aus der Warteschlange abgerufen werden sollen, in der sie in die Warteschlange eingereiht wurden, wählen Sie FIFO (First In/First Out) aus. | MSGDLVSQ |
Rückhalteintervall | Geben Sie an, wie lange eine Warteschlange benötigt wird; der Wert wird in Stunden zwischen 0 und 999.999.999 ab dem Zeitpunkt (Tag und Uhrzeit) angegeben, an dem die Warteschlange erstellt wurde. Mithilfe dieser Informationen können Sie bestimmen, wann die Warteschlange nicht mehr erforderlich ist. Die Warteschlange wird nicht gelöscht, wenn sie nicht mehr benötigt wird. | RETINTVL |
Indextyp | Wählen Sie eine dieser fünf Optionen aus, um den Indextyp anzugeben, den der Warteschlangenmanager zum Erhöhen der Geschwindigkeit von MQGET-Operationen in der Warteschlange verwendet: Keine: Es wird kein Index verwendet. Diese Option können Sie verwenden, wenn Nachrichten nacheinander abgerufen werden. Dies ist die Standardeinstellung. Gruppen-ID: Es wird ein Index mit Gruppen-IDs verwendet. Sie müssen diesen Indextyp verwenden, wenn Nachrichtengruppen logisch geordnet werden sollen.Korrelations-ID: Es wird ein Index mit Korrelations-IDs verwendet. Geben Sie diesen Wert an, wenn Nachrichten mithilfe des Feldes 'CorrelId' als Auswahlkriterium im Aufruf MQGET abgerufen werden. Nachrichten-ID: Es wird ein Index mit Nachrichten-IDs verwendet. Geben Sie diesen Wert an, wenn Nachrichten mithilfe des Feldes 'MsgId' als Auswahlkriterium im Aufruf MQGET abgerufen werden.Nachrichten-Token: Es wird ein Index mit Nachrichtentoken verwendet. |
|
Definitionstyp | Bei lokalen Warteschlangen ist diese Eigenschaft schreibgeschützt: Predefined bedeutet, dass die Warteschlange von einem Bediener oder einer berechtigten Anwendung erstellt wurde, die eine Befehlsnachricht an die Servicewarteschlange sendet; Permanent dynamic bedeutet, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf mit dem Namen einer Modellwarteschlange ausgibt, die im Objektdeskriptor (MQOD) angegeben ist, und die Warteschlange permanent ist; Temporary dynamic bedeutet, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf ausgibt, aber die Warteschlange ist temporary; Shared dynamic (nurz/OS ) bedeutet auch, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf ausgibt, die Warteschlange jedoch permanent ist und die Disposition Shared für die Gruppe mit gemeinsamer Warteschlange aufweist.Für Modellwarteschlangen ist diese Eigenschaft bearbeitbar. Um anzugeben, dass eine permanente dynamische Warteschlange aus dieser Modellwarteschlange erstellt wird, wählen Sie Permanent dynamisch aus (unter z/OShat die dynamische Warteschlange die Disposition |
DEFTYPE |
Standardvorauslesen | Wenn Sie Vorauslesen auf der Warteschlangenebene konfigurieren möchten, wählen Sie Ja aus. Nicht permanente Nachrichten werden automatisch vom Client vorausgelesen (das heißt, vor der die Nachrichten anfordernden Anwendung). Nicht permanente Nachrichten gehen möglicherweise verloren, wenn der Client abnormal beendet wird oder die Clientanwendung nicht alle der ihr gesendeten Nachrichten aufnimmt. Wenn Sie die Warteschlange so konfigurieren möchten, dass nicht persistente Nachrichten vom Client nicht automatisch vorausgelesen werden, wählen Sie Nein aus. Dies ist der Standardwert. Die Nachrichten werden vom Client nicht automatisch vorausgelesen (das heißt, vor der die Nachrichten anfordernden Anwendung). Nachrichten werden nur auf Anforderung des Clients vorausgelesen. Bei abnormaler Beendigung des Clients geht maximal eine nicht permanente Nachricht verloren. Soll das Vorauslesen auf Warteschlangenebene inaktiviert werden, wählen Sie Inaktiviert aus. Die Nachrichten werden vom Client nicht vorausgelesen (das heißt, vor der die Nachrichten anfordernden Anwendung), unabhängig davon, ob von der Clientanwendung ein Vorauslesen angefordert wurde. |
DEFREADA |
Standardantworttyp beim Einreihen | Der Standardantworttyp für Nachrichteneinreihungen. Wenn Sie angeben möchten, dass die Antwort synchron eingereiht werden soll, wählen Sie Synchron aus. Soll die Antwort asynchron eingereiht werden, wählen Sie Asynchron aus. | DEFPRESP |
Verteilerlisten | Wenn es möglich sein soll, Verteilerlisten-Nachrichten in die Warteschlange einzureihen, wählen Sie Aktiviert aus. Wenn die Einreihung von Verteilerlisten-Nachrichten in die Warteschlange verhindert werden soll, wählen Sie Inaktiviert aus. | DISTL |
Eigenschaftensteuerung (Nur in lokale Warteschlangen, Aliaswarteschlangen und Modellwarteschlangen) |
Dies definiert, was mit Eigenschaften von Nachrichten geschieht, die mit dem MQGET -Befehl aus Warteschlangen abgerufen werden, wenn die Option MQGMO_PROPERTIES_AS_Q_DEF angegeben ist. Wenn alle Eigenschaften der Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung) enthalten sein sollen, wählen Sie Alle aus. Bei Angabe von Alle sind alle Eigenschaften der Nachricht in der Nachricht enthalten, wenn diese an den fernen Warteschlangenmanager gesendet wird. Die Eigenschaften werden, mit Ausnahme der Eigenschaften im Deskriptor oder der Erweiterung der Nachricht, innerhalb der Nachrichtendaten in ein oder mehrere MQRFH2-Header eingefügt. Wenn es Anwendungen, die JMS-spezifische Eigenschaften in einem MQRFH2-Header der Nachrichtendaten erwarten, ermöglicht werden soll, ihre Arbeit in unveränderter Weise fortzusetzen, wählen Sie Kompatibilität aus. Dies ist der Standardwert. Kompatibilität bedeutet Folgendes: Enthält die Nachricht eine Eigenschaft mit dem Präfix mcd., jms., usr. oder mqext., werden alle Nachrichteneigenschaften in einem MQRFH2-Header an die Anwendung übergeben. Andernfalls werden alle Eigenschaften der Nachricht, außer denen, die im Nachrichtendeskriptor (oder Erweiterung) enthalten sind, gelöscht und sind nicht mehr für die Anwendung verfügbar. Um sicherzustellen, dass die Eigenschaften in den Nachrichtendaten immer in einem MQRFH2-Header zurückgegeben werden, unabhängig davon, ob die Anwendung eine Nachrichtenkennung angibt, wählen Sie MQRFH2 erzwingen aus. Eine im Feld für die Nachrichtenkennung (MsgHandle) der MQGMO-Struktur des Aufrufs MQGET bereitgestellte gültige Nachrichtenkennung wird ignoriert. Die Eigenschaften der Nachricht sind nicht über die Nachrichtenkennung zugänglich. Wenn alle Eigenschaften einer Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung) gelöscht werden sollen, wählen Sie Keine aus. Dieser Wert sorgt dafür, dass Anwendungen, die Nachrichteneigenschaften nicht unterstützen, durch die Einbindung einer Eigenschaft in eine Nachricht nicht beeinflusst werden. V6COMPAT: MQRFH2-Header werden nicht vom Eigenschaftencode geändert. Wenn Nachrichteneigenschaften bereitgestellt wurden, aber nicht in den ursprünglichen MQRFH2-Headern enthalten sind, werden sie in einem Nachrichtenhandle zurückgegeben oder andernfalls verworfen. Dieses Verhalten kann durch Angabe einer der MQGMO_PROPERTIES-Optionen geändert werden. Hinweis: Für eine Übertragungswarteschlange, bei der Usage auf Transmission(Übertragung) gesetzt ist, ist die Eigenschaft Property Control (Eigenschaftssteuerung) der Warteschlange irrelevant und stellt die Eigenschaftssteuerung dar. Eigenschaft im entsprechenden Kanalobjekt, das das Verhalten der Nachrichteneigenschaft steuert.
|
PROPCTL |
Benutzerdefiniert | Der Parameter Angepasst ist nur für die Verwendung durch IBM enthalten, reserviert für die Konfiguration neuer Funktionen, bevor separate Eigenschaften eingeführt wurden. Mögliche Werte sind eine Liste von null oder mehreren Eigenschaftswertepaaren im MQSC-Format, die
durch mindestens ein Leerzeichen getrennt sind. Bei Eigenschaftsnamen und -werten wird die Groß-/Kleinschreibung beachtet; die Angaben müssen in Großbuchstaben erfolgen. Die Werte können
Leerzeichen, runde Klammern und einfache Anführungszeichen enthalten (die mit einem weiteren
einfachen Anführungszeichen als Escapezeichen versehen sein müssen). Andere Zeichen, einschließlich
verschachtelter Klammern (), können angegeben werden, indem sie in zwei einfache Anführungszeichen
eingeschlossen werden. Hier einige Beispiele für eine gültige Syntax:
Der Wert wird vom Warteschlangenmanager geparst; kann die Zeichenfolge allerdings nicht entsprechend den Regeln geparst werden oder sind Eigenschaften oder Werte enthalten, die nicht erkannt werden, werden diese Fehler vom Warteschlangenmanager ignoriert. |
Angepasst |
Namen von Clusterkanälen | Wenn die Standardzuordnung von Clustersenderkanälen und Clusterübertragungswarteschlangen geändert werden soll, können Sie für den Parameter Cluster channel
names (Clusterkanalnamen) eine Clusterübertragungswarteschlange angeben. Sie haben die Möglichkeit, anzugeben, welche Clustersenderkanäle Nachrichten aus dieser Clusterübertragungswarteschlange übertragen können. Standardmäßig übertragen alle Clustersenderkanäle Nachrichten aus einer einzelnen Clusterübertragungswarteschlange ( Für den Parameter Cluster channel names (Clusterkanalnamen) kann der Name eines bestimmten Clustersenderkanals oder ein generischer Name angegeben werden. Bei Angabe eines generischen Namens werden dieser Übertragungswarteschlange mehrere Clustersenderkanäle zugeordnet. Generische Namen können an jeder Stelle im Namen Platzhalterzeichen ( Wenn dieser Parameter unter z/OSfestgelegt ist, muss die Warteschlange gemeinsam nutzbar sein, nach Korrelations-ID indexiert sein und darf keine dynamische oder gemeinsam genutzte Warteschlange sein. |
CLCHNAME |
Seite 'Cluster'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Cluster des Dialogs Warteschlangeneigenschaften festlegen können. Wenn die Warteschlange in einem oder mehreren Clustern gemeinsam genutzt werden soll, müssen Sie die Eigenschaften auf der Seite Cluster bearbeiten.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Nicht gemeinsam genutzt in Cluster | Wählen Sie diese Option aus, wenn diese Warteschlange anderen Warteschlangenmanagern nicht über Clusterverbindungen zur Verfügung stehen soll. | (Nicht zutreffend.) |
Gemeinsam genutzt in Cluster | Wenn diese Warteschlange für lediglich einen Cluster als Repository fungieren soll, müssen Sie diese Option auswählen und anschließend den Namen des Clusters eingeben. | Cluster |
Gemeinsam genutzt in Clusterliste | Wenn diese Warteschlange anderen Warteschlangenmanagern in mehr als nur einem Cluster zur Verfügung stehen soll, müssen Sie diese Option auswählen und anschließend den Namen der Namensliste eingeben, die die Clusterliste enthält. | CLUSNL |
Standardbindungsart | Diese Eigenschaft gibt die Bindung für Clusterwarteschlangen an, wenn von einer Anwendung die Angabe MQ00_BIND_AS_Q_DEF im Aufruf MQOPEN erfolgt. Wenn Sie die Warteschlange an eine bestimmte Instanz der Clusterwarteschlange binden möchten, sobald die Warteschlange geöffnet wird, wählen Sie Beim Öffnen aus. Wenn dem Warteschlangenmanager ermöglicht werden soll, beim Einreihen der Nachricht mit dem MQPUT-Aufruf eine bestimmte Warteschlangeninstanz auszuwählen und diese Auswahl gegebenenfalls danach zu ändern, wählen Sie Nicht fixiert aus. | DEFBIND |
CLWL-Warteschlangenrangordnung | Diese Eigenschaft gibt die Warteschlangenrangordnung für die Clusterauslastung an. Geben Sie die Rangordnung der Warteschlange im Cluster ein. Zulässig sind die Werte 0 bis 9, wobei 0 die niedrigste Priorität ist. Weitere Informationen finden Sie unter Distributed queuing and clusters in der Dokumentation zuIBM. | CLWLRANK |
CLWL-Warteschlangenpriorität | Diese Eigenschaft gibt die Warteschlangenpriorität für die Clusterauslastung an. Geben Sie die Priorität der Warteschlange im Cluster ein. Zulässig sind die Werte 0 bis 9, wobei 0 die niedrigste Priorität ist. Weitere Informationen finden Sie unter Distributed queuing and clusters in der Dokumentation zuIBM. | CLWLPRTY |
Warteschlange für CLWL-Verwendung | Über diese Eigenschaft wird angegeben, welche Warteschlange für die Clusterauslastung verwendet werden soll. Sie definiert das Verhalten eines MQPUT-Aufrufs, wenn die Zielwarteschlange sowohl eine lokale Instanz als auch mindestens eine ferne Clusterinstanz hat. Geht der PUT-Vorgang von einem Clusterkanal aus, wird diese Eigenschaft nicht verwendet. Wählen Sie eine der folgenden Optionen aus: Wählen Sie Warteschlangenmanager aus, wenn der Wert verwendet werden soll, der von der Eigenschaft Warteschlange für CLWL-Verwendung des Warteschlangenmanagers angegeben wird, zu dem die ausgewählte Warteschlange gehört. Dies ist der Standardwert. Wählen Sie Alle aus, um die lokalen und fernen Warteschlangen zu verwenden. Um nur die lokalen Warteschlangen zu verwenden, wählen Sie Lokal aus. Weitere Informationen finden Sie unter Distributed queuing and clusters in der IBM -Dokumentation. |
CLWLUSEQ |
Seite 'Auslösefunktion'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Auslösefunktion des Dialogs Warteschlangeneigenschaften festlegen können. Wenn Sie die Warteschlange für die Auslösefunktion konfigurieren möchten, müssen Sie die Eigenschaften auf der Seite Auslösefunktion bearbeiten.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Auslösesteuerung | Wählen Sie zur Aktivierung der Auslösefunktion für die Warteschlange Ein aus und konfigurieren Sie anschließend für die Warteschlange die übrigen Eigenschaften der Auslösefunktion; wenn Sie die Auslösefunktion für die Warteschlange inaktivieren möchten, wählen Sie Aus aus. | TRIGGER |
Auslösertyp | Wenn ein Ereignis ausgelöst werden soll, sobald die aktuelle Warteschlangenlänge von 0 auf 1 springt, wählen Sie Erste aus. Wenn ein Ereignis ausgelöst werden soll, sobald der Schwellenwert für die Warteschlangenlänge überschritten wird, wählen Sie Länge aus. Wenn bei jeder Einreihung einer Nachricht in die Warteschlange ein Ereignis ausgelöst werden soll, wählen Sie Alle aus. | TRIGTYPE |
Auslösertiefe | Geben Sie die Anzahl der Nachrichten ein, die in die Warteschlange eingereiht werden müssen, damit ein Ereignis ausgelöst wird. | TRIGDEPTH |
Priorität der Auslösenachricht | Geben Sie die Mindestpriorität (von 1 bis 9) ein, die eine Nachricht haben muss, damit sie für ein Auslöseereignis berücksichtigt wird. Der Warteschlangenmanager ignoriert Nachrichten mit einer niedrigeren Priorität, wenn er festlegt, ob eine Auslösenachricht erstellt werden soll. Wenn alle Nachrichten für ein Auslöseereignis berücksichtigt werden sollen, geben Sie 0 ein. | TRIGMPRI |
Daten des Auslösers | Geben Sie unformatierte Daten ein, die in die Auslösenachricht eingefügt werden sollen, wenn das Auslöseereignis durch diese Warteschlange verursacht wird. Die Daten haben für den Warteschlangenmanager keine Bedeutung. Sie sind für einen Monitor für Auslösenachrichten bestimmt, der die Initialisierungswarteschlange verarbeitet, oder für die Anwendung, die von dem Auslösemonitor gestartet wird. | TRIGDATA |
Initialisierungswarteschlange | Geben Sie den Namen der Initialisierungswarteschlange ein. Wenn die Kriterien für eine Auslösenachricht erfüllt sind, reiht der Warteschlangenmanager eine Auslösenachricht in die Initialisierungswarteschlange ein. | INITQ |
Prozessname | Der lokale Name des IBM MQ -Prozesses. Dieser Parameter wird nur für lokale Warteschlangen und Modellwarteschlangen unterstützt. Dies ist der Name eines Prozesses, der die beim Auftreten einer Ereignisbedingung vom Warteschlangenmanager gestartete Anwendung angibt. Dieser Prozess muss nicht unbedingt bei der Definition der lokalen Warteschlange definiert werden, er ist jedoch Voraussetzung für das Auslösen von Ereignisbedingungen. Bei Übertragungswarteschlangen enthält die Prozessdefinition den Namen des Kanals, der gestartet werden soll. Dieser Parameter ist optional; wenn Sie keinen Prozessnamen angeben, wird der Kanalname dem für den Parameter TRIGDATA angegebenen Wert entnommen. |
PROCESS |
Seite 'Ereignisse'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Ereignisse des Dialogs Warteschlangeneigenschaften festlegen können. Wenn Sie den Warteschlangenmanager so konfigurieren möchten, dass als Reaktion auf bestimmte Kriterien in der Warteschlange Ereignisse generiert werden, bearbeiten Sie die Eigenschaften auf der Seite Ereignisse.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Ereignis 'Maximale WS-Länge' | Wählen Sie Aktiviert aus, wenn ein Ereignis des Typs 'Warteschlange voll' generiert werden soll, sobald eine Nachricht bei ihrer Einreihung in die Warteschlange zurückgewiesen wird, weil die Warteschlange bereits voll ist. | QDPMAXEV |
Ereignis 'Warteschlangenlänge hoch' | Wenn ein Ereignis vom Typ 'Queue Depth High' (Warteschlangenlänge hoch) generiert werden soll, wenn eine Nachricht in die Warteschlange eingereiht wird und dadurch die Länge der Warteschlange größer-gleich dem Wert der Eigenschaft Queue depth high limit ist, wählen Sie Aktiviert aus. |
QDPHIEV |
Grenzwert für 'Warteschlangenlänge hoch' | Gibt die maximale Warteschlangenlänge in Prozent an, die als Obergrenze für die Warteschlangenlänge dienen soll. Geben Sie den Grenzwert für die maximale Warteschlangenlänge in Prozent ein, mit dem der Warteschlangenmanager die aktuelle Warteschlangenlänge vergleicht, um zu ermitteln, ob er ein Ereignis des Typs 'Warteschlangenlänge hoch' generiert. | QDEPTHHI |
Ereignisse 'Warteschlangenlänge niedrig' | Wenn ein Ereignis vom Typ 'Queue Depth Low' (Warteschlangenlänge niedrig) generiert werden soll, wenn eine Nachricht aus der Warteschlange abgerufen wird und dadurch die Länge der Warteschlange kleiner-gleich dem Wert der Eigenschaft Queue depth low limit ist, wählen Sie Aktiviert aus. |
QDPLOEV |
Grenzwert für 'Warteschlangenlänge niedrig' | Gibt die maximale Warteschlangenlänge in Prozent an, die als Untergrenze für die Warteschlangenlänge dienen soll. Geben Sie den Grenzwert für die minimale Warteschlangenlänge in Prozent ein, mit dem der Warteschlangenmanager die aktuelle Warteschlangenlänge vergleicht, um zu ermitteln, ob er ein Ereignis des Typs 'Warteschlangenlänge niedrig' generiert. | QDEPTHLO |
Ereignis 'Intervall für Warteschlangenwartung' | Wenn ein Ereignis vom Typ 'Queue Service Interval High' (Warteschlangenserviceintervall hoch' generiert werden soll, enn eine Prüfung darauf hinweist, dass mindestens über den durch die Eigenschaft Queue service interval angegebenen Zeitraum keine Nachrichten aus der Warteschlange abgerufen wurden, wählen Sie Hochaus. Wenn ein Ereignis vom Typ 'Queue Service Interval OK' (Warteschlangenserviceintervall OK) generiert werden soll, wenn eine Prüfung darauf hinweist, dass Nachrichten innerhalb des durch die Eigenschaft Queue service interval angegebenen Zeitraums abgerufen wurden, wählen Sie OK aus. Wenn jegliche Ereignisse hinsichtlich des Warteschlangenserviceintervalls inaktiviert werden sollen, wählen Sie Keine aus. |
QSVCIEV |
Intervall für Warteschlangenwartung | Geben Sie das Serviceintervall in Millisekunden ein; hier wird ein Wert zwischen 0 und 999.999.999 angegeben. Der Warteschlangenmanager ermittelt mithilfe dieses Werts, ob Ereignisse des Typs 'Warteschlangen-Serviceintervall hoch' oder 'Serviceintervall OK' generiert werden sollen. | QSVCINT |
Seite 'Speicher'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Speicher des Dialogs Warteschlangeneigenschaften festlegen können. Um zu konfigurieren, wie IBM MQ mit zurückgesetzten Nachrichten umgeht, bearbeiten Sie die Eigenschaften auf der Seite Speicher .
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Warteschlange zum Wiedereinreihen zurückgesetzter Nachrichten | Geben Sie den Namen der Warteschlange ein, an die eine Nachricht übertragen wird, wenn sie häufiger als durch die Eigenschaft Backout threshold angegeben zurückgesetzt wird. |
BOQNAME |
Rücksetzschwellenwert | Geben Sie an, wie oft die Nachricht zurückgesetzt werden kann, bevor sie an die in der Eigenschaft Backout requeue queue angegebene Rücksetzwarteschlange übertragen wird. |
BOTHRESH |
Anzahl der Versuche vor Zurückstellung aufzeichnen | Um sicherzustellen, dass die Anzahl der Zurückstellungen (wie oft die Nachricht vom MQGET-Aufruf abgerufen und anschließend zurückgesetzt wurde) bei einem Neustart des Warteschlangenmanagers genau festgehalten wird, wählen Sie Aufzeichnen aus. Da sich die Aufzeichnung der Anzahl negativ auf die Leistung auswirkt, sollten Sie die Option Aufzeichnen nur auswählen, wenn die Anzahl unbedingt genau festgehalten werden muss. Wählen Sie andernfalls Nicht aufzeichnen aus. | HARDENBO |
NPM-Klasse | Diese Eigenschaft gibt die Umstände an, unter denen nicht permanente Nachrichten in der Warteschlange gelöscht werden. Wenn Sie angeben möchten, dass nicht permanente Nachrichten bei einem Neustart des Warteschlangenmanagers gelöscht werden sollen, wählen Sie Normal aus; dies gilt nur für nicht gemeinsam genutzte Warteschlangen. Wenn Sie angeben möchten, dass der Warteschlangenmanager versuchen soll, nicht permanente Nachrichten für die Lebensdauer der Warteschlange zu behalten, wählen Sie Hoch aus; dies ist sowohl für nicht gemeinsam genutzte als auch für gemeinsam genutzte Warteschlangen zulässig; die nicht permanenten Nachrichten können im Fall einer Störung jedoch nach wie vor verloren gehen. | NPMCLASS |
Name der Speicherklasse | Dies ist der Name der Speicherklasse, die die Warteschlange einer Seitengruppe zuordnet. Die Nachrichten der Warteschlange werden in dieser Seitengruppe gespeichert. Sie können diese Eigenschaft ändern; die Warteschlange muss jedoch zuerst leer und geschlossen sein. Der Name der Speicherklasse muss in Großbuchstaben eingegeben werden. | STGKLASSE |
Strukturname der Coupling-Facility | (Nur gemeinsam genutztez/OS -Warteschlange) Der Name der Coupling-Facility-Struktur, in der die Nachrichten der Warteschlange gespeichert werden. Sie können diese Eigenschaft ändern; die Warteschlange muss jedoch zuerst leer und geschlossen sein. | CFSTRUCT |
![]() |
Die maximale Größe, die die Datei der Warteschlange annehmen kann (in Megabyte). Wenn die Warteschlangendatei diesen Grenzwert erreicht, können erst neue Nachrichten in die Warteschlange eingereiht werden, wenn einige Nachrichten entfernt wurden. | MAXFSIZE |
Seite 'Statistik'
In der folgenden Tabelle werden die Eigenschaften auf der Seite Statistik des Dialogs Warteschlangeneigenschaften aufgelistet. Auf der Seite Statistik werden Informationen zum Verlauf der Warteschlange angezeigt. Nicht alle Eigenschaften können bearbeitet werden.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Erstellungsdatum | Schreibgeschützt. Dieses Attribut zeigt das Datum an, an dem die Warteschlange erstellt wurde. | CRDATE |
Erstellungszeit | Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Warteschlange erstellt wurde. | CRTIME |
Anzahl der Öffnungen zur Eingabe | Schreibgeschützt. Die Anzahl der Anwendungen, die derzeit mit der Warteschlange verbunden sind, um Nachrichten aus dieser abzurufen. | IPPROCS |
Anzahl der Öffnungen zur Ausgabe | Schreibgeschützt. Die Anzahl der Anwendungen, die derzeit mit der Warteschlange verbunden sind, um Nachrichten in diese einzureihen. | OPPROCS |
Aktuelle Warteschlangenlänge | Schreibgeschützt. Gibt die Anzahl der Nachrichten an, die sich derzeit in der Warteschlange befinden. | CURDEPTH |
Änderungsdatum | Schreibgeschützt. Dieses Attribut zeigt das Datum an, an dem die Eigenschaften der Warteschlange zuletzt geändert wurden. | ALTDATE |
Änderungszeit | Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Eigenschaften der Warteschlange zuletzt geändert wurden. | ALTTIME |
Warteschlangenüberwachung | Sie können IBM MQ so konfigurieren, dass Onlineüberwachungsdaten zur aktuellen Leistung der Warteschlange erfasst werden. Um den Wert der Eigenschaft Queue
monitoring des Warteschlangenmanagers ein anderer Wert als None festgelegt ist, gilt Folgendes:
Weitere Informationen finden Sie unter Überwachung und Leistung in der Dokumentation zuIBM. |
MONQ |
Warteschlangenstatistik | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Aktivität der Warteschlange erfasst werden. Um den Wert der Eigenschaft Queue
statistics des Warteschlangenmanagers zu übernehmen (siehe Eigenschaften des Warteschlangenmanagers), wählen Sie Warteschlangenmanageraus. Wenn für die Eigenschaft Queue statistics des Warteschlangenmanagers der Wert None festgelegt ist, wird die Eigenschaft Queue statistics der Warteschlange ignoriert. Wenn für die Eigenschaft Queue statistics des Warteschlangenmanagers nicht der Wert None festgelegt ist, gilt Folgendes: Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt werden sollen und die Datenerfassung für diese Warteschlange verhindert werden soll, wählen Sie Aus aus. Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt und Daten erfasst werden sollen, wählen Sie Ein aus. Weitere Informationen finden Sie unter Überwachung und Leistung in der Dokumentation zuIBM. |
STATQ |
Berechnung der Warteschlange | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Aktivität von Verbindungen für diese Warteschlange erfasst werden. Um den Wert der Eigenschaft Queue accounting des Warteschlangenmanagers zu übernehmen (siehe Eigenschaften des Warteschlangenmanagers), wählen Sie Warteschlangenmanageraus. Wenn für die Eigenschaft Queue accounting des Warteschlangenmanagers der Wert None festgelegt ist, wird die Eigenschaft Queue accounting der Warteschlange ignoriert. Wenn für die Eigenschaft Queue accounting des Warteschlangenmanagers nicht der Wert None festgelegt ist, gilt Folgendes: Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt werden sollen und die Datenerfassung für diese Warteschlange verhindert werden soll, wählen Sie Aus aus. Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt und Daten erfasst werden sollen, wählen Sie Ein aus. Weitere Informationen finden Sie unter Überwachung und Leistung in der Dokumentation zuIBM. |
ACCTQ |