ANZEIGEN CHSTATUS

Mit dem WebSphere MQ-Scriptbefehl DISPLAY CHSTATUS können Sie den Status eines oder mehrerer Kanäle anzeigen.

MQSC-Befehle verwenden

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

IBM® i	UNIX und Linux®	Windows	z/OS®
			CR

Eine Erläuterung der Symbole in der Spalte z/OS finden Sie unter Befehle unter z/OSverwenden.

Syntaxdiagramm
Hinweise zur Verwendung von DISPLAY CHSTATUS
Parameterbeschreibungen für DISPLAY CHSTATUS
Zusammenfassungsattribute
Allgemeine Statusfelder
Aktuelle Statusfelder
Kurzstatus

Synonym : DIS CHS

ANZEIGEN CHSTATUS

Allgemeine Statusfelder

Aktuelle Statusfelder

Kurzstatus

Anmerkungen:

¹ Nur gültig unter z/OS , wenn der Warteschlangenmanager Mitglied einer Gruppe mit gemeinsamer Warteschlange ist
² Nur gültig unter z/OS.
³ Wird auch durch Auswahl des Parameters MONITOR angezeigt.
⁴ Wird ignoriert, wenn unter z/OSangegeben.

Hinweise zur Verwendung von DISPLAY CHSTATUS

unter z/OS:

Wenn der Kanalinitiator nicht aktiv ist, wird dieser Befehl nicht ausgeführt.
Der Befehlsserver muss aktiv sein.
Wenn Sie den Gesamtstatus des Kanals anzeigen möchten (d. h. den Status der Gruppe mit gemeinsamer Warteschlange), verwenden Sie den Befehl DISPLAY CHSTATUS SHORT, der die Statusinformationen des Kanals aus Db2®abruft.
Wenn ein numerischer Parameter den Wert 999.999.999 überschreitet, wird er als 999999999 angezeigt.

Die Statusinformationen, die für verschiedene Kombinationen von CHLDISP, CMDSCOPE und Statustyp zurückgegeben werden, sind in Tabelle 1, Tabelle 2und Tabelle 3zusammengefasst.

Tabelle 1. CHLDISP und CMDSCOPE für DISPLAY CHSTATUS CURRENT
CHLDISP	CMDSCOPE( ) oder CMDSCOPE (lokaler Warteschlangenmanager)	CMDSCOPE (Warteschlangenmanagername)	CMDSCOPE(*)
PRIVATE	Allgemeiner und aktueller Status für aktuelle private Kanäle des lokalen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle private Kanäle des angegebenen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle private Kanäle aller Warteschlangenmanager
SHARED	Allgemeiner und aktueller Status für aktuelle gemeinsame Kanäle des lokalen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle gemeinsame Kanäle des angegebenen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle gemeinsame Kanäle aller Warteschlangenmanager
ALLE	Allgemeiner und aktueller Status für aktuelle private und gemeinsame Kanäle des lokalen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle private und gemeinsame Kanäle des angegebenen Warteschlangenmanagers	Allgemeiner und aktueller Status für aktuelle private und gemeinsame Kanäle aller aktiven Warteschlangenmanagers

Tabelle 2. CHLDISP und CMDSCOPE für DISPLAY CHSTATUS SHORT
CHLDISP	CMDSCOPE( ) oder CMDSCOPE (lokaler Warteschlangenmanager)	CMDSCOPE (Warteschlangenmanagername)	CMDSCOPE(*)
PRIVATE	STATUS und Kurzstatus für aktuelle private Kanäle des lokalen Warteschlangenmanagers	STATUS und Kurzstatus für aktuelle private Kanäle des angegebenen Warteschlangenmanagers	STATUS und Kurzstatus für aktuelle private Kanäle aller aktiven Warteschlangenmanager
SHARED	STATUS und Kurzstatus für aktuelle gemeinsame Kanäle aller aktiven Warteschlangenmanager in einer Gruppe mit gemeinsamer Warteschlange	Nicht zugelassen	Nicht zugelassen
ALLE	STATUS und Kurzstatus für aktuelle private Kanäle des lokalen Warteschlangenmanagers und aktuelle gemeinsame Kanäle in der Gruppe mit gemeinsamer Warteschlange ( 5.a )	STATUS und Kurzstatus für aktuelle private Kanäle des angegebenen Warteschlangenmanagers	STATUS und Kurzstatus für aktuelle private und gemeinsame Kanäle aller aktiven Warteschlangenmanager in der Gruppe mit gemeinsamer Warteschlange ( 5.a )

Hinweis:

In diesem Fall erhalten Sie für diesen Befehl zwei Antwortsätze auf dem Warteschlangenmanager, auf dem der Befehl eingegeben wurde: Einen Satz für PRIVATE und einen anderen für SHARED.

Tabelle 3. CHLDISP und CMDSCOPE für DISPLAY CHSTATUS SAVED
CHLDISP	CMDSCOPE( ) oder CMDSCOPE (lokaler Warteschlangenmanager)	CMDSCOPE (Warteschlangenmanagername)	CMDSCOPE(*)
PRIVATE	Allgemeiner Status für gesicherte private Kanäle des lokalen Warteschlangenmanagers	Allgemeiner Status für gesicherte private Kanäle des angegebenen Warteschlangenmanagers	Allgemeiner Status für gesicherte private Kanäle aller aktiven Warteschlangenmanager
SHARED	Allgemeiner Status für gesicherte gemeinsame Kanäle aller aktiven Warteschlangenmanager in einer Gruppe mit gemeinsamer Warteschlange	Nicht zugelassen	Nicht zugelassen
ALLE	Allgemeiner Status für gesicherte private Kanäle des lokalen Warteschlangenmanagers sowie für gesicherte gemeinsame Kanäle in einer Gruppe mit gemeinsamer Warteschlange	Allgemeiner Status für gesicherte private Kanäle des angegebenen Warteschlangenmanagers	Allgemeiner Status für gesicherte private und gemeinsame Kanäle aller aktiven Warteschlangenmanager in einer Gruppe mit gemeinsamer Warteschlange

Parameterbeschreibungen für DISPLAY CHSTATUS

Die Angabe des Kanals, für den Statusinformationen angezeigt werden sollen, ist erforderlich. Dabei kann es sich um einen bestimmten oder einen generischen Kanalnamen handeln. Bei Verwendung eines generischen Kanalnamens kann Folgendes angezeigt werden: Statusinformationen für alle Kanäle oder Statusinformationen für einen oder mehrere Kanäle, die dem angegebenen Namen entsprechen.

Außerdem können Sie angeben, ob die aktuellen Statusinformationen (nur der aktuellen Kanäle) oder die gespeicherten Statusinformationen aller Kanäle angezeigt werden sollen.

Es werden die Statusinformationen aller Kanäle angezeigt, die den angegebenen Auswahlkriterien entsprechen; dabei spielt es keine Rolle, ob die Kanäle manuell oder automatisch erstellt wurden.

Die für den Kanalstatus verfügbaren Datenklassen sind gespeichert und aktuell [z/OS] und (nur unter z/OS ) kurz.

