Eigenschaften von Themen

Ein IBM® MQ-Thema ist ein IBM MQ-Objekt, das Auskunft über den Inhalt einer Veröffentlichung gibt. Sie können die Eigenschaften für Themen festlegen. Einige Themeneigenschaften beziehen sich speziell auf z/OS-Themen. Einige dieser Eigenschaften können jedoch nur bei der Erstellung eines neuen Themas festgelegt werden. Eine Änderung nach der Erstellung des IBM MQ-Themas ist dann nicht mehr möglich.

In der folgenden Tabelle sind alle Eigenschaften für IBM MQ-Themen aufgelistet.

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 TOPIC genannt. Weitere Informationen zu MQSC-Befehlen finden Sie unter Verwaltung mithilfe von MQSC-Befehlen in der IBM Knowledge Center.

Allgemein

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Allgemein des IBM MQ-Dialogs Themeneigenschaften zu finden sind.
Eigenschaft Bedeutung MQSC-Parameter
Themenname Dieser Wert kann nicht mehr geändert werden, nachdem das Thema erstellt wurde. Dieser Parameter ist erforderlich und darf keine leere Zeichenfolge enthalten.

Die eindeutige Kennung der zu erstellenden administrativen Themendefinition. Zulässig sind bis zu 48 Zeichen.

Der Themenname darf nicht gleich lauten wie eine der auf dem ausgewählten WS-Manager definierten Themendefinitionen.

TOPNAME
Thementyp Dieser Wert ist schreibgeschützt. Der Wert definiert, ob es sich um ein lokales Thema (Lokal) oder um ein Clusterthema (Cluster) handelt. Nicht zutreffend
Themenzeichenfolge Dieser Wert kann nicht mehr geändert werden, nachdem das Thema erstellt wurde. Dieser Parameter ist erforderlich und darf keine leere Zeichenfolge enthalten.

Der Schrägstrich (/) in dieser Zeichenfolge hat eine spezielle Bedeutung. Er trennt die Elemente in der Themenstruktur voneinander. Eine Themenzeichenfolge kann, muss aber nicht mit einem Schrägstrich (/) beginnen. Eine Zeichenfolge, die mit einem Schrägstrich beginnt, ist nicht dasselbe wie die gleiche Zeichenfolge, die nicht mit einem Schrägstrich beginnt.

Die Themenzeichenfolge darf nicht gleich lauten wie eine Themenzeichenfolge, die bereits durch eine andere Themenobjektdefinition dargestellt wird. Die maximale Länge einer Themenzeichenfolge umfasst 10 240 Zeichen.

TOPICSTR
Beschreibung Dieser Wert besteht aus einer Zeichenfolge, die vom Administrator eingegeben wird. Er enthält beschreibende Informationen zum Thema. Nur anzeigbare Zeichen dürfen darin enthalten sein. Zulässig sind maximal 64 Zeichen.

Werden Zeichen verwendet, die nicht Bestandteil der ID des codierten Zeichensatzes (CCSID) für den ausgewählten WS-Manager sind, werden diese, wenn die Informationen an einen anderen WS-Manager gesendet werden, möglicherweise nicht ordnungsgemäß umgesetzt.

DESC
Veröffentlichen Über diese Eigenschaft wird gesteuert, ob Nachrichten zu dem Thema veröffentlicht werden können. Der Standardwert lautet Als übergeordnetes Objekt. Darüber hinaus stehen zwei weitere Optionen zur Verfügung:

Zulässig bedeutet, Nachrichten zu dem Thema können von einer berechtigten Anwendung veröffentlicht werden.

Unterdrückt bedeutet, Nachrichten können nicht zu dem Thema veröffentlicht werden.

PUB
Subskribieren Über diese Eigenschaft wird gesteuert, ob Nachrichten das Thema subskribieren können. Der Standardwert lautet Als übergeordnetes Objekt. Darüber hinaus stehen zwei weitere Optionen zur Verfügung:

Zulässig bedeutet, das Thema kann von einer berechtigten Anwendung subskribiert werden.

Unterdrückt bedeutet, Anwendungen können das Thema nicht subskribieren.

SUB
Permanente Subskriptionen Über diese Eigenschaft wird gesteuert, ob permanente Subskriptionen des Themas möglich sind. Der Standardwert lautet Als übergeordnetes Objekt. Darüber hinaus stehen zwei weitere Optionen zur Verfügung:

Zulässig bedeutet, permanente Subskriptionen des Themas durch eine Anwendung sind möglich.

