Kanaleigenschaften

Sie können die Eigenschaften für sämtliche Kanaltypen (auch Clientverbindungskanäle) festlegen. Einige Eigenschaften gelten speziell für bestimmte Kanaltypen.

In den folgenden Tabellen werden alle Eigenschaften aufgeführt, die festgelegt werden können:

Einige Eigenschaften gelten nicht für alle Kanaltypen:
  • Einige Eigenschaften gelten speziell für Clusterkanäle.
  • [z/OS]Einige Eigenschaften gelten speziell für z/OS-Kanäle.

Für jede Eigenschaft wird kurz beschrieben, wann deren Konfiguration erforderlich oder sinnvoll sein kann. In der Tabelle werden auch die entsprechenden MQSC-Parameter für die Befehle DEFINE, ALTER und DISPLAY CHANNEL 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 Kanaleigenschaften festlegen können.

Eigenschaft Bedeutung MQSC-Parameter
Kanalname Schreibgeschützt. Gibt den Namen der Kanaldefinition an. CHANNEL
Type Schreibgeschützt. Gibt die Art der Kanaldefinition an. CHLTYPE
QSG-Disposition Schreibgeschützt. Gibt die Disposition der Gruppe mit gemeinsamer Warteschlange der Kanaldefinition an. Die Disposition einer Kanaldefinition 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. QSGDISP
Beschreibung Geben Sie für den Kanal eine aussagekräftige Beschreibung des Zwecks an. Siehe Zeichenfolgen in Eigenschaftendialogen. DESCR
Name des Warteschlangenmanagers Geben Sie den Namen des Warteschlangenmanagers ein, in dem der Kanal definiert ist. Geben Sie bei Clientverbindungskanälen den Namen des Warteschlangenmanagers ein, zu dem eine Anwendung, die in der MQI-Clientumgebung ausgeführt wird, eine Verbindung anfordern kann. QMNAME
Übertragungsprotokoll Wählen Sie aus der Liste den Transporttyp aus, der vom Kanal verwendet wird. TRPTYPE
Verbindungsname Geben Sie mit Ausnahme der Clusterempfängerkanäle für alle Kanaltypen den Namen des Computers ein, auf dem sich der Ziel-Warteschlangenmanager befindet. Das Format des Verbindungsnamens hängt vom ausgewählten Übertragungsprotokoll ab. Wenn Sie beispielsweise das TCP/IP-Protokoll verwenden und wissen, dass der Ziel-Warteschlangenmanager eine Verbindung mit einer anderen als der standardmäßigen IBM MQ-Portnummer 1414 herstellt, müssen Sie Computername(Portnummer) eingeben; dabei ist Computername der Name bzw. die IP-Adresse des Computers, auf dem sich der Ziel-Warteschlangenmanager befindet, und Portnummer der Port, der vom Empfangsprogramm des Ziel-Warteschlangenmanagers verwendet wird.

[UNIX, Linux, Windows]Bei Clusterempfangskanälen unter Windows, UNIX und Linux®, die das TCP/IP-Transportprotokoll verwenden, wird für diese Eigenschaft kein Wert angegeben; IBM MQ erstellt einen Namen für die Verwendung, wobei der Standardport und die aktuelle IPv4-Adresse des Systems übernommen werden. Wenn das System über keine IPv4-Adresse verfügt, wird die aktuelle IPv6-Adresse des Systems verwendet. Geben Sie für Clusterempfängerkanäle auf anderen Plattformen sowie für Clusterempfängerkanäle, die nicht das Transportprotokoll 'TCP/IP' verwenden, den Namen des Computers ein, auf dem sich der lokale Warteschlangenmanager befindet.

CONNAME
Übertragungswarteschlange Geben Sie den Namen der Übertragungswarteschlange ein, der dem Warteschlangenmanager auf der Empfängerseite des Kanals entspricht. XMITQ
Lokale Kommunikationsadresse Wenn der Kanal TCP/IP nutzt und eine bestimmte IP-Adresse, einen bestimmten Port oder Portbereich für die ausgehende Kommunikation verwenden soll, müssen Sie die lokale Kommunikationsadresse für den Kanal eingeben. Der Kanal bindet sich lokal an die Adresse. Verwenden Sie das Format IP-Adresse(niedrige Portnummer, hohe Portnummer). Dabei steht IP-Adresse für die IP-Adresse, die in der IPv4-Schreibweise mit Trennzeichen, im IPv6-Hexadezimalformat oder im alphanumerischen Hostnamensformat angegeben ist. Beispiele: 192.0.2.0 gibt die IPv4-Adresse mit beliebigem Port an; 192.0.2.0(1000) gibt die IPv4-Adresse und einen bestimmten Port an; 192.0.2.0(1000,2000) gibt die IPv4-Adresse und einen Portbereich an; (1000) gibt nur einen Port an.

Clustersenderkanäle: Wenn Sie im Feld Lokale Kommunikationsadresse eines manuell definierten Clustersenderkanals einen Wert eingeben, wird dieser Wert durch die Werte im Clusterempfängerkanal des vollständigen Repositorys überschrieben, wenn eine Kommunikation mit dem Warteschlangenmanager des vollständigen Repositorys aufgebaut wird. Neben der Angabe des Werts im manuell definierten Clustersenderkanal müssen Sie einen Exit für automatische Kanaldefinition schreiben, damit der Wert der Eigenschaft Lokale Kommunikationsadresse in allen automatisch definierten Clustersenderkanälen umgesetzt wird.

LOCLADDR
 

Clusterempfängerkanäle: Geben Sie im Feld Lokale Kommunikationsadresse eines Clusterempfängerkanals nur dann eine IP-Adresse ein, wenn sich alle Warteschlangenmanager auf demselben Computer befinden. Der Grund hierfür ist, dass bei jedem Versuch eines Warteschlangenmanagers, sich mit einer IP-Adresse im Feld Lokale Kommunikationsadresse seines Clusterempfängerkanals zu verbinden, diese Werte an die zugehörigen automatisch definierten Clustersenderkanäle weitergegeben werden. Sie können im Feld Lokale Kommunikationsadresse eines Clusterempfängerkanals jedoch eine Portnummer oder einen Portbereich angeben, wenn Sie möchten, dass alle Warteschlangenmanager in einem Cluster für alle abgehenden Übertragungen einen bestimmten Port oder Portbereich verwenden sollen.

 
Gesamtkanalstatus Schreibgeschützt. Dieses Attribut gibt den Status des Kanals an. STATUS

Seite 'Erweitert'

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

Eigenschaft Bedeutung MQSC-Parameter
Maximale Nachrichtenlänge Geben Sie die maximale Länge einer Nachricht ein, die auf dem Kanal übertragen werden kann:
  • Auf den folgenden Plattformen muss der Wert größer-gleich null und kleiner-gleich der maximalen Nachrichtenlänge des Warteschlangenmanagers sein:
    • [AIX]AIX
    • [IBM i]IBM i:
    • [Windows]Windows
    • VSE/ESA
  • Auf anderen Plattformen müssen Sie einen Wert größer-gleich null und kleiner-gleich 4.194.304 Byte angeben.
  • [z/OS]Unter IBM MQ for z/OS muss der Wert größer-gleich null und kleiner-gleich 104.857.600 Bytes sein.
