Eigenschaften für IBM MQ-Warteschlangen
Welche Eigenschaften für eine Warteschlange festgelegt werden können, ist abhängig vom Warteschlangentyp. Die verschiedenen Warteschlangentypen in IBM® MQ verfügen über jeweils verschiedene Eigenschaften. Einige Eigenschaften gelten nicht für alle Warteschlangentypen, einige Eigenschaften gelten nur für Clusterwarteschlangen, andere wieder nur 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 Knowledge Center.
Seite 'Allgemein'
In der folgenden Tabelle werden die Eigenschaften genannt, die Sie auf der Seite Allgemein im Dialog mit den Warteschlangeneigenschaften festlegen können.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Name der Warteschlange | 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. Warteschlangenmanager bedeutet, dass die Objektdefinition nur dem Warteschlangenmanager zur Verfügung steht, der sie enthält; Gruppe bedeutet, dass die Objektdefinition im gemeinsamen Repository gespeichert wird und dass jeder Warteschlangenmanager in der Gruppe mit gemeinsamer Warteschlange über eine Kopie der Definition verfügt; Kopie bedeutet, dass es sich bei der Objektdefinition um die Kopie einer Definition im gemeinsamen Repository handelt, die dem Warteschlangenmanager gehört. Gemeinsam genutzt bedeutet, dass die Objektdefinition die Definitionskopie des Warteschlangenmanagers im gemeinsamen Repository ist. |
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 |
Syntax | 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. | USAGE |
Basistyp | Wählen Sie den Objekttyp aus (Warteschlange oder Thema), in den die Aliaswarteschlange aufgelöst wird. Der Standardwert ist Warteschlange. | 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 genannt, die Sie auf der Seite Erweitert im Dialog mit den 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. Auf allen Plattformen mit Ausnahme von z/OS wird hier ein Wert zwischen 0 und der maximalen Nachrichtenlänge für den Warteschlangenmanager angegeben. Weitere Informationen finden Sie in der Beschreibung der Eigenschaft Max. Nachrichtenlänge im Abschnitt Eigenschaften des Warteschlangenmanagers. Unter z/OS wird ein Wert zwischen 0 und 100 MB angegeben. |
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. |
|
Definitionsart | Für lokale Warteschlangen ist diese Eigenschaft schreibgeschützt; Vordefiniert gibt an, dass die Warteschlangen von einem Operator oder einer entsprechend berechtigten Anwendung durch Senden einer Befehlsnachricht an die Servicewarteschlange erstellt wurde; Permanent dynamisch gibt an, dass die Warteschlange von einer Anwendung durch Ausgabe eines MQOPEN-Aufrufs unter Angabe einer Modellwarteschlange im Objektdeskriptor (MQOD) erstellt wurde und permanent ist; Temporär dynamisch gibt an, dass die Warteschlange von einer Anwendung durch Ausgabe eines MQOPEN-Aufrufs erstellt wurde, aber temporär ist; Dynamisch gemeinsam genutzt (nur unter z/OS) gibt ebenfalls an, dass die Warteschlange von einer Anwendung durch Ausgabe eines MQOPEN-Aufrufs erstellt wurde; die Warteschlange ist aber permanent und die Disposition der Gruppe mit gemeinsamer Warteschlange ist für sie auf Gemeinsam genutzt gesetzt.Für Modellwarteschlangen kann diese Eigenschaft geändert werden. Wählen Sie Permanent dynamisch aus, um anzugeben, dass eine permanente dynamische Warteschlange auf Basis dieser Modellwarteschlange erstellt wurde (unter z/OS ist die Disposition der dynamischen Warteschlange auf |
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 die Warteschlange so konfiguriert werden soll, dass nicht permanente 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) |
Definiert, wie Eigenschaften von Nachrichten gehandhabt werden, die bei
angegebener Option MQGMO_PROPERTIES_AS_Q_DEF über den Befehl MQGET
aus Warteschlangen abgerufen werden. 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 Nachrichtendeskriptor (oder in der Erweiterung) - dabei in einen oder mehrere MQRFH2-Header in den Nachrichtendaten 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: Wenn die Nachricht eine Eigenschaft mit dem Präfix mcd., jms., usr. oder mqext. enthält, werden der Anwendung alle Nachrichteneigenschaften in einem MQRFH2-Header zugestellt. 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 Nachrichtenbehandlung 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. Anmerkung: Für eine Übertragungswarteschlange, bei der es sich um eine lokale Warteschlange handelt, für die der Parameter Verwendung auf Übertragung gesetzt ist, spielt die Warteschlangeneigenschaft Eigenschaftensteuerung keine Rolle; das Verhalten der Nachrichteneigenschaften wird über die Eigenschaft Eigenschaftensteuerung des entsprechenden Kanalobjekts gesteuert.
|
PROPCTL |
Benutzerdefiniert | Der Parameter Benutzerdefiniert wird
ausschließlich für die Nutzung durch IBM bereitgestellt
und ist für die Konfiguration neuer Funktionen reserviert, bevor eigene Eigenschaften eingeführt
sind. 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. |
CUSTOM |
Cluster channel names (Clusterkanalnamen) | 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 einzigen 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/OS gesetzt wird, muss die Warteschlange gemeinsam nutzbar und nach Korrelations-ID indiziert sein, darf aber keine dynamische oder gemeinsam genutzte Warteschlange sein. |
CLCHNAME |
Seite 'Cluster'
In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Cluster im Dialog mit den 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 Verteilte Steuerung von Warteschlangen und Cluster in der IBM Knowledge Center. | 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 Verteilte Steuerung von Warteschlangen und Cluster in der IBM Knowledge Center. | 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 die Standardeinstellung. 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 Verteilte Steuerung von Warteschlangen und Cluster in der IBM Knowledge Center. |
CLWLUSEQ |
Seite 'Auslösefunktion'
In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Auslösefunktion im Dialog mit den 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öserart | 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öserlängenschwelle | 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 aufgeführt, die Sie auf der Seite Ereignisse im Dialog mit den 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 Warteschlangenlä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' | Wählen Sie Aktiviert aus, wenn ein Ereignis des Typs 'Warteschlangenlänge hoch' generiert werden soll, sobald eine Nachricht in die Warteschlange eingereiht wird und die Warteschlangenlänge dadurch den Wert der Eigenschaft Grenzwert für 'Warteschlangenlänge hoch' erreicht bzw. überschreitet. |
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 |
Ereignis 'Warteschlangenlänge niedrig' | Wählen Sie Aktiviert aus, wenn ein Ereignis des Typs 'Warteschlangenlänge niedrig' generiert werden soll, sobald eine Nachricht aus der Warteschlange abgerufen wird und die Warteschlangenlänge dadurch den Wert der Eigenschaft Grenzwert für 'Warteschlangenlänge niedrig' erreicht bzw. unterschreitet. |
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 'Serviceintervall für Warteschlangen' | Wenn ein Ereignis des Typs 'Warteschlangen-Serviceintervall hoch' generiert werden soll, sobald eine Prüfung ergibt, dass in mindestens dem Zeitraum, der über die Eigenschaft Serviceintervall für Warteschlangen angegeben ist, keine Nachrichten aus der Warteschlange abgerufen wurden, wählen Sie Hoch aus. Wenn ein Ereignis des Typs 'Warteschlangen-Serviceintervall OK' generiert werden soll, sobald eine Prüfung ergibt, dass in dem Zeitraum, der über die Eigenschaft Serviceintervall für Warteschlangen angegeben ist, Nachrichten aus der Warteschlange abgerufen wurden, wählen Sie OK aus. Wenn die Ereignisse des Typs 'Warteschlangen-Serviceintervall' inaktiviert werden sollen, wählen Sie Keine aus. |
QSVCIEV |
Serviceintervall für Warteschlangen | 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 aufgeführt, die Sie auf der Seite Speicher im Dialog mit den Warteschlangeneigenschaften festlegen können. Über die Eigenschaften auf der Seite Speicher können Sie angeben, wie IBM MQ mit zurückgesetzten Nachrichten verfahren werden soll.
Eigenschaft | Beschreibung | MQSC-Parameter |
---|---|---|
Name für Zurückstellungswarteschlange | Geben Sie den Namen der Warteschlange ein, in die eine Nachricht übertragen wird, falls sie häufiger zurückgesetzt wird, als in der Eigenschaft Zurückstellungsschwelle angegeben wurde. |
BOQNAME |
Zurückstellungsschwelle | Geben Sie an, wie häufig die Nachricht zurückgesetzt werden kann, bevor sie an die Zurückstellungswarteschlange übertragen wird, die Sie in der Eigenschaft Name für Zurückstellungswarteschlange angegeben haben. |
BOTHRESH |
Anzahl 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. | STGCLASS |
Name der Coupling-Facility-Struktur | (Nur bei gemeinsam genutzter Warteschlange unter z/OS) 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 im Dialog mit den Warteschlangeneigenschaften aufgeführt. 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 |
Wert für Eingabe öffnen | Schreibgeschützt. Die Anzahl der Anwendungen, die derzeit mit der Warteschlange verbunden sind, um Nachrichten aus dieser abzurufen. | IPPROCS |
Wert für Ausgabe öffnen | 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 | IBM MQ kann so konfiguriert werden, dass Onlineüberwachungsdaten zur aktuellen Warteschlangenleistung erfasst werden. Wenn Sie den Wert der Warteschlangenmanagereigenschaft Warteschlangenüberwachung des Warteschlangenmanagers auf Keine gesetzt ist:
Weitere Informationen finden Sie unter Überwachung und Leistung in der IBM Knowledge Center. |
MONQ |
Warteschlangenstatistik | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Warteschlangenaktivität erfasst werden. Wenn Sie den Wert der Warteschlangenmanagereigenschaft Warteschlangenstatistik übernehmen möchten (siehe Eigenschaften des WS-Managers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für die Eigenschaft Warteschlangenstatistik auf Keine gesetzt ist, wird die Eigenschaft Warteschlangenstatistik der Warteschlange ignoriert. Wenn die Eigenschaft Warteschlangenstatistik des Warteschlangenmanagers nicht auf Keine gesetzt ist, gilt Folgendes: Wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und eine Datenerfassung verhindern möchten, wählen Sie Aus aus; wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und Daten erfassen möchten, wählen Sie Ein aus.
Weitere Informationen finden Sie unter Überwachung
und Leistung in der IBM Knowledge Center.
|
STATQ |
Berechnung der Warteschlange | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Verbindungsaktivität für diese Warteschlange erfasst werden. Wenn Sie den Wert der Warteschlangenmanagereigenschaft Berechnung auf Warteschlangenebene übernehmen möchten (siehe Eigenschaften des WS-Managers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für die Eigenschaft Berechnung auf Warteschlangenebene auf Keine gesetzt ist, wird das Attribut Berechnung auf Warteschlangenebene der Warteschlange ignoriert. Wenn die Eigenschaft Berechnung auf Warteschlangenebene des Warteschlangenmanagers nicht auf Keine gesetzt ist, gilt Folgendes: Wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und eine Datenerfassung verhindern möchten, wählen Sie Aus aus; wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und Daten erfassen möchten, wählen Sie Ein aus.
Weitere Informationen finden Sie unter Überwachung
und Leistung in der IBM Knowledge Center.
|
ACCTQ |