IBM MQ Warteschlangeneigenschaften

Welche Eigenschaften für eine Warteschlange festgelegt werden können, ist abhängig vom Warteschlangentyp. Unterschiedliche Typen von IBM® MQ -Warteschlangen haben verschiedene Eigenschaften. Einige der Eigenschaften gelten nicht für alle Arten von Warteschlangen; einige Eigenschaften sind spezifisch für Cluster-Warteschlangen; einige Eigenschaften sind spezifisch 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 IBM Documentation.

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
[z/OS]QSG-Verfügung (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 Strings in Eigenschaftsdialogen. 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. NUTZUNG
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 Multiplattformen einen Wert zwischen 0 und der maximalen Nachrichtenlänge für den Warteschlangenmanager an. Siehe die Eigenschaft Maximum message length in Warteschlangenmanager-Eigenschaften. Auf z/OS geben Sie einen Wert von 0 - 100 MB an. 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 autorisierten Anwendung erstellt wurde, die eine Befehlsnachricht an die Service-Warteschlange sendet; Permanent dynamic bedeutet, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf mit dem Namen einer im Objektdeskriptor (MQOD) angegebenen Modell-Warteschlange tätigt, und dass die Warteschlange permanent ist; Temporary dynamic bedeutet, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf getätigt hat, aber die Warteschlange ist temporär; Shared dynamic (nur z/OS) bedeutet ebenfalls, dass die Warteschlange von einer Anwendung erstellt wurde, die einen MQOPEN-Aufruf getätigt hat, aber die Warteschlange ist permanent und hat die Queue-Sharing-Group-Disposition von Shared.
Bei Modell-Warteschlangen ist diese Eigenschaft editierbar.
  • Um festzulegen, dass aus dieser Modell-Warteschlange eine permanente dynamische Warteschlange erstellt wird, wählen Sie Permanent dynamisch (bei z/OS hat die dynamische Warteschlange eine Disposition von Queue manager).
  • Um festzulegen, dass eine temporäre dynamische Warteschlange erstellt wird, wählen Sie Temporär dynamisch (bei z/OS hat die dynamische Warteschlange eine Disposition von Queue manager).
  • [z/OS]Wählen Sie auf z/OS die Option Gemeinsame dynamische Warteschlange, um anzugeben, dass eine permanente dynamische Warteschlange mit einer Disposition von Shared erstellt wird.
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)

Definiert, was mit Eigenschaften von Nachrichten geschieht, die mit dem Befehl MQGET 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: Bei einer Übertragungswarteschlange, bei der Usage auf Übertragunggesetzt ist, ist die Eigenschaft Property Control der Warteschlange irrelevant und die Eigenschaft Property Control im entsprechenden Kanalobjekt, die das Verhalten der Nachrichteneigenschaft steuert.
PROPCTL
[IBM i]Benutzerdefiniert Der Parameter Custom wird ausschließlich zur Nutzung durch IBM bereitgestellt und ist für die Konfiguration neuer Funktionen reserviert, bevor eigene Eigenschaften für diese eingeführt worden 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
Namen von Clusterkanälen Definieren Sie den Parameter Cluster channel names in einer Clusterübertragungswarteschlange, um die Standardzuordnung von Clustersenderkanälen zu Clusterübertragungswarteschlangen außer Kraft zu setzen. 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 (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 Eigenschaft des Warteschlangenmanagers lautet Default cluster transmission queue. Bei Bedarf erstellt der Warteschlangenmanager automatisch separate Warteschlangen. Der Warteschlangenmanager legt den Parameter Cluster channel name nicht fest.

Legen Sie für den Parameter Cluster channel names den Namen eines einzelnen Clustersenderkanals oder einen generischen Namen fest. Bei Angabe eines generischen Namens werden dieser Übertragungswarteschlange mehrere Clustersenderkanäle zugeordnet. Ein generischer Name enthält Platzhalterzeichen - * - an beliebigen Positionen im Namen. Nur Clustersenderkanäle, die mit diesem Namen übereinstimmen, können Nachrichten aus dieser Übertragungswarteschlange übertragen.

[z/OS]Auf z/OS, wenn dieser Parameter gesetzt ist, muss die Warteschlange gemeinsam nutzbar sein, durch die Korrelations-ID indiziert sein und darf keine dynamische oder gemeinsam genutzte Warteschlange sein.

CLCHNAME
[MQ 9.4.0 Juni 2024]Ablauf der Kappe Die in Zehntelsekunden ausgedrückte maximale Zeit, bis eine Nachricht, die unter Verwendung einer Objektkennung mit diesem Objekt in den Auflösungspfad eingereiht wurde, für die Ablaufverarbeitung infrage kommt.
Weitere Informationen zur Verarbeitung des Ablaufs von Nachrichten finden Sie unter CAPEXPRY: Begrenzung der Ablaufzeit von Nachrichten in IBM Documentation.
Ganze Zahl
Der Wert muss im Bereich zwischen 1 und 999 999 999 liegen.
NOLIMIT
Für die Ablaufzeit von Nachrichten, die unter Verwendung dieses Objekts eingereiht werden, besteht keine Begrenzung. Dies ist der Standardwert.

Beachten Sie, dass Nachrichten, die bereits vor einer Änderung in CAPEXPRY in der Warteschlange enthalten waren, nicht von der Änderung betroffen sind (deren Ablaufzeit bleibt also unverändert). Nur für Nachrichten, die nach der Änderung von CAPEXPRY in die Warteschlange eingereiht werden, gilt die neue Ablaufzeit.

CAPEXPRY

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 Verteilte Warteschlangen und Cluster in IBM Documentation. 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 Warteschlangen und Cluster in IBM Documentation. 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, um den Wert zu verwenden, der durch die Eigenschaft CLWL use queue desjenigen Warteschlangenmanagers angegeben ist, 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 Verteilte Warteschlangen und Cluster in IBM Documentation.

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. Durch Bearbeiten der Eigenschaften auf der Seite Speicher können Sie konfigurieren, wie IBM MQ Nachrichten handhabt, die zurückgesetzt wurden.

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
[z/OS]Name der Struktur der Kopplungseinrichtung (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
[UNIX, Linux, Windows, IBM i]Maximale Größe der Warteschlangen-Datei 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 für die Erfassung von Onlineüberwachungsdaten zur aktuellen Leistung der Warteschlange konfigurieren. Um den Wert der Eigenschaft Queue monitoring des Warteschlangenmanagers zu erben (siehe Warteschlangenmanager-Eigenschaften), wählen Sie Warteschlangenmanager. Wenn für die Eigenschaft Queue monitoring des Warteschlangenmanagers der Wert None festgelegt ist, wird die Eigenschaft Queue monitoring der Warteschlange ignoriert.

Wenn für die Eigenschaft Queue monitoring des Warteschlangenmanagers ein anderer Wert als None festgelegt ist, gilt Folgendes:
  • 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 IBM Documentation.

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 erben (siehe Warteschlangenmanager-Eigenschaften), wählen Sie Warteschlangenmanager. 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 IBM Documentation. 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 Queue accounting Eigenschaft des Warteschlangenmanagers zu erben (siehe Warteschlangenmanager-Eigenschaften), wählen Sie Warteschlangenmanager. 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 IBM Documentation. ACCTQ