MAXMSGL
Intervall des Überwachungssignals Geben Sie die Länge des Intervalls der Überwachungssignale ein. Zulässige Werte liegen zwischen 0 und 999.999. Null gibt an, dass kein Überwachungssignalaustausch stattfindet. Dieser Wert sollte unter dem Wert der Eigenschaft Unterbrechungsintervall liegen. Der hier angegebene Wert muss größer als der auf der Sender- und Empfängerseite definierte Wert sein. Das Intervall der Überwachungssignale ist die in Sekunden angegebene Zeitspanne zwischen dem Austausch von Überwachungssignalen, die von dem sendenden Nachrichtenkanalagenten ausgegeben werden, wenn die Übertragungswarteschlange keine Nachrichten enthält. Der Austausch der Überwachungssignale gibt dem empfangenden Nachrichtenkanalagenten die Möglichkeit, den Kanal in den Ruhezustand zu versetzen. HBINT
Maximale Instanzen

Dieser Parameter wird auf Serververbindungskanälen und AMQP-Kanälen verwendet. Maximale Instanzen gibt die maximale Anzahl gleichzeitiger Instanzen an, die jeweils für einen Serververbindungskanal oder einem AMQP-Kanal zulässig ist.

Der Wert kann eine Zahl im Bereich von 0 bis 999.999.999 sein. Der Standardwert ist 999.999.999.

Der Wert null gibt an, dass Clientzugriff generell nicht zugelassen wird.

Wenn Maximale Instanzen auf einen Wert gesetzt ist, der kleiner als die Anzahl der derzeit aktiven Instanzen des Serververbindungskanals ist, können neue Instanzen erst wieder gestartet werden, wenn eine genügende Anzahl der vorhandenen Instanzen gestoppt wurde.

Wenn ein Client mit einer ID, für die bereits eine Verbindung besteht, eine Verbindung auf einem AMQP-Kanal herstellt (also eine Clientübernahme durchführt), ist die Übernahme unabhängig davon erfolgreich, ob die Anzahl verbundener Clients den Wert von MAXINST erreicht hat.

MAXINST
Maximale Instanzen pro Client

Dieser Parameter wird auf Serververbindungskanälen verwendet. Maximale Instanzen pro Client gibt die maximale Anzahl gleichzeitiger Instanzen an, die jeweils für einen Serververbindungskanal über einen bestimmten Client gestartet werden kann. In diesem Zusammenhang werden Verbindungen, die von derselben Remotenetzwerkadresse stammen, als von demselben Client kommend betrachtet.

Der Wert kann eine Zahl von 0 bis 999.999.999 sein. Der Standardwert ist 999.999.999.

Der Wert null gibt an, dass Clientzugriff generell nicht zugelassen wird.

Maximale Instanzen unterscheidet sich von Maximale Instanzen pro Client insofern, dass Maximale Instanzen die maximale Anzahl Verbindungen insgesamt bestimmt, während Maximale Instanzen pro Client die maximale Anzahl Verbindungen angibt, die jeweils jeder Client zum Server herstellen kann.

MAXINSTC
Keepalive-Intervall Geben Sie die Länge des Keepalive-Intervalls ein. Zulässige Werte liegen zwischen 0 und 99.999. Diese Eigenschaft wird ignoriert, wenn der Kanal einen anderen Transporttyp als TCP oder SPX verwendet. Die Eigenschaft TCP - Keepalive auf der Seite 'Kanäle' der Eigenschaften des Warteschlangenmanagers muss auf Ja gesetzt sein.

[z/OS]Bei z/OS-Warteschlangenmanagern gibt die Eigenschaft Keepalive-Intervall das Keepalive-Intervall für den Kanal an.

[UNIX, Linux, Windows, IBM i]Auf Warteschlangenmanagern auf Multiplatforms wird die Eigenschaft Keepalive-Intervall nur verwendet, wenn der Kanal eine Verbindung zu einem z/OS-Warteschlangenmanager herstellt. Soll in diesem Fall die Funktionalität der Eigenschaft Keepalive-Intervall verwendet werden, müssen Sie die Eigenschaft auf Auto setzen, damit ein Wert auf Basis des verhandelten Heartbeatintervalls verwendet wird.

KAINT
Folgenummernumbruch Die Folgenummer ist die Anzahl der Nachrichten, die über den Kanal gesendet werden. Die Folgenummer wird jedes Mal schrittweise erhöht, wenn eine Nachricht über den Kanal gesendet wird.

[z/OS]Geben Sie bei Verwendung von z/OS mit CICS die höchste Zahl im Bereich 1 bis 999999999 ein, die erreicht werden kann, bevor die Nachrichtenfolgenummer erneut bei 1 beginnt.

Geben Sie bei allen anderen Plattformen die höchste Zahl im Bereich 100 bis 999999999 ein, die erreicht werden kann, bevor die Nachrichtenfolgenummer erneut bei 1 beginnt.

Dieser Wert muss so hoch sein, dass dieselbe Nummer nicht erneut ausgegeben wird, während sie noch von einer früheren Nachricht verwendet wird. Den beiden Kanalenden muss derselbe Wert für den Folgenummernumbruch zugeordnet sein, wenn der Kanal gestartet wird; andernfalls tritt ein Fehler auf.

SEQWRAP
Geschwindigkeit nicht permanenter Nachrichten

Wenn Sie angeben möchten, dass nicht permanente Nachrichten in einem Kanal nicht innerhalb einer Transaktion übertragen werden sollen, wählen Sie Schnell aus. Dadurch stehen nicht permanente Nachrichten weitaus schneller für die Abfrage zur Verfügung, als wenn sie Bestandteil einer Transaktion wären. Der Nachteil ist, dass nicht permanente Nachrichten beispielsweise während der Übertragung beim Stoppen des Kanals verloren gehen können, da sie nicht zu einer Transaktion gehören. Um dies zu vermeiden, müssen Sie Normal auswählen. NPMSPEED
Stapelgröße Geben Sie die maximale Anzahl an Nachrichten an, die gesendet werden müssen, damit ein Synchronisationspunkt erreicht wird. Die Nachrichten werden immer einzeln übertragen, aber die Festschreibung und Zurückstellung erfolgt im Stapelbetrieb. Es wird empfohlen, die Standardstapelgröße 50 zu übernehmen und den Wert nur zu ändern, falls erforderlich. BATCHSZ
Nachrichtenkomprimierung Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung der Nachrichtenkomprimierung aufzurufen. Wählen Sie je nach Belieben die Komprimierungstechniken für Nachrichten an, die von der Kanaldefinition unterstützt werden. Das erste Verfahren, das von der anderen Kanalseite unterstützt wird, wird verwendet. Keine bedeutet, dass keine Nachrichtenkomprimierung stattfindet; RLE bedeutet, dass die Komprimierung von Nachrichtendaten unter Verwendung der Lauflängencodierung erfolgt; ZLIBFAST bedeutet, dass die Komprimierung von Nachrichtendaten unter Verwendung der zlib-Komprimierung erfolgt, und dass eine kurze Komprimierungszeit bevorzugt wird; ZLIBHIGH bedeutet, dass die Komprimierung von Nachrichtendaten unter Verwendung der zlib-Komprimierungstechnik erfolgt und dass eine hohe Komprimierungsstufe bevorzugt wird; ANY bedeutet, dass jede beliebige Komprimierungstechnik verwendet werden kann, die vom Warteschlangenmanager unterstützt wird. Weitere Informationen finden Sie unter Verteilte Steuerung von Warteschlangen und Cluster in der IBM Knowledge Center. COMPMSG
Header-Komprimierung Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung der Headerkomprimierung aufzurufen. Wählen Sie je nach Belieben die Komprimierungstechniken für Header an, die von der Kanaldefinition unterstützt werden. Das erste Verfahren, das von der anderen Kanalseite unterstützt wird, wird verwendet. Keine bedeutet, dass keine Header-Komprimierung vorgenommen wird; System bedeutet, dass eine Header-Komprimierung erfolgt. Weitere Informationen finden Sie unter Verteilte Steuerung von Warteschlangen und Cluster in der IBM Knowledge Center. COMPHDR
Stapelintervall Geben Sie den Zeitraum in Millisekunden an (von 0 bis 999.999.999), für den der Kanal einen Stapelbetrieb geöffnet lässt, selbst wenn die Übertragungswarteschlange keine Nachrichten enthält. BATCHINT
Stapeldatengrenzwert Geben Sie den Grenzwert für das Datenvolumen, das über einen Kanal gesendet wird, bevor ein Synchronisationspunkt erreicht wird, in Kilobyte und im Bereich von 0 bis 999.999 an. Der Wert 0 bedeutet, dass kein Datengrenzwert auf Stapel, die über diesen Kanal übertragen werden, angewendet wird. BATCHLIM
Unterbrechungsintervall Geben Sie die Anzahl der Sekunden (von 0 bis 999.999) nach der Beendigung der Stapelverarbeitung an, bei deren Ablauf der Kanal geschlossen wird. Der Wert 0 bedeutet, dass die Verbindung des Kanals nicht getrennt wird. DISCINT
Datenkonvertierung Wenn Sie angeben möchten, dass die Nachricht von der empfangenden Anwendung in das Format konvertiert werden soll, das auf dem empfangenden System erforderlich ist (hierbei handelt es sich um die übliche Methode), wählen Sie Nein aus; wenn sich der ferne Warteschlangenmanager auf einer Plattform befindet, von der die Datenkonvertierung nicht unterstützt wird, wählen Sie Ja aus. Dadurch geben Sie an, dass die Nachricht vor ihrer Übertragung in das Format konvertiert wird, das auf dem empfangenden System erforderlich ist. CONVERT
Gibt die PUT-Berechtigung an. Diese Eigenschaft gibt die Art der Sicherheitsverarbeitung an, die vom Nachrichtenkanalagenten (Message Channel Agent, MCA) vorgenommen werden soll, wenn ein MQPUT-Befehl für die Zielwarteschlange oder ein MQI-Aufruf ausgeführt wird. Wenn die Standardbenutzer-ID verwendet werden soll, klicken Sie auf Standard; wenn die alternative Benutzer-ID aus den der Nachricht zugeordneten Kontextdaten verwendet werden soll, klicken Sie auf Kontext. PUTAUT
Intervall der Überwachungssignale für Stapel

