Eigenschaften für IBM MQ-Warteschlangen
Welche Attribute 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 Attribute gelten nicht für alle Warteschlangentypen, einige Attribute gelten nur für Clusterwarteschlangen, andere wieder nur für z/OS-Warteschlangen.
In der folgenden Tabelle werden alle Attribute aufgeführt, die für sämtliche Warteschlangentypen festgelegt werden können:
Für jedes Attribut wird kurz beschrieben, wann dessen Konfiguration erforderlich oder sinnvoll sein kann. In der Tabelle werden auch die entsprechenden MQSC-Parameter für die Befehle ALTER QUEUE und DISPLAY QUEUE genannt. Weitere Informationen zu MQSC-Befehlen finden Sie unter MQSC-Befehle in der online verfügbaren Produktdokumentation von IBM MQ.
Seite 'Allgemein'
In der folgenden Tabelle werden die Attribute genannt, die Sie auf der Seite Allgemein im Dialog mit den Warteschlangeneigenschaften festlegen können.
Attribut | 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. Das Attribut '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 Attribute genannt, die Sie auf der Seite Erweitert im Dialog mit den Warteschlangeneigenschaften festlegen können.
Attribut | 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 des Attributs Max. Nachrichtenlänge im Abschnitt Eigenschaften des Warteschlangenmanagers. Unter z/OS wird ein Wert zwischen 0 und 100 MB angegeben. Wenn für das Attribut QSG-Disposition der Wert Gemeinsam genutzt angegeben wird oder das Attribut Definitionsart den Wert Dynamisch gemeinsam genutzt hat, muss der Wert Maximale Nachrichtenlänge für die Warteschlange zwischen 0 und 4 MB liegen. Auf anderen Plattformen müssen Sie einen Wert zwischen 0 und 4 MB eingeben. | MAXMSGL |
Gemeinsame Benutzung | 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. Mit Hilfe 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 |
Pipe-Name | (Nur gemeinsam genutzte z/OS-Warteschlange) Schreibgeschützt. | |
Indextyp | (Nur gemeinsam genutzte z/OS-Warteschlange) Für die Angabe des Indextyps, mit dessen Hilfe der Warteschlangenmanager die Geschwindigkeit von MQGET-Operationen in der Warteschlange erhöht, stehen fünf Optionen zur Auswahl: 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 dieses Attribut 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 dieses Attribut 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 beim Einreihen von Nachrichten. 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 das Warteschlangenattribut Eigenschaftensteuerung keine Rolle; das Verhalten der Nachrichteneigenschaften wird über das Attribut Eigenschaftensteuerung des entsprechenden Kanalobjekts gesteuert.
|
PROPCTL |
Benutzerdefiniert | Der Parameter Benutzerdefiniert ist für die Konfiguration neuer Funktionen reserviert, bevor eigene Attribute eingeführt sind. Mögliche Werte sind eine Liste von null oder mehreren Attributwertepaaren im MQSC-Format, die durch mindestens ein Leerzeichen getrennt sind. Bei Attributnamen und -werten wird die Groß-/Kleinschreibung beachtet; die Angaben müssen in Großbuchstaben erfolgen.
Die Werte dürfen Leerzeichen und runde Klammern, jedoch keine einfachen Anführungszeichen enthalten. 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 Attribute 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. Das betreffende Warteschlangenmanagerattribut 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 ( 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 Attribute 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 Attribute auf der Seite Cluster bearbeiten.
Attribut | 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 | Dieses Attribut 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 | Dieses Attribut gibt die Warteschlangenrangfolge 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 im Abschnitt Verteilte Steuerung von Warteschlangen und Cluster in der Online-Produktdokumentation zu IBM MQ. | CLWLRANK |
CLWL-Warteschlangenpriorität | Dieses Attribut 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 im Abschnitt Verteilte Steuerung von Warteschlangen und Cluster in der Online-Produktdokumentation zu IBM MQ. | 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 dieses Attribut nicht verwendet. Wählen Sie eine der folgenden Optionen aus: Wählen Sie Warteschlangenmanager aus, wenn der Wert verwendet werden soll, der von der Eigenschaft Warteschlange für CLWL-Verwendung des Warteschlangenmanagers angegeben wird, zu dem die ausgewählte Warteschlange gehört. Dies ist der Standardwert. Wählen Sie Alle aus, um die lokalen und fernen Warteschlangen zu verwenden. Um nur die lokalen Warteschlangen zu verwenden, wählen Sie Lokal aus. Weitere Informationen finden Sie im Abschnitt Verteilte Steuerung von Warteschlangen und Cluster in der Online-Produktdokumentation zu IBM MQ. |
CLWLUSEQ |
Seite 'Auslösefunktion'
In der folgenden Tabelle werden die Attribute 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 Attribute auf der Seite Auslösefunktion bearbeiten.
Attribut | 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 Attribute 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 Attribute 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 Attribute auf der Seite Ereignisse.
Attribut | 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 des Attributs 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 des Attributs 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 das Attribut Intervall für Warteschlangenservice 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 das Attribut Intervall für Warteschlangenservice 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 Attribute aufgeführt, die Sie auf der Seite Speicher im Dialog mit den Warteschlangeneigenschaften festlegen können. Über die Attribute auf der Seite Speicher können Sie angeben, wie IBM MQ mit zurückgesetzten Nachrichten verfahren werden soll.
Attribut | 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 im Attribut 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 im Attribut 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 | Dieses Attribut 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 | (Nur bei gemeinsam genutzter Warteschlange unter z/OS) Der Name der Speicherklasse, über die die Warteschlange einer Seitengruppe zugeordnet wird. Die Nachrichten der Warteschlange werden in dieser Seitengruppe gespeichert. Sie können dieses Attribut ändern; die Warteschlange muss jedoch zuerst leer und geschlossen sein. Der Name der Speicherklasse muss in Großbuchstaben eingegeben werden. | STGCLASS |
coupling facility name (Coupling Facility-Name) | (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 dieses Attribut ändern; die Warteschlange muss jedoch zuerst leer und geschlossen sein. | CFSTRUCT |
Seite 'Statistik'
In der folgenden Tabelle werden die Attribute auf der Seite Statistik im Dialog mit den Warteschlangeneigenschaften aufgeführt. Auf der Seite Statistik werden Informationen zum Verlauf der Warteschlange angezeigt. Nicht alle Attribute können bearbeitet werden.
Attribut | 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 Attribute der Warteschlange zuletzt geändert wurden. | ALTDATE |
Änderungszeit | Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Attribute 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 des Warteschlangenmanagerattributs Warteschlangenüberwachung übernehmen möchten (siehe Eigenschaften des Warteschlangenmanagers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für das Attribut Warteschlangenüberwachung auf Keine gesetzt ist, wird das Attribut Warteschlangenüberwachung der Warteschlange ignoriert. Wenn der Wert für das Attribut Warteschlangenüberwachung des Warteschlangenmanagers auf Keine gesetzt ist:
Weitere Informationen finden Sie im Abschnitt Überwachung und Leistung in der Online-Produktdokumentation zu IBM MQ. |
MONQ |
Warteschlangenstatistik | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Warteschlangenaktivität erfasst werden. Wenn Sie den Wert des Warteschlangenmanagerattributs Warteschlangenstatistik übernehmen möchten (siehe Eigenschaften des Warteschlangenmanagers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für das Attribut Warteschlangenstatistik auf Keine gesetzt ist, wird das Attribut Warteschlangenstatistik der Warteschlange ignoriert. Wenn das Attribut 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 im Abschnitt Überwachung und Leistung in der Online-Produktdokumentation zu IBM MQ. | 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 des Warteschlangenmanagerattributs Berechnung auf Warteschlangenebene übernehmen möchten (siehe Eigenschaften des Warteschlangenmanagers), wählen Sie Warteschlangenmanager aus. Wenn der Wert für das Attribut Berechnung auf Warteschlangenebene auf Keine gesetzt ist, wird das Attribut Berechnung auf Warteschlangenebene der Warteschlange ignoriert. Wenn das Attribut 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 im Abschnitt Überwachung und Leistung in der Online-Produktdokumentation zu IBM MQ. | ACCTQ |