Bei den Statusfeldern für gesicherte Daten (den so genannten allgemeinen Statusfeldern) handelt es sich um eine Teilmenge der für die aktuellen Statusinformationen verfügbaren Felder. Hier sollten Sie beachten, dass bei diesen allgemeinen Datenfeldern die Felder zwar identisch sind, die Feldwerte jedoch für den gesicherten und den aktuellen Status unterschiedlich sein können. Bei den übrigen Feldern für aktuelle Daten handelt es sich um die so genannten aktuellen Statusfelder.

Gesicherte Daten setzen sich aus den im Syntaxdiagramm dargestellten allgemeinen Statusfeldern zusammen.
- Für einen sendenden Kanal werden die Daten vor Anforderung einer Bestätigung über den Empfang eines Nachrichtenstapels und bei Empfang einer Bestätigung aktualisiert.
- Für einen empfangenden Kanal werden die Daten unmittelbar vor der Bestätigung über den Empfang eines Nachrichtenstapels zurückgesetzt.
- Für Serververbindungskanäle werden keine Daten gespeichert.
- Daraus folgt, dass für Kanäle, für die noch keine aktuellen Statusdaten vorlagen, keine gesicherten Statusdaten zur Verfügung stehen.
  Hinweis: Der Status wird erst gespeichert, wenn eine persistente Nachricht über einen Kanal übertragen wird oder wenn eine nicht persistente Nachricht mit NPMSPEED von NORMAL übertragen wird. Da der Kanalstatus jeweils nach Abschluss eines Stapels gesichert wird, stehen Statusinformationen für einen Kanal erst nach der Übertragung von mindestens einem Stapel zur Verfügung.
Aktuelle Daten setzen sich aus den im Syntaxdiagramm dargestellten allgemeinen und aktuellen Statusfeldern zusammen. Die Datenfelder werden jeweils beim Empfang bzw. Senden einer Nachricht aktualisiert.
Kurzdaten bestehen aus dem aktuellen Datenelement STATUS und dem Kurzstatusfeld (siehe Syntaxdiagramm).

Aus dieser Vorgehensweise ergeben sich folgende Konsequenzen:

Für inaktive Kanäle sind unter Umständen keine gesicherten Statusdaten verfügbar; dies ist dann der Fall, wenn für diese Kanäle noch keine aktuellen Statusdaten vorlagen oder die gesicherten Statusdaten noch nicht zurückgesetzt wurden.
Die allgemeinen Datenfelder enthalten unter Umständen verschiedene Werte für den gesicherten bzw. aktuellen Status.
Für jeden aktiven Kanal liegen auf jeden Fall aktuelle und unter Umständen gesicherte Statusinformationen vor.

Kanäle können entweder aktuell oder inaktiv sein:

Aktive Kanäle

Dabei handelt es sich um Kanäle, die gestartet wurden, oder zu denen eine Clientverbindung aufgebaut wurde, die noch besteht. Dabei spielt es keine Rolle, ob bereits Nachrichten oder Daten übertragen wurden oder ob bereits eine Verbindung zum Partner hergestellt wurde. Für aktive Kanäle liegen aktuelle und unter Umständen auch gespeicherte Statusinformationen vor.

Der Begriff aktiv bezeichnet die Gruppe aktiver Kanäle, die noch nicht gestoppt wurden.

Inaktive Kanäle

Hier handelt es sich um Kanäle, die:

noch nicht gestartet wurden;
für die noch keine Clientverbindungen bestehen;
die beendet wurden;
bei denen die Verbindung ordnungsgemäß abgebaut wurde.

(Dabei sollten Sie beachten, dass das Stoppen eines Kanals nicht gleichbedeutend mit dessen ordnungsgemäßer Beendigung ist; er gilt weiterhin als aktiv.) Inaktive Kanäle haben entweder den Status gesichert oder überhaupt keinen Status.

Es ist möglich, dass mehrere Instanzen eines gleichnamigen Empfänger- oder Clusterempfängerkanals, eines Requesterkanals oder eines Kanals für Serververbindungen gleichzeitig aktiv sind (der Requesterkanal fungiert als Empfängerkanal). Dies ist der Fall, wenn mehrere Senderkanäle in verschiedenen Warteschlangenmanagern eine Sitzung mit diesem Empfänger initialisieren und dabei denselben Kanalnamen verwenden. Bei anderen Kanaltypen kann nur jeweils eine Instanz aktiv sein.

Für alle Kanaltypen können jedoch für den jeweiligen Kanalnamen mehrere gesicherte Datensätze mit Statusinformationen vorhanden sein. Dabei gibt nur jeweils ein Datensatz den aktuellen Kanalstatus wieder, bei den übrigen Datensätzen handelt es sich um die Statusinformationen von Kanalinstanzen, die zu einem früheren Zeitpunkt aktuell waren. Mehrere Kanalinstanzen liegen vor, wenn in Zusammenhang mit einem Kanal verschiedene Übertragungswarteschlangen oder Verbindungen verwendet wurden. Dies ist unter den folgenden Bedingungen der Fall:

Bei einem Sender oder Server:
- Wenn von verschiedenen Requestern eine Verbindung zu demselben Kanal hergestellt wurde (nur Server);
- Wenn der Name der Übertragungswarteschlange in der Definition geändert wurde;
- Wenn der Name der Verbindung in der Definition geändert wurde.
Bei einem Empfänger oder Requester:
- Wenn verschiedene Sender oder Server eine Verbindung zu demselben Kanal hergestellt haben;
- Wenn der Name der Verbindung in der Definition geändert wurde (bei Requester-Kanälen, die eine Verbindung initialisieren).

Die Anzahl der für jeden Kanal angezeigten Datensätze kann über die Angabe der Parameter XMITQ, CONNAME und CURRENT im Befehl begrenzt werden.

(generischer_Kanalname)

Gibt den Namen der Kanaldefinition an, für die Statusinformationen angezeigt werden sollen. Wird abschließend ein Stern (*) angegeben, werden alle Kanaldefinitionen mit demselben Namensstamm gefolgt von keinem oder mehr Zeichen erfasst. Wird nur ein Stern (*) angegeben, werden alle Kanaldefinitionen angezeigt. Für alle Kanaltypen muss ein Wert angegeben werden.

ORT

Gibt eine Filterbedingung an, sodass Statusinformationen nur für die Kanäle angezeigt werden, die den Auswahlkriterien dieser Filterbedingung entsprechen.

Die Filterbedingung setzt sich aus filter-keyword, operator und filter-value zusammen:

Filterschlüsselwort

Der Parameter, mit dem Attribute für diesen DISPLAY-Befehl angezeigt werden.

Folgende Parameter können auf verteilten Plattformen allerdings nicht als Filterschlüsselwörter angegeben werden: COMPRATE, COMPTIME, CURRENT, EXITTIME, JOBNAME, NETTIME, SAVED, SHORT, XBATCHSZ oder XQTIME.

Außerdem können unter z/OSdie folgenden Parameter nicht als Filterschlüsselwörter verwendet werden: CHLDISP, CMDSCOPE, MCASTAT oder MONITOR.

Wenn die Parameter CONNAME oder XMITQ zur Auswahl des Kanalstatus verwendet werden, können sie nicht auch als Filterschlüsselwörter angegeben werden.