Wenn am sendenden Kanal innerhalb dieses Intervalls eine Kommunikation vom empfangenden Kanal eingegangen ist, gilt der empfangende Kanal als aktiv; andernfalls wird dem empfangenden Kanal zur Überprüfung ein Überwachungssignal gesendet. Der sendende Kanal wartet die durch die Kanaleigenschaft 'Intervall der Überwachungssignale' (HBINT) angegebene Anzahl an Sekunden auf eine Antwort vom empfangenden Kanal.

Wenn der empfangende Kanal nicht aktiv ist, kann der Stapel zurückgestellt werden. Ansonsten wird den Nachrichten der unbestätigte Status zugewiesen. Durch das Zurückstellen des Stapels bleiben die Nachrichten für die Verarbeitung verfügbar, sodass sie beispielsweise an einen anderen Kanal umgeleitet werden können. Geben Sie die Anzahl an Sekunden an (von 0 bis 999.999), die die Sendeseite des Kanals auf eine Antwort von der Empfangsseite des Kanals wartet, bevor er davon ausgeht, dass die Empfangsseite des Kanals inaktiv ist.

Der Wert 0 gibt an, dass der Austausch von Überwachungssignalen für den Stapelbetrieb nicht verwendet wird. Weitere Informationen finden Sie in Kanal so konfigurieren, dass die Wahrscheinlichkeit für die Versetzung in den unbestätigten Status reduziert wird.

BATCHHB
Disposition des Standardkanals Wenn Sie den Befehl START CHANNEL ohne das Schlüsselwort für die Disposition des Kanals (CHLDISP) absetzen, wird der Kanal mit dem Wert der Disposition des Standardkanals(DEFCDISP) gestartet. Es gibt drei gültige Werte:

Privat. Dies ist der Standardwert. Der Kanal wird als privater Kanal auf dem lokalen Warteschlangenmanager gestartet.

Gemeinsam genutzt. Empfängerkanäle werden gemeinsam genutzt, wenn sie auf eine eingehende Übertragung an die Gruppe mit gemeinsamer Warteschlange hin gestartet wurden. Senderkanäle werden gemeinsam genutzt, wenn die Disposition der Übertragungswarteschlange SHARED ist.

Gemeinsam genutzte Korrektur. Ein Senderkanal wird gemeinsam genutzt, wenn seine Übertragungswarteschlange die Disposition SHARED aufweist und CONNAME nicht leer ist.
DEFCDISP
Eigenschaftensteuerung

(Nur bei Senderkanälen, Serverkanälen, Clustersenderkanälen und Clusterempfängerkanälen)

Mit diesem Attribut wird definiert, was mit Eigenschaften von Nachrichten geschieht, die gerade an einen Warteschlangenmanager der IBM WebSphere MQ 6.0 oder einer früheren Version gesendet werden sollen. Der Wert muss von Kompatibilität in Alle geändert werden, um das Verhalten von IBM WebSphere MQ 6.0 beizubehalten, dass RFH2 an das aufrufende Programm weitergegeben wird. Folgende Werte sind gültig:

Alle bedeutet, es werden alle Eigenschaften der Nachricht in die Nachricht eingeschlossen, wenn diese an den fernen Warteschlangenmanager gesendet wird. Die Eigenschaften werden in einem oder mehreren MQRFH2-Headern in den Nachrichtendaten eingeschlossen, ausgenommen der Eigenschaften im Nachrichtendeskriptor (oder Erweiterung).

Kompatibilität. Das ist der Standardwert. Er ermöglicht Anwendungen, die mit JMS zusammengehörige Eigenschaften in einem MQRFH2-Header in den Nachrichtendaten erwarten, unverändert fortzufahren.

Wenn die Nachricht eine Eigenschaft mit dem Präfix mcd., jms., usr. oder mqext. enthält, werden alle optionalen Nachrichteneigenschaften (die MQPD_SUPPORT_OPTIONAL als Unterstützungswert aufweisen), mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung), in einen oder in mehrere MQRFH2-Header der Nachrichtendaten gestellt, bevor die Nachricht an den fernen Warteschlangenmanager gesendet wird. Andernfalls werden alle Eigenschaften der Nachricht, außer denen im Nachrichtendeskriptor (oder in der Erweiterung), von der Nachricht entfernt, bevor die Nachricht an den fernen Warteschlangenmanager gesendet wird.

Wenn die Nachricht eine Eigenschaft enthält, für die das Feld 'Unterstützung' des Eigenschaftendeskriptors nicht auf MQPD_SUPPORT_OPTIONAL gesetzt ist, wird die Nachricht zurückgewiesen und gemäß ihrer Berichtsoptionen gehandhabt. Wenn die Nachricht eine oder mehrere Eigenschaften enthält, für die das Feld 'Unterstützung' des Eigenschaftendeskriptors auf MQPD_SUPPORT_OPTIONAL gesetzt ist, aber andere Felder des Eigenschaftendeskriptors auf Nichtstandardwerte gesetzt sind, dann werden diese Eigenschaften aus der Nachricht entfernt, bevor sie an den fernen Warteschlangenmanager gesendet wird.

Keine bedeutet, alle Eigenschaften der Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung), werden aus der Nachricht entfernt, bevor diese an den fernen Warteschlangenmanager gesendet wird. Wenn die Nachricht eine Eigenschaft enthält, für die das Feld 'Unterstützung' des Eigenschaftendeskriptors nicht auf MQPD_SUPPORT_OPTIONAL gesetzt ist, wird die Nachricht zurückgewiesen und gemäß ihrer Berichtsoptionen gehandhabt.

