SUB DEFINI

MQSC-Befehle verwenden

Informationen zur Verwendung von MQSC-Befehlen finden Sie unter Lokale Verwaltungstasks mit MQSC-Befehlen ausführen.

Hinweise zur Verwendung von DEFINE SUB

• Zur Definition einer Subskription muss Folgendes angegeben werden:
  • DieSUBNAME
  • Eine Zieladresse für Nachrichten
  • Das Thema, auf das sich die Subskription bezieht
• Der Themenname kann auf die folgenden Arten angegeben werden:

  TOPICSTR

  Das Thema ist vollständig angegeben als das Attribut TOPICSTR.

  TOPICOBJ

  Das Thema wird aus dem Attribut TOPICSTR des benannten Themenobjekts abgerufen. Das benannte Themenobjekt wird als Attribut TOPICOBJ der neuen Subskription beibehalten. Diese Methode wird zur Verfügung gestellt, um dabei zu helfen, lange Themenzeichenfolgen durch eine Objektdefinition eingeben zu können.

  TOPICSTR und TOPICOBJ

  Das Thema wird durch die Verkettung des Attributs TOPICSTR des benannten Themenobjekts mit dem Wert von TOPICSTR erhalten (siehe die Spezifikation MQSUB API für Verkettungsregeln). Das benannte Themenobjekt wird als Attribut TOPICOBJ der neuen Subskription beibehalten.

• Wenn Sie TOPICOBJ angeben, muss der Parameter ein IBM MQ-Themenobjekt benennen. Das Vorhandensein des benannten Themenobjekts wird zum Zeitpunkt der Befehlsverarbeitungen überprüft.
• Die Zieladresse für Nachrichten kann explizit durch die Verwendung der Schlüsselwörter DEST und DESTQMGR angegeben werden.

  Sie müssen das Schlüsselwort DEST für die Standardoption DESTCLAS(PROVIDED) angeben; wenn Sie DESTCLAS(MANAGED) angeben, wird ein verwaltetes Ziel auf dem lokalen Warteschlangenmanager erstellt, und so können Sie entweder das Attribut DEST oder das Attribut DESTQMGR nicht angeben. Weitere Informationen finden Sie unter Verwaltete Warteschlangen und Publish/Subscribe.

• Nur unter z/OS : Wenn der Befehl DEF SUB verarbeitet wird, wird nicht überprüft, ob die benannte Datei DEST oder DESTQMGR vorhanden ist.

  Diese Namen werden zum Zeitpunkt der Publizierung als ObjectName und ObjectQMgrName für einen MQOPEN-Anruf verwendet. Diese Namen werden gemäß den IBM MQ -Namensauflösungsregeln aufgelöst.

• Wenn eine Subskription laut Definition administrativ WebSphere MQ-Scriptbefehle oder PCF-Befehle verwendet, wird der Selektor nicht auf eine ungültige Syntax geprüft. Der Befehl DEFINE SUB hat keine Entsprechung zum Ursachencode MQRC_SELECTION_NOT_AVAILABLE, der vom API-Aufruf MQSUB zurückgegeben werden kann.
• TOPICOBJ, TOPICSTR, WSCHEMA, SELECTOR, SUBSCOPEund DESTCLAS können nicht mit DEFINE REPLACEgeändert werden.
• Wenn eine Veröffentlichung beibehalten wurde, ist sie für Subskribenten höherer Ebenen nicht mehr verfügbar, da sie auf PubLevel 1 erneut veröffentlicht wird.
• Eine erfolgreiche Ausführung des Befehls bedeutet nicht, dass die Aktion beendet ist. Informationen zur Überprüfung des tatsächlichen Abschlusses finden Sie im Schritt DEFINE SUB unter Prüfen, ob asynchrone Befehle für verteilte Netze beendet wurden.

Parameterbeschreibungen für DEFINE SUB

(Zeichenfolge)

Ein verbindlicher Parameter. Gibt den eindeutigen Namen für diese Subskription an (siehe Eigenschaft SUBNAME).

CMDSCOPE

Dieser Parameter gilt nur für z/OS und gibt an, wie der Befehl ausgeführt wird, wenn der Warteschlangenmanager Mitglied einer Gruppe mit gemeinsamer Warteschlange ist.

' '

Dieser Befehl wird auf dem Warteschlangenmanager ausgeführt, auf dem er eingegeben wurde. Dies ist der Standardwert.

Warteschlangenmanager-name

Der Befehl wird auf dem angegebenen Warteschlangenmanager ausgeführt, wenn dieser innerhalb der Gruppe mit gemeinsamer Warteschlange aktiv ist.

Sie können nur dann einen anderen Warteschlangenmanager als denjenigen angeben, auf dem der Befehl eingegeben wird, wenn Sie eine Umgebung verwenden, in der Gruppen mit gemeinsamer Warteschlange unterstützt werden, und wenn der Befehlsserver aktiv ist.

*

