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:
- Allgemein
- Erweitert
- Nachrichtenkanalagent
- Exits
- LU6.2
- Wiederholung
- Nachrichtenwiederholung
- Cluster
- SSL
- Lastausgleich
- Statistik
- Einige Eigenschaften gelten speziell für Clusterkanäle.
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.
|
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 |
LOCLADDR |
Clusterempfängerkanäle: Geben Sie im Feld |
||
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:
|
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.
|
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.
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:
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:
|
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 |
![]() ![]() |
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:
|
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:
Die Zeichenfolge hat die folgende maximale Länge:
|
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:
|
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:
|
SENDDATA |
Name des Empfangsexits | Klicken Sie auf Bearbeiten, um den Dialog zur Bearbeitung des Empfangsexitnamens aufzurufen. Fügen Sie die Namen Ihrer Empfangsexitprogramme hinzu:
|
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:
|
RCVDATA |
Name des Sicherheitsexits | Geben Sie den Namen des Sicherheitsexitprogramms ein:
|
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:
|
MSGEXIT |
Benutzerdaten des Nachrichtenexits | Geben Sie die Daten (höchstens 32 Zeichen) ein, die an den Kanalnachrichtenexit beim Aufruf des Kanalnachrichtenexitprogramms übergeben werden sollen:
|
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:
|
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'
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 |