[z/OS]

Aus WebSphere Application Server in CICS importierte Transaktionen überwachen

Informationen zu diesem Vorgang

Wenn eine Anforderung von einer Komponente von WebSphere Application Server, die in einer globalen Transaktion ausgeführt wird, an einen CICS-Link-Server abgesetzt wird, der mit dem Parameter "TXN=Y" gestartet wurde, wird die globale Transaktion an CICS weitergeleitet.

Es wird eine neue Verzweigung der Transaktion von CICS erstellt, bei der WebSphere als Koordinator und CICS untergeordnete Instanz agieren. CICS definiert die Gesamtdarstellung der Transaktionsverzweigung als Arbeitseinheit (UOW, Unit of Work) und die Darstellung des Koordinators als Arbeitseinheitenlink (UOWLINK).

Der CICS-Link-Server markiert den UOWLINK so, dass er von anderen UOWLINKS auf dem System unterschieden und zum ursprünglichen WebSphere-Server sowie zur Registrierung des optimierten lokalen Adapters, der für die Erstellung der Verzweigung verwendet wurde, zurückverfolgt werden kann.

Die folgenden Felder werden im UOWLINK definiert:
  • Rolle

    Wird auf Koordinator gesetzt, da WebSphere das Ergebnis der Gesamt-UOW koordiniert.

  • Typ

    Wird auf IIOP gesetzt. Der IIOP-Koordinator und das Ressourcenmodell stellen die Beziehung zwischen dem WebSphere-Koordinator und der untergeordneten CICS-Instanz am besten dar.

  • Host
    Wird auf eine Zeichenfolge gesetzt, die den koordinierenden WebSphere-Server beschreibt. Die Zeichenfolgensyntax ist wie folgt:
    WOLA:<DGN>/<NDN>/<SVN>:<RGN>
    DGN steht für den Namen der Dämongruppe, NDN für den Kurznamen des Knotens und SVN für den Serverkurznamen des WebSphere Application Server, der die Transaktion koordiniert. RGN steht für den Registernamen des Link-Servers, der für die Erstellung der Transaktionsverzweigung verwendet wird.
    Beispiel:
    WOLA:SY1/SY1/BBOS001:MYLINKSERVER
    Dieser Wert gibt an, dass der WebSphere-Server BBOS001 auf dem Knoten SY1 und in der Dämongruppe SY1 die Transaktion eingeleitet hat, die dann über den Link-Server MYLINKSERVER in CICS importiert wurde.

Sie können den Status dieser untergeordneten CICS-Verzweigungen mit den APIs EXEC CICS INQUIRE UOW und EXEC CICS INQUIRE UOWLINK in einem CICS-Programm überwachen.