Der Befehl wird auf dem lokalen Warteschlangenmanager ausgeführt und außerdem an jeden aktiven Warteschlangenmanager in der Gruppe mit gemeinsamer Warteschlange übergeben. Der Befehl wird dann auf den einzelnen Warteschlangenmanagern innerhalb der Gruppe mit gemeinsamer Warteschlange so ausgeführt, als wäre er dort eingegeben worden.

CMDSCOPE kann nicht als Filterschlüsselwort verwendet werden.

DEST (zeichenfolge)

Das Ziel für Nachrichten, die zu dieser Subskription veröffentlicht werden; dies ist der Name einer Warteschlange.

DESTCLAS

Systemverwaltete Zieladresse.

PROVIDED

Das Ziel ist eine Warteschlange.

Managed

Das Ziel ist verwaltet.

DESTCORL (Zeichenfolge)

Die CorrelId für Nachrichten, welche zu dieser Subskription veröffentlicht werden.

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

Bei Angabe von 000000000000000000000000000000000000000000000000 (48 Nullen) wird der Wert für CorrelId, der von der veröffentlichenden Anwendung festgelegt wurde, in der Kopie der an die Subskription gesendete Nachricht beibehalten, sofern Nachrichten nicht über eine Publish/Subscribe-Hierarchie weitergegeben werden.

Hinweis: Es ist nicht möglich, die Eigenschaft DESTCORL programmgesteuert mit JMSfestzulegen.

DESTQMGR (Zeichenfolge)

Der Zielwarteschlangenmanager für Nachrichten, die in dieser Subskription veröffentlicht werden. Sie müssen die Kanäle zum fernen Warteschlangenmanager, zum Beispiel XMITQ, und einen Senderkanal definieren. Sonst kommen die Nachrichten nicht am Ziel an.

EXPIRY

Die Zeit bis zum Ablauf des Subskriptionsobjekts von Erstellungsdatum und -uhrzeit.

(Ganze Zahl)

Die Zeit bis zum Ablauf, in Zehntelsekunden, von Erstellungsdatum und -zeit.

UNLIMITED

Keine Ablaufzeit vorhanden. Dies ist der mit dem Produkt gelieferte Standardoption.

LIKE (subskriptionsname)

Der Name einer Subskription, deren Parameter als Modell für diese Definition verwendet werden.

Dieser Parameter wird nur für den Befehl DEFINE SUB unterstützt.

Wenn dieses Feld leer ist und die Parameterfelder dieses Befehls nicht ausgefüllt werden, werden die Werte der Standarddefinition für Subskriptionen in diesem Warteschlangenmanager übernommen. Die Nichtangabe dieses Parameters ist äquivalent zur Angabe des folgenden Parameters:

LIKE (SYSTEM.DEFAULT.SUB)

PSPROP

Die Art und Weise, auf welche mit Publish/Subscribe zusammenhängende Nachrichteneigenschaften den Nachrichten, welche an diese Subskription gesendet werden, hinzugefügt werden.

Ohne

Keine Publish/Subscribe-Eigenschaften zu der Nachricht hinzufügen.

COMPAT

Publish/Subscribe-Eigenschaften werden innerhalb eines Headers der MQRFH-Version 1 hinzugefügt, sofern die Nachricht nicht im Programmable Command Format veröffentlicht wurde.

MSGPROP

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

RFH2

Publish/Subscribe-Eigenschaften werden innerhalb eines Headers der MQRFH-Version 2 hinzugefügt.

PUBACCT (zeichenfolge)

Vom Subskribenten übergebener Abrechnungstoken zur Weitergabe an Nachrichten zu dieser Subskription im Feld AccountingToken des MQMD.

PUBAPPID (zeichenfolge)

Vom Subskribenten übergebene Identität zur Weitergabe an Nachrichten, welche an diese Subskription im Feld ApplIdentityData des MQMD veröffentlicht wurden.

PUBPRTY

Die Priorität der an diese Subskription gesendeten Nachricht.

ASPUB

Die Priorität der an diese Subskription gesendeten Nachricht wird von der Priorität übernommen, die in der veröffentlichten Nachricht angegeben ist.

ASQDEF

Die Priorität der an diese Subskription gesendeten Nachricht wird von der Standardpriorität der Warteschlange übernommen, die als Zieladresse definiert ist.

(Ganzzahl)

Eine Ganzzahl, die eine explizite Priorität für Nachrichten bereitstellt, die zu dieser Subskription veröffentlicht wurden.

REPLACE und NOREPLACE

Dieser Parameter steuert, ob eine vorhandene Definition durch diese ersetzt werden soll.

REPLACE

Vorhandene Definitionen gleichen Namens werden durch diese Definition ersetzt. Ist keine Definition dieses Namens vorhanden, wird sie erstellt.

Sie können TOPICOBJ, TOPICSTR, WSCHEMA, SELECTOR, SUBSCOPEoder DESTCLAS nicht mit DEFINE REPLACEändern.

