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 Warteschlangenmanager) gesetzt. Wählen Sie Temporär dynamisch aus, um anzugeben, dass eine temporäre dynamische Warteschlange erstellt wurde (unter z/OS ist die Disposition der dynamischen Warteschlange auf Warteschlangenmanager gesetzt). Wählen Sie Dynamisch gemeinsam genutzt aus, um anzugeben, dass eine permanente dynamische Warteschlange mit der Disposition Gemeinsam genutzt erstellt wurde (nur unter z/OS).

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:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

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 (SYSTEM.CLUSTER.TRANSMIT.QUEUE). Diese Standardeinstellung können Sie für den Warteschlangenmanager ändern, sodass alle Clustersenderkanäle Nachrichten aus jeweils eigenen Übertragungswarteschlangen übertragen. Die betreffende Warteschlangenmanagereigenschaft ist Default cluster transmission queue (Standard-Clusterübertragungswarteschlange). Bei Bedarf erstellt der Warteschlangenmanager automatisch separate Warteschlangen. Der Parameter Cluster channel name (Clusterkanalname) wird vom Warteschlangenmanager nicht gesetzt.

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 (*) enthalten. Nur Clustersenderkanäle, die mit diesem Namen übereinstimmen, können Nachrichten aus dieser Übertragungswarteschlange übertragen.

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
[V9.2.0 Juli 2020][UNIX, Linux, Windows, IBM i]Maximale Größe der Warteschlangendatei 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 übernehmen möchten (siehe Eigenschaften des WS-Managers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für die Eigenschaft Warteschlangenüberwachung auf Keine gesetzt ist, wird die Eigenschaft Warteschlangenüberwachung der Warteschlange ignoriert.

Wenn der Wert für die Eigenschaft Warteschlangenüberwachung des Warteschlangenmanagers auf Keine gesetzt ist:
  • Wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und eine Datenerfassung für diese Warteschlange verhindern möchten, wählen Sie Aus aus.
  • Ist eine niedrige Datenerfassungsrate erwünscht, wählen Sie Niedrig aus.
  • Ist eine mittlere Datenerfassungsrate erwünscht, wählen Sie Mittel aus.
  • Ist eine hohe Datenerfassungsrate erwünscht, wählen Sie Hoch aus.

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