![[z/OS]](../images/ngzos.gif)
Gestion des demandes de distribution
Utilisez le DPM (dispatch progress monitor) pour assembler à intervalle de temps régulier, des données relatives à la demande de distribution si cette dernière est toujours en cours de traitement une fois l'intervalle de temps écoulé. Une fois les données rassemblées, un nouvel intervalle de temps commence. De même que pour l'intervalle de temps précédent, quand ce nouvel intervalle est écoulé, les données sont de nouveau rassemblées. Aussi longtemps que le DPM est activé, et que la demande est en cours d'exécution dans le serviteur, les données continuent d'être rassemblées à la fin de chaque intervalle de temps.
Avant de commencer
- Déterminez le type de protocole que vous souhaitez utiliser pour surveiller les demandes. Vous pouvez configurer DPM pour rassembler les données des demandes qui utilisent les protocoles IIOP, HTTP, HTTPS, MDB, SIP, ou SIPS. Vous pouvez aussi configurer DPM afin de collecter les données pour les demandes provenant de l'adaptateur CRA et qui sont dirigées via le contrôleur pour la mise en file d'attente sur un serviteur.
- Déterminez la fréquence à laquelle DPM doit collecter les données de chaque demande. Par exemple, vous pouvez vouloir ne rassembler que les données des demandes à traitement long. Si tel est le cas, définissez l'intervalle sur une longueur de temps suffisante pour empêcher que les données des demandes qui se terminent rapidement, soient collectées.
- Déterminez le type de données que DPM doit collecter à la fin de chaque intervalle. Vous pouvez configurer DPM pour prendre un cliché SVC, un cliché Java™ core, un cliché de tas, un Java Tdump, ou pour collecter des données de trace.
Pourquoi et quand exécuter cette tâche
Si DPM n'est pas activé pour le protocole utilisé par une demande, tel que le protocole HTTP ou IIOP, lorsque la demande est distribuée dans le serviteur, DPM ne surveille pas cette demande. Même si vous effectuez la commande modify pour activer dynamiquement DPM pour ce protocole, une fois la demande distribuée, DPM ne surveille pas la demande. Une fois DPM activé pour un protocole, DPM ne surveille que les nouvelles demandes qui utilisent ce protocole.
L'intervalle DPM et l'action de cliché sont initialement obtenus à partir du fichier de classification WLM. La commande DPM modify remplace ces valeurs sur la totalité du serveur. La réinitialisation de l'intervalle DPM ou de l'action de cliché désactive le remplacement de sorte que les valeurs des paramètres de réinitialisation proviennent à nouveau du fichier de classification WLM.
Si DPM est activé pour le protocole utilisé par une demande, avant que cette demande ne soit distribuée dans le serviteur, vous pouvez modifier dynamiquement l'intervalle de temps spécifié et l'opération de cliché que vous souhaitez effectuer. Toute modification dynamique réalisée prend effet à la fin de l'intervalle en cours d'une demande distribuée, et commence avec le premier intervalle pour les nouvelles demandes.
Procédure
f server,dpm,[IIOP=nnn | HTTP=nnn | HTTPS=nnn
| MDB=nnn | CRA=nnn | SIP=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn
| dump_action=xxx | clear_all | reset_all]
- La marque de réservation nnn spécifie en secondes la longueur de l'intervalle de temps pour un type de protocole spécifique ou une demande CRA. La valeur de la marque de réservation nnn doit être un nombre entier compris entre 0 et 255, ou reset. La valeur 0 signifie qu'aucun intervalle n'est défini pour le protocole et que DPM est désactivé pour les demandes qui font appel à lui. La valeur reset signifie que le contrôle de l'intervalle DPM est renvoyé au fichier de classification WLM.
- Les valeurs valides pour la marque de réservation xxx sont SVCDUMP, JAVACORE, HEAPDUMP, TRACEBACK, JAVATDUMP, NONE ou RESET. La valeur RESET signifie que le contrôle de l'action dump est renvoyé au fichier de classification WLM.
- Une valeur affectée au paramètre INTERVAL définit l'intervalle DPM à la même valeur pour les six protocoles.
- La valeur clear_all définit l'intervalle de temps à 0 et l'action de cliché à None pour tous les protocoles de demande associés.
- La valeur reset_all réinitialise tous les intervalles DPM et les paramètres dump_action. Le contrôle des intervalles DPM et de l'action de cliché sont renvoyés au fichier de classification WLM.
Quand vous spécifiez une valeur autre que zéro pour un ou plusieurs protocoles associés à DMP, vous activez automatiquement cette fonctionnalité pour ces protocoles. Pour désactiver DPM pour un protocole spécifique, définissez le paramètre de ce protocole sur 0. Pour désactiver DPM pour tous les protocoles associés à DPM, définissez le paramètre dump_action sur NONE. Ce paramètre remplace toute valeur spécifiée pour le paramètre d'un protocole spécifique.
Résultats
Quand DPM est activé pour un protocole et que les données de suivi sont collectées, à la fin de l'intervalle de temps, des données similaires à l'exemple suivant sont consignées dans le fichier journal de votre serveur :
BossLog: { 0175} 2008/05/05 12:16:01.418 01 SYSTEM=SY1 SERVER=BBOS001
PID=0X00010144 TID=0X00000034 0XF6FAF20 c=./bbgrjtr.cpp at line:+885 ...
BBOJ0118I: ThreadDetails: ASID = 005B, TCB = 0X008CBE88, Request = fffff503,
Is JVM Blocked = false, Tried to interrupt = false, Given up = false,
Internal Work Thread = false, Hung Reason = Not Hung,
SR Dispatch Time = 2008/05/05 12:15:31.371625,
CTL Receive Time = 2008/05/05 12:15:31.366693,
CTL Queued to WLM Time = 2008/05/05 12:15:31.371328,
Details = , ODI Details = .JVM INTERRUPTIBLE THREAD, Monitor ACTIVE.
BossLog: { 0176} 2008/05/05 12:16:01.423 01 SYSTEM=SY1 SERVER=BBOS001 PID=0X00010144
TID=0X00000034 0XF6F9DE0 c=./bbgrjtr.cpp at line:+885 ...
BBOJ0117I: JAVA THREAD STACK TRACEBACK FOR THREAD WebSphere:ORB.thread.pool t=008cbe88:
Dispatch Progress Monitor
Traceback for thread WebSphere:ORB.thread.pool t=008cbe88:
com.ibm.ws390.orb.ClientDelegate.invokeRequestCFW(Native Method)
com.ibm.ws390.orb.ClientDelegate.commonInvoke(ClientDelegate.java:998)
com.ibm.ws390.orb.ClientDelegate.invoke(ClientDelegate.java:845)
org.omg.CORBA.portable.ObjectImpl._invoke(ObjectImpl.java:484)
com.ejb.test.hello.second._SayHelloSecondHome_Stub.create(_SayHelloSecondHome_Stub.java:207)
com.ejb.test.hello.first.SayHelloFirstBean.sayHelloOne(SayHelloFirstBean.java:76)
com.ejb.test.hello.first.EJSRemoteStatelessSayHelloFirst_67c1d243.
sayHelloOne(EJSRemoteStatelessSayHelloFirst_67c1d243.java:41)
Que faire ensuite
- Visualiser les paramètres DPM courants. Vous pouvez effectuer la commande d'affichage suivante
si vous souhaitez vérifier les paramètres DPM courants :
f <varname>server</varname>,display,dpm
Le message suivant s'affiche en réponse à cette commande :
BBOO0361I DISPATCH PROGRESS MONITOR (DPM) SETTINGS: IIOP(000):HTTP(010):HTTPS(015) :MDB(000):SIP(020):SIPS(000):OLA(000),DUMP_ACTION (JAVATDUMP)
Depuis la version 8.5.5.1, un message similaire au suivant s'affiche en réponse à cette commande :BBOO0361I DISPATCH PROGRESS MONITOR (DPM) SETTINGS: IIOP(000):HTTP(000):HTTPS(015):MDB(000):SIP(020):SIPS(000):OLA(000):CRA(015) DUMP_ACTION(TRACEBACK) BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,DPM
- Modifier l'opération de cliché que DPM doit effectuer. Vous pouvez utiliser
la commande MODIFY ou la variable server_region_dpm_dump_action WebSphere pour modifier
l'opération de cliché que DPM doit effectuer.Pour utiliser la commande MODIFY afin de modifier l'opération de cliché qui doit être réalisée par DPM, effectuez la commande suivante en spécifiant l'opération de cliché appropriée :
f server,dpm,dump_action=[SVCDUMP | JAVACORE | HEAPDUMP | TRACEBACK | JAVATDUMP | NONE ]
Pour utiliser la variable WebSphere server_region_dpm_dump_action afin de modifier l'opération de cliché qui doit être réalisée par DPM, effectuez les opérations suivantes :- Dans la console d'administration, cliquez sur .
- Sélectionnez le noeud ou la cellule appropriée dans la liste des cellules, des noeuds et des serveurs disponibles, puis cliquez sur .
- Spécifiez server_region_dpm_dump_action dans la zone Nom et SVCDUMP, JAVACORE, HEAPDUMP, TRACEBACK, JAVATDUMP, ou NONE dans la zone Valeur.