Unterdrückt bedeutet, permanente Subskriptionen des Themas durch eine Anwendung sind nicht möglich.

DURSUB
Standardpriorität Die Standardpriorität von Nachrichten, die zum Thema veröffentlicht wurden. Der Standardwert lautet Als übergeordnetes Objekt.

Die Standardpriorität kann auf einen Wert von 0 (niedrigste Priorität) bis 9 (höchste Priorität) gesetzt werden.

DEFPRTY
Standardpermanenz Ein neues Thema hat jeweils die Standardpermanenz Als übergeordnetes Objekt. 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, die von Anwendungen erstellt werden, die MQPER_PERSISTENCE_AS_Q_DEF verwenden, nicht permanent sein sollen. DEFPSIST
Permanente Modellwarteschlange

Dieser Wert besteht aus einer Zeichenfolge, die vom Administrator eingegeben wird. Sie enthält den Namen der Modellwarteschlange, die für permanente Subskriptionen verwendet wird, über die angefordert wird, dass der Warteschlangenmanager das Ziel seiner Veröffentlichungen verwaltet.

Der Name kann aus maximal 48 Zeichen bestehen.

Ist dieses Feld leer, wird dafür die Option Als übergeordnetes Objekt verwendet.

Wenn Sie eine Modellwarteschlange für ein Clusterthema angeben, müssen Sie sicherstellen, dass die Warteschlange auf jedem Warteschlangenmanager des Clusters definiert ist, auf dem eine permanente Subskription für dieses Thema eingerichtet werden kann.

Eine auf Basis dieses Modells erstellte dynamische Warteschlange erhält das Präfix SYSTEM.MANAGED.DURABLE.

MDURMDL
Temporäre Modellwarteschlange Dieser Wert besteht aus einer Zeichenfolge, die vom Administrator eingegeben wird. Sie enthält den Namen der Modellwarteschlange, die für nicht permanente Subskriptionen verwendet wird, über die angefordert wird, dass der Warteschlangenmanager das Ziel seiner Veröffentlichungen verwaltet.

Der Name kann aus maximal 48 Zeichen bestehen.

Ist dieses Feld leer, wird dafür die Option Als übergeordnetes Objekt verwendet.

Wenn Sie eine Modellwarteschlange für ein Clusterthema angeben, müssen Sie sicherstellen, dass die Warteschlange auf jedem Warteschlangenmanager des Clusters definiert ist, auf dem eine nicht permanente Subskription für dieses Thema eingerichtet werden kann.

Eine auf Basis dieses Modells erstellte dynamische Warteschlange erhält das Präfix SYSTEM.MANAGED.NDURABLE.

MNDURMDL
QSG-Disposition Die Disposition der Gruppe mit gemeinsamer Warteschlange des Themas. Sie können die Disposition der Gruppe mit gemeinsamer Warteschlange auf einen der drei folgenden Werte setzen:
  • Warteschlangenmanager bedeutet, dass die Objektdefinition nur für den Warteschlangenmanager verfügbar ist, 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 die Objektdefinition die Kopie einer Definition im gemeinsamen Repository für den Warteschlangenmanager ist.
Werden die Eigenschaften eines Themas angezeigt, so ist dieses Feld schreibgeschützt.
QSGDISP
Standardantworttyp beim Einreihen Der Standardantworttyp beim Einreihen von Nachrichten. Der Standardwert lautet Als übergeordnetes Objekt. Darüber hinaus stehen zwei weitere Optionen zur Verfügung:

Synchron bedeutet, die Antwort wird synchron eingereiht.

Asynchron bedeutet, die Antwort wird asynchron eingereiht.

DEFPRESP
Nicht permanente Nachrichtenübermittlung

Die Zustellungsmethode für die zu diesem Thema veröffentlichten nicht permanenten Nachrichten. Folgende vier Optionen stehen zur Verfügung:

Als übergeordnetes Objekt Der verwendete Zustellungsmechanismus wird in Abhängigkeit von der Einstellung des ersten übergeordneten Verwaltungsknotens gewählt, der sich in der diesem Thema zugehörigen Themenstruktur befindet. Dies ist die Standardstellung für IBM MQ, die jedoch unter Umständen bei Ihrer Installation geändert wurde.

An alle verfügbaren Subskribenten Nicht permanente Nachrichten werden allen Subskribenten zugestellt, die die Nachricht annehmen können. Fehler bei der Zustellung an Subskribenten verhindern nicht, dass andere Subskribenten die Nachricht erhalten.

