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 im Abschnitt IBM® MQ mit MQSC-Befehlen verwalten in IBM Documentation.
Seite 'Allgemein'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Allgemein des Dialogs Kanaleigenschaften festlegen können.
Eigenschaft | Bedeutung | MQSC-Parameter |
---|---|---|
Kanalname | Schreibgeschützt. Gibt den Namen der Kanaldefinition an. | CHANNEL |
Typ | 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. Queue manager bedeutet, dass die Objektdefinition nur für den Warteschlangenmanager verfügbar ist, der sie hostet. Group bedeutet, dass die Objektdefinition im gemeinsamen Repository gespeichert ist und jeder Warteschlangenmanager in der Gruppe mit gemeinsamer Warteschlange über eine Kopie der Definition verfügt. Copy bedeutet, dass es sich bei der Objektdefinition um die Kopie einer Definition im gemeinsamen Repository handelt. |
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 Zielwarteschlangenmanager eine Verbindung über eine andere Portnummer als die IBM MQ-Standardportnummer 1414 herstellt, geben Sie computer_name(port_number) ein, wobei Computername der Name oder die IP-Adresse des Computers ist, auf dem sich der Zielwarteschlangenmanager befindet, und Portnummer den Port angbit, den der Listener des Zielwarteschlangenmanagers verwendet.
|
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. Zu verwendendes Formatipaddress(low-port, high-port), wobei IP-Adresse die IP-Adresse ist, die in der IPv4 -Schreibweise mit Trennzeichen, im IPv6 -Hexadezimalformat oder im alphanumerischen Hostnamensformat angegeben ist. Beispiel:192.0.2.0Gibt die IPv4 -Adresse mit einem beliebigen 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 Cluster-sender channels: Wenn Sie im Feld |
LOCLADDR |
Cluster-receiver channels: 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 aufgelistet, die Sie auf der Seite Erweitert des Dialogs 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 der Überwachungssignale | 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. Legen Sie einen Wert fest, der kleiner als der Wert für die Eigenschaft Disconnect
interval ist. 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. Maximum instances gibt die maximale Anzahl gleichzeitiger Instanzen eines einzelnen Serververbindungskanals oder AMQP-Kanals an. 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 für Maximum instances ein Wert festgelegt ist, der niedriger als die Anzahl der gegenwärtig aktiven Instanzen des Serververbindungskanals ist, können so lange keine neuen Instanzen gestartet werden, bis eine ausreichende Anzahl vorhandener Instanzen gestoppt werden. 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. Maximum instances per clientGibt die maximale Anzahl simultaner Instanzen eines bestimmten Serververbindungskanals an, die von einem einzigen Client gestartet werden können. 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. Maximum instances unterscheidet sich von Maximum instances per client dadurch, dass Maximum instances zwar die maximale Anzahl an Verbindungen angibt, aber Maximum instances per client die maximale Anzahl an Verbindungen festlegt, die jeder Client zum Server herstellen darf. |
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. Für die Eigenschaft TCP Keep alive muss auf der Seite 'Kanäle' der Eigenschaften des Warteschlangenmanagers der Wert Yes festgelegt werden.
|
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. Testen Sie die Standardstapelgröße von50und ändern Sie den Wert nur bei Bedarf. | 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. Ohne bedeutet, dass keine Nachrichtenkomprimierung ausgeführt wird. RLE bedeutet, dass die Nachrichtendatenkomprimierung mit der Ausführungslängencodierung erfolgt. ZLIBFAST bedeutet, dass die Komprimierung von Nachrichtendaten unter Verwendung der zlib-Komprimierungstechnik durchgeführt wird und eine schnelle Komprimierungszeit bevorzugt wird. ZLIBHIGH bedeutet, dass die Komprimierung von Nachrichtendaten mit der zlib-Komprimierungstechnik durchgeführt wird und ein hoher Komprimierungsgrad bevorzugt wird. ![]() ![]() ANY bedeutet, dass jede vom Warteschlangenmanager unterstützte Komprimierungstechnik verwendet werden kann. Weitere Informationen finden Sie unter Verteilte Warteschlangen und Cluster in IBM Documentation. |
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 Warteschlangen und Cluster in IBM Documentation. | 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 |
PUT-Berechtigung | 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 der sendende Kanal innerhalb des Überwachungssignalintervalls im Stapelbetriebüber eine Kommunikation vom empfangenden Kanal verfügt, wird davon ausgegangen, dass der empfangende Kanal noch aktiv ist. Andernfalls wird zur Überprüfung ein Überwachungssignal an den empfangenden Kanal 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 unter Konfiguration des Kanals, um die Möglichkeit zu verringern, in Zweifel gezogen zu werden. |
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) |
Enthält die Nachricht eine Eigenschaft mit dem Präfix mcd., jms., usr. oder mqext. werden alle optionalen Eigenschaften der Nachrichten (wenn 'Unterstützung' auf den Wert MQPD_SUPPORT_OPTIONAL gesetzt ist), außer denen im Nachrichtendeskriptor (oder in der Erweiterung) in einen oder mehrere MQRFH2-Header in den Nachrichtendaten eingefügt, 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 |
Gemeinsamer Datenaustausch (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 wird in Bezug auf Folgendes in einem Modus vor dem von IBM WebSphere® MQ 7.0ausgeführt:
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 aus einer ausstehenden Anforderung; sie weist darauf hin, dass eine Anforderung für den Befehl 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 die AMQPKA-Eigenschaft Auto lautet, wird ein Wert verwendet, der auf dem ausgehandelten Heartbeat-Intervall-Wert basiert. Wenn der AMQP-Client innerhalb des Keepalive-Intervalls keine Frames gesendet hat, wird die Verbindung mit einemamqp:resource-limit-exceededAMQP-Fehlerbedingung. |
AMQPKA |
Themen-Root (Nur auf AMQP-Kanälen) |
Gibt den Themenstamm (Topic-Root) für einen AMQP-Kanal an. Verwenden Sie diese Eigenschaft, um sicherzustellen, dass eine MQ Light -Anwendung bei der Implementierung in einem Warteschlangenmanager keine Nachrichten in oder aus Bereichen der Themenstruktur veröffentlicht oder subskribiert, die von anderen Anwendungen verwendet werden. 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 |
Temporäre Modellwarteschlange (Nur auf AMQP-Kanälen) |
Gibt den Namen der Modellwarteschlange an, die beim Erstellen einer temporären Warteschlange verwendet werden soll (maximal 48 Zeichen lang). Der Standardwert lautet SYSTEM.DEFAULT.MODEL.QUEUE. |
TMPMODEL |
Präfix für temporäre Warteschlangen (Nur auf AMQP-Kanälen) |
Das Präfix des vorläufigen Warteschlangennamens, das beim Ableiten eines solchen Namens (maximal 32 Zeichen lang) am Anfang der Modellwarteschlange hinzugefügt werden soll. Der Standardwert lautet AMQP.* |
TMPQPRFX |
![]() |
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 möglich:
|
SPLPROT |
Seite 'Nachrichtenkanalagent'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite Nachrichtenkanalagent des Dialogs 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. Wenn es nicht leer ist, ist es die Benutzer-ID, die vom Nachrichtenkanalagenten für die Berechtigung zum Zugreifen auf IBM MQ -Ressourcen verwendet werden soll, einschließlich (wenn PUTAUT auf DEF gesetzt ist) der Berechtigung zum Einreihen der Nachricht in die Zielwarteschlange für Empfänger-oder Requesterkanäle. 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 möglich:
Die Zeichenfolge hat die folgende maximale Länge:
|
MCAUSER |
MCA-Typ | 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 aufgelistet, die Sie auf der Seite Exits des Dialogs 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 Sendeexits | 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 Empfangsexits | 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 aufgelistet, die Sie auf der Seite LU6.2 des Dialogs 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 |
---|---|---|
Modusname | Geben Sie den LU 6.2-Modusnamen ein. Dies ist der Name des SNA-Modus, es sei denn, der Wert der Eigenschaft Connection name auf der Seite Allgemein enthält ein Nebenobjekt. In diesem Fall lassen Sie den Wert für Mode name leer. Die maximal zulässige Länge beträgt 8 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 aufgelistet, die Sie auf der Seite Wiederholung des Dialogs 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 |
---|---|---|
Zähler für kurze Wiederholungsversuche | Geben Sie die maximale Anzahl an, 0 - 999999999 (oder, für z/OS mit CICS, 1 - 999999999), die der Kanal versuchen kann, eine Verbindung zu einem entfernten Warteschlangenmanager herzustellen. | SHORTRTY |
Intervall für kurze Wiederholungsversuche | 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 |
Zähler für lange Wiederholungsversuche | 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 die in der Eigenschaft Short retry count angegebene Anzahl ausgeschöpft wurde und der Kanal noch immer keine Verbindung zum fernen Warteschlangenmanager erfolgreich herstellen konnte. |
LONGRTY |
Intervall für lange Wiederholungsversuche | 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 Keep alive interval gibt das Zeitlimit 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 verhandelte Überwachungsintervall einen Wert größer als null hat, ergibt sich der Wert für Keep alive interval aus dem Wert für das verhandelten Überwachungssignalintervall plus 60 Sekunden. Wenn das verhandelte Überwachungssignalintervall null ist, ist Keep alive interval ebenfalls null. 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 aufgelistet, die Sie auf der Seite Nachrichtenwiederholung des Dialogs 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. Diese Eigenschaft steuert die Aktion des Nachrichtenkanalagenten nur, wenn für die Eigenschaft Message retry exit name kein Wert angegeben ist. Wenn die Eigenschaft Message retry exit name nicht leer ist, wird der Wert der Eigenschaft Message retry count zur Verwendung durch den Exit an den Exit übergeben. Die Anzahl der erneuten Versuche der Nachrichtenzustellung durch den Kanal wird jedoch vom Exit gesteuert und durch die Eigenschaft Message retry count . |
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 Nachrichtenwiederholungsexits | Geben Sie den Namen des Exitprogramms für Kanalnachrichtenwiederholungen ein:
|
MRDATA |
Benutzerdaten des Nachrichtenwiederholungsexits | 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 Strings in Eigenschaftsdialogen. | 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 NETPRTY Kanalattribut in IBM Documentation. | 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 CLWLRANK Kanalattribut in IBM Documentation. | 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 CLWLPRTY Kanalattribut in IBM Documentation. | 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 CLWLWGHT Kanalattribut in IBM Documentation. | CLWLWGHT |
Seite 'SSL'
In der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie auf der Seite SSL des Dialogs 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. Beide Enden der IBM MQ SSL-Kanaldefinition müssen denselben Wert in der Eigenschaft CipherSpec haben. Weitere Informationen finden Sie unter der Eigenschaft SSLCIPH in DEFINE CHANNEL in IBM Documentation. Der Wert für diesen Parameter wird auch verwendet, um den Wert der Eigenschaft "Sicherheitsprotokoll" festzulegen, die ein Ausgabefeld auf der Seite Kanalstatusattribute ist. |
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 DNs (Distinguished Names) akzeptieren | Geben Sie den Wert für den definierten Namen im Zertifikat des Peer-Warteschlangenmanagers oder Clients am anderen Ende des IBM MQ -Kanals ein. Sobald der Kanal gestartet wird, wird der Wert dieser Eigenschaft mit dem DN des Zertifikats verglichen. | SSLPEER |
Nur Zertifikate mit den folgenden DNs (Distinguished Names) 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 aufgelistet, die Sie auf der Seite Lastausgleich des Dialogs 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 im Bereich von 0 bis 99 an. Der Standardwert ist 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 von 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. Bei jeder Verbindung des Prozesses wird versucht, die Verbindung über die erste Definition der Liste herzustellen. 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 eines Prozesses, die eine 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 aufgelistet, die Sie auf der Seite Statistik des Dialogs 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 für die Erfassung von Onlineüberwachungsdaten zur aktuellen Leistung des Kanals konfigurieren. Um den Wert der Eigenschaft Channel monitoring des Warteschlangenmanagers zu erben (siehe Warteschlangenmanager-Eigenschaften), klicken Sie auf Warteschlangenmanager. Wenn für die Eigenschaft Channel
monitoring des Warteschlangenmanagers der Wert None festgelegt ist, wird die Eigenschaft Channel
monitoring der Warteschlange ignoriert. Wenn für die Eigenschaft Channel monitoring des Warteschlangenmanagers nicht der Wert None festgelegt ist, gilt Folgendes: Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt sollen und die Datenerfassung für diesen Kanal verhindert werden soll, klicken Sie auf Aus. Wenn Daten mit einer geringen Geschwindigkeitsrate erfasst werden sollen, klicken Sie auf Niedrig. Wenn Daten mit einer mittleren Geschwindigkeitsrate erfasst werden sollen, klicken Sie auf Mittel. Sollen Daten mit einer hohen Geschwindigkeitsrate erfasst werden, klicken Sie auf Hoch. |
MONCHL |
Kanalstatistik | Sie können IBM MQ so konfigurieren, dass Statistikdaten zur Aktivität des Kanals erfasst werden. Wenn Sie den Wert der Eigenschaft Channel
statistics des Warteschlangenmanagers übernehmen möchten (siehe Eigenschaften des Warteschlangenmanagers), klicken Sie auf Warteschlangenmanager. Wenn für die Eigenschaft Channel statistics des Warteschlangenmanagers der Wert None festgelegt ist, wird die Eigenschaft Channel
statistics der Warteschlange ignoriert. Wenn für die Eigenschaft Channel statistics des Warteschlangenmanagers nicht der Wert None festgelegt ist, gilt Folgendes: Wenn die Einstellungen des Warteschlangenmanagers außer Kraft gesetzt werden sollen und die Datenerfassung für diesen Kanal verhindert werden soll, klicken Sie auf Aus. Wenn Daten mit einer geringen Geschwindigkeitsrate erfasst werden sollen, klicken Sie auf Niedrig. Wenn Daten mit einer mittleren Geschwindigkeitsrate erfasst werden sollen, klicken Sie auf Mittel. Sollen Daten mit einer hohen Geschwindigkeitsrate erfasst werden, klicken Sie auf Hoch. |
STATCHL |