PROPCTL
Gemeinsame Nutzung von Dialogen

(Nur bei Serververbindungskanälen und Clientverbindungskanälen)

Gibt die maximale Anzahl von Datenaustauschvorgängen an, die über eine bestimmte TCP/IP-Clientkanalinstanz gemeinsam genutzt werden können. Folgende Werte sind möglich:
0: Gibt keine gemeinsame Nutzung von Datenaustauschvorgängen über eine TCP/IP-Kanalinstanz an. Die Kanalinstanz ist in einem Modus vor dem von IBM WebSphere MQ 7.0 aktiv hinsichtlich:
  • Administrator Stop-Ruhestand
  • Überwachungssignal wird gesendet
  • Vorauslesen

1: Gibt keine gemeinsame Nutzung von Datenaustauschvorgängen über eine TCP/IP-Kanalinstanz an. Clientaustausch von Überwachungssignalen und Vorauslesen sind verfügbar, unabhängig davon, ob in einem MQGET-Aufruf oder nicht, und Kanal in den Wartemodus versetzen ist weitergehend kontrollierbar.

2 - 999.999.999: Die Anzahl der gemeinsam genutzten Datenaustauschvorgänge. Der Standardwert ist 10.

Wenn der Clientverbindungswert für SHARECNV dem Serververbindungswert für SHARECNV nicht entspricht, wird der niedrigste Wert verwendet.
SHARECNV
Pending reset sequence number (Folgenummer für anstehende Zurücksetzung)

Dies ist die Folgenummer einer ausstehenden Anforderung, die angibt, dass eine Anforderung des Befehls RESET CHANNEL aussteht. Der Wert 0 gibt an, dass keine RESET CHANNEL-Anforderung aussteht. Der Wert kann im Bereich zwischen 1 und 999.999.999 liegen.

Hat RESETSEQ den Wert 0, wird vom Befehl DISPLAY CHANNEL der Wert RESETSEQ(NO) zurückgegeben.

RESETSEQ
Warteschlange für nicht zustellbare Nachrichten verwenden

(Nicht bei Clientverbindungs-, Serververbindungs- oder Telemetriekanälen)

Gibt an, ob die Warteschlange für nicht zustellbare Nachrichten verwendet wird, wenn Nachrichten von Kanälen nicht zugestellt werden können. Zwei Werte sind möglich:
  • Nein: Nachrichten, die von einem Kanal nicht zugestellt werden können, werden als fehlgeschlagene Nachrichten gehandhabt; der Fehler wird entweder entsprechend der Einstellung Geschwindigkeit nicht permanenter Nachrichten beendet oder die Nachrichten werden verworfen.
  • 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.
USEDLQ
Port

(Nur auf AMQP-Kanälen)

Gibt den Port für die AMQP-Verbindung an. Der Standardport für AMQP 1.0-Verbindungen ist 5672. Falls Port 5672 bereits verwendet wird, können Sie einen anderen Port angeben. PORT
Client-ID verwenden

(Nur auf AMQP-Kanälen)

Gibt an, dass die Client-ID für die Verbindung auf einem AMQP-Kanal verwendet wird. Ist auf Ja oder Nein gesetzt. USECLTID
AMQP-Keepalive

(Nur auf AMQP-Kanälen)

Gibt die Keepalive-Zeit in Millisekunden an. Wenn der AMQP-Client innerhalb des Keepalive-Intervalls keine Frames gesendet hat, wird die Verbindung mit der AMQP-Fehlerbedingung amqp:resource-limit-exceeded geschlossen. AMQPKA
Themenstamm

(Nur auf AMQP-Kanälen)

Gibt den Themenstamm (Topic-Root) für einen AMQP-Kanal an. Mit dieser Eigenschaft können Sie sicherstellen, dass eine MQ Light-Anwendung im Fall einer Implementierung in einem Warteschlangenmanager keine Nachrichten in den von anderen Anwendungen verwendeten Bereichen der Themenstruktur veröffentlicht bzw. dort subskribiert.

Der Standardwert für TPROOT ist SYSTEM.BASE.TOPIC. Bei diesem Standardwert hat die von einem AMQP-Client für Veröffentlichungen oder Subskriptionen verwendete Themenzeichenfolge (Topic-Zeichenfolge) kein Präfix und der Client kann Nachrichten mit anderen MQ Publish/Subscribe-Anwendungen austauschen.

TPROOT
[V9.2.0 Juli 2020][z/OS]Sicherheitsrichtlinienschutz Dies definiert das Verhalten für den Nachrichtenkanalagenten beim Abrufen von Nachrichten aus einer Übertragungswarteschlange bzw. beim Einreihen in eine Zielwarteschlange in Bezug auf die Anwendung von AMS-Schutzrichtlinien.
Dies gilt für Kanäle vom Typ Sender, Server, Empfänger und Requester. Folgende Werte sind gültig:
Durchgriff
Alle vom Nachrichtenkanalagenten für diesen Kanal gesendeten oder empfangenen Nachrichten werden durchgereicht.
Dieser Wert ist für Kanäle mit dem Kanaltyp Sender, Server, Empfänger oder Requester gültig. Er ist der Standardwert.
Entfernen
Entfernen Sie jeglichen AMS-Schutz der Nachrichten, die vom Nachrichtenkanalagenten aus der Übertragungswarteschlange abgerufen werden, und senden Sie die Nachrichten an den Partner.
Wenn der Nachrichtenkanalagent eine Nachricht aus der Übertragungswarteschlange abruft und eine AMS-Richtlinie für die Übertragungswarteschlange definiert ist, wird sie angewendet, um jeglichen AMS-Schutz für die Nachricht zu entfernen, bevor sie über den Kanal hinweg gesendet wird. Wenn für die Übertragungswarteschlange keine AMS-Richtlinie definiert ist, wird die Nachricht in unveränderter Form gesendet.
Dieser Wert ist nur für Kanäle mit dem Kanaltyp Sender oder Server gültig.
Wie Richtlinie
Auf eingehende Nachrichten wird vor ihrem Einreihen in die Zielwarteschlange der AMS-Schutz angewendet, der auf der für die Zielwarteschlange definierten Richtlinie basiert.
Wenn der Nachrichtenkanalagent eine eingehende Nachricht empfängt, wird (sofern eine AMS-Richtlinie für die Zielwarteschlange definiert ist) der AMS-Schutz auf die Nachricht angewendet, bevor sie in die Zielwarteschlange eingereiht wird. Wenn für die Zielwarteschlange keine AMS-Richtlinie definiert ist, wird die Nachricht in unveränderter Form in die Zielwarteschlange eingereiht.
Dieser Wert ist nur für Kanäle mit dem Kanaltyp Empfänger oder Requester gültig.
SPLPROT

Seite 'Nachrichtenkanalagent'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Nachrichtenkanalagent im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie konfigurieren möchten, wie der Nachrichtenkanalagent (MCA) für diesen Kanal ausgeführt wird, müssen Sie die Eigenschaften auf der Seite Nachrichtenkanalagent bearbeiten.