An alle dauerhaften Subskribenten Nicht permanente Nachrichten müssen allen permanenten Subskribenten zugestellt werden. Nichtzustellung einer nicht persistenten Nachricht an nicht permanenten Subskribenten erzeugt keinen Fehler beim MQPUT-Aufruf. Tritt bei der Zustellung an einen permanenten Subskribenten ein Fehler auf, erhält auch keiner der anderen Subskribenten die Nachricht und der MQPUT-Aufruf schlägt fehl.

An alle Subskribenten Nicht permanente Nachrichten müssen, unabhängig von der Dauerhaftigkeit in Bezug auf den MQPUT-Aufruf, allen Subskribenten zugestellt werden, um als erfolgreich zu gelten. Tritt bei der Zustellung an irgendeinen der Subskribenten ein Fehler auf, erhält auch keiner der anderen Subskribenten die Nachricht und der MQPUT-Aufruf schlägt fehl.

NPMSGDLV
Permanente Nachrichtenübermittlung

Die Zustellungsmethode für die zu diesem Thema veröffentlichten permanenten Nachrichten. Folgende vier Optionen stehen zur Verfügung:

Als übergeordnetes Objekt Der verwendete Zustellungsmechanismus wird in Abhängigkeit von der Einstellung des ersten übergeordneten Verwaltungsknotens gewählt, der sich in der diesem Thema zugehörigen Themenstruktur befindet. Dies ist die Standardstellung für IBM MQ, die jedoch unter Umständen bei Ihrer Installation geändert wurde.

An alle verfügbaren Subskribenten Permanente Nachrichten werden allen Subskribenten zugestellt, die die Nachricht annehmen können. Fehler bei der Zustellung an Subskribenten verhindern nicht, dass andere Subskribenten die Nachricht erhalten.

An alle dauerhaften Subskribenten Permanente Nachrichten müssen allen permanenten Subskribenten zugestellt werden. Nichtzustellung einer persistenten Nachricht an nicht permanenten Subskribenten erzeugt keinen Fehler beim MQPUT-Aufruf. Tritt bei der Zustellung an einen permanenten Subskribenten ein Fehler auf, erhält auch keiner der anderen Subskribenten die Nachricht und der MQPUT-Aufruf schlägt fehl.

An alle Subskribenten Permanente Nachrichten müssen, unabhängig von der Dauerhaftigkeit in Bezug auf den MQPUT-Aufruf, allen Subskribenten zugestellt werden, um als erfolgreich zu gelten. Tritt bei der Zustellung an irgendeinen der Subskribenten ein Fehler auf, erhält auch keiner der anderen Subskribenten die Nachricht und der MQPUT-Aufruf schlägt fehl.

PMSGDLV
Platzhalteroperation Dieser Wert steuert das Verhalten von Platzhaltersubskriptionen in Bezug auf das Thema. Folgende zwei Werte stehen hierfür zur Verfügung:

Block. Subskriptionen für ein Platzhalterthema, die weniger spezifisch sind als die Themenzeichenfolge für dieses Themenobjekt, erhalten keine Veröffentlichungen, die zu diesem Thema bzw. zu Themenzeichenfolgen bereitgestellt werden, die spezifischer als dieses Thema sind.

Durchgriff. Subskriptionen für ein Platzhalterthema, die weniger spezifisch sind als die Themenzeichenfolge für dieses Themenobjekt, erhalten Veröffentlichungen, die zu diesem Thema und zu Themenzeichenfolgen bereitgestellt werden, die spezifischer als dieses Thema sind. Dies ist die Standardeinstellung.

WILDCARD
Warteschlange für nicht zustellbare Nachrichten verwenden Gibt an, ob die Warteschlange für nicht zustellbare Nachrichten verwendet wird, wenn Veröffentlichungsnachrichten nicht an die korrekte Warteschlange für Teilnehmerberechtigungen zugestellt werden können. Drei Werte sind möglich:
  • Nein: Veröffentlichungsnachrichten, die nicht der korrekten Subskribentenwarteschlange zugestellt werden können, werden als nicht übermittelbare Nachrichten behandelt, und der MQPUT-Befehl der Anwendung für das Thema schlägt gemäß der Einstellung von Nicht permanente Nachrichtenübermittlung und Permanente Nachrichtenübermittlung fehl.
  • Ja bedeutet, dass, falls die Eigenschaft Warteschlange für nicht zustellbare Nachrichten des Warteschlangenmanagers den Namen einer Warteschlange für nicht zustellbare Nachrichten angibt, diese Warteschlange verwendet wird. Ansonsten entspricht das Verhalten dem Verhalten für Nein.
  • Als übergeordnetes Objekt gibt an, dass die Verwendung von der Einstellung des am nächsten gelegenen Objekts für Themenverwaltung abhängt. Dies ist die Standardeinstellung für IBM MQ, die jedoch unter Umständen bei Ihrer Installation geändert wurde.
