[z/OS]

Surveillance des transactions importées de WebSphere Application Server vers CICS

Pourquoi et quand exécuter cette tâche

Lorsqu'une requête est lancée d'un composant WebSphere Application Server exécuté dans une transaction globale vers un serveur de lien CICS démarré avec le paramètre TXN=Y, la transaction globale est propagée vers CICS.

Une nouvelle branche de la transaction est créée par CICS, avec WebSphere servant de coordinateur et CICS de subordonné. La représentation globale de la branche de transaction est définie par CICS comme une unité de travail (UOW) et la représentation du coordinateur est définie par CICS comme unité de lien de travail (UOWLINK).

Le serveur de lien CICS marque le lien UOWLINK de façon à le différencier des autres liens UOWLINKS du système et à le tracer à nouveau vers le serveur WebSphere d'origine, ainsi que l'enregistrement de l'adaptateur local optimisé utilisé pour créer la branche.

Les zones suivantes sont définies dans UOWLINK :
  • Rôle

    Paramétrez sur coordinator car WebSphere coordonne le résultat de l'unité de travail globale.

  • Type

    Paramétrez sur IIOP. Le coordinateur IIOP et le modèle de ressource représentent au mieux la relation entre le coordinateur WebSphere et le subordonné CICS.

  • Host
    Paramétrez sur une chaîne décrivant le serveur WebSphere de coordination. La syntaxe de la chaîne est la suivante :
    WOLA:<DGN>/<NDN>/<SVN>:<RGN>
    où DGN est le nom de groupe du démon, NDN est le nom abrégé du noeud et SVN est le nom abrégé du serveur du serveur WebSphere Application Server coordonnant la transaction. RGN est le nom de registre du serveur de lien utilisé pour créer la branche de transaction.
    Dans l'exemple suivant, une valeur :
    WOLA:SY1/SY1/BBOS001:MYLINKSERVER
    indique que le serveur WebSphere, BBOS001, du noeud SY1 et du groupe de démon SY1, a initialisé la transaction et a été importé dans CICS à l'aide du serveur de lien MYLINKSERVER.

Vous pouvez contrôler le statut de ces branches subordonnées CICS à l'aide des API EXEC CICS INQUIRE UOW et EXEC CICS INQUIRE UOWLINK d'un programme CICS.

La transaction CEMT fournie par CICS utilise ces API pour afficher les unités de travail actuellement connues de CICS. Vous pouvez effectuer une enquête sur une unité de travail particulière si une erreur s'est produite au cours du traitement de point de synchronisation. Un exemple de ce cas se présente si la tâche exécutant CICS UOW est abandonnée lorsque la transaction globale est in-doubt ou entre la phase 1 et la phase 2 de la validation en deux phases. Exemple de sortie de la transaction CEMT 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
Dans cet exemple, UOW C5B284C82EAF3BE0 est in-doubt (représenté par l'abréviation "Ind") et est également shunted (représenté par l'abréviation "Shu"). Une unité de travail est dérivée car la tâche qui l'exécute n'est plus disponible, soit parce qu'elle est abandonnée, soit parce que l'unité de travail est récupérée d'une instance CICS précédente. Placez le curseur sur cette unité de travail et cliquez sur Entrée pour afficher plus de détails sur l'unité de travail, comme indiqué :
| 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  
Avertissement : L'ID de transaction est BBO# qui correspond à l'ID de transaction par défaut pour la tâche de lien CICS. Afin de déterminer pourquoi l'unité de travail reste in-doubt, vous pouvez étudier les objets UOWLINK de cette unité de travail afin de savoir si le coordinateur est présent. L'exemple suivant est la sortie de 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  		 |
Pour l'unité de travail C5B284C82EAF3BE0, il existe un seul lien UOWLINK. Il s'agit d'un lien de type IIOP représenté par l'abréviation "Iio" et d'un lien de coordinateur OTS représenté l'abréviation "Coo Ots". Placez le curseur sur UOWLINK et cliquez sur Entrée pour afficher des informations détaillées sur ce lien UOWLINK, comme indiqué ci-dessous :
|
| 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       |
Avertissement : Sur cet écran, la zone Uow() provient du texte EBCDIC et est transformée dans sa représentation hexadécimale de telle sorte qu'elle ne correspond pas à l'écran précédent, par exemple, C3=C, F5=5 et C2=B. L'hôte représentant le coordinateur est WOLA:PLEX1/SY1/BBOS001:OLASERVER. Cela indique que le coordinateur est WOLA ou WebSphere Optimized Local Adapters. Le serveur auquel nous sommes connectés est BBOS001, dans le noeud SY1 du groupe de démons PLEX1. Le nom de l'enregistrement utilisé pour créer cette branche de transaction est OLASERVER. L'unité de travail doit attendre le serveur BBOS001 pour fournir le résultat de cette unité de travail.
Pour plus d'informations concernant la transaction CEMT, voir la rubrique des commandes CEMT INQUIRE dans le centre de documentation CICS Transaction Server for z/OS, version 4.1. Pour plus d'informations sur les commandes EXEC CICS INQUIRE UOW et EXEC CICS INQUIRE UOWLINK API, voir les rubriques System Commands du centre de documentation CICS Transaction Server for z/OS, version 4.1

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_monitortrans
Nom du fichier : tdat_monitortrans.html