NOREPLACE

Vorhandene Definitionen gleichen Namens werden durch diese Definition nicht ersetzt.

REQONLY

Zeigt an, ob der Subskribent unter Verwendung des MQSUBRQ API-Aufrufs Aktualisierungen abfragt oder ob alle Veröffentlichungen an diese Subskription zugestellt werden.

NO

Alle Veröffentlichungen zu dem Thema werden an diese Subskription zugestellt. Dies ist der Standardwert.

YES

Veröffentlichungen an diese Subskription werden nur als Antwort auf einen MQSUBRQ API-Aufruf zugestellt.

Dieser Parameter entspricht der Subscribe-Option MQSO_PUBLICATIONS_ON_REQUEST.

SELECTOR (zeichenfolge)

Ein Selektor der auf Nachrichten angewendet wird, welche zu diesem Thema veröffentlicht wurden.

SUBLEVEL( integer )

Die Version innerhalb der Subskriptionshierarchie, zu welcher diese Subskription angelegt wurde. Der Bereich ist von Null bis 9.

SUBSCOPE

Bestimmt, ob diese Subskription an andere Warteschlangenmanager weitergeleitet wird, damit der Subskribent Nachrichten empfängt, die bei diesen anderen Warteschlangenmanagern veröffentlicht wurden.

All

Die Subskription wird an alle Warteschlangenmanager weitergeleitet, die direkt durch einen Publish/Subscribe-Brokerverbund oder eine Publish/Subscribe-Hierarchie verbunden sind.

QMGR

Die Subskription leitet Nachrichten, die zu diesem Thema veröffentlicht wurden, nur innerhalb dieses Warteschlangenmanagers weiter.

Hinweis: Einzelne Abonnenten können nur SUBSCOPEbeschränken. Wird der Parameter auf Themenebene auf ALL gesetzt, kann ihn ein Einzelsubskribent für diese Subskription auf QMGR beschränken. Wird der Parameter dagegen auf Themenebene auf QMGR gesetzt, bleibt die Angabe von ALL für einen Einzelsubskribenten ohne Auswirkung.

SUBNAME

Der dieser Kennung zugeordnete, eindeutige Subskriptionsname der Anwendung. Dieser Parameter ist nur relevant für Kennungen von Subskriptionen zu Themen. Für andere Kennungen wird er nicht zurückgegeben. Nicht alle Subskriptionen haben einen Subskriptionsnamen.

SUBUSER (zeichenfolge)

Gibt die für die Sicherheitsprüfungen verwendete Benutzer-ID an, die vorgenommen werden, um zu gewährleisten, dass die Veröffentlichungen in die der Subskription zugeordneten Zielwarteschlange eingereiht werden können. Diese ID ist entweder die Benutzer-ID, die mit dem Ersteller der Subskription verbunden ist, oder, wenn eine Subskriptionsübernahme erlaubt ist, die Benutzer-ID, die zuletzt die Subskription übernommen hat. Die Länge dieses Parameters darf 12 Zeichen nicht überschreiten.

TOPICOBJ (zeichenfolge)

Der Name eines Themenobjekts, der von dieser Subskription verwendet wird.

TOPICSTR (zeichenfolge)

Gibt eine vollständig qualifizierten Abschnittsnamen oder einen Abschnittssatz unter Verwendung von Platzhalterzeichen für die Subskription an.

USERDATA (zeichenfolge)

Gibt die Benutzerdaten an, die dieser Subskription zugeordnet sind. Die Zeichenfolge ist variabler Längenwert, der von der Anwendung durch einen MQSUB API-Aufruf abgerufen abgerufen und in einer Nachricht, die an diese Subskription als eine Nachrichteneigenschaft gesendet wird, weitergegeben werden kann. Die USERDATA-Datei wird im RFH2-Header im Ordner mqps mit dem Schlüssel Sud gespeichert.

Eine IBM MQ classes for JMS -Anwendung kann die Subskriptionsbenutzerdaten mithilfe der Konstanten JMS_IBM_SUBSCRIPTION_USER_DATAaus der Nachricht abrufen. Weitere Informationen finden Sie unter Abrufen von Benutzerabonnementdaten.

VARUSER

Gibt an, ob ein anderer Benutzer als der Ersteller der Subskription mit der Subskription Verbindung aufnehmen und Eigentumsrecht über die Subskription erhalten kann.

Beliebig

Jeder Benutzer kann mit der Subskription Verbindung aufnehmen und Eigentumsrechte über sie erhalten.

FIXED

Die Übernahme durch eine andere USERID ist nicht erlaubt.

WSCHEMA

Das Schema, das verwendet wird, wenn Platzhalterzeichen in der Themenzeichenfolge interpretiert werden.

char

Platzhalterzeichen stehen für Teile von Zeichenfolgen.

Thema

Platzhalterzeichen stehen für Teile der Themenhierarchie.