USEDLQ
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

Verteiltes Publish/Subscribe

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Verteiltes Publish/Subscribe des IBM MQ-Dialogs Themeneigenschaften zu finden sind.
Eigenschaft Bedeutung MQSC-Parameter
Verhalten der Proxy-Subskription Proxy-Subskriptionen sind dem Warteschlangenmanagernamen zugeordnet, über den sie erstellt wurden. Veröffentlichungen werden nur an direkt angeschlossene Warteschlangenmanager weitergeleitet, wenn eine Proxy-Subskription vorhanden ist, die das Veröffentlichungsthema enthält. Folgende zwei Optionen stehen für diesen Wert zur Verfügung:

Erzwingen. Diese Option erzwingt das Senden einer mit einem Platzhalter versehenen Proxy-Subskription für die diesem Themenobjekt zugeordnete Themenzeichenfolge von jedem Warteschlangenmanager des Clusters an jeden anderen Warteschlangenmanager der Publish/Subscribe-Topologie, unabhängig davon, ob lokale Subskriptionen vorgenommen wurden. Sobald diese erzwungene Proxy-Subskription innerhalb der gesamten Topologie weitergegeben wurde, empfangen alle neuen Subskriptionen unverzüglich, ohne jegliche Latenzzeit, Veröffentlichungen von den anderen angeschlossenen Warteschlangenmanagern, obwohl alle Veröffentlichungen unabhängig davon, ob die jeweilige Veröffentlichung angefordert wurde, an alle anderen Warteschlangenmanager des Clusters weitergeleitet werden.

Durch Einrichtung dieses Werts auf einer angegebenen Ebene wird zudem verhindert, dass für einzelne Themenzeichenfolgen auf nachfolgenden Ebenen in der Themenstruktur Proxy-Subskriptionen generiert werden, wodurch sich die Belastung durch Proxy-Subskriptionen insgesamt verringert.

Erste Verwendung. Für jede eindeutige Topic-Zeichenfolge an oder unter diesem Topic-Objekt wird eine Proxy-Subskription asynchron an alle benachbarten Warteschlangenmanager in den folgenden Szenarien gesendet:
  • Eine lokale Subskription wurde erstellt.
  • Eine Proxy-Subskription wurde empfangen, die an direkt verbundene Warteschlangenmanager weitergegeben werden muss.
PROXYSUB
Veröffentlichungsumfang
Der Veröffentlichungsumfang lässt sich über das Themenattribut PUBSCOPE administrativ steuern. Das Attribut kann auf einen der folgenden drei Werte gesetzt werden:
  • Als übergeordnetes Objekt. Dies ist der Standardwert. Der Veröffentlichungsumfang wird auf denselben Wert wie der übergeordnete Warteschlangenmanager gesetzt.
  • Warteschlangenmanager. Die Veröffentlichung wird ausschließlich lokalen Subskribenten zugestellt.
  • Alle. Die Veröffentlichung wird lokalen und fernen Subskribenten zugestellt. Die Zustellung erfolgt über direkt angeschlossene Warteschlangenmanager.
PUBSCOPE
Subskriptionsumfang
Der Subskriptionsumfang lässt sich über das Themenattribut SUBSCOPE administrativ steuern. Das Attribut kann auf einen der folgenden drei Werte gesetzt werden:
  • Als übergeordnetes Objekt. Dies ist der Standardwert. Der Subskriptionsumfang wird auf denselben Wert wie der übergeordnete Warteschlangenmanager gesetzt.
  • Warteschlangenmanager. Die Subskription empfängt nur lokale Veröffentlichungen. Proxy-Subskriptionen werden nicht an ferne Warteschlangenmanager weitergeleitet.
  • Alle. Proxy-Subskriptionen werden an ferne Warteschlangenmanager weitergeleitet, und der Subskribent enpfängt sowohl lokale als auch ferne Veröffentlichungen.
SUBSCOPE
Multicasting Diese Eigenschaft steuert, ob das Thema als mit Multicasting übertragbar betrachtet wird oder nicht. Es gibt vier gültige Werte:

Als übergeordnetes Objekt. Die Multicasting-Eigenschaft des Themas wird vom übergeordneten Thema übernommen.

Inaktiviert. Auf diesem Knoten ist kein Multicasting-Datenverkehr zulässig.

