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 |
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 |
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:
|
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:
|
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:
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:
|
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:
|
PUBSCOPE |
Subskriptionsumfang |
Der Subskriptionsumfang lässt sich über das Themenattribut SUBSCOPE administrativ steuern. Das Attribut kann auf einen der folgenden drei Werte gesetzt werden:
|
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:
|
CLSTATE |
Clusterroute |
Das Routing-Verhalten für die Themen des im Parameter CLUSTER definierten Clusters. Zwei Werte sind möglich:
|
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 |