Eigenschaft Bedeutung MQSC-Parameter
MCA-Benutzer-ID Gibt die Benutzer-ID für den Nachrichtenkanalagenten an. Ist das Feld belegt, handelt es sich um die Benutzer-ID, die vom Nachrichtenkanalagenten für den Zugriff auf IBM MQ-Ressourcen verwendet werden soll; dazu gehört auch (wenn PUTAUT auf DEF gesetzt ist) die Berechtigung, die Nachricht in die Zielwarteschlange für Empfänger- oder Senderkanäle einzureihen.
Erfolgt keine Angabe, wird für den Nachrichtenkanalagenten die standardmäßige Benutzer-ID verwendet. Die standardmäßige Benutzer-ID wird von der Benutzer-ID abgeleitet, unter der der empfangende Kanal gestartet wurde. Folgende Werte sind gültig:
  • [z/OS]Unter z/OS: die Benutzer-ID, die der gestarteten Task des Kanalinitiators in der Tabelle mit den gestarteten z/OS-Prozeduren zugeordnet ist.
  • Bei TCP/IP (alle Plattformen außer z/OS): Die Benutzer-ID aus dem Eintrag 'inetd.conf' oder die ID des Benutzers, von dem das Empfangsprogramm gestartet wurde.
  • Bei SNA (alle Plattformen außer z/OS): Die Benutzer-ID aus dem SNA-Servereintrag oder (falls kein solcher Eintrag vorhanden ist) aus der eingehenden Verbindungsanforderung, oder die ID des Benutzers, von dem das Empfangsprogramm gestartet wurde.
  • Bei NetBIOS oder SPX die Benutzer-ID, unter der das Empfangsprogramm gestartet wurde.
Die Zeichenfolge hat die folgende maximale Länge:
  • [Windows]64 Zeichen unter Windows.

    [V9.2.0 Juli 2020]Bei Kanälen mit dem CHLTYPE-Wert AMQP wird die MCAUSER-Benutzer-ID in Versionen vor IBM MQ 9.1.1 nur für Benutzer-IDs mit einer Länge von höchstens 12 Zeichen unterstützt. Ab IBM MQ 9.1.1 Continuous Delivery und ab IBM MQ 9.2.0 Long Term Support ist die Begrenzung auf 12 Zeichen entfernt.

  • 12 Zeichen auf anderen Plattformen als Windows.

[Windows]Unter Windows können Sie eine Benutzer-ID zusammen mit dem Domänennamen im Format Benutzer@Domäne angeben.

MCAUSER
MCA-Art Um anzugeben, dass der Nachrichtenkanalagent (MCA) als Thread ausgeführt werden soll, wählen Sie Thread aus; um anzugeben, dass der MCA als Prozess ausgeführt werden soll, wählen Sie Prozess aus. MCATYPE
MCA-Name Schreibgeschützt. Diese Eigenschaft kann nicht bearbeitet werden, da der MCA-Name reserviert ist und nur auf Leerzeichen gesetzt werden darf. MCANAME

Seite 'Exits'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Exits im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie den Kanal so konfigurieren möchten, dass Benutzerexits ausgeführt werden, bearbeiten Sie die Eigenschaften auf der Seite Exits.