Aktiviert. Auf diesem Knoten ist Multicasting-Datenverkehr zulässig.

Nur. Nur Subskriptionen von einem Multicasting-fähigen Client sind zulässig.

MCAST
Kommunikationsinformationen Der Name des Kommunikationsinformationsobjekts. Da sich in der Baumstruktur mehrere Themen befinden, die dieselben Multicasting-Übertragungseigenschaften erfordern, ist zu empfehlen, diese Eigenschaften in einem separaten Objekt zu platzieren, auf das verwiesen werden kann. COMMINFO

Cluster

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Cluster des IBM MQ-Dialogs Themeneigenschaften zu finden sind.
Eigenschaft Bedeutung MQSC-Parameter
Clustername Mit dieser Eigenschaft machen Sie aus einem Thema ein Clusterthema. Bei dieser Einstellung wird jedes Thema, das von einem Publisher oder Subskribent an dieser Stelle oder in der Themenstruktur verwendet wird, von allen Warteschlangenmanagern im Cluster gemeinsam genutzt, und Nachrichten, die auf einem Clusterzweig der Themenstruktur veröffentlicht werden, werden automatisch an Subskriptionen auf anderen Warteschlangenmanagern des Clusters weitergeleitet. CLUSTER
Clusterobjektstatus
Der aktuelle Status dieses Themenobjekts in diesem Cluster. Folgende Werte sind möglich:
ACTIVE (Aktiv)
Das Clusterthema ist ordnungsgemäß konfiguriert und auf diesem Warteschlangenmanager aktiv.
PENDING (Anstehend)
Dieser Status wird nur auf einem Host-Warteschlangenmanager angezeigt. Er wird gemeldet, wenn das Thema erstellt, aber noch nicht vom vollständigen Repository an das Cluster weitergeleitet wurde. Möglicherweise ist der Host-Warteschlangenmanager mit keinem vollständigen Repository verbunden oder das vollständige Repository hat das Thema für ungültig gehalten.
INVALID (Ungültig)
Diese Clusterthemendefinition steht in Konflikt mit früheren Definitionen im Cluster und ist daher zur Zeit nicht aktiv.
ERROR (Fehler)
In Verbindung mit diesem Themenobjekt ist ein Fehler aufgetreten.
Dieser Parameter wird normalerweise zur Diagnose verwendet, wenn sich mehrere Definitionen desselben Clusterthemas auf verschiedenen Warteschlangenmanagern befinden, diese Definitionen aber nicht identisch sind.
CLSTATE
Clusterroute
Das Routing-Verhalten für die Themen des im Parameter CLUSTER definierten Clusters. Zwei Werte sind möglich:
DIRECT
Wenn Sie auf einem Warteschlangenmanager ein direkt weitergeleitetes Clusterthema konfigurieren, werden sich alle Warteschlangenmanager des Clusters über alle anderen Clusterwarteschlangenmanager bewusst. Bei Publish/Subscribe-Vorgängen stellt jeder Warteschlangenmanager dann eine direkte Verbindung zu allen anderen Warteschlangenmanagern her.
TOPICHOST
Bei Verwendung der Routing-Option "TOPICHOST" werden sich alle Warteschlangenmanager des Clusters über diejenigen Clusterwarteschlangenmanager bewusst, auf denen die weitergeleiteten Themendefinitionen bereitgestellt werden. Bei der Durchführung von Veröffentlichungs- und Subskriptionsoperationen stellen Warteschlangenmanager im Cluster nur mit den TOPICHOST-Warteschlangenmanagern eine Verbindung her, nicht direkt miteinander. Die Themenhost-Warteschlangenmanager sind dann für die Weiterleitung der Veröffentlichungen von den Warteschlangenmanagern, auf denen die Veröffentlichung stattgefunden hat, zu den Warteschlangenmanagern mit entsprechenden Subskriptionen verantwortlich.
CLROUTE

Statistik

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die auf der Seite Statistik des IBM MQ-Dialogs Themeneigenschaften zu finden sind.
Eigenschaft Bedeutung MQSC-Parameter
Änderungsdatum Dieser Wert kann nicht geändert werden, er dient lediglich zu Informationszwecken.

Dieses Attribut zeigt das Datum an, an dem die Themeneigenschaften zuletzt geändert wurden.

ALTDATE
Änderungszeit Dieser Wert kann nicht geändert werden, er dient lediglich zu Informationszwecken.

Dieses Attribut zeigt die Uhrzeit an, zu der die Themeneigenschaften zuletzt geändert wurden.

ALTTIME