Eigenschaften von Anwendungsverbindungen
Die Eigenschaften für Anwendungsverbindungen werden im Dialog mit den Eigenschaften für Anwendungsverbindungen angezeigt. Die Werte dieser Eigenschaften können nicht bearbeitet werden.
In den folgenden Tabellen werden alle Eigenschaften aufgeführt, die für Anwendungsverbindungen festgelegt werden können.
Die Bedeutung der einzelnen Eigenschaften wird jeweils kurz beschrieben. In der Tabelle werden auch die entsprechenden MQSC-Parameter für den Befehl DISPLAY CONN aufgeführt. 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 auf der Seite Allgemein im Dialog mit den Eigenschaften der Anwendungsverbindung aufgeführt.
Eigenschaft | Bedeutung | MQSC-Parameter |
---|---|---|
Anwendungsname | Eine Zeichenfolge mit der Kennung der Anwendung, die mit mit dem Warteschlangenmanager verbunden ist. Dies ist einer der folgenden Werte: ein z/OS® -Stapeljobname, eine TSO-Benutzer-ID, eine CICS® -Anwendungs-ID (APPLID), ein IMS -Regionsname, ein Kanalinitiatorjobname, ein OS/400® -Jobname, ein Linux® -oder AIX® -Prozess, ein Windows -Prozess. Der Anwendungsname repräsentiert den Namen des Prozesses oder Jobs, der mit dem Warteschlangenmanager verbunden ist. Falls dieser Prozess bzw. Job über einen Kanal mit dem Warteschlangenmanager verbunden ist, repräsentiert der Anwendungsname den fernen Prozess bzw. Job statt des lokalen Kanalprozesses oder Jobnamens. | APPLTAG |
Anwendungstyp | Eine Zeichenfolge, die den Typ der mit dem Warteschlangenmanager verbundenen Anwendung angibt. Batch gibt eine Anwendung an, die eine Stapelverbindung verwendet; RRSBATCH gibt eine RRS-koordinierte Anwendung an, die eine Stapelverbindung verwendet; CICS gibt eine CICS-Transaktion an; IMS gibt eine IMS-Transaktion an; CHINIT gibt einen Kanalinitiator an; System gibt einen Warteschlangenmanager an; User gibt eine Benutzeranwendung an. |
APPLTYPE |
Prozess-ID | Die ID des Prozesses, von dem die Warteschlange geöffnet wurde. Diese Eigenschaft ist unter z/OSnicht gültig. | Prozess-ID |
Thread-ID | Die ID des Threads innerhalb des Anwendungsprozesses, von dem die Warteschlange geöffnet wurde. Ein Stern gibt an, dass diese Warteschlange mit einer gemeinsamen Verbindung geöffnet wurde. Diese Eigenschaft ist unter z/OSnicht gültig. | TID |
Benutzer-ID | Die Benutzer-ID, die der internen Kennung zugeordnet ist. | USERID |
Optionen | Hierbei handelt es sich um die Verbindungsoptionen, die derzeit von dieser Anwendungsverbindung verwendet werden. | CONNOPTS |
Kanalname | Der Name des Kanals, der Eigner der Kennung ist. Wenn der internen Kennung kein Kanal zugeordnet ist, bleibt dieser Wert leer. Dieser Wert wird nur angezeigt, wenn die Kennung zum Kanalinitiator gehört. | CHANNEL |
Verbindungsname | Der Verbindungsname, der dem Kanal zugeordnet ist, dem die interne Kennung gehört. Wenn der internen Kennung kein Kanal zugeordnet ist, bleibt dieser Wert leer. Dieser Wert wird nur angezeigt, wenn die Kennung zum Kanalinitiator gehört. | CONNAME |
PSB-Name | Der aus acht Zeichen bestehende Name des Programmspezifikationsblocks (PSB), der der aktiven IMS-Transaktion zugeordnet ist. | PSBNAME |
Verbindungs-ID | Dies ist die aus 24 Byte bestehende eindeutige Verbindungs-ID, mit der IBM MQ eine Anwendung zuverlässig identifizieren kann. Wenn die Anwendung zuerst eine Verbindung zum WS-Manager herstellt, legt der WS-Manager die Verbindungs-ID fest. | CONN und EXTCONN |
Seite 'Arbeitseinheit'
In der folgenden Tabelle werden die Eigenschaften auf der Seite 'Arbeitseinheit' im Dialog mit den Eigenschaften der Anwendungsverbindung aufgeführt. Die Seite 'Arbeitseinheit' enthält Informationen, die zu der Arbeitseinheit verfügbar sind, die der ausgewählten Verbindung zugeordnet ist.
Eigenschaft | Bedeutung | MQSC-Parameter |
---|---|---|
Art der Arbeitseinheit | Gibt an, um was für eine Art Wiederherstellungseinheit es sich aus Sicht des Warteschlangenmanagers handelt. Hierbei handelt es sich um einen der folgenden Werte: CICS (nur z/OS ), XA , RRS (nur z/OS ), IMS (nur z/OS ), Queue manager . |
URTYPE |
Startdatum der Arbeitseinheit | Hierbei handelt es sich um das Datum, an dem die der Verbindung zugeordnete Transaktion gestartet wurde. | UOWSTDA |
Startzeit der Arbeitseinheit | Hierbei handelt es sich um den Zeitpunkt, an dem die der Verbindung zugeordnete Transaktion gestartet wurde. | UOWSTTI |
ID der ursprünglichen Arbeitseinheit | Die ID der Arbeitseinheit mit Wiederherstellung, die vom Ersteller zugeordnet wurde. Sie besteht aus einem 8-Byte-Wert. | NID |
Ursprungsname | Identifiziert den Ersteller des Threads. Dies trifft nicht zu, wenn die Eigenschaft Anwendungstyp auf RRSBATCH gesetzt ist, da in dem Fall der Name nicht angegeben wird. | NID |
Name des Protokollspeicherbereichs | Hierbei handelt es sich um den Dateinamen des Protokollspeicherbereichs, in den die Transaktion, die dieser Verbindung zugeordnet ist, erstmalig Daten geschrieben hat. | UOWLOG |
Datum des ersten Protokollzugriffs | Hierbei handelt es sich um das Datum, an dem die der Verbindung zugeordnete Transaktion zum ersten Mal Daten in das Protokoll geschrieben hat. | UOWLOGDA |
Uhrzeit des ersten Protokollzugriffs | Hierbei handelt es sich um die Uhrzeit, zu der die der Verbindung zugeordnete Transaktion zum ersten Mal Daten in das Protokoll geschrieben hat. | UOWLOGTI |
Arbeitseinheitenstatus | Der Status der Arbeitseinheit. None bedeutet, dass es keine Arbeitseinheit gibt. Active bedeutet, dass die Arbeitseinheit aktiv ist. Prepared bedeutet, dass die Arbeitseinheit gerade festgeschrieben wird. Unresolved bedeutet, dass sich die Arbeitseinheit in der zweiten Phase einer zweiphasigen Festschreibungsoperation befindet, wobei IBM MQ Ressourcen für sie bereithält und ein externer Eingriff erforderlich ist, um eine Auflösung herbeizuführen. Hierbei kann es sich um eine einfache Intervention handeln wie den Start des Wiederherstellungskoordinators (beispielsweise CICS, IMS oder RRS), oder es kann sich um einen komplexeren Vorgang handeln wie beispielsweise die Verwendung des Befehls RESOLVE INDOUBT. Der Wert Unresolved kann nur bei z/OS vorkommen. |
UOWSTATE |
ID der Warteschlangenmanager-Arbeitseinheit | Die vom Warteschlangenmanager zugeordnete Arbeitseinheit mit Wiederherstellung. Unter z/OS handelt es sich hierbei um eine Protokoll-RBA mit 8 Byte, auf anderen Plattformen um eine Transaktions-ID mit 8 Byte, die in Form von 16 hexadezimalen Zeichen angezeigt wird. | QMURID |
ID für externe Arbeitseinheit | Die ID der externen Wiederherstellungseinheit, die der Verbindung zugeordnet ist. Dabei handelt es sich um die Wiederherstellungs-ID, die im externen Synchronisationspunktkoordinator bekannt ist. Ihr Format wird durch den Wert der Eigenschaft UOW
type bestimmt. |
EXTURID |
Asynchroner Status | Der Status des asynchronen Konsumenten dieser Objektkennung. Es gibt fünf gültige Werte: Aktiv: Ein MQCB-Aufruf hat eine Funktion eingerichtet, um einen Rückruf für die asynchrone Verarbeitung von Nachrichten durchzuführen, und die Verbindungskennung wurde gestartet, damit die asynchrone Nachrichtenverarbeitung stattfinden kann. Inaktiv: Ein MQCB-Aufruf hat eine Funktion eingerichtet, um einen Rückruf für die asynchrone Verarbeitung von Nachrichten durchzuführen, doch die Verbindungskennung wurde noch nicht gestartet, sodass eine asynchrone Nachrichtenverarbeitung noch nicht stattfinden kann.Ausgesetzt: Der asynchrone Verarbeitungsrückruf wurde ausgesetzt, sodass die asynchrone Nachrichtenverarbeitung momentan nicht mit diesem Objekthandle fortfahren kann. Die Aussetzung wurde entweder vom System initiiert oder von einer Anwendung, die für diese Objektkennung einen MQCB-Aufruf mit der Operation MQOP_SUSPEND ausgegeben hat. Wurde der Rückruf vom System ausgesetzt, wird die Rückruffunktion als Teil des Aussetzungsprozesses der asynchronen Nachrichtenverarbeitung mit einem Ursachencode aufgerufen, der das Problem beschreibt, das zu der Aussetzung geführt hat. Dieser Ursachencode ist im Feld Reason (Ursache) der MQCBC-Struktur enthalten, die an die Rückruffunktion übergeben wird. Damit die asynchrone Nachrichtenverarbeitung fortgesetzt werden kann, muss die Anwendung einen MQCB-Aufruf ausgeben, wobei der Parameter 'Operation' auf MQOP_RESUME gesetzt ist. |
ASTATE |
Vorläufig ausgesetzt: Der asynchrone Verarbeitungsrückruf wurde vom System vorübergehend ausgesetzt, sodass die asynchrone Nachrichtenverarbeitung momentan nicht mit diesem Objekthandle fortfahren kann. Als Teil des Aussetzungsprozesses der asynchronen Nachrichtenverarbeitung wird die Rückruffunktion mit dem Ursachencode aufgerufen, der das Problem beschreibt, das zu der Aussetzung geführt hat. Dieser Ursachencode ist im Feld Reason (Ursache) der MQCBC-Struktur enthalten, die an die Rückruffunktion übergeben wird. Die Callback-Funktion wird wieder aufgerufen, sobald die temporäre Fehlerbedingung behoben ist und die asynchrone Nachrichtenverarbeitung wieder vom System aufgenommen wurde. Keine: Für diese Kennung wurde kein MQCB-Aufruf ausgegeben, also wird für diese Kennung keine asynchrone Nachrichtenverarbeitung konfiguriert. Dies ist der Standardwert. |
||
Disposition der Arbeitseinheit mit Wiederherstellung | (nur z/OS) Mithilfe dieses Parameters wird die Liste der zurückgegebenen Verbindungen gefiltert. Es kann aus drei Optionen ausgewählt werden:
|
URDISP |
Seite 'Kennung'
In der folgenden Tabelle werden die Eigenschaften auf der Seite Kennung im Dialog mit den Eigenschaften der Anwendungsverbindung aufgeführt. Die Seite Kennung enthält Informationen zu dem Objekt, das von der ausgewählten Anwendung geöffnet wurde.
Eigenschaft | Bedeutung | MQSC-Parameter |
---|---|---|
Verbindungs-ID | Dies ist die aus 24 Byte bestehende eindeutige Verbindungs-ID, mit der IBM MQ eine Anwendung zuverlässig identifizieren kann. Wenn die Anwendung zuerst eine Verbindung zum WS-Manager herstellt, legt der WS-Manager die Verbindungs-ID fest. | CONN und EXTCONN |
Objektname | Der Name des von der Verbindung geöffneten Objekts. | OBJNAME |
Objekttyp | Dies ist der Typ des Objekts, das die Verbindung geöffnet hat. Beispiel: Queue , Channel , Storage
Class . |
OBJTYPE |
Öffnungsoptionen | Hierbei handelt es sich um Optionen, die von der Verbindung zum Öffnen des Objekts verwendet werden.
|
OPENOPTS |
|
||
QSG-Disposition | Schreibgeschützt. Die Disposition der Gruppe mit gemeinsamer Warteschlange des Objekts. Queue
manager bedeutet, dass die Objektdefinition nur für den Warteschlangenmanager verfügbar ist, der sie hostet. Group bedeutet, dass die Objektdefinition im gemeinsam genutzten 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 des Warteschlangenmanagers einer Definition im gemeinsamen Repository handelt. Shared bedeutet, dass die Objektdefinition in der Coupling-Facility der Gruppe mit gemeinsamer Warteschlange gespeichert ist und allen Warteschlangenmanagern in der Gruppe mit gemeinsamer Warteschlange zur Verfügung steht. |
QSGDISP |
Kennungsstatus | Der aktuelle Status der Kennung. Aktiv bedeutet, über diese Verbindung wird derzeit ein API-Aufruf für dieses Objekt durchgeführt. Handelt es sich bei dem Objekt um eine Warteschlange, ergibt sich diese Bedingung bei einem MQGET WAIT-Vorgang. Ein ausstehendes MQGET-Signal an und für sich bedeutet nicht, dass die Kennung aktiv ist. Inaktiv bedeutet, über diese Verbindung wird derzeit kein API-Aufruf für dieses Objekt durchgeführt. Handelt es sich bei dem Objekt um eine Warteschlange, ergibt sich diese Bedingung, wenn kein MQGET WAIT-Vorgang aktiv ist. | HSTATE |
Themenzeichenfolge | Die aufgelöste Artikelzeichenfolge. Dieser Parameter ist relevant für Kennungen mit OBJTYPE(TOPIC). Für alle anderen Objekttypen ist dieser Parameter nicht belegt. | TOPICSTR |
Name der Subskription | Der dieser Kennung zugeordnete, eindeutige Subskriptionsname der Anwendung. Dieser Parameter ist nur relevant für Kennungen von Subskriptionen zu Themen. Nicht alle Subskriptionen haben einen Subskriptionsnamen. | SUBNAME |
Subskriptions-ID | Die interne, für immer eindeutige Kennung der Subskription. Dieser Parameter ist nur relevant für Kennungen von Subskriptionen zu Themen. Nicht alle Subskriptionen werden in DISPLAY CONN angezeigt, sondern nur solche, die aktuelle Kennungen offen zur Subskription haben. Sie können den Befehl DISPLAY SUB verwenden, um alle Subskriptionen zu sehen. | SUBID |
Ziel-Warteschlangenmanager | Die Zielwarteschlange für Nachrichten, die zu dieser Subskription veröffentlicht werden. Dieser Parameter ist nur relevant für Kennungen von Subskriptionen zu Themen. Wenn DEST eine Warteschlange ist, die auf dem lokalen Warteschlangenmanager per Hosting bereitgestellt wird, wird dieser Parameter den lokalen Warteschlangenmanager-Namen enthalten. Wenn DEST eine Warteschlange ist, die auf einem fernen Warteschlangenmanager per Hosting bereitgestellt wird, enthält dieser Parameter den Namen des fernen Warteschlangenmanagers. | DESTQMGR |
Name des Ziels | Die Zielwarteschlange für Nachrichten, die zu dieser Subskription veröffentlicht werden. Dieser Parameter ist nur für Kennungen von Themensubskriptionen relevant. | DEST |
Asynchroner Status | Der Status des asynchronen Konsumenten dieser Objektkennung. Es gibt fünf gültige Werte: Aktiv: Ein MQCB-Aufruf hat eine Funktion eingerichtet, um einen Rückruf für die asynchrone Verarbeitung von Nachrichten durchzuführen, und die Verbindungskennung wurde gestartet, damit die asynchrone Nachrichtenverarbeitung stattfinden kann. Inaktiv: Ein MQCB-Aufruf hat eine Funktion eingerichtet, um einen Rückruf für die asynchrone Verarbeitung von Nachrichten durchzuführen, doch die Verbindungskennung wurde noch nicht gestartet, sodass eine asynchrone Nachrichtenverarbeitung noch nicht stattfinden kann.Ausgesetzt: Der asynchrone Verarbeitungsrückruf wurde ausgesetzt, sodass die asynchrone Nachrichtenverarbeitung momentan nicht mit diesem Objekthandle fortfahren kann. Die Aussetzung wurde entweder vom System initiiert oder von einer Anwendung, die für diese Objektkennung einen MQCB-Aufruf mit der Operation MQOP_SUSPEND ausgegeben hat. Wurde der Rückruf vom System ausgesetzt, wird die Rückruffunktion als Teil des Aussetzungsprozesses der asynchronen Nachrichtenverarbeitung mit einem Ursachencode aufgerufen, der das Problem beschreibt, das zu der Aussetzung geführt hat. Dieser Ursachencode ist im Feld Reason (Ursache) der MQCBC-Struktur enthalten, die an die Rückruffunktion übergeben wird. Damit die asynchrone Nachrichtenverarbeitung fortgesetzt werden kann, muss die Anwendung einen MQCB-Aufruf ausgeben, wobei der Parameter 'Operation' auf MQOP_RESUME gesetzt ist. |
ASTATE |
Vorläufig ausgesetzt: Der asynchrone Verarbeitungsrückruf wurde vom System vorübergehend ausgesetzt, sodass die asynchrone Nachrichtenverarbeitung momentan nicht mit diesem Objekthandle fortfahren kann. Als Teil des Aussetzungsprozesses der asynchronen Nachrichtenverarbeitung wird die Rückruffunktion mit dem Ursachencode aufgerufen, der das Problem beschreibt, das zu der Aussetzung geführt hat. Dieser Ursachencode ist im Feld Reason (Ursache) der MQCBC-Struktur enthalten, die an die Rückruffunktion übergeben wird. Die Callback-Funktion wird wieder aufgerufen, sobald die temporäre Fehlerbedingung behoben ist und die asynchrone Nachrichtenverarbeitung wieder vom System aufgenommen wurde. Keine: Für diese Kennung wurde kein MQCB-Aufruf ausgegeben, also wird für diese Kennung keine asynchrone Nachrichtenverarbeitung konfiguriert. Dies ist der Standardwert. |
||
Vorauslesen | Der Vorauslesestatus der Verbindung. Es gibt vier gültige Werte: Nein: Für dieses Objekt ist das Vorauslesen nicht persistenter Nachrichten nicht aktiviert. Dies ist der Standardwert. Ja: Für dieses Objekt ist das Vorauslesen nicht persistenter Nachrichten aktiviert und wird auf effiziente Weise genutzt.Rückstand: Für dieses Objekt ist das Vorauslesen nicht persistenter Nachrichten aktiviert. Vorauslesen wird nicht effizient genutzt, weil dem Client eine große Anzahl von Nachrichten gesendet wurden, die nicht gelesen werden. Unterdrückt: Von der Anwendung wurde Vorauslesen angefordert, doch es wurde unterdrückt, weil im ersten MQGET-Aufruf inkompatible Optionen angegeben wurden. |
READA |