Eigenschaft Bedeutung MQSC-Parameter
Name des Sende-Exits Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung des Sendeexitnamens aufzurufen. Fügen Sie die Namen Ihrer Sendeexitprogramme hinzu:
  • [Linux][UNIX]Unter UNIX und Linux wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Die maximal zulässige Gesamtlänge aller Namen beträgt 999 Zeichen. Verwenden Sie das Format Bibliotheksname(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einem Namen 128 Zeichen beträgt.
  • [Windows]Unter Windows wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Die maximal zulässige Gesamtlänge aller Namen beträgt 999 Zeichen. Verwenden Sie das Format DLL-Name(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einem Namen 128 Zeichen beträgt.
  • [IBM i]Unter IBM i: werden hier die Namen von bis zehn Exitprogrammen eingegeben. Verwenden Sie das Format Programmname Bibliotheksname. Dabei belegt der Programmname die ersten zehn Zeichen und Bibliotheksname die nächsten zehn Zeichen. Fügen Sie am Ende von kürzeren Namen Leerzeichen hinzu, sodass sie zehn Zeichen lang sind.
  • [z/OS]Unter z/OS werden hier die Namen von bis zu acht Exitprogrammen eingegeben. Verwenden Sie den Namen des Lademoduls, wobei maximal acht Zeichen in einem Namen zulässig sind.
  • Auf den anderen Plattformen können Sie auch nur den Namen eines Sendeexitprogramms für die einzelnen Kanäle angeben.
SENDEXIT
Benutzerdaten des Sende-Exits Geben Sie die Daten (höchstens 32 Zeichen) ein, die an den Kanalsendeexit beim Aufruf des Sendeexitprogramms übergeben werden sollen:
  • [UNIX, Linux, Windows]Unter Windows und UNIX und Linux werden hier die Daten für ein oder mehrere Exitprogramme eingegeben. Trennen Sie die Daten durch Kommas. Die maximal zulässige Gesamtlänge der Eingabe in diesem Feld beträgt 999 Zeichen.
  • [IBM i]Unter IBM i: werden hier bis zu zehn Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Sendeexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • [z/OS]Unter z/OS werden hier bis zu acht Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Sendeexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • Auf anderen Plattformen können Sie für jeden Kanal nur eine Zeichenfolge mit Daten des Sendeexits angeben.
SENDDATA
Name des Empfangsexits Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung des Empfangsexitnamens aufzurufen. Fügen Sie die Namen Ihrer Empfangsexitprogramme hinzu:
  • [UNIX, Linux, Windows]Unter UNIX und Linux wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Die maximal zulässige Gesamtanzahl der Zeichen aller Namen beträgt 999 Zeichen. Verwenden Sie das Format Bibliotheksname(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einer Zeichenfolge 128 Zeichen beträgt.
  • [Windows]Unter Windows wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Trennen Sie die Namen durch Kommas. Die maximal zulässige Gesamtlänge der Eingabe in diesem Feld beträgt 999 Zeichen. Verwenden Sie das Format DLL-Name(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einer Zeichenfolge 128 Zeichen beträgt.
  • [Windows]Unter Windows werden hier die Namen von bis zu zehn Exitprogrammen eingegeben. Trennen Sie die Namen durch Kommas. Verwenden Sie das Format Programmname Bibliotheksname. Dabei belegt der Programmname die ersten zehn Zeichen und Bibliotheksname die nächsten zehn Zeichen. Fügen Sie am Ende von kürzeren Namen Leerzeichen hinzu, sodass sie zehn Zeichen lang sind.
  • [z/OS]Unter z/OS werden hier die Namen von bis zu acht Exitprogrammen eingegeben. Trennen Sie die Namen durch Kommas. Verwenden Sie den Namen des Lademoduls, wobei maximal acht Zeichen zulässig sind.
  • Auf den anderen Plattformen können Sie auch nur den Namen eines Sendeexitprogramms für die einzelnen Kanäle angeben.
RCVEXIT
Benutzerdaten des Empfangs-Exits Geben Sie die Daten (höchstens 32 Zeichen) ein, die an den Kanalempfangsexit beim Aufruf des Empfangsexitprogramms übergeben werden sollen:
  • [UNIX, Linux, Windows]Unter Windows und UNIX und Linux werden hier die Daten für ein oder mehrere Exitprogramme eingegeben. Trennen Sie die Daten durch Kommas. Die maximal zulässige Gesamtlänge der Eingabe in diesem Feld beträgt 999 Zeichen.
  • [IBM i]Unter IBM i: werden hier bis zu zehn Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Empfangsexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • [z/OS]Unter z/OS werden hier bis zu acht Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Empfangsexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • Auf anderen Plattformen können Sie für jeden Kanal nur eine Zeichenfolge mit Daten des Empfangsexits angeben.
RCVDATA
Name des Sicherheitsexits Geben Sie den Namen des Sicherheitsexitprogramms ein:
  • [UNIX, Linux, Windows]Unter UNIX und Linux erfolgt die Angabe im Format Bibliotheksname(Funktionsname); die Zeichenfolge kann eine Länge von maximal 128 Zeichen haben.
  • [IBM i]Unter IBM i: erfolgt die Angabe im Format Programmname Bibliotheksname; dabei belegt Programmname die ersten zehn Zeichen, Bibliotheksname die nächsten zehn Zeichen. Fügen Sie am Ende von kürzeren Namen Leerzeichen hinzu, sodass sie zehn Zeichen lang sind.
  • [z/OS]Unter z/OS wird der Name des Lademoduls mit maximal acht Zeichen angegeben.
SCYEXIT
Benutzerdaten des Sicherheitsexits Geben Sie die Daten (maximal 32 Zeichen) ein, die beim Aufruf des Kanalsicherheitsexits übergeben werden sollen. SCYDATA
Name des Nachrichtenexits Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung des Nachrichtenexitnamens aufzurufen. Fügen Sie die Namen Ihrer Nachrichtenexitprogramme hinzu:
  • [UNIX, Linux, Windows]Unter UNIX und Linux wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Die maximal zulässige Gesamtlänge aller Namen beträgt 999 Zeichen. Verwenden Sie das Format Bibliotheksname(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einem Namen 128 Zeichen beträgt.
  • [Windows]Unter Windows wird hier der Name eines oder mehrerer Exitprogramme eingegeben. Die maximal zulässige Gesamtlänge aller Namen beträgt 999 Zeichen. Verwenden Sie das Format DLL-Name(Funktionsname), wobei die maximal zulässige Anzahl an Zeichen in einem Namen 128 Zeichen beträgt.
  • [IBM i]Unter IBM i: werden hier die Namen von bis zehn Exitprogrammen eingegeben. Verwenden Sie das Format Programmname Bibliotheksname. Dabei belegt der Programmname die ersten zehn Zeichen und Bibliotheksname die nächsten zehn Zeichen. Fügen Sie am Ende von kürzeren Namen Leerzeichen hinzu, sodass sie zehn Zeichen lang sind.
  • [z/OS]Unter z/OS werden hier die Namen von bis zu acht Exitprogrammen eingegeben. Verwenden Sie den Namen des Lademoduls, wobei maximal acht Zeichen in einem Namen zulässig sind.
  • Auf den anderen Plattformen können Sie auch nur den Namen eines Nachrichtenexitprogramms für die einzelnen Kanäle angeben.
MSGEXIT
Benutzerdaten des Nachrichtenexits Geben Sie die Daten (höchstens 32 Zeichen) ein, die an den Kanalnachrichtenexit beim Aufruf des Kanalnachrichtenexitprogramms übergeben werden sollen:
  • [UNIX, Linux, Windows]Unter Windows und UNIX und Linux werden hier die Daten für ein oder mehrere Exitprogramme eingegeben. Trennen Sie die Daten durch Kommas. Die maximal zulässige Gesamtlänge der Eingabe in diesem Feld beträgt 999 Zeichen.
  • [IBM i]Unter IBM i: werden hier bis zu zehn Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Kanalnachrichtenexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • [z/OS]Unter z/OS werden hier bis zu acht Datenzeichenfolgen eingegeben, jede mit einer Länge von 32 Zeichen. Die erste Datenzeichenfolge wird an den ersten Kanalnachrichtenexit übergeben, die zweite Zeichenfolge an den zweiten Exit usw.
  • Auf anderen Plattformen können Sie für jeden Kanal nur eine Zeichenfolge mit Daten des Kanalnachrichtenexits angeben.
MSGDATA

Seite 'LU6.2'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite LU6.2 im Dialog mit den Kanaleigenschaften festlegen können. Falls der Kanal das Transportprotokoll 'LU 6.2' verwendet, müssen Sie die Eigenschaften auf der Seite LU6.2 bearbeiten.

Eigenschaft Bedeutung MQSC-Parameter
Modus- name Geben Sie den LU 6.2-Modusnamen ein, bei dem es sich um den SNA-Modus handelt. Wenn der Wert der Eigenschaft Verbindungsname auf der Seite Allgemein jedoch ein Nebenobjekt enthält, müssen Sie den Wert 'Modusnamen' leer lassen. Die maximal zulässige Länge beträgt acht Zeichen. MODENAME
TP-Name Geben Sie den Namen oder generischen Namen des MCA-Programms ein, das am fernen Ende der Verbindung ausgeführt wird. TPNAME
Benutzer-ID Geben Sie die Benutzer-ID ein, die vom Nachrichtenkanalagenten für den Aufbau einer sicheren LU6.2-Sitzung mit einem fernen Nachrichtenkanalagenten verwendet wird. Die maximal zulässige Länge beträgt zwölf Zeichen, es werden jedoch nur die ersten zehn Zeichen berücksichtigt. USERID
Kennwort Klicken Sie auf Kennwort für Kanal ändern und geben Sie anschließend im Dialog 'Kennwort ändern' das Kennwort ein, das vom MCA für den Aufbau einer sicheren LU 6.2-Sitzung mit einem fernen MCA verwendet wird. Die maximal zulässige Länge beträgt 12 Zeichen. PASSWORD

Seite 'Wiederholung'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Wiederholung im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie konfigurieren möchten, wie sich der Kanal verhält, wenn er keine Verbindung zum fernen Warteschlangenmanager herstellen kann, müssen Sie die Eigenschaften auf der Seite Wiederholung bearbeiten.

Eigenschaft Bedeutung MQSC-Parameter
Gibt den Zähler für kurze Wiederholungsversuche an an. Geben Sie an, wie oft der Kanal versuchen kann, eine Verbindung zu einem fernen Warteschlangenmanager herzustellen; hier kann ein Wert zwischen 0 und 999.999.999 oder (bei z/OS mit CICS) 1 und 999.999.999 eingegeben werden. SHORTRTY
Kurzes Wiederholungsintervall Geben Sie das ungefähre Intervall in Sekunden an, das der Kanal abwarten muss, bevor er erneut versucht, eine Verbindung zum fernen Warteschlangenmanager mit dem kurzen Wiederholungszähler herzustellen. Der Wert 0 bedeutet, dass der Kanal sofort einen neuen Versuch unternimmt. SHORTTMR
Gibt die maximal zulässige Anzahl an Wiederholungsversuchen an. Geben Sie an, wie oft der Kanal höchstens versuchen kann, eine Verbindung zu einem fernen Warteschlangenmanager herzustellen. Zulässig sind die Werte 0 bis 999.999.999. Der Wert dieser Eigenschaft wird nur verwendet, wenn der Zähler, der in der Eigenschaft 'Kurzer Wiederholungszähler' angegeben wurde, voll ausgeschöpft wurde und der Kanal immer noch keine Verbindung zum fernen Warteschlangenmanager herstellen konnte. LONGRTY
Langes Wiederholungsintervall Geben Sie das ungefähre Intervall in Sekunden an, das der Kanal abwarten muss, bevor er erneut versucht, eine Verbindung zum fernen Warteschlangenmanager mit dem langen Wiederholungszähler herzustellen. Der Wert 0 bedeutet, dass der Kanal sofort einen neuen Versuch unternimmt. LONGTMR
Keepalive-Intervall Der Wert der Eigenschaft Keepalive-Intervall gibt den Zeitlimitwert des Kanals an. Wenn Sie den Keepalive-Wert auf den Wert des variablen Intervalls der Überwachungssignale basieren möchten, wählen Sie Auto aus. Wenn das variable Intervall der Überwachungssignale größer als null ist, wird für das Keepalive-Intervall das variable Intervall der Überwachungssignale plus 60 Sekunden übernommen; wenn das variable Intervall der Überwachungssignale null ist, wird für das Keepalive-Intervall ebenfalls null übernommen. Geben Sie zur Festlegung eines Zeitlimitwerts die gewünschte Anzahl an Sekunden ein (von 0 bis 99.999). Wenn Sie die Keepalive-Funktion für diesen Kanal inaktivieren möchten, geben Sie 0 ein. KAINT

Seite 'Nachrichtenwiederholung'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Nachrichtenwiederholung im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie konfigurieren möchten, wie sich der Kanal verhält, wenn er beim ersten Versuch keine Nachricht in die ferne Warteschlange einreihen kann, müssen Sie die Eigenschaften auf der Seite Nachrichtenwiederholung bearbeiten.

Eigenschaft Bedeutung MQSC-Parameter
Zähler für Nachrichtenwiederholungen Geben Sie an, wie oft der Kanal erneut versucht, eine Nachricht zuzustellen, bevor er davon ausgeht, dass er die Nachricht nicht an die ferne Warteschlange zustellen kann. Zulässige Werte sind 0 bis 999.999.999. Die Aktion des Nachrichtenkanalagenten kann über diese Eigenschaft nur gesteuert werden, wenn für die Eigenschaft 'Name des Nachrichtenwiederholungs-Exits' kein Wert angegeben wurde. Andernfalls wird der Wert der Eigenschaft Zähler für Nachrichtenwiederholungen an den Exit zu dessen Verwendung übergeben. Die Angabe, wie oft der Kanal erneut versucht, die Nachricht zuzustellen, wird jedoch vom Exit gesteuert, nicht von der Eigenschaft Zähler für Nachrichtenwiederholungen. MRRTY
Intervall für Nachrichtenwiederholungen Geben Sie in Millisekunden an, wie lange der Kanal mindestens warten muss, bis er einen erneuten Versuch zur Einreihung der Nachricht in die ferne Warteschlange unternimmt. MRTMR
Name des Nachrichtenwiederholungs-Exits Geben Sie den Namen des Exitprogramms für Kanalnachrichtenwiederholungen ein:
  • [Linux][UNIX]Unter UNIX und Linux erfolgt die Angabe im Format Bibliotheksname(Funktionsname); die Zeichenfolge kann eine Länge von maximal 128 Zeichen haben.
  • [IBM i]Unter IBM i: erfolgt die Angabe im Format Programmname Bibliotheksname; dabei belegt Programmname die ersten zehn Zeichen, Bibliotheksname die nächsten zehn Zeichen. Fügen Sie am Ende von kürzeren Namen Leerzeichen hinzu, sodass sie zehn Zeichen lang sind.
  • [z/OS]Unter z/OS wird der Name des Lademoduls mit maximal acht Zeichen angegeben.
MRDATA
Benutzerdaten des Nachrichtenwiederholungs-Exits Geben Sie die Daten (höchstens 32 Zeichen) ein, die an den Kanalnachrichtenwiederholungsexit bei dessen Aufruf übergeben werden. MREXIT

Seite 'Cluster'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Cluster im Dialog mit den Kanaleigenschaften festlegen können. Wenn der Kanal in einem oder mehreren Clustern gemeinsam genutzt werden soll, müssen Sie die Eigenschaften auf der Seite Cluster bearbeiten.
Anmerkung: Geben Sie die Clusterkanaleigenschaften in den Clusterempfängerkanälen auf den Ziel-Warteschlangenmanagern an. Alle Eigenschaften, die Sie in den entsprechenden Clustersenderkanälen festlegen, werden wahrscheinlich ignoriert. Siehe Clusterkanäle in der IBM Knowledge Center.
Eigenschaft Bedeutung MQSC-Parameter
Nicht gemeinsam genutzt in Cluster Standardmäßig ist diese Option ausgewählt, was bedeutet, dass der Kanal in keinem Cluster gemeinsam genutzt wird. Nicht zutreffend.
Gemeinsam genutzt in Cluster Wenn der Kanal in einem Cluster gemeinsam genutzt werden soll, wählen Sie diese Option aus und geben Sie anschließend den Namen des Clusters ein. Siehe Zeichenfolgen in Eigenschaftendialogen. CLUSTER
Gemeinsam genutzt in Clusterliste Wenn der Kanal in mehreren Clustern gemeinsam genutzt werden soll, wählen Sie diese Option aus und geben Sie anschließend den Namen des Namenslistenobjekts ein, das die Namen der Cluster enthält. Siehe Zeichenfolgen in Eigenschaftendialogen. CLUSNL
Netzpriorität Der Wert dieser Eigenschaft gibt die Kanalpriorität für die Netzverbindung an. Geben Sie einen Wert von 0 bis 9 ein. 0 ist die niedrigste Priorität. Siehe Kanalattribut NETPRTY in der IBM Knowledge Center. NETPRTY
CLWL-Kanalrangordnung Geben Sie die Rangordnung des Kanals im Cluster ein. Zulässig sind die Werte 0 bis 9, wobei 0 die niedrigste Rangordnung ist. Siehe Kanalattribut CLWLRANK in der IBM Knowledge Center. CLWLRANK
CLWL-Kanalpriorität Geben Sie die Priorität des Kanals im Cluster ein. Zulässig sind die Werte 0 bis 9, wobei 0 die niedrigste Priorität ist. Siehe Kanalattribut CLWLPRTY in der IBM Knowledge Center. CLWLPRTY
CLWL-Kanalgewichtung Geben Sie die Gewichtung ein, die für den Kanal gilt. Auf diese Weise wird der Anteil der Nachrichten gesteuert, die über den Kanal gesendet werden. Der Wert muss zwischen 1 und 99 liegen, wobei 1 die niedrigste Gewichtung ist. Siehe Kanalattribut CLWLWGHT in der IBM Knowledge Center. CLWLWGHT

Seite 'SSL'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite SSL im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie den Kanal so konfigurieren möchten, dass die SSL-Sicherheit verwendet wird, bearbeiten Sie die Eigenschaften auf der Seite SSL.

Eigenschaft Bedeutung MQSC-Parameter
CertificateLabel Die für diesen Kanal zu verwendende Zertifikatsbezeichnung. Diese Bezeichnung gibt an, welches persönliche Zertifikat aus dem Schlüsselrepository an den fernen Peer gesendet werden soll. Wird für diese Eigenschaft kein Wert angegeben, so wird das Zertifikat durch die Eigenschaft 'CertificateLabel' des Warteschlangenmanagers bestimmt. CERTLABL
CipherSpec Geben Sie für eine TLS-Verbindung den Namen (höchstens 32 Zeichen) der CipherSpec (Verschlüsselungsspezifikation) ein. Die Definition muss an beiden Enden des IBM MQ-SSL-Kanals in der CipherSpec-Eigenschaft den gleichen Wert haben. Weitere Informationen finden Sie unter der Eigenschaft SSLCIPH in DEFINE CHANNEL in der IBM Knowledge Center.

Der Wert für diesen Parameter wird auch verwendet, um den Wert der Sicherheitsprotokolleigenschaft festzulegen, bei der es sich um ein Ausgabefeld auf der Seite Statusattribute von Kanälen handelt.

SSLCIPH
Authentifizierung von Verbindungen einleitenden Parteien Wenn Sie angeben möchten, dass der Kanal von einem TLS-Client ein TLS-Zertifikat empfangen und authentifizieren soll, wählen Sie Erforderlich aus. Wenn Sie angeben möchten, dass der Kanal kein TLS-Zertifikat von einem TLS-Client empfangen und authentifizieren muss, wählen Sie Optional aus. Wenn Sie Optional auswählen und der TLS-Peer-Client ein Zertifikat sendet, wird das Zertifikat wie üblich vom Kanal authentifiziert. SSLCAUTH
Name des Ausstellers für Peer DN-Namensfilter für Zertifikatsaussteller. Dieses Feld enthält einen DN-Filter (Filter für definierte Namen) für den Aussteller-DN des persönlichen Zertifikats des fernen Peers. Der 'Name des Ausstellers für Peer' ist ein Schlüsselfeld der SSL-Peer-Map und wird zum Abgleich der Kanalberechtigungssätze für die Verbindung eingehender Kanäle verwendet. SSLCERTI
Nur Zertifikate mit den folgenden Definierten Namen akzeptieren Geben Sie den DN ein, der im Zertifikat des Peer-Warteschlangenmanagers oder Clients auf der anderen Seite des IBM MQ-Kanals enthalten ist. Sobald der Kanal gestartet wird, wird der Wert dieser Eigenschaft mit dem DN des Zertifikats verglichen. SSLPEER
Nur Zertifikate mit den folgenden Definierten Namen akzeptieren Dieser Kanalauthentifizierungssatz ordnet definierte TLS-Namen (DNs) MCAUSER-Werten zu. Gemeinsam mit dem Parameter SSLPEERMAP muss auch ein SSLPEER angegeben sein. SSLPEERMAP

Seite 'Lastausgleich'

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

Eigenschaft Bedeutung MQSC-Parameter
Gewicht Mit der Eigenschaft für die Clientkanalgewichtung kann eine Gewichtung angegeben und damit beeinflusst werden, welche Definition des Clientverbindungskanals verwendet wird. Bei Verwendung der Eigenschaft für die Clientkanalgewichtung ist es möglich, Clientkanaldefinitionen auf der Basis ihrer Gewichtung auszuwählen, wenn mehr als eine geeignete Definition zur Verfügung steht.

Setzt ein Client einen MQCONN ab, um eine Verbindung zu einer Warteschlangenmanagergruppe anzufordern, und gibt er dazu einen mit einem Stern beginnenden Warteschlangenmanagernamen an, dann wird, wenn die Definitionstabelle für Clientkanäle (CCDT - Client Channel Definition Table) mehr als eine geeignete Kanaldefinition enthält, die zu verwendende Definition auf der Basis der Gewichtung ausgewählt. Dabei werden gültige Definitionen des Typs CLNTWGHT(0) der alphabetischen Reihenfolge folgend zuerst ausgewählt. Geben Sie einen Wert zwischen 0 und 99 ein. Der Standardwert lautet 0. Der Wert 0 gibt an, dass kein Lastausgleich erfolgt und gültige Definitionen in alphabetischer Reihenfolge ausgewählt werden. Wenn der Lastausgleich aktiviert werden soll, wählen Sie einen Wert im Bereich 1 bis 99 aus, wobei 1 der niedrigsten und 99 der höchsten Gewichtung entspricht. Die Aufteilung der Nachrichten zwischen zwei oder mehreren Kanälen mit einer Gewichtung ungleich null erfolgt in etwa proportional zum Verhältnis dieser Gewichtungen.

CLNTWGHT
Affinität Die Eigenschaft Kanalaffinität wird verwendet, um Clientanwendungen, die mehrfach unter Verwendung desselben WE-Managernamens verbinden, wählen können, ob sie für jede Verbindung dieselbe Clientkanaldefinition verwenden. Verwenden Sie diese Eigenschaft, wenn mehrere gültige Kanaldefinitionen verfügbar sind. Folgende Werte sind möglich:

Bevorzugt. Dies ist der Standardwert. Die erste Verbindung eines Prozesses, der eine Definitionstabelle für Clientkanäle (CCDT) liest, erstellt basierend auf der Clientkanalgewichtung eine Liste gültiger Definitionen, in der die Definitionen mit der Gewichtung 0 jeweils in alphabetischer Reihenfolge zuerst aufgeführt sind. Jede Verbindung in dem Prozess versucht unter Verwendung der ersten Definition in der Liste eine Verbindung aufzunehmen. Wenn eine Verbindung nicht erfolgreich ist, wird die nächste Definition verwendet. Nicht erfolgreiche Definitionen mit Clientkanalgewichtungswerten ungleich null werden an das Ende der Liste verschoben. Definitionen mit einer Clientkanalgewichtung von 0 verbleiben am Anfang der Liste und werden für jede Verbindung zuerst ausgewählt. Jeder Clientprozess mit demselben Hostnamen erstellt dieselbe Liste.

Keine. Die erste Verbindung in einem Prozess, die ein CCDT liest, erstellt eine Liste gültiger Definitionen. Alle Verbindungen eines Prozesses wählen eine gültige Definition basierend auf der Clientkanalgewichtung aus, wobei Definitionen mit der Gewichtung 0 in alphabetischer Reihenfolge zuerst ausgewählt werden.

AFFINITY

Seite 'Statistik'

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die Sie auf der Seite Statistik im Dialog mit den Kanaleigenschaften festlegen können. Wenn Sie den Kanal so konfigurieren möchten, dass Überwachungs- oder Statistikdaten erfasst werden, bearbeiten Sie die Eigenschaften auf der Seite Statistik.

Eigenschaft Bedeutung MQSC-Parameter
Änderungsdatum Schreibgeschützt. Dieses Attribut zeigt das Datum an, an dem die Warteschlangeneigenschaften zuletzt geändert wurden. ALTDATE
Änderungszeit Schreibgeschützt. Dieses Attribut zeigt die Uhrzeit an, zu der die Warteschlangeneigenschaften zuletzt geändert wurden. ALTTIME
Kanalüberwachung Sie können IBM MQ so konfigurieren, dass Onlineüberwachungsdaten zur aktuellen Kanalleistung erfasst werden. Wenn Sie den Wert der Warteschlangenmanagereigenschaft Kanalüberwachung übernehmen möchten (siehe Eigenschaften des WS-Managers), klicken Sie auf Warteschlangenmanager. Wenn der Wert für die Eigenschaft Kanalüberwachung auf Keine gesetzt ist, wird die Eigenschaft Kanalüberwachung der Warteschlange ignoriert. Wenn die Eigenschaft Kanalüberwachung des Warteschlangenmanagers nicht auf Keine gesetzt ist, gilt Folgendes: Wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und für diesen Kanal eine Datenerfassung verhindern möchten, klicken Sie auf Aus; wenn Sie Daten in einem geringen Maß erfassen möchten, klicken Sie auf Niedrig; wenn Sie eine mittlere Datenerfassung wünschen, klicken Sie auf Mittel; wenn Sie Daten in hohem Maß erfassen möchten, klicken Sie auf Hoch. MONCHL
Kanalstatistik Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Kanalaktivität erfasst werden. Wenn Sie den Wert der Warteschlangenmanagereigenschaft Kanalstatistik übernehmen möchten (siehe Eigenschaften des Warteschlangenmanagers), klicken Sie auf Warteschlangenmanager. Wenn der Wert für die Eigenschaft Kanalstatistik auf Keine gesetzt ist, wird die Eigenschaft Kanalstatistik der Warteschlange ignoriert. Wenn die Eigenschaft Kanalstatistik des Warteschlangenmanagers nicht auf Keine gesetzt ist, gilt Folgendes: Wenn Sie die Einstellungen des Warteschlangenmanagers außer Kraft setzen und für diesen Kanal eine Datenerfassung verhindern möchten, klicken Sie auf Aus; wenn Sie Daten in einem geringen Maß erfassen möchten, klicken Sie auf Niedrig; wenn Sie eine mittlere Datenerfassung wünschen, klicken Sie auf Mittel; wenn Sie Daten in hohem Maß erfassen möchten, klicken Sie auf Hoch. STATCHL