Für Kanaltypen, für die das Filterschlüsselwort nicht gültig ist, werden keine Statusinformationen angezeigt.

Operator

Über den Operator wird festgelegt, ob ein Kanal dem Wert des angegebenen Filterschlüsselworts entspricht. Folgende Operatoren stehen zur Auswahl:

LT: Kleiner als
GT: Größer als
EQ: Gleich
NE: Ungleich
LE: Kleiner-gleich
GE: Größer-gleich
LK: Stimmt mit einer generischen Zeichenfolge überein, die als filter-value angegeben ist.
NL: Stimmt nicht mit einer generischen Zeichenfolge überein, die als filter-value angegeben ist.
CT: Enthält ein bestimmte Element. Wenn das filter-keyword eine Liste ist, können Sie mit diesem Operator Objekte anzeigen, deren Attribute das angegebene Element enthalten.
EX: Enthält das angegebene Element nicht. Wenn das filter-keyword eine Liste ist, können Sie mit diesem Operator Objekte anzeigen, deren Attribute das angegebene Element nicht enthalten.

Filter-Wert

Der Wert, mit dem das Attribut unter Verwendung des Operators verglichen werden muss. Je nach Filterschlüsselwort sind verschiedene Arten von Werten möglich:

Ein expliziter Wert, bei dem es sich um einen gültigen Wert für das Attribut handelt, das geprüft werden soll.
Für einen solchen Wert können nur die Operatoren LT, GT, EQ, NE, LE oder GE verwendet werden. Wenn es sich hier allerdings um einen von mehreren Attributwerten in einem Parameter handelt (beispielsweise 'SDR' im Parameter CHLTYPE), kann nur EQ oder NE angegeben werden.
Ein generischer Wert. Dabei handelt es sich um eine Zeichenfolge gefolgt von einem Stern, wie z. B. ABC*. Beim Operator LK werden alle Elemente aufgelistet, deren entsprechender Attributwert mit der Zeichenfolge beginnt (im Beispiel ABC). Beim Operator NL werden alle Elemente aufgelistet, deren entsprechender Attributwert nicht mit der Zeichenfolge beginnt. Erlaubt ist nur ein einziges abschließendes Platzhalterzeichen (Stern).
Bei Parametern mit numerischen Werten oder mit einem Wert einer Gruppe von möglichen Werten können Sie keinen generischen Filterwert verwenden.
Ein Element aus einer Liste von Werten. In diesem Fall müssen CT oder EX als Operator verwendet werden. Wird beispielsweise für den Wert DEF der Operator CT angegeben, werden alle Elemente aufgeführt, bei denen ein Attribut den Wert DEF hat.

ALLE

Gibt an, dass die Statusinformationen für alle betroffenen Instanzen angezeigt werden sollen.

Bei Angabe von SAVED werden nur gesicherte, keine aktuellen Statusinformationen angezeigt.

Bei Angabe dieses Parameters werden alle anderen Parameter, die spezifische Statusinformationen anfordern, ignoriert; es werden in jedem Fall alle Statusinformationen angezeigt.

CHLDISP

Dieser Parameter gilt nur für z/OS und gibt die Disposition der Kanäle an, für die Informationen angezeigt werden sollen, die in den Befehlen START und STOP CHANNEL verwendet werden, und nicht , die von QSGDISP für die Kanaldefinition festgelegt werden. Folgende Werte sind möglich:

All

Der Standardwert, mit dem die angeforderten Informationen zu privaten Kanälen angezeigt werden.

In einer Umgebung mit gemeinsamem Warteschlangenmanager werden mit dieser Option auch die angeforderten Statusinformationen zu gemeinsamen Kanälen angezeigt, wenn der Befehl auf dem Warteschlangenmanager ausgeführt wird, auf dem er abgesetzt wurde bzw. wenn der Parameter CURRENT angegeben wurde.

Privater

Zeigt die angeforderten Statusinformationen zu privaten Kanälen an.

SHARED

Zeigt die angeforderten Statusinformationen zu gemeinsamen Kanälen an. Dies ist nur nur in einer Umgebung mit gemeinsamer Warteschlange und unter einer der folgenden Voraussetzungen möglich:

Für CMDSCOPE erfolgt keine Angabe bzw. der lokalen Warteschlangenmanager wird angegeben
Bei Angabe von CURRENT

Mit CHLDISP werden folgende Werte angezeigt:

Privater: Der Status für private Kanäle.
SHARED: Der Status für gemeinsame Kanäle.
FIXSHARED: Der Status für einen gemeinsamen Kanal, der an einen bestimmten Warteschlangenmanager gebunden ist.

CMDSCOPE

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

' ': Dieser Befehl wird auf dem Warteschlangenmanager ausgeführt, auf dem er eingegeben wurde. Dies ist der Standardwert.
Warteschlangenmanagername: Der Befehl wird auf dem angegebenen Warteschlangenmanager ausgeführt, sofern dieser innerhalb der Gruppe mit gemeinsamer Warteschlange aktiv ist.
Sie können einen anderen Warteschlangenmanager angeben als den, auf dem der Befehl eingegeben wurde. Dazu muss allerdings der Befehlsserver aktiviert sein; außerdem ist dies nur in einer Umgebung möglich, in der Gruppen mit gemeinsamer Warteschlange unterstützt werden.
*: Der Befehl wird auf dem lokalen Warteschlangenmanager ausgeführt und darüber hinaus an jeden aktiven Warteschlangenmanager der Gruppe mit gemeinsamer Warteschlange weitergeleitet. Der Befehl wird dann auf den einzelnen Warteschlangenmanagern innerhalb der Gruppe mit gemeinsamer Warteschlange so ausgeführt, als wäre er dort eingegeben worden.

CMDSCOPE kann nicht als Filterschlüsselwort verwendet werden.

Hinweis: Die zulässigen Kombinationen von CHLDISP und CMDSCOPE finden Sie in Tabelle 1, Tabelle 2und Tabelle 3 .

CONNAME(verbindungsname)

Gibt für den angegebenen Kanal bzw. die angegebenen Kanäle die Verbindung an, zu der Statusinformationen angezeigt werden sollen.

Mit diesem Parameter kann die Anzahl der angezeigten Statusdatensätze begrenzt werden. Erfolgt keine Angabe, werden alle entsprechenden Datensätze angezeigt.

Der für CONNAME zurückgegebene Wert unterscheidet sich unter Umständen von dem in der Kanaldefinition angegebenen Wert; eventuell bestehen auch Unterschiede in den aktuellen und gesicherten Kanalstatusinformationen. (Eine Begrenzung der Anzahl der angezeigten Statusdatensätze sollte daher nicht über CONNAME erfolgen.)

So gilt beispielsweise bei Verwendung von TCP Folgendes:

Wurde in der Kanaldefinition für CONNAME kein Wert oder der Hostname angegeben, enthält der Kanalstatus die aufgelöste IP-Adresse.
Enthält die Portnummer. Der aktuelle Kanalstatuswert enthält die Portnummer (außer unter z/OS ), der gespeicherte Kanalstatuswert jedoch nicht.