Die von CICS bereitgestellte CEMT-Transaktion verwendet diese APIs, um die UOWs anzuzeigen, die CICS derzeit bekannt sind. Sie können Informationen über eine bestimmte UOW abfragen, wenn während der Verarbeitung des Synchronisationspunkts ein Fehler auftritt. Ein Beispiel für diese Situation ist die abnormale Beendigung der Task, die die CICS-UOW ausführt, während sich die globale Transaktion in einem unbestätigten Status oder zwischen Phase 1 und Phase 2 der zweiphasigen Festschreibung befindet. Im Folgenden sehen eine Beispielausgabe der CEMT-Transaktion INQUIRE UOW:
| INQUIRE UOW                                                                 |
| STATUS:  RESULTS - OVERTYPE TO MODIFY                                       |
|  Uow(C5B2837D664B4D25) Inf Act Tra(CSOL) Tas(0000003)                       |
|     Age(00000373)                          Use(CICSUSER)                    |
|  Uow(C5B2837DCB24B56B) Inf Act Tra(CSSY) Tas(0000005)                       |
|     Age(00000373)                          Use(CICSUSER)                    |
|  Uow(C5B2837DCB2B046B) Inf Act Tra(CSSY) Tas(0000006)                       |
|     Age(00000373)                          Use(CICSUSER)                    |
|  Uow(C5B2837DDE3D9C96) Inf Act Tra(CSTP) Tas(0000008)                       |
|     Age(00000373)                          Use(CICSUSER)                    |
|  Uow(C5B28380EF477F93) Inf Act Tra(CSHQ) Tas(0000020)                       |
|     Age(00000370)                          Use(CICSUSER)                    |
|  Uow(C5B2839DD76D01D5) Inf Act Tra(CSNE) Tas(0000021)                       |
|     Age(00000339)                          Use(CICSUSER)                    |
|  Uow(C5B284C7C4C9535B) Inf Act Tra(OLAT) Tas(0000043)                       |
|     Age(00000027) Ter(L320) Netn(L320    ) Use(CICSUSER)                    |
|  Uow(C5B284C7C81DB991) Inf Act Tra(BBO$) Tas(0000044)                       |
|     Age(00000027)                          Use(CICSUSER)                    |
|+ Uow(C5B284C82EAF3BE0) Ind Shu Tra(BBO#) Tas(0000047)                       |
|     Age(00000026)                          Use(CICSUSER)                    |
|                                                                             |
|                                                  SYSID=CICS APPLID=CICSHTH3 |
|  RESPONSE: NORMAL                          TIME:  14.13.08  DATE: 03.18.10  |
|PF 1 HELP       3 END       5 VAR     7 SBH 8 SFH 9 MSG 10 SB 11 SF
In diesem Beispiel befindet sich die UOW C5B284C82EAF3BE0 in einem unbestätigten Status (dargestellt durch die Abkürzung "Ind" (für In-doubt)), und ist darüber hinaus verzögert (dargestellt durch die Abkürzung "Shu" (für Shunted)). Eine UOW ist verzögert, weil die Task, die die UOW ausführt, nicht mehr verfügbar ist, z. B., weil sie abnormal beendet wurde oder weil die UOW von einer vorherigen CICS-Instanz übrig geblieben ist. Platzieren Sie den Cursor auf dieser UOW, und drücken Sie dann die Eingabetaste, um weitere Details zur UOW anzuzeigen, z. B. die folgenden:
| INQUIRE UOW                                                                 |
| RESULT - OVERTYPE TO MODIFY                                                 |
|   Uow(C5B284C82EAF3BE0)                                                     |
|   Uowstate( Indoubt )                                                       |
|   Waitstate(Shunted)                                                        |
|   Transid(BBO#)                                                             |
|   Taskid(0000047)                                                           |
|   Age(00000047)                                                             |
|   Termid()                                                                  |
|   Netname()                                                                 |
|   Userid(CICSUSER)                                                          |
|   Waitcause()                                                               |
|   Link()                                                                    |
|   Sysid()                                                                   |
|   Netuowid(..MCLNT2L.CICSHTH3.dH......) |
|   Otstid(.......O.b...... .Ep6E3.S....m.............O.b...... .Ep6E3.S....) |
|   Otstid(m..........................) |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                  SYSID=CICS APPLID=CICSHTH3 |
|                                            TIME:  14.13.28  DATE: 03.18.10  |
|PF 1 HELP 2 HEX 3 END       5 VAR        7 SBH 8 SFH       10 SB 11 SF  
Achtung: Die Transaktions-ID ist BBO#. Dies ist die Standardtransaktions-ID für die CICS-Link-Task. Um festzustellen, warum die UOW in einem unbestätigten Status verbleibt, können Sie die UOWLINK-Objekte für diese UOW untersuchen, um festzustellen, ob ein Koordinator vorhanden ist. Im Folgenden sehen Sie eine Beispielausgabe für CEMT INQUIRE UOWLINK:
| INQUIRE UOWLINK                                                             |
| STATUS:  RESULTS - OVERTYPE TO MODIFY                                       |
|  Uowl(01020001) Uow(C5B284C7C4C9535B) Rmi Lin(BBOATRUE)                     |
|     Unk                                   Net(..MCLNT2L.L320.dGDI........)  |
|  Uowl(01030001) Uow(C5B284C7C81DB991) Rmi Lin(BBOATRUE)                     |
|     Unk                                   Net(..MCLNT2L.CICSHTH3.dGH.....)  |
|  Uowl(01010003) Uow(C5B284C82EAF3BE0) Rmi Lin(BBOATRUE)                     |
|     Sub                                   Net(..MCLNT2L.CICSHTH3.dH......)  |
|  Uowl(01040001) Uow(C5B284C82EAF3BE0) Iio                                   |
|     Coo Ots                              Net(..MCLNT2L.CICSHTH3.dH......)   |
|  Uowl(01000002) Uow(C5B284E2AEAA9951) Rmi Lin(BBOATRUE)                     |
|     Unk                                   Net(..MCLNT2L.CICSHTH3.dS..r...)  |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                  SYSID=CICS APPLID=CICSHTH3 |
|  RESPONSE: NORMAL                          TIME:  14.13.38  DATE: 03.18.10  |
|PF 1 HELP       3 END       5 VAR        7 SBH 8 SFH 9 MSG 10 SB 11 SF  		 |
Für UOW C5B284C82EAF3BE0 gibt es einen einzigen UOWLINK. Dieser Link ist ein Link des Typs IIOP, der durch die Abkürzung "Iio" dargestellt wird, und ein OTS-Koordinator-Link, der durch die Abkürzung "Coo Ots" dargestellt wird. Platzieren Sie den Cursor auf dem UOWLINK, und drücken Sie dann die Eingabetaste, um Details wie die folgenden für diesen UOWLINK anzuzeigen:
|
| INQUIRE UOWLINK                                                             |
| RESULT - OVERTYPE TO MODIFY                                  NOT FOUND      |
|   Uowlink(01040001)                                                         |
|   Uow(C3F5C2F2F8F4C3F8)                                                     |
|   Type(Iiop)                                                                |
|   Link()                                                                    |
|   Action(              )                                                    |
|   Role(Coordinator)                                                         |
|   Protocol(Ots)                                                             |
|   Resyncstatus()                                                            |
|   Sysid()                                                                   |
|   Rmiqfy()                                                                  |
|   Netuowid(..MCLNT2L.CICSHTH3.dH......) |
|   Urid()                                                                    |
|   Host(WOLA:PLEX1/SY1/BBOS001:OLASERVER)                                    |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                                             |
|                                                  SYSID=CICS APPLID=CICSHTH3 |
|                                            TIME:  14.13.46  DATE: 03.18.10  |
|PF 1 HELP 2 HEX 3 END       5 VAR        7 SBH 8 SFH       10 SB 11 SF       |
Achtung: In dieser Anzeige wurde das Feld "Uow()" von EBCDIC-Text in die entsprechende hexadezimale Darstellung konvertiert und entspricht somit nicht der vorherigen Anzeige, z. B. C3=C, F5=5 und C2=B. Der Host, der den Koordinator darstellt, ist WOLA:PLEX1/SY1/BBOS001:OLASERVER. Dies zeigt an, dass der Koordinator WOLA bzw. WebSphere Optimized Local Adapters ist. Der Server, mit dem Sie verbunden sind, ist BBOS001 auf dem Knoten SY1 in der Dämongruppe PLEX1. Der Name der Registrierung, die zum Erstellen dieser Transaktion verwendet wurde, ist OLASERVER. Diese UOW muss auf die Bereitstellung des Ergebnisses durch den Server BBOS001 warten.
Weitere Informationen zur CEMT-Transaktion finden Sie im Artikel zu den CEMT-INQUIRE-Befehlen im Information Center von CICS Transaction Server for z/OS Version 4.1. Weitere Informationen zu den API-Befehlen EXEC CICS INQUIRE UOW und EXEC CICS INQUIRE UOWLINK finden sie im Artikel zu den Systembefehlen im Information Center von CICS Transaction Server for z/OS Version 4.1.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_monitortrans
Dateiname:tdat_monitortrans.html