Eigenschaften für IBM MQ-Subskriptionen

Sie können die Eigenschaften für sämtliche Subskriptionstypen festlegen. Einige Eigenschaften gelten nicht für alle Subskriptionstypen, und einige Eigenschaften beziehen sich speziell auf z/OS-Subskriptionen.

In den folgenden Tabellen werden alle Eigenschaften aufgeführt, die 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 SUB genannt. Weitere Informationen zu MQSC-Befehlen finden Sie unter Verwaltung mithilfe von MQSC-Befehlen in der IBM® Knowledge Center.

Seite 'Allgemein'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Allgemein im Dialog mit den Subskriptionseigenschaften festlegen können.

Eigenschaft Bedeutung MQSC-Parameter
Name der Subskription Schreibgeschützt. Der Name der Subskription kann nach deren Erstellung nicht geändert werden. SUBNAME
Themenname Der Name des von der Subskription verwendeten Themenobjekts. Der Themenname stellt ein optionales Themenstammverzeichnis bereit. Zulässig sind bis zu 48 Zeichen. TOPICOBJ
Themenzeichenfolge Gibt einen vollständig qualifizierten Themennamen oder ein Platzhalterthema an, der bzw. das für die Subskription festgelegt ist.

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 dem Zeichen (/) beginnen. Eine Zeichenfolge, die mit dem Zeichen (/) beginnt, ist nicht dasselbe wie eine Zeichenfolge, die nicht mit diesem Zeichen beginnt.

TOPICSTR
Verwendung von Platzhaltern Das Schema wird beim Interpretieren von in der Themenzeichenfolge enthaltenen Platzhalterzeichen verwendet. Folgende zwei Werte stehen hierfür zur Verfügung:

TOPIC: Platzhalterzeichen stellen Teile der Themenhierarchie dar.

CHAR: Platzhalterzeichen stellen Teile von Zeichenfolgen dar.

WSCHEMA
Bereich Der Bereich legt fest, ob diese Subskription an andere Warteschlangenmanager weitergeleitet wird, so dass der Subskribent auch Nachrichten erhält, die bei diesen Warteschlangenmanagern veröffentlicht wurden. Folgende zwei Werte stehen hierfür zur Verfügung:
ALL
Die Subskription wird an alle direkt angeschlossenen Warteschlangenmanager über einen Publish/Subscribe-Brokerverbund bzw. eine Publish/Subscribe-Hierarchie weitergeleitet.
QMGR
Die Subskription leitet zu dem Thema veröffentlichte Nachrichten nur innerhalb dieses Warteschlangenmanagers weiter.
Anmerkung: Einzelsubskribenten können SUBSCOPE nur beschränken. Wenn der Parameter auf Themenebene auf ALL gesetzt ist, kann ein Einzelsubskribent ihn für diese Subskription auf QMGR beschränken. Ist der Parameter allerdings bereits auf Themenebene auf QMGR gesetzt, hat die Einstellung eines Einzelsubskribenten auf ALL keine Auswirkung.
SUBSCOPE
Zielklasse Die Zielklasse gibt an, ob es sich bei dem von der Subskription verwendeten Ziel um ein verwaltetes Ziel handelt. Folgende zwei Werte stehen hierfür zur Verfügung:

MANAGED: Das Ziel wird verwaltet.

PROVIDED: Das Ziel ist eine Warteschlange. Dies ist der Standardwert.

DESTCLAS
Ziel-Warteschlangenmanager Der Zielwarteschlangenmanager für Nachrichten, die für die Subskription veröffentlicht werden. DESTQMGR
Name des Ziels Gibt den Namen der Alias- oder Clusterwarteschlange bzw. der lokalen oder fernen Warteschlange an, in die Nachrichten für diese Subskription eingereiht werden. DEST
Korrelations-ID Der Wert von Korrelations-ID wird in den Nachrichtendeskriptor aller an die Subskription gesendeten Nachrichten gestellt. Wenn der Parameter Korrelations-ID nicht angegeben wird, werden die Nachrichten in eine Zieladresse mit der Korrelations-ID MQCI_NONE gestellt.

Bei einem Leerwert (Standard) wird eine vom System generierte Korrelations-ID verwendet.

Bei 48 Nullen (000000000000000000000000000000000000000000000000) wird in der Nachrichtenkopie, die an die Subskription übermittelt wird, die in der veröffentlichenden Anwendung festgelegte CorrelId verwendet, sofern die Nachrichtenweiterleitung nicht über eine Publish/Subscribe-Hierarchie erfolgt.

DESTCORL
Anmerkung: Die Eigenschaft 'DESTCORL' kann nicht programmgesteuert mit JMS festgelegt werden.
Permanent Eine permanente Subskription wird nicht gelöscht, wenn die erstellende Anwendung ihre Subskriptionskennung schließt. Für den Parameter Permanent der Subskription kann der Wert Ja oder Nein festgelegt werden. Ist Permanent auf Ja gesetzt, werden die Subskriptionen nicht gelöscht, wenn die erstellende Anwendung ihre Subskriptionskennung schließt. DURABLE
Typ Der Typ einer Subskription gibt an, wie die Subskription erstellt wurde. Es gibt folgende Subskriptionstypen:

API: Die Subskription wurde über die Anforderung MQSUB API erstellt.

ADMIN: Die Subskription wurde über den Befehl DEF SUB MQSC oder einen PCF-Befehl erstellt. Darüber hinaus kann mit ADMIN angegeben werden, dass eine Subskription über einen Verwaltungsbefehl geändert wurde.

PROXY: Die Subskription wurde intern für die Weiterleitung von Veröffentlichungen durch ein Warteschlangenmanagernetz erstellt.

Subskriptionen des Typs PROXY werden nicht in ADMIN geändert, wenn Änderungen versucht werden.

Der Typ kann nicht geändert werden.

SUBTYPE
Eigenschaften Eigenschaften bestimmt, auf welche Weise Publish/Subscribe-Nachrichteneigenschaften Nachrichten hinzugefügt werden, die der Subskription gesendet werden. Folgende Optionen stehen zur Verfügung:

Kompatibilität: Publish/Subscribe-Eigenschaften werden zur Nachricht hinzugefügt, um die Kompatibilität mit IBM WebSphere MQ 6.0 Publish/Subscribe zu gewährleisten.

Nachrichteneigenschaften: Publish/Subscribe-Eigenschaften werden als Nachrichteneigenschaften hinzugefügt.

Keine: Publish/Subscribe-Eigenschaften werden nicht zur Nachricht hinzugefügt.

RFH2: Publish/Subscribe-Eigenschaften werden in einem Header der RFH-Version 2 hinzugefügt.

PSPROP
Gibt die Benutzerdaten an. Der Wert von Benutzerdaten kann optional in einer an die Subskription gesendeten Nachricht als Nachrichteneigenschaft übergeben werden. USERDATA
Selektor Der Selektor ist eine auf die Nachrichten des benannten Themas angewendete SQL92-Zeichenfolge, mit der angegeben wird, ob diese für die Subskription berechtigt sind. SELECTOR
Selektortyp Der Typ der Auswahlzeichenfolge, die angegeben wurde. Diese Anzeigeeigenschaft wird berechnet und ist keinem Objekt zugeordnet. Der Auswahltyp kann (z. B. mit einer WHERE-Klausel) gefiltert werden, damit ein Administrator ausschließlich interne oder ausschließlich externe Selektoren anzeigen kann. SELTYPE

Seite 'Erweitert'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Erweitert im Dialog mit den Subskriptionseigenschaften festlegen können.

Eigenschaft Bedeutung MQSC-Parameter
Variable Benutzer-ID Gibt an, ob andere Benutzer als der Ersteller der Subskription eine Verbindung zur Subskription herstellen und das Eigentumsrecht der Subskription erlangen können. Folgende zwei Werte stehen hierfür zur Verfügung:

ANY: Andere Benutzer können eine Verbindung zur Subskription herstellen, wenn diese über die erforderlichen Themen- und Zielberechtigungsprüfungen verfügen. Dies ist die Standardeinstellung.

FIXED: Andere Benutzer können keine Verbindung zur Subskription herstellen.

VARUSER
Benutzer Gibt das Benutzerprofil an, dem diese Subskription zugeordnet ist. SUBUSER
Identitätsdaten der Anwendung Der Wert von Identitätsdaten der Anwendung wird für die der Subskription gesendeten Nachrichten verwendet. Ist Identitätsdaten der Anwendung nicht angegeben, wird ein leerer Standardwert verwendet. PUBAPPID
Berechnungs-Token Der Wert von Berechnungs-Token wird für die der Subskription gesendeten Nachrichten verwendet. Ist Berechnungs-Token nicht angegeben, wird der Standardwert MQACT_NONE verwendet. PUBACCT
Veröffentlichungspriorität Die Veröffentlichungspriorität bestimmt, auf welche Weise Publish/Subscribe-Nachrichteneigenschaften Nachrichten hinzugefügt werden, die der Subskription gesendet werden. Folgende Optionen stehen zur Verfügung:

Wie veröffentlicht, was bedeutet, dass die Priorität der Nachricht an diese Subskription gesendet wird und von der Priorität übernommen wird, die in der veröffentlichten Nachricht angegeben ist.

Wie in Warteschlange definiert, was bedeutet, dass die Priorität der Nachricht an diese Subskription gesendet wird und von der Standardpriorität der Warteschlange übernommen wird, die als Zieladresse definiert ist.

'Priority-value' (Prioritätswert). Hier können Sie eine Priorität von 0 bis 9 angeben.

PUBPRTY
Subskriptions-ID Der Wert von Subskriptions-ID wird vom Warteschlangenmanager als eine jederzeit eindeutige ID für die Subskription zugeordnet. Diese ID kann als Alternative zu einem Unternamen (SUBNAME) als Ziel für die MQSC-Befehle DISPLAY, ALTER und DELETE verwendet werden, wenn eine Bereitstellung des Unternamens aufgrund dessen Formats nicht möglich ist oder wenn für eine von einer Anwendung erstellte Subskription kein Untername bereitgestellt wurde. SUBID
Verfall Die Lebensdauer der Subskription ab Erstellungsdatum bzw. Erstellungszeit. Der Verfall wird in Zehntelsekunden gemessen. Folgende zwei Werte stehen hierfür zur Verfügung:

Uneingeschränkt Das heißt, die Subskription läuft niemals ab oder der Benutzer kann einen eigenen Wert eingeben, der in Zehntelsekunden gemessen wird. Der Standardwert ist null.

EXPIRY
Nur Anforderung 'Nur Anforderung' gibt an, ob der Subskribent Aktualisierungen über MQSUBPRQ API abfragt. Folgende zwei Werte stehen hierfür zur Verfügung:

Mit Alle werden der Subskription alle Veröffentlichungen zugestellt. Dies ist der Standardwert.

Auf Anforderung bewirkt, dass der Subskription Veröffentlichungen nur in Reaktion auf MQSUBPRQ API zugestellt werden.

REQONLY
Subskriptionsebene Dies ist die Ebene, die der Subskription zugeordnet ist. Veröffentlichungen werden nur an diese Subskription übermittelt, wenn sie sich in der Gruppe der Subskriptionen befindet, bei der der höchste Wert für 'SubLevel' kleiner-gleich dem Wert für 'PubLevel' ist, der zur Veröffentlichungszeit verwendet wurde. Der Wert muss im Bereich zwischen 0 und 9 liegen. Dabei steht 0 für die niedrigste Ebene. SUBLEVEL

Seite 'Statistik'

In der folgenden Tabelle werden die Eigenschaften auf der Seite Statistik im Dialog mit den Subskriptionseigenschaften aufgeführt. Auf der Seite Statistik werden Informationen zum Verlauf der Subskription angezeigt. Die auf der Seite Statistik angezeigten Informationen sind schreibgeschützt und damit durch den Benutzer nicht änderbar.

Eigenschaft Bedeutung MQSC-Parameter
Erstellungsdatum Schreibgeschützt. Dieses Attribut zeigt das Datum an, an dem die Subskription erstellt wurde. CRDATE
Erstellungszeit Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Subskription erstellt wurde. CRTIME
Änderungsdatum Schreibgeschützt. Dieses Attribut zeigt das Datum an, an dem die Eigenschaften der Subskription zuletzt geändert wurden. ALTDATE
Änderungszeit Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Eigenschaften der Subskription zuletzt geändert wurden. ALTTIME