Beim Status SAVED [z/OS] oder SHORT kann dieser Wert auch der Name des Warteschlangenmanagers oder der Gruppe mit gemeinsamer Warteschlange des fernen Systems sein.

AKTUELL

Dies ist die Standardeinstellung; dieser Parameter gibt an, dass nur die aktuellen Statusinformationen des Kanalinitiators für aktive Kanäle angezeigt werden.

Für aktive Kanäle können sowohl allgemeine als auch aktuelle Statusinformationen angefordert werden.

Die Kurzstatusinformationen werden bei Angabe dieses Parameters nicht angezeigt.

SAVED

Gibt an, dass gesicherte Statusinformationen für aktive und inaktive Kanäle angezeigt werden sollen.

Bei Angabe dieses Attributs werden nur gesicherte Statusinformationen angezeigt. Die Kurzstatusinformationen sowie aktuelle Statusinformationen werden bei Angabe dieses Parameters nicht angezeigt.

SHORT

Gibt an, dass nur Kurzstatusinformationen sowie das Element STATUS zu aktuellen Kanälen angezeigt werden sollen.

Bei Angabe dieses Parameters werden keine weiteren allgemeinen und aktuellen Statusinformationen angezeigt.

MONITOR

Dieser Parameter wird angegeben, wenn die Parameter für Onlineüberwachung zurückgegeben werden sollen. Dabei handelt es sich um die Parameter COMPRATE, COMPTIME, EXITTIME, MONCHL, NETTIME, XBATCHSZ, XQMSGSA und XQTIME. Bei Verwendung des Parameters MONITOR hat die Angabe bestimmter Überwachungsparameter keine Wirkung; es werden trotzdem alle Überwachungsparameter zurückgegeben.

XMITQ(q-name)

Gibt für den angegebenen Kanal bzw. die angegebenen Kanäle die Übertragungswarteschlange an, zu der Statusinformationen angezeigt werden sollen.

Mit diesem Parameter kann die Anzahl der angezeigten Statusdatensätze begrenzt werden. Erfolgt keine Angabe, werden alle entsprechenden Datensätze angezeigt.

Die folgenden Daten sind in allen Statusinformationen enthalten:

Der Kanalname
Der Name der Übertragungswarteschlange (für Sender- und Serverkanäle)
Der Name der Verbindung
Der Name des fernen Warteschlangenmanagers oder der Gruppe mit gemeinsamer Warteschlange (nur für den Status CURRENT sowie für alle Kanaltypen mit Ausnahme von Serververbindungskanälen)
Der Name der fernen Partneranwendung (für Serververbindungskanäle)
Der Typ der zurückgegebenen Statusinformationen (CURRENT oder SAVEDoder nur unter z/OS SHORT).
STATUS (außer SAVED unter z/OS )
Unter z/OS, CHLDISP
STOPREQ (nur für den aktuellen Status)
SUBSTATE

Wenn keine Parameter für die Anzeige spezifischer Statusinformationen angegeben werden (und nicht der Parameter ALL angegeben ist), werden keine weiteren Daten zurückgegeben.

Anforderungen von Statusinformationen, die für den angegebenen Kanaltyp nicht von Bedeutung sind, führen zu keiner Fehlermeldung.

Zusammenfassungsattribute

Wenn SUMMARY oder TOTAL zum WebSphere MQ-Scriptbefehl DISPLAY CHSTATUS hinzugefügt wird, wird die Dialoganzahl als Attribut CONVS angezeigt. Mit den folgenden Attributen wird bei Angabe von SUMMARY eine Zusammenfassung für jeden Kanal einzeln oder bei Angabe von TOTAL eine Zusammenfassung für alle Kanäle angezeigt.

ALLE

Gibt an, dass die Statusinformationen für alle betroffenen Instanzen angezeigt werden sollen. Dieses Attribut ist die Standardeinstellung, wenn keine Attribute angefordert wurden.

Bei Angabe von SAVED werden nur gesicherte, keine aktuellen Statusinformationen angezeigt.

Bei Angabe dieses Parameters werden alle anderen Parameter, die spezifische Statusinformationen anfordern, ignoriert; es werden in jedem Fall alle Statusinformationen angezeigt.

CURCNV

Die Anzahl der aktuellen Dialoge.

Allgemeine Statusfelder

Die folgenden Informationen sind in allen Kanalstatusdatensätzen enthalten, unabhängig davon, ob es sich um den aktuellen oder gesicherten Status handelt. Einige dieser Informationen gelten nicht für Serververbindungskanäle.

CHLTYPE

Der Kanaltyp. Folgende Werte sind möglich:

SDR: ein Senderkanal
SVR: Ein Serverkanal
RCVR: fein Empfängerkanal
RQSTR: Ein Requesterkanal
CLUSSDR: Ein Clustersenderkanal
CLUSRCVR: Ein Clusterempfängerkanal
SVRCONN: Ein Serververbindungskanal
AMQP: Ein AMQP-Kanal

CURLUWID

Gibt für einen Sender- oder Empfängerkanal die ID der logischen Arbeitseinheit an, die dem aktuellen Stapel zugeordnet ist.

Bei einem unbestätigten Senderkanal ist dies die LUWID dieses unbestätigten Stapels.

Für gesicherte Kanalinstanzen enthält dieser Parameter nur sinnvolle Informationen, wenn es sich um unbestätigte Kanalinstanzen handelt. Auf Anforderung wird dieser Parameterwert jedoch auf jeden Fall zurückgegeben, auch wenn es sich nicht um eine unbestätigte Kanalinstanz handelt.

Dieses Attribut wird durch die LUWID des nächsten Stapels überschrieben, sobald diese bekannt ist.

Dieser Parameter gilt nicht für Serververbindungskanäle.

AKTUELLUNGEN

Für einen Senderkanal gibt dieses Attribut die Anzahl der Nachrichten an, die in dem aktuellen Stapel übertragen wurden. Dieser Wert wird bei jeder übertragenen Nachricht entsprechend erhöht; handelt es sich um einen unbestätigten Kanal, gibt dieses Attribut die Anzahl der unbestätigten Nachrichten an.

Für einen Empfängerkanal gibt dieses Attribut die Anzahl der Nachrichten an, die in dem aktuellen Stapel empfangen wurden. Der Wert wird bei jeder empfangenen Nachricht erhöht.

Bei Festschreibung des Stapels wird dieser Wert für Sender- und Empfängerkanäle auf null zurückgesetzt.

Dieser Parameter gilt nicht für Serververbindungskanäle.

CURSEQNO

Für einen Senderkanal gibt dieses Attribut die Folgenummer der zuletzt übertragenen Nachricht an. Dieser Wert wird bei jeder übertragenen Nachricht erhöht; handelt es sich um einen unbestätigten Kanal, gibt dieses Attribut die Folgenummer der zuletzt übertragenen Nachricht in diesem unbestätigten Stapel an.

Für einen Empfängerkanal gibt dieses Attribut die Folgenummer der zuletzt empfangenen Nachricht an. Der Wert wird bei jeder empfangenen Nachricht erhöht.

Dieser Parameter gilt nicht für Serververbindungskanäle.

INDOUBT

Gibt an, ob der Kanal momentan unbestätigt ist.

Der Wert YES wird hier nur zurückgegeben, solange der sendende Nachrichtenkanalagent auf die Empfangsbestätigung für einen erfolgreich gesendeten Stapel wartet. Andernfalls wird NO zurückgegeben, auch für den Zeitraum, in dem Nachrichten gesendet wurden, jedoch noch keine Empfangsbestätigung angefordert wurde.

Für Empfängerkanäle wird immer der Wert NO zurückgegeben.

Dieser Parameter gilt nicht für Serververbindungskanäle.

LSTLUWID

Gibt die ID der logischen Arbeitseinheit an, die dem festgeschriebenen Nachrichtenstapel zugeordnet ist, der zuletzt übertragen wurde.

Dieser Parameter gilt nicht für Serververbindungskanäle.

LSTSEQNO

Gibt die Folgenummer der zuletzt gesendeten Nachricht in dem zuletzt festgeschriebenen Stapel an. Bei nicht permanenten Nachrichten, die unter Angabe von FAST für die Serviceklasse (NPMSPEED) übertragen werden, wird die Folgenummer nicht erhöht.

Dieser Parameter gilt nicht für Serververbindungskanäle.

STATUS

Der aktuelle Status des Kanals. Folgende Werte sind möglich:

BINDING

Vom Kanal wird gerade die Kanalvereinbarung durchgeführt; die Übertragung von Nachrichten ist in diesem Status noch nicht möglich.

INITIALISIERUNG

Der Kanalinitiator versucht, den Kanal zu starten.

Unter z/OSwird dies als INITIALIZI angezeigt.

PAUSED

Der Kanal wartet auf den Ablauf des Intervalls für die Nachrichtenwiederholung, um anschließend die Operation MQPUT zu wiederholen.

REQUESTING

Ein lokaler Requesterkanal fordert Services von einem fernen Nachrichtenkanalagenten an.

RETRYING

Ein vorangegangener Verbindungsversuch ist fehlgeschlagen. Der Nachrichtenkanalagent unternimmt nach Ablauf des angegebenen Zeitintervalls einen erneuten Verbindungsversuch.

RUNNING

Der Kanal ist momentan bei der Nachrichtenübertragung oder wartet auf den Eingang von Nachrichten in der Übertragungswarteschlange, um diese dann zu übertragen.

STARTING

Eine Anforderung zum Starten des Kanals wurde abgesetzt, der Kanal ist jedoch noch nicht aktiv. In diesem Status wartet der Kanal auf seine Aktivierung.

STOPPED

Dieser Status wird in den folgenden Fällen verursacht:

Der Kanal wurde manuell gestoppt.
Vom Benutzer wurde ein Stoppbefehl für den betreffenden Kanal eingegeben.
Die maximal zulässige Anzahl Nachrichtenwiederholungen wurde erreicht.
Vom Nachrichtenkanalagenten wurden die maximal möglichen Versuche zum Aufbau einer Verbindung ausgeführt. Es wird kein weiterer Versuch unternommen, eine Verbindung automatisch herzustellen.

Ein Kanal mit diesem Status kann erst nach Eingabe des Befehls START CHANNEL oder über den Start des Programms für den Nachrichtenkanalagenten (mit dem für das jeweilige Betriebssystem üblichen Verfahren) gestartet werden.

STOPPING

Der Kanal wird gerade beendet oder es wurde eine Schließanforderung empfangen.

SWITCHING

Der Kanal schaltet zwischen Übertragungswarteschlangen um.

[z/OS] Unter z/OSwird STATUS nicht angezeigt, wenn gespeicherte Daten angefordert werden.

Auf verteilten Plattformen wird im Feld STATUS in den gesicherten Daten der Status des Kanals zum Zeitpunkt des Schreibens des gesicherten Status zurückgegeben. Normalerweise lautet der Wert für den gesicherten Status RUNNING. Den aktuellen Status des Kanals kann der Benutzer mit dem Befehl DISPLAY CHSTATUS CURRENT anzeigen.

Anmerkung: Für einen inaktiven Kanal haben CURMSGS, CURSEQNO und CURLUWID nur dann aussagekräftige Informationen, wenn der Kanal INDOUBT ist. Auf Anforderung hin werden diese Informationen jedoch angezeigt.

Aktuelle Statusfelder

Die folgenden Statusdaten werden nur für aktuelle Kanalinstanzen zurückgegeben. Falls nicht anders angegeben, beziehen sie sich auf alle Kanaltypen.

AMQPKA

Die in Sekunden angegebene Keepalive-Zeit für einen AMQP-Kanal. Wenn der AMQP-Client innerhalb des Keepalive-Intervalls keine Frames gesendet hat, wird die Verbindung mit einemamqp:resource-limit-exceededAMQP-Fehlerbedingung.

Dieser Parameter ist nur für Kanäle vom Kanaltyp (CHLTYPE) AMQP gültig.

BATCHES

Gibt die Anzahl der bereits übertragenen Stapel in der aktuellen Sitzung (seit dem Kanalstart) an.

BATCHSZ

Die Stapelgröße für diese Sitzung.

Dieser Parameter gilt nicht für Kanäle für Serververbindungen; in diesem Fall werden keine Werte zurückgegeben; bei Angabe im Befehl wird er ignoriert.

BUFSRCVD

Gibt die Anzahl der empfangenen Übertragungspuffer an. Dazu gehören auch Übertragungen reiner Steuerinformationen.

BUFSSENT

Anzahl der gesendeten Übertragungspuffer. Dazu gehören auch Übertragungen reiner Steuerinformationen.

BYTSRCVD

Gibt die Anzahl Bytes an, die in der aktuellen Sitzung (seit dem Kanalstart) bereits empfangen wurden. Dazu gehören auch Steuerinformationen, die von dem Nachrichtenkanal empfangen wurden.

BYTSSENT

Gibt die Anzahl Bytes an, die in der aktuellen Sitzung (seit dem Kanalstart) bereits gesendet wurden. Dazu gehören auch Steuerinformationen, die von dem Nachrichtenkanal gesendet wurden.

CHSTADA

Gibt das Datum des Kanalstarts im Format JJJJ-MM-TT an. (Eventuell werden andere Formate unterstützt.)

CHSTATI

Gibt den Zeitpunkt des Kanalstarts an (im Format hh.mm.ss).

COMPHDR

Das Komprimierungsverfahren für die im Kanal gesendeten Headerdaten. Zwei Werte werden angezeigt:

Der für diesen Kanal vereinbarte Standardwert für die Komprimierung von Headerdaten.
Der Wert der Headerdatenkomprimierung, der für die zuletzt gesendete Nachricht verwendet wird. Dieser Wert kann im Nachrichtenexit der Senderkanäle geändert werden. Wurde keine Nachricht gesendet, bleibt der zweite Wert leer.

COMPMSG

Das Komprimierungsverfahren für die im Kanal gesendeten Nachrichtendaten. Zwei Werte werden angezeigt:

Der für diesen Kanal vereinbarte Standardwert für die Komprimierung von Nachrichtendaten.
Der Wert der Nachrichtendatenkomprimierung, der für die zuletzt gesendete Nachricht verwendet wird. Dieser Wert kann im Nachrichtenexit der Senderkanäle geändert werden. Wurde keine Nachricht gesendet, bleibt der zweite Wert leer.

COMPRATE

Die erreichte Komprimierungsrate, angezeigt als Prozentsatz, d. h., eine Rate von 25 bedeutet, dass Nachrichten auf 75% ihrer ursprünglichen Länge komprimiert werden.

Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Diese Werte werden bei jedem Start des Kanals zurückgesetzt und nur angezeigt, wenn der Kanalstatus (STATUS) auf RUNNING gesetzt ist. Werden keine Überwachungsdaten erfasst oder keine Nachrichten im Kanal gesendet, bleiben beide Werte leer.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

COMPTIME

Gibt an, wie viel Zeit (in Millisekunden) die Komprimierung bzw. Dekomprimierung für jede Nachricht in Anspruch nimmt. Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Hinweis: Unter z/OSist COMPTIME die Zeit für jede Nachricht, sofern die Nachricht nicht in Segmenten verarbeitet werden muss.

Diese Segmentierung der Nachricht unter z/OS tritt auf, wenn die Nachricht wie folgt lautet:

32 KB oder größer ist oder
16 KB oder größer und der Kanal SSL-verschlüsselt ist.

Wenn die Nachricht in Segmente aufgeteilt wird, ist COMPTIME die Zeit für die Komprimierung jedes einzelnen Segments. Dies bedeutet, dass für eine Nachricht, die in acht Segmente aufgeteilt ist, tatsächlich (COMPTIME * 8) Mikrosekunden für die Komprimierung bzw. Dekomprimierung benötigt werden.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

CURSHCNV

Der Wert CURSHCNV ist für alle Kanaltypen außer Serververbindungskanälen leer. Für jede Instanz eines Serververbindungskanals liefert die Ausgabe CURSHCNV einen Zähler der Anzahl an Datenaustauschvorgängen, die derzeit über die betreffende Kanalinstanz ausgeführt werden.

Der Wert null gibt an, dass der Kanal wie in den Versionen von IBM MQ vor Version 7.0ausgeführt wird, was Folgendes betrifft:

Administratorstop-quiesce
Überwachungssignal wird gesendet
Vorauslesen
Gemeinsamer Datenaustausch
Asynchrone Clientverarbeitung

EXITTIME

Gibt an (in Mikrosekunden), wie lange die Verarbeitung von Benutzerexits pro Nachricht dauert. Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Diese Werte hängen von der Konfiguration und dem Verhalten des Systems sowie von der jeweiligen Systemaktivität ab; sie dienen als Indikator dafür, dass das System ordnungsgemäß arbeitet. Erhebliche Schwankungen dieser Werte können ein Hinweis auf Probleme im System sein. Diese Werte werden bei jedem Start des Kanals zurückgesetzt und nur angezeigt, wenn der Kanalstatus (STATUS) auf RUNNING gesetzt ist.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

HBINT

Gibt für die aktuelle Sitzung das Intervall für Überwachungssignale an.

JOBNAME

Ein Name, der den MQ-Prozess identifiziert, der den Kanal gegenwärtig bereitstellt und betreibt.

Auf IBM i-, Windows-, UNIX-und Linux -Systemen ist dieser Name die Verkettung der Prozess-ID und der Thread-ID des MCA-Programms, die im Hexadezimalformat angezeigt wird.

[z/OS] Diese Informationen sind unter z/OSnicht verfügbar. Falls der Parameter angegeben ist, wird er ignoriert.

[z/OS] Sie können JOBNAME nicht als Filterschlüsselwort unter z/OSverwenden.

KAINT

Das KeepAlive-Intervall für diese Sitzung. Dies gilt nur unter z/OS.

LOCLADDR

Gibt die lokale Kommunikationsadresse für den Kanal an. Der zurückgegebene Wert hängt von dem Wert für TRPTYPE des Kanals ab (derzeit wird nur TCP/IP unterstützt).

LONGRTS

Gibt die noch mögliche Anzahl von Startversuchen bei langen Wiederholungsintervallen an. Gilt nur für Sender- oder Serverkanäle.

LSTMSGDA

Gibt das Datum an, an dem die letzte Nachricht gesendet oder der letzte MQI-Aufruf ausgeführt wurde (siehe LSTMSGTI).

LSTMSGTI

Gibt den Zeitpunkt an, zu dem die letzte Nachricht gesendet oder der letzte MQI-Aufruf ausgeführt wurde.

Für einen Sender- oder Serverkanal ist dies der Zeitpunkt, zu dem die letzte Nachricht (bzw. im Falle einer Segmentierung das letzte Nachrichtensegment) gesendet wurde. Für einen Requester- oder Empfängerkanal ist dies der Zeitpunkt, zu dem die letzte Nachricht in die entsprechende Bestimmungswarteschlange gestellt wurde. Für einen Serververbindungskanal ist dies der Zeitpunkt, zu dem der letzte MQI-Aufruf abgeschlossen wurde.

Im Fall einer Serververbindungskanalinstanz, auf der Dialoge gemeinsam genutzt werden, ist dies die Zeit, wenn der letzte MQI-Aufruf auf allen Dialogen auf der Kanalinstanz aktiv ist.

MAXMSGL

Die maximale Nachrichtenlänge, die für diese Sitzung verwendet wird (nur unter z/OS gültig)

MAXSHCNV

Der Wert MAXSHCNV ist für alle Kanaltypen außer Serververbindungskanälen leer. Für jede Instanz eines Serververbindungskanals liefert die Ausgabe MAXSHCNV die vereinbarte maximale Anzahl an Datenaustauschvorgängen, die über die betreffende Kanalinstanz ausgeführt werden können.

Der Wert null gibt an, dass der Kanal wie in den Versionen von IBM MQ vor Version 7.0ausgeführt wird, was Folgendes betrifft:

Administratorstop-quiesce
Überwachungssignal wird gesendet
Vorauslesen
Gemeinsamer Datenaustausch
Asynchrone Clientverarbeitung

MCASTAT

Gibt an, ob der Nachrichtenkanalagent momentan aktiv ist. Mögliche Werte sind 'aktiv' ('running') oder 'inaktiv' ('not running').

Es ist durchaus möglich, dass ein Kanal sich im Stoppstatus befindet, das Programm jedoch nach wie vor aktiv ist.

Unter z/OS ist diese Information nicht verfügbar. Falls der Parameter angegeben ist, wird er ignoriert.

Unter z/OSkann MCASTAT nicht als Filterschlüsselwort verwendet werden.

MCAUSER

Die vom Nachrichtenkanalagenten (MCA = Message Channel Agent) verwendete Benutzer-ID. Dabei kann es sich um die in der Kanaldefinition festgelegte Benutzer-ID, die Standard-Benutzer-ID für Nachrichtenkanäle, eine vom Client übertragene Benutzer-ID (bei Serververbindungskanälen) oder um eine von einem Sicherheitsexit angegebene Benutzer-ID handeln.

Dieser Parameter gilt nur für Serververbindungs-, Empfänger- und Clusterempfängerkanäle sowie für Requester-Kanäle.

Auf Serververbindungskanälen, die Dialoge gemeinsam nutzen, enthält das Feld MCAUSER eine Benutzer-ID, wenn alle Dialoge den gleichen MCA-Benutzer-ID-Wert haben. Wenn die MCA-Benutzer-ID in Benutzung in verschiedenen Dialogen unterschiedlich ist, enthält das Feld MCAUSER einen Wert von *.

Auf verteilten Plattformen beträgt die maximale Länge 64 Zeichen.

[z/OS] Die maximale Länge unter z/OS beträgt 12 Zeichen.

MONCHL

Der aktuelle Umfang an Überwachungsdaten, die für den Kanal erfasst werden.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

MSGS

Die Anzahl der gesendeten oder empfangenen Nachrichten (oder für Serververbindungskanäle die Anzahl der verarbeiteten MQI-Aufrufe) während dieser Sitzung (seit dem Kanalstart).

Im Fall einer Serververbindungsinstanz, auf der Dialoge gemeinsam genutzt werden, ist dies die Gesamtzahl von MQI-Aufrufen, die auf allen Dialogen, die auf der Kanalinstanz aktiv sind, gesteuert werden.

NETTIME

Gibt an, wie lange es dauert (in Mikrosekunden), um eine Anforderung an das ferne Ende des Kanals zu senden und eine Antwort zu empfangen. Diese Zeit berücksichtigt nur die Netzübertragungszeit für solch eine Operation. Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Dieser Parameter gilt nur für Sender-, Server- und Clustersenderkanäle.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

NPMSPEED

Gibt die Behandlungsmethode für nicht permanente Nachrichten an, die in der aktuellen Sitzung verwendet wird.

PORT

Die Portnummer, die für die Verbindung eines AMQP-Kanals verwendet wird. Der Standardport für AMQP 1.0-Verbindungen ist 5672.

RAPPLTAG

Der Name der fernen Partneranwendung. Hierbei handelt es sich um den Namen der Clientanwendung am fernen Ende des Kanals. Er gilt nur für Serververbindungskanäle.

Hinweis: Wenn mehrere IBM MQ Verbindungen dieselbe Kanalinstanz verwenden, d. h., der Kanal mit SHARECNV > 1 definiert ist und derselbe Prozess mehrere Verbindungen zum Warteschlangenmanager herstellt, wenn die Verbindungen unterschiedliche Anwendungsnamen angeben, wird im Feld RAPPLTAG ein Stern angezeigt: RAPPLTAG(*).

RPRODUCT

Die ID des fernen Partnerprodukts. Dies ist die Produkt-ID des IBM MQ -Codes, der am fernen Ende des Kanals ausgeführt wird. Die möglichen Werte sind in Tabelle 4aufgeführt.

Tabelle 4. Werte für Produkt-ID
Produkt-ID	Beschreibung
MQMM	Warteschlangenmanager auf einer verteilten Plattform
MQMV	Warteschlangenmanager unter z/OS
MQCC	IBM MQ C-Client
MQNC	IBM MQ -Client für HP Integrity NonStop Server
MQNM	Vollständig verwalteter IBM MQ .NET -Client
MQJB	IBM MQ Klassen für Java
MQJM	IBM MQ Klassen für JMS (normaler Modus)
MQJN	IBM MQ Classes for JMS (Migrationsmodus)
MQJU	Einheitliche Java-Schnittstelle für MQI
MQXC	XMS-Client für C/C++ (normaler Modus)
MQXD	XMS-Client für C/C++ (Migrationsmodus)
MQXN	XMS -Client .NET (normaler Modus)
MQXM	XMS -Client .NET (Migrationsmodus)
MQXU	IBM MQ .NET XMS -Client (nicht verwaltet/XA)
MQNU	Nicht verwalteter IBM MQ .NET-Client

RQMNAME

Bei diesem Wert handelt es sich um den Namen des Warteschlangenmanagers oder der Gruppe mit gemeinsamer Warteschlange im fernen System. Dieser Parameter gilt nicht für Serververbindungskanäle.

RVERSION

Die Version des fernen Partners. Dies ist die Version des IBM MQ -Codes, der am fernen Ende des Kanals ausgeführt wird.

Die ferne Version wird als VVRRMMFF angezeigt:

VV: Version
RR: Release
MM: Wartungsstufe
FF: Fixversion

SECPROT

Definiert das aktuell verwendete Sicherheitsprotokoll.

Gilt nicht für Clientverbindungskanäle.

Automatisch auf der Basis des Werts festlegen, den Sie für SSLCIPH in DEFINE CHANNELfestgelegt haben.

Mögliche Werte:

KEINE: Kein Sicherheitsprotokoll
SSLV3: SSL Version 3.0
TLSV1: TLS Version 1.0
TLSV12: TLS Version 1.2

[z/OS] SECPROT ist unter z/OSnicht verfügbar.

SHORTRTS

Gibt die noch mögliche Anzahl von Startversuchen bei kurzen Wiederholungsintervallen an. Gilt nur für Sender- oder Serverkanäle.

SSLCERTI

Der vollständig definierte Name des Ausstellers des fernen Zertifikats. Bei dem Aussteller handelt es sich um die Zertifizierungsstelle, von der das Zertifikat ausgegeben wurde.

Die maximal zulässige Länge beträgt 256 Zeichen. Diese Begrenzung kann dazu führen, dass außergewöhnlich lange registrierte Namen abgeschnitten werden.

SSLCERTU

Die lokale Benutzer-ID, die dem fernen Zertifikat zugeordnet ist. Dies gilt nur unter z/OS .

SSLKEYDA

Das Datum, an dem der geheime SSL-Schlüssel zuletzt erfolgreich zurückgesetzt wurde.

SSLKEYTI

Die Uhrzeit, zu der der geheime SSL-Schlüssel zuletzt erfolgreich zurückgesetzt wurde.

SSLPEER

Definierter Name des Partner-Warteschlangenmanagers oder -Clients am anderen Ende des Kanals.

Die maximal zulässige Länge beträgt 256 Zeichen. Diese Begrenzung kann dazu führen, dass außergewöhnlich lange registrierte Namen abgeschnitten werden.

SSLRKEYS

Gibt an, wie oft der SSL-Schlüssel erfolgreich zurückgesetzt wurde. Der Zähler der Rückstellungen geheimer SSL-Schlüssel wird bei der Beendigung der Kanalinstanz zurückgesetzt.

STOPREQ

Gibt an, ob eine Stoppanforderung eines Benutzers ansteht. Mögliche Werte sind YES oder NO.

SUBSTATE

Die Aktion, die bei Eingabe dieses Befehls vom Kanal ausgeführt wird. Die folgenden Unterzustände werden in der Reihenfolge ihrer Vorrangstellung aufgelistet, wobei der Unterzustand mit dem höchsten Vorrang zuerst genannt wird:

ENDBATCH: Der Kanal ist bei der Stapelendeverarbeitung.
SENDEN: Das Kommunikationssubsystem wurde aufgefordert, Daten zu senden.
RECEIVE: Das Kommunikationssubsystem wurde aufgefordert, Daten zu empfangen.
SERIALISIEREN: Der Kanal serialisiert die Zugriffe auf den Warteschlangenmanager. Nur zulässig unter z/OS.
RESYNCH: Der Kanal führt eine Neusynchronisation mit dem Partner durch.
HEARTBEAT: Der Kanal tauscht Überwachungssignale mit dem Partner aus.
SCYEXIT: Der Kanal führt den Sicherheitsexit aus.
RCVEXIT: Der Kanal führt einen der Empfangsexits aus.
SENDEXIT: Der Kanal führt einen der Sendeexits aus.
MSGEXIT: Der Kanal führt einen der Nachrichtenexits aus.
MREXIT: Der Kanal führt den Exit für Nachrichtenwiederholung aus.
CHADEXIT: Der Kanal ist über den Exit für die automatische Kanaldefinition aktiv.
NETZVERBIND: Das Kommunikationssubsystem wurde aufgefordert, eine Verbindung zu einem Partnersystem herzustellen.
SSLHANDSHK: Der Kanal verarbeitet gerade einen SSL-Handshake.
NAMESERVER: An den Namensserver wurde eine Anforderung gesendet.
MQPUT: Der Warteschlangenmanager wurde aufgefordert, eine Nachricht in die Zielwarteschlange einzureihen.
MQGet: Der Warteschlangenmanager wurde aufgefordert, eine Nachricht aus der Übertragungswarteschlange (wenn es sich um einen Nachrichtenkanal handelt) oder aus einer Anwendungswarteschlange (wenn es sich um einen MQI-Kanal handelt) abzurufen.
MQICALL: Es wird ein MQ-API-Aufruf ausgeführt, bei dem es sich nicht um einen MQPUT- oder MQGET-Vorgang handelt.
COMPRESS: Der Kanal komprimiert oder extrahiert Daten.

Nicht alle diese Teilstatus sind für jeden Kanaltyp oder Kanalstatus zulässig. Es gibt Fälle, in denen kein Teilstatus zulässig ist und in denen ein Leerwert zurückgegeben wird.

Für Kanäle, die mit mehreren Threads ausgeführt werden, wird mit diesem Parameter der Teilstatus angezeigt, der absoluten Vorrang hat.

TPROOT

Der Themen-Root für einen AMQP-Kanal. Der Standardwert für TPROOT ist SYSTEM.BASE.TOPIC. Bei diesem Wert weist die Themenzeichenfolge, die von einem AMQP-Client für die Veröffentlichung oder Subskription verwendet wird, kein Präfix auf und der Client kann Nachrichten mit anderen MQ-Publish/Subscribe-Anwendungen austauschen. Damit AMQP-Clients unter einem Themenpräfix Veröffentlichungen und Subskriptionen vornehmen können, müssen Sie zunächst ein MQ-Themenobjekt mit einer Themenzeichenfolge erstellen, die mit dem gewünschten Präfix festgelegt wird. Anschließend müssen Sie TPROOT auf den Namen des von Ihnen erstellten MQ-Themenobjekts setzen.

Dieser Parameter ist nur für Kanäle vom Kanaltyp (CHLTYPE) AMQP gültig.

XBATCHSZ

Größe der über den Kanal übertragenen Chargen. Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Diese Werte hängen von der Konfiguration und dem Verhalten des Systems sowie von der jeweiligen Systemaktivität ab; sie dienen als Indikator dafür, dass das System ordnungsgemäß arbeitet. Eine wesentliche Abweichung bei diesen Werten kann auf einen Fehler in Ihrem System hinweisen. Diese Werte werden bei jedem Start des Kanals zurückgesetzt und nur angezeigt, wenn der Kanalstatus (STATUS) auf RUNNING gesetzt ist.

Dieser Parameter gilt nicht für Serververbindungskanäle.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

USECLTID

Gibt an, dass anstelle des MCAUSER-Attributwerts die Client-ID für Berechtigungsprüfungen bei einem AMQP-Kanal verwendet werden soll.

XQMSGSA

Die Anzahl der Nachrichten in der Übertragungswarteschlange, die für MQGET-Aufrufe des Kanals zur Verfügung stehen.

Der höchste Wert, der mit diesem Parameter angezeigt werden kann, ist 999. Wenn die Anzahl der verfügbaren Nachrichten 999 übersteigt, wird der Wert 999 angezeigt.

[z/OS] Unter z/OSwird dieser Wert leer angezeigt, wenn die Übertragungswarteschlange nicht von CorrelIdindexiert wurde.

Dieser Parameter gilt nur für Clustersenderkanäle.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

XQTIME

Gibt an (in Mikrosekunden), wie lange Nachrichten in der Übertragungswarteschlange verblieben, bevor sie abgerufen wurden. Die Zeit wird vom Einreihen der Nachricht in die Übertragungswarteschlange bis zu ihrem Abruf, um über den Kanal gesendet zu werden, gerechnet; daher enthält dieser Zeitwert auch Zeitintervalle, die durch Verzögerungen in der Anwendung, die den PUT-Vorgang durchführt, entstanden sind.

Zwei Werte werden angezeigt:

Der erste Wert basiert auf der letzten Aktivität über eines kurzen Zeitraum.
Der zweite Wert basiert auf der letzten Aktivität über einen längeren Zeitraum.

Diese Werte hängen von der Konfiguration und dem Verhalten des Systems sowie von der jeweiligen Systemaktivität ab; sie dienen als Indikator dafür, dass das System ordnungsgemäß arbeitet. Eine wesentliche Abweichung bei diesen Werten kann auf einen Fehler in Ihrem System hinweisen. Diese Werte werden bei jedem Start des Kanals zurückgesetzt und nur angezeigt, wenn der Kanalstatus (STATUS) auf RUNNING gesetzt ist.

Dieser Parameter gilt nur für Sender-, Server- und Clustersenderkanäle.

Dieser Parameter wird auch angezeigt, wenn Sie den Parameter MONITOR angeben.

Für diesen Parameter wird nur dann ein Wert angezeigt, wenn MONCHL für den vorliegenden Kanal gesetzt ist. Siehe Überwachungswerte festlegen.

Kurzstatus

Die folgenden Statusdaten werden nur für aktuelle Kanalinstanzen zurückgegeben.

QMNAME: Der Name des Warteschlangenmanagers, der als Eigner der Kanalinstanz festgelegt ist.

Überwachungswerte einstellen

Bei automatisch definierten Clustersenderkanälen werden diese mit dem Warteschlangenmanager-Parameter MONACLS gesteuert. Weitere Informationen finden Sie unter ALTER QMGR . Automatisch definierte Clustersenderkanäle können nicht angezeigt oder geändert werden. Sie können jedoch ihren Status abrufen oder den Befehl DISPLAY CLUSQMGR ausgeben, wie unter Mit automatisch definierten Clustersenderkanälen arbeitenbeschrieben.

Bei anderen Kanälen, einschließlich manuell definierter Clustersenderkanäle, werden diese mit dem Kanalparameter MONCHL gesteuert. Weitere Informationen finden Sie unter ALTER CHANNEL .