Commande modify
Vous pouvez émettre la commande modify à partir de la console MVS pour modifier dynamiquement les opérations du produit.
- Contrôleurs actifs
- Paramètres de trace
- Serviteurs
- Sessions
- Tas de la machine virtuelle Java™ (JVM)
- Trace Java
Utilisez le format ci-après lorsque vous entrez la commande modify.
f <serveur>, paramètres
serveur correspond au nom abrégé du serveur auquel la commande modify est destinée. Cet argument est obligatoire.
Paramètres
Les paramètres suivants sont valides pour la commande modify :
- DISABLEFAILOVER,'<nom JNDI>'
- Permet de désactiver manuellement la prise en charge de la reprise de ressources par transfert pour la ressource identifiée par le nom JNDI fourni. Ce nom identifie la ressource principale. Il doit être entouré de guillemets simples pour protéger sa casse.
- ENABLEFAILOVER,'<nom JNDI>'
- Permet d'activer manuellement la prise en charge de la reprise de ressources par transfert pour la ressource identifiée par le nom JNDI fourni. Ce nom identifie la ressource principale. Il doit être entouré de guillemets simples pour protéger sa casse.
- FAILOVER,'<nom JNDI>'
- Permet d'acheminer manuellement les demandes destinées à la ressource principale vers la ressource secondaire configurée. Le nom JNDI fourni identifie la ressource principale. Il doit être entouré de guillemets simples pour protéger sa casse. Pour basculer les demandes vers la ressource principale, exécutez la commande modify avec le paramètre FAILBACK,'<nom JNDI>'.
- FAILBACK,'<nom JNDI>'
- Permet d'acheminer manuellement les demandes vers la ressource principale configurée
identifiée par le nom JNDI fourni. Ce nom identifie
la ressource principale. Il doit être entouré de guillemets simples pour protéger sa casse. Cette commande active automatiquement la reprise automatique après incident. Si cette reprise n'est pas souhaitée, exécutez
la commande modify avec le paramètre DISABLEFAILOVER,'<nom JNDI>'. Avertissement : Le nom JNDI est sensible à la casse.
- CANCEL
- Permet d'annuler le serveur spécifié.
Vous pouvez définir les options suivantes pour le paramètre CANCEL :
- ARMRESTART
- Indique si vous utilisez l'agent ARM (Application Response Management) et si vous souhaitez que l'ARM redémarre le serveur une fois qu'elle a terminé. Si vous n'indiquez pas l'option ARMRESTART pour le paramètre CANCEL, ARM ne redémarre pas le serveur.
- HELP
- Indique si vous souhaitez consulter les informations d'aide qui décrivent la syntaxe CANCEL.
Eviter les incidents: Vous ne pouvez pas utiliser le paramètre CANCEL pour annuler un cluster de la console MVS. Vous devez annuler individuellement chaque serveur qui compose le cluster.gotcha
- DPM,[IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | 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. La valeur de la marque de réservation nnn doit être un entier compris entre 0 et 255 ou reset. La valeur 0 signifie que le protocole n'a pas d'intervalle et que DPM est désactivé pour les requêtes qui utilisent ce protocole. La valeur reset signifie que le contrôle de l'intervalle DPM est renvoyé à l'attribut de classification dpm_interval dans le fichier de classification de la charge de travail.
La commande DPM INTERVAL modify remplace l'attribut de classification dpm_interval. La commande modify dump_action DPM remplace l'attribut de classification dpm_dump_action et la propriété server_region_dpm_dump_action server-wide.
L'option RESET exécutée sur l'action de vidage dump désactive cette dernière pour la commande modify. Les paramètres de l'attribut de classification dpm_dump_action et de la propriété server_region_dpm_dump_action server-wide restent appliqués.
Une valeur spécifiée pour le paramètre INTERVAL définit l'intervalle DPM pour les six protocoles sur la même valeur.
La valeur clear_all définit les intervalles pour tous les protocoles de demandes associés sur 0 et l'action de vidage sur Aucune.
La valeur reset_all réinitialise tous les intervalles DPM et le paramètre dump_action. Le contrôle des intervalles DPM et de l'action de cliché sont renvoyés au fichier de classification WLM.
- HEAPDUMP
- Génère un cliché du segment de mémoire JVM pour le contrôleur et tous les serviteurs associés à ce contrôleur.
- JAVACORE
- Génère un cliché du processus noyau JVM pour le contrôleur et tous les serviteurs associés à ce contrôleur.
- JAVATDUMP
- Génère un cliché TDUMP initialisé par la JVM pour tous les espaces adresse de serviteurs. Vous pouvez aussi utiliser la variable d'environnement native JAVA_DUMP_TDUMP_PATTERN pour spécifier le nom de l'ensemble de données TDUMP.
- JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]
- Permet de modifier dynamiquement l'action de diagnostic engagée si une situation de saturation de la mémoire da la machine virtuelle Java (JVM) survient sur ce serveur. Permet également de modifier l'intervalle de répétition de l'action de diagnostic.
INTERVAL permet de spécifier le délai, en secondes, pendant lequel une action de diagnostic n'est pas répétée. Cet attribut prévaut sur la valeur spécifiée pour la variable d'environnement ras_java_oom_interval.
ACTION permet de spécifier l'action de diagnostic engagée lorsqu'une situation de saturation de la mémoire JVM survient sur ce serveur. Cet attribut prévaut sur la valeur spécifiée pour la variable d'environnement ras_java_oom_action. Vous pouvez spécifier l'une des valeurs suivantes pour xxx :
- AUCUNE
- Aucune action de diagnostic n'est lancée.
- WTO
- Un message d'erreur BBOO0404E est envoyé vers la sortie papier.
- SVCDUMP
- Un vidage SVCDUMP de l'espace adresse affecté est capturé, avec code mineur C9C2704B.
Le fait de spécifier RESET réaffecte à l'action de diagnostic et à l'intervalle les valeurs indiquées pour les variables d'environnement ras_java_oom_action et ras_java_oom_interval.
- MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}
- Permet de modifier dynamiquement l'emplacement de sortie des identificateurs de message.
La marque de réservation xxx est une liste délimitée par des virgules d'identificateurs de message de produit devant être acheminés par le serveur d'applications. Les messages peuvent être acheminés vers plusieurs emplacements.
Lorsque vous lancez initialement la commande pour un emplacement et un ensemble de messages, la liste de messages de l'emplacement est celle de la première commande. Si la variable d'environnement de l'emplacement contient des messages définis, ces derniers sont ajoutés à la fin de la liste de messages de l'emplacement. Lorsque vous lancez ensuite la commande pour le même emplacement et un autre ensemble de messages, le serveur d'applications ajoute les messages de la commande suivante à la fin de la liste de messages existante.
L'option ERRORLOG achemine les messages vers le journal des erreurs plutôt que vers l'emplacement par défaut.
L'option HARDCOPY achemine les messages vers le journal système SYSLOG, également appelé copie papier, plutôt que vers l'emplacement par défaut.
L'option CONSOLE achemine les messages vers la console de l'opérateur MVS plutôt que vers l'emplacement par défaut.
L'option COPYERRORLOG copie les messages dans le journal des erreurs ainsi qu'à l'emplacement par défaut.
L'option COPYHARDCOPY copie les messages dans le journal système SYSLOG, également appelé copie papier, ainsi qu'à l'emplacement par défaut.
L'option COPYCONSOLE copie les messages dans la console de l'opérateur MVS ainsi qu'à l'emplacement par défaut.
L'option NONE supprime l'acheminement des messages. La valeur NONE est prioritaire sur l'acheminement des messages vers le journal des erreurs, le journal système ou la console d'opérateur MVS.
L'option RESET avec ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG, COPYHARDCOPY, COPYCONSOLE ou NONE signifie que les messages qui sont acheminés ou supprimés proviennent du fichier was.env et non de la commande modify MSGROUTE.- L'option RESET avec ERRORLOG achemine les messages spécifiés dans la variable d'environnement ras_message_routing_errorlog vers le journal des erreurs plutôt que vers l'emplacement par défaut.
- L'option RESET avec HARDCOPY achemine les messages spécifiés dans la variable d'environnement ras_message_routing_hardcopy vers le journal système SYSLOG plutôt que vers l'emplacement par défaut.
- L'option RESET avec CONSOLE achemine les messages spécifiés dans la variable d'environnement ras_message_routing_console vers la console d'opérateur MVS plutôt que vers l'emplacement par défaut.
- L'option RESET avec COPYERRORLOG copie les messages spécifiés dans la variable d'environnement ras_message_routing_errorlog dans le journal des erreurs ainsi qu'à l'emplacement par défaut.
- L'option RESET avec COPYHARDCOPY copie les messages spécifiés dans la variable d'environnement ras_message_routing_copy_hardcopy dans le journal système SYSLOG ainsi qu'à l'emplacement par défaut.
- L'option RESET avec COPYCONSOLE copie les messages spécifiés dans la variable d'environnement ras_message_routing_copy_console dans la console de l'opérateur MVS ainsi qu'à l'emplacement par défaut.
- L'option RESET avec NONE supprime l'acheminement des messages spécifiés dans la variable d'environnement ras_message_routing_hardcopy.
L'option CLEAR avec ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE ou NONE signifie que les messages sont acheminés vers un emplacement par défaut ou qu'ils ne sont plus supprimés.- L'option CLEAR avec ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG, COPYHARDCOPY, COPYCONSOLE ou NONE signifie que les messages sont acheminés vers un emplacement par défaut ou qu'ils ne sont plus supprimés.
- L'option CLEAR avec ERRORLOG ou COPYERRORLOG achemine les messages vers l'emplacement par défaut plutôt que vers le journal des erreurs.
- L'option CLEAR avec HARDCOPY ou COPYERRORLOG achemine les messages vers l'emplacement par défaut plutôt que vers le journal système SYSLOG.
- L'option CLEAR avec CONSOLE ou COPYCONSOLE achemine les messages vers l'emplacement par défaut plutôt que vers la console de l'opérateur MVS.
- L'option CLEAR avec NONE annule la suppression des messages.
- RECLASSIFY[,FILE=['/path/to/file.xml']]
- Utilisé pour recharger dynamiquement le document de classification de charge de travail sans avoir à redémarrer le serveur. Les paramètres de classification de charge de travail rechargée prennent effet immédiatement.
L'option RECLASSIFY exécute la reclassification à l'aide du fichier de classification de la charge de travail spécifié dans la variable wlm_classification_file.
La spécification d'un nom de fichier avec le paramètre reclassify tel que RECLASSIFY,FILE='/path/to/newfile.xml' exécute la reclassification à l'aide du fichier de classification spécifié. La valeur de la variable wlm_classification_file devient le nom de fichier spécifié dans l'option FILE. Toute commande suivante modify de reclassification qui utilise la variable wlm_classification_file recharge le nouveau fichier spécifié dans la variable et non le fichier initial.
L'option RECLASSIFY,FILE= désactive la classification. La variable wlm_classification_file est définie par NULL. Toute commande suivante modify de reclassification qui utilise la variable wlm_classification_file n'affecte pas le serveur car la variable wlm_classification_file n'a pas de valeur.
Avertissement : Si le nouveau fichier de classification de la charge de travail ne peut pas être chargé, le serveur d'applications annule les paramètres de classification rechargés. Le serveur d'applications continue à s'exécuter avec les paramètres de classification en vigueur avant la commande modify de reclassification en cours d'exécution.Conseil : Lorsque le chargement du fichier de classification de la charge de travail aboutit, le serveur d'applications enregistre dans le journal système, SYSLOG, un message similaire au message suivant. Le message est également affiché dans la console de l'opérateur en réponse à la commande d'affichage DISPLAY,WORK,CLINFO.BBOJ0129I: The /tmp/wlm4.class.xml workload classification file was loaded at 2009/07/14 19:33:35.297 (GMT)
- ROLL_LOGS
- Permet de réexécuter une redirection des journaux de sortie de serviteur vers le système de fichiers USS. Un nouvel ensemble de fichiers journaux de sortie est créé sous le même répertoire de sortie et les anciens fichiers journaux sont conservés. Les messages sont écrits à la fin des journaux précédents et au début des nouveaux journaux, créant ainsi un lien logique entre les fichiers.
- STACKTRACE
- Permet de consigner la trace de pile Java pour toutes les unités d'exécution Java du serveur dans le journal des erreurs.
- SMF,REQUEST,{ON|OFF|RESET}
- Permet de contrôler la création d'enregistrements SMF 120-9.
La commande modify SMF,REQUEST remplace l'attribut de classification SMF_request_activity_enabled et la propriété server_SMF_request_activity_enabled server-wide.
L'option ON permet d'activer la création d'enregistrements SMF 120-9.
L'option OFF permet de désactiver la création d'enregistrements SMF 120-9.
L'option RESET permet de désactiver les paramètres de la commande modify pour la création d'enregistrements SMF 120-9. Les paramètres de l'attribut de classification SMF_request_activity_enabled et la propriété à l'échelle du serveur server_SMF_request_activity_enabled sont en vigueur au moment de la réinitialisation.
- SMF,REQUEST,ASYNC,{ON|OFF|RESET}
- Utilisé pendant la collecte de données pour la section Formatted ASYNC
de l'enregistrement SMF 120-9 lors de la création de ce dernier.
La commande SMF,REQUEST,ASYNC modify remplace la propriété server_SMF_request_activity_async server-wide.
L'option ON permet d'activer la collecte de données.
L'option OFF permet de désactiver la collecte de données. Lorsque cette valeur est indiquée, cette section contient des zéros dans les triplets d'emplacement du haut des enregistrements créés.
L'option RESET permet de désactiver les paramètres de la commande modify pour la collecte de données. Les paramètres de la propriété à l'échelle du serveur server_SMF_request_activity_async au moment de la réinitialisation sont en vigueur.
- SMF,REQUEST,CPU,{ON|OFF|RESET}
- Utilisé pendant la collecte de données pour la section CPU Usage Breakdown
de l'enregistrement SMF 120-9 lors de la création de ce dernier.
La commande modify SMF,REQUEST,CPU remplace l'attribut de classification SMF_request_activity_CPU_detail et la propriété à l'échelle du serveur server_SMF_request_activity_CPU_detail.
L'option ON permet d'activer la collecte de données.
L'option OFF permet de désactiver la collecte de données. Lorsque cette valeur est indiquée, cette section contient des zéros dans les triplets d'emplacement du haut des enregistrements créés.
L'option RESET permet de désactiver les paramètres de la commande modify pour la collecte de données. Les paramètres de l'attribut de classification SMF_request_activity_CPU_detail et la propriété à l'échelle du serveur server_SMF_request_activity_CPU_detail sont en vigueur au moment de la réinitialisation.
- SMF,REQUEST,SECURITY,{ON|OFF|RESET}
- Utilisé pendant la collecte de données pour la section Security Data
de l'enregistrement SMF 120-9 lors de la création de ce dernier.
La commande modify SMF,REQUEST,SECURITY remplace l'attribut de classification SMF_request_activity_security et la propriété à l'échelle du serveur server_SMF_request_activity_security.
L'option ON permet d'activer la collecte de données.
L'option OFF permet de désactiver la collecte de données. Lorsque cette valeur est indiquée, cette section contient des zéros dans les triplets d'emplacement du haut des enregistrements créés.
L'option RESET permet de désactiver les paramètres de la commande modify pour la collecte de données. Les paramètres de l'attribut de classification SMF_request_activity_security et la propriété à l'échelle du serveur server_SMF_request_activity_security sont en vigueur au moment de la réinitialisation.
- SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}
- Utilisé pendant la collecte de données pour la section Formatted Timestamps
de l'enregistrement SMF 120-9 lors de la création de ce dernier.
La commande modify SMF,REQUEST,TIMESTAMPS remplace l'attribut de classification SMF_request_activity_timestamps et la propriété à l'échelle du serveur server_SMF_request_activity_timestamps.
L'option ON permet d'activer la collecte de données.
L'option OFF permet de désactiver la collecte de données. Lorsque cette valeur est indiquée, cette section contient des zéros dans les triplets d'emplacement du haut des enregistrements créés.
L'option RESET permet de désactiver les paramètres de la commande modify pour la collecte de données. Les paramètres de l'attribut de classification SMF_request_activity_timestamps et la propriété à l'échelle du serveur server_SMF_request_activity_timestamps sont en vigueur au moment de la réinitialisation.
- SMF,OUTBOUND,ON
- Permet d'activer la création d'enregistrements SMF 120-10.
- SMF,OUTBOUND,OFF
- Permet de désactiver la création d'enregistrements SMF 120-10.
- SMF,OUTBOUND,RESET
- Permet de contrôler la création des enregistrements SMF 120-10 à l'aide de la valeur indiquée dans la variable d'environnement server_SMF_outbound_enabled.
- TIMEOUT_DELAY=n
- Permet de remplacer dynamiquement la valeur de la variable de
délai d'attente control_region_timeout_delay par n
secondes. Cette commande s'utilise avec la commande
TIMEOUTDUMPACTION modify pour définir un délai
d'attente qui active l'action de cliché spécifiée, par exemple
JAVACORE, quand le délai d'attente arrive à expiration. Les actions
de cliché spécifiées dans la commande TIMEOUTDUMPACTION
modify demandent un délai d'attente qui active le serviteur
pour exécuter le cliché avant l'arrêt du serviteur.
Une fois réalisé le cliché spécifié, vous pouvez relancer cette commande pour ramener la variable control_region_timeout_delay à sa valeur antérieure sans recycler le serveur.
- TIMEOUTDUMPACTION=n
- Permet d'indiquer, parmi les actions suivantes, celles qui sont
effectuées en cas de dépassement de délai pour un travail envoyé à un
serviteur, alors que la valeur de la propriété control_region_timeout_delay
est différente de zéro :
- Si NONE ou none est indiqué, aucun cliché n'est pris.
- Si JAVACORE ou javacore est indiqué, un cliché du processus Java core est pris.
- Si SVCDUMP ou svcdump est indiqué, un cliché SVC est pris.
- Si vous spécifiez JAVATDUMP ou
javatdump, un cliché TDUMP est initialisé par
la JVM. Remarque : Vous devez affecter à la propriété control_region_timeout_delay une valeur assez élevée pour laisser au serviteur le temps de collecter le cliché JAVATDUMP avant que le contrôleur ne l'arrête. La commande TIMEOUT_DELAY modify permet de modifier dynamiquement la valeur de la propriété control_region_timeout_delay.
- TIMEOUTDUMPACTIONSESSION=n
- Permet d'indiquer, parmi les actions suivantes, celles qui sont
effectuées en cas de dépassement de délai pour une demande HTTP, HTTPS,
SIP ou SIPS envoyée à un serviteur, alors que la propriété de reprise
correspondante a pour valeur SESSION :
- Si NONE ou none est indiqué, aucun cliché n'est pris.
- Si JAVACORE ou javacore est indiqué, un cliché du processus Java core est pris.
- Si SVCDUMP ou svcdump est indiqué, un cliché SVC est pris.
- Si vous spécifiez JAVATDUMP ou javatdump, un cliché TDUMP est initialisé par la JVM.
Les propriétés de reprise correspondantes sont répertoriées ci-après :- protocol_http_timeout_output_recovery
- protocol_https_timeout_output_recovery
- protocol_sip_timeout_output_recovery
- protocol_sips_timeout_output_recovery
- TRACEALL=n
- Permet d'établir un niveau de trace général pour le serveur. Les valeurs suivantes sont des niveaux de trace valides. En général, vous indiquez la valeur 1.
- 0 : aucun traçage.
- 1 : traçage en cas d'exception.
- 2 : traçage de base.
- 3 : traçage détaillé pour tous les composants.
Eviter les incidents: Soyez prudent lors de l'utilisation d'un niveau 3, car ce niveau de trace peut générer plus de données qu'il est raisonnablement possible de gérer.gotcha
- TRACEBASIC=n
- Permet d'indiquer les composants du produit pour lesquels vous souhaitez activer un niveau de
trace de base. Cette commande permet de remplacer un niveau de trace différent établi par TRACEALL pour ces composants.
Eviter les incidents: Ne modifiez pas cette variable sans y avoir été invité par le Support IBM®. gotcha
La table suivante contient les valeurs possibles pour ce paramètre. Vous pouvez indiquer une ou plusieurs de ces valeurs pour TRACEBASIC ou TRACEDETAIL :
Value Composant du produit 0 RAS 1 Utilitaires communs 3 COMM 4 ORB 6 OTS 7 Shasta 9 Encapsuleurs z/OS A Démon E Security P Externalisation J (A utiliser uniquement si vous y êtes invité par le support IBM) JRas L Java EE - TRACEDETAIL=n
- Permet d'indiquer les composants du produit pour lesquels vous voulez activer un niveau de trace détaillé. Cette commande active les fonctions de trace les plus détaillées pour les composants du produit et elle remplace différents paramètres dans TRACEALL. Les composants sélectionnés sont identifiés par leurs ID composant, qui sont identiques aux ID répertoriés pour le paramètre TRACEBASIC. Les sous-composants, définis par des nombres, reçoivent des traces détaillées. D'autres parties du produit reçoivent une trace définie par la variable TRACEALL.
Eviter les incidents: Ne modifiez pas cette variable sans y avoir été invité par le Support IBM.gotcha
- TRACESPECIFIC=xxyyyzzz
- Sert à spécifier les substitutions de traçage pour les points de trace spécifiques du produit. Les points de trace sont définis par des nombres hexadécimaux à huit chiffres. Pour indiquer plusieurs points de trace, utilisez des parenthèses et séparez les nombres par une virgule. Vous pouvez également définir une variable d'environnement en entourant le nom de guillemets simples. La valeur de la variable d'environnement est traitée comme si vous aviez indiqué cette valeur sur le paramètre TRACESPECIFIC.
Eviter les incidents: N'utilisez pas TRACESPECIFIC sans y avoir été invité par un technicien du support IBM.gotcha
- TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
- Permet d'indiquer les points de trace du produit à exclure. Les points de trace à exclure sont définis par des nombres hexadécimaux à huit chiffres. Pour indiquer plusieurs points de trace, utilisez des parenthèses et séparez les nombres par une virgule. Vous pouvez également définir une variable d'environnement en entourant le nom de guillemets simples. La valeur de la variable d'environnement est traitée comme si vous l'aviez spécifiée sur le paramètre TRACE_EXCLUDE_SPECIFIC. Vous pouvez utiliser le paramètre TRACE_EXCLUDE_SPECIFIC comme masque afin de désactiver les traces actives. Par exemple, utilisez le paramètre TRACESPECIFIC pour activer la trace d'une partie entière du produit, puis utilisez le paramètre TRACE_EXCLUDE_SPECIFIC pour désactiver une trace dans cette partie du produit.
Eviter les incidents: N'utilisez pas le paramètre TRACE_EXCLUDE_SPECIFIC sans y avoir été invité par un technicien du support IBM.gotcha
- TRACEINIT
- Permet de réinitialiser les paramètres de trace initiaux.
- TRACENONE
- Permet de désactiver tous les paramètres de trace.
- TRACETOSYSPRINT={YES|NO}
- Permet de déterminer si la trace doit être envoyée à SYSPRINT.
YES indique d'envoyer la trace à SYSPRINT. NO arrête l'envoi de la trace à SYSPRINT.
- TRACETOTRCFILE={YES|NO}
- Permet de déterminer s'il convient de diriger la trace vers la carte TRCFILE DD.
YES envoie la trace à la carte TRCFILE DD. NO arrête l'envoi de la trace à la carte TRCFILE DD.
- TRACEJAVA
- Modifie la chaîne de trace Java.
La spécification de trace Java permet de contrôler le traçage Java et respecte les règles des spécifications de trace Java. *=all=enabled indique qu'il faut activer tous les types de traçage pour tous les composants de trace enregistrés.
- TRACERECORD,{ON|OFF|RESET}
- Permet de contrôler l'écriture d'enregistrements de trace. Ce paramètre est utilisé avec l'attribut classification_only_trace défini dans le fichier de classification de la charge de travail.
L'option ON écrit les enregistrements de trace en fonction de la spécification de trace en cours. Les attributs classification_only_trace ne sont pas pris en compte.
L'option OFF empêche l'écriture d'enregistrements de trace.ATTENTION :Les enregistrements de trace basés sur la spécification de trace en cours ou produits dans le cadre du traitement d'exécution normal ne sont pas écrits.L'option RESET écrit les enregistrements de trace pour la spécification de trace en cours comme suit :- Si aucun attribut classification_only_trace n'est défini, les enregistrements de trace sont écrits pour toutes les unités d'exécution de traitement. Cette situation est fonctionnellement équivalente à la définition de TRACERECORD sur ON.
- Si un ou plusieurs attributs classification_only_trace sont définis, les enregistrements de trace sont écrits uniquement pour les unités d'exécution de traitement dont la classification contient l'attribut classification_only_trace 1.
La valeur par défaut est RESET.
- HELP
- Permet d'afficher la liste de tous les mots clés que vous pouvez utiliser avec la commande modify.
Vous pouvez également utiliser le paramètre HELP après les paramètres CANCEL et DISPLAY afin d'afficher les listes des mots clés que vous pouvez utiliser avec chacun de ces paramètres.
- PAUSELISTENERS
- Permet d'empêcher que les opérations ne soient acceptées dans le serveur. Utilisez ce paramètre
pour éteindre les programme d'écoute des communications et purger tout travail en attente du
registre de travail.
Eviter les incidents: La commande MODIFY server,PAUSELISTENERS arrête l'écoute du contrôleur sur tous les ports, à l'exception du port IIOP (ORB_TCP_SECURE et ORB_TCP_LISTENER). Pour IIOP, lorsque cette commande modify est exécutée, le démon arrête l'envoi de requêtes vers les canaux de transport IIOP. Cependant, si vous exécutez des applications client pratiquant la mise en cache, il est possible que les demandes émanant de ces applications soient envoyées directement au port IIOP ouvert. Cette situation peut se produire car les programmes d'écoute IIOP démarrent à un stade précoce du démarrage du serveur, ce qui rend possible l'ouverture du port IIOP avant l'exécution de cette commande modify.gotcha
- WLM_MIN_MAX=min,max
- Permet de modifier de manière dynamique les paramètres du nombre minimal et maximal de serviteurs
(wlm_minimumSRCount et wlm_maximumSRCount). WLM ajuste de manière dynamique le nombre
actuel de serviteurs actifs afin de s'adapter aux nouvelles contraintes. Les nouveaux paramètres ne s'appliquent pas immédiatement. WLM tente d'atteindre le minimum et le maximum cible
aussi rapidement que possible,
en fonction de la disponibilité des ressources et de la charge de travail.
Eviter les incidents: La commande WLM_MIN_MAX est ignorée sur les serveurs configurés avec un seul environnement d'application dynamique de serveur, c'est-à-dire si la propriété wlm_dynapplenv_single_server a la valeur 1.gotcha
- WORKERTHREADMAX=n
- Permet d'auglenter le nombre maximal de pools d'unités d'exécution de tâche de la région de contrôleur. La valeur spécifiée dans la commande modify prévaut sur la valeur spécifiée pour la variable d'environnement control_region_thread_pool_maximum_size. La valeur maximale peut uniquement être augmentée. Les demandes de réduction de la valeur maximale seront rejetées. Lorsque vous indiquez un nombre maximal, assurez-vous que vous disposez de suffisamment de ressources pour prendre en charge ce nombre maximal. Par exemple, pensez à vérifier la taille de segment de mémoire de JVM.
- RESUMELISTENERS
- Permet de redémarrer les programmes d'écoute des communications après l'exécution d'une commande modify qui comprend le paramètre PAUSELISTENERS. Ce paramètre permet à de nouveaux travaux d'être acceptés dans le serveur.
- DISPLAY
- Permet d'afficher le nom du serveur, le nom du système sur lequel il s'exécute et le niveau de code actuel.
Vous pouvez définir les options suivantes pour ce paramètre :
- SERVERS affiche le nom du serveur auquel la commande est envoyée, le nom du système et le niveau de code de chaque serveur actif dans le sysplex se trouvant dans la même cellule.
- SERVANTS : affiche une liste des identificateur d'espace adresse des serviteurs associés au serveur pour lequel vous avez exécuté la commande display.
- TRACE affiche des informations de trace pour un contrôleur de serveur. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS : affiche des informations de trace pour tous les serviteurs, un par un.
- ALL : affiche des informations de trace pour le contrôleur et tous les serviteurs, un par un.
- JAVA affiche les paramètres de trace Java pour un contrôleur de serveur. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS affiche les informations de trace Java pour tous les servants, un par un.
- ALL affiche les informations de trace Java pour le contrôleur et tous les servants, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display trace Java.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display trace.
- JVMHEAP : affiche des informations sur le segment de mémoire de la JVM pour un contrôleur de serveur. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS : affiche des informations sur le segment de mémoire de la JVM pour tous les serviteurs, un par un.
- ALL : affiche des informations sur le segment de mémoire de la JVM pour le contrôleur et tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display Javaheap.
- LISTENERS affiche le nom d'instance de connexion, l'adresse IP associée et le numéro de port d'écoute. L'adresse IP associée peut comporter un astérisque (*) comme caractère générique.
- CONNECTIONS affiche chaque nom d'instance de connexion et le nombre de connexions. Chaque instance de connexion figure sur une ligne distincte. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- NAME='nom' affiche le nombre de connexions associées pour l'instance de connexion 'nom'. Si le nom de connexion est localisé mais qu'il comporte zéro connexion, la commande renvoie un nombre de zéro. Si le nom de connexion est introuvable, la commande renvoie un message d'erreur.
- LIST : affiche les informations d'hôte distant relatives à toutes les connexions de toutes les instances de connexion. Si un nom d'instance de connexion ne possède aucune connexion, la commande ne renvoie que le nom d'instance de connexion.
- LIST, NAME='nom' affiche les informations d'hôte distant pour toutes les connexions d'une instance de connexion 'nom'.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify.
- ERRLOG affiche les dix dernières entrées du journal des erreurs. Vous pouvez modifier cette option à l'aide d'une des options suivantes :
- SRS affiche les dix dernières entrées du journal des erreurs pour tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display error log.
- MODE affiche le mode d'octets d'exécution.
- MSGROUTE affiche la liste des messages pour tous les emplacements d'acheminement et pour les messages à supprimer. Les emplacements d'acheminement peuvent être le journal des erreurs, le journal système ou la console d'opérateur MVS.
- ERRORLOG affiche la liste des messages à acheminer vers le journal des erreurs.
- HARDCOPY affiche la liste des messages à acheminer au journal système SYSLOG, aussi appelé copie papier.
- CONSOLE affiche la liste des messages à acheminer vers la console d'opérateur MVS.
- NONE affiche la liste des messages à supprimer.
- SMFaffiche l'état de la création d'enregistrement SMF 120-9 pour un serveur.
- ASYNC affiche l'état de la création d'enregistrements SMF 120-9 pour le travail asynchrone sur tous les servants successivement.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display SMF.
- WORK affiche le nombre d'éléments de travail du serveur. Vous pouvez modifier cette option à l'aide d'une des options suivantes :
- CRA affiche des informations concernant le nombre de demandes de bean géré par message CRA. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS affiche des informations concernant le nombre de demandes CRA pour tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work CRA.
- ASYNCSERVLET affiche le nombre total de demandes de servlets asynchrones et le nombre actuel de demandes de servlets asynchrones en cours de traitement. Le nombre total de demandes de servlets asynchrones correspond uniquement aux demandes soumises depuis le dernier démarrage ou redémarrage du serveur entier. Toutefois, le nombre total peut décroître si un ou plusieurs servants ont été arrêtés ou redémarrés.
- SRS affiche pour chaque servant le nombre total de demandes de servlets asynchrones et le nombre actuel de demandes de servlets asynchrones en cours de traitement. Le nombre total correspond au nombre de demandes de servlets asynchrones émises depuis le dernier démarrage ou redémarrage du servant.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work asyncservlets.
- EJB affiche les informations concernant le nombre de demandes EJB (Enterprise JavaBeans).
Vous pouvez modifier cette option à
l'aide d'une des options suivantes :
- SRS affiche les informations concernant le nombre de demandes EJB pour tous les serviteurs un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work EJB.
- SERVLET affiche des informations concernant le nombre de demandes de servlet.
Vous pouvez modifier cette option à
l'aide d'une des options suivantes :
- SRS affiche les informations concernant le nombre de demandes de servlet pour tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work servlet.
- MDB affiche des informations concernant le nombre de demandes de bean géré par message. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS affiche les informations concernant le nombre de demandes de bean géré par message pour tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work MDB.
- SIP affiche des informations concernant le nombre de demandes du protocole SIP. Vous pouvez modifier cette option à
l'aide d'une des options suivantes :
- SRS affiche les informations concernant le nombre de demandes du protocole SIP pour tous les serviteurs un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work SIP.
- SUMMARY affiche un récapitulatif des informations concernant le nombre de demandes.
- SRS affiche un récapitulatif des informations concernant le nombre de demandes pour tous les serviteurs, un par un.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work summary.
- ALL affiche toutes les informations concernant le nombre de toutes les demandes.
- SRS affiche les informations concernant le nombre de toutes les demandes pour tous les serviteurs, un par un.
- STATS affiche des statistiques détaillées.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work all.
- CLINFO affiche des informations de classification de travaux.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work.
- OLA affiche les demandes OLA (Optimized Local Adapter)
générées par les services BBOA1INV et BBOA1SRQ. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- SRS affiche les informations concernant le nombre de demandes OLA pour chacun des serviteurs.
- HELP affiche une liste de tous les mots clés que vous pouvez utiliser avec la commande modify display work all.
- CRA affiche des informations concernant le nombre de demandes de bean géré par message CRA. Vous pouvez encore modifier cette commande à l'aide de l'une des options suivantes :
- Fonction FRCA (Fast Response Cache Accelerator). Affichez les statistiques de cache FRCA comme suit :
- f <nom_serveur>,display,frca
- f <nom_serveur>,display,frca,content
- f <nom_serveur>,display,frca,stats
- ADAPTER
- STATUS affiche l'état du composant des adaptateurs locaux optimisés.
- REGISTRATIONS affiche la liste des clients d'adaptateurs locaux optimisés connectés au serveur.
- DAEMONRGES affiche la liste des clients d'adaptateurs locaux optimisés connectés à un serveur du groupe de démons.
- SEARCHRGES affiche la liste des clients d'adaptateurs locaux optimisés connectés à un serveur du groupe de démons et correspondant aux critères de recherche.
- ASIDX=
- Ajoutez ASIDX= après la commande modify avec l'identificateur d'espace adresse (ASID) approprié (au format hexadécimal) d'une région serviteur à vider.Exemple :
Dans cet exemple, la commande prend un cliché JAVACORE de la région serviteur dont l'identificateur d'espace adresse (ASID) (au format hexadécimal) est 'F4'.MODIFY server,JAVACORE,ASIDX=F4
Exemple : désactivation de la reprise en ligne
f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'
Exemple : annulation de clusters d'applications et de serveurs à l'aide de la commande modify
Vous ne pouvez pas annuler un cluster à partir de la console MVS. Vous devez, à la place, annuler chacun des serveurs qui composent le cluster.
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
Exemple : Etablissement d'un niveau général de trace à l'aide du scriptage
f serveur,traceall=n
Les niveaux de trace valides sont 0 (aucun), 1 (exception), 2 (de base) et 3 (fonction de trace détaillée). Lorsque les conditions sont normales, et en cas de production, utilisez le niveau 1 (exception).
f bbo6acr,traceall=1
f bbo6acr,traceall=1
BBOO0211I TRACEALL=1 DE LA COMMANDE MODIFY EXECUTE AVEC SUCCES
Exemple : définition de niveaux de trace de base et détaillés pour les composants WebSphere z/OS
f server,tracebasic=(n,...)
f bbo6acr,tracebasic=a
f bbo6acr,TRACEBASIC=A
BBOO0211I TRACEBASIC=A DE LA COMMANDE MODIFY EXECUTE AVEC SUCCES
f serveur,tracedetail=(n,...)
f bbo6acr,tracedetail=e
f bbo6acr,TRACEDETAIL=E
BBOO0211I TRACEDETAIL=E DE LA COMMANDE MODIFY EXECUTE AVEC SUCCES
Exemple : Définition de points de trace particuliers à l'aide du scriptage
f server,tracespecific=n | (n,...)
f bbo6acr,tracespecific=04006001
f bbo6acr,tracespecific=(04006001,04006027)
f bbo6acr,tracespecific='tracepoints'
Exemple : Exclusion de points de trace particuliers à l'aide du scriptage
f server,trace_exclude_specific=n | (n,...)
f bbo6acr,tracespecific=04006000
f bbo6acr,trace_exclude_specific=04006031
Exemple : Réinitialisation des paramètres de trace d'origine à l'aide du scriptage
f server,traceinit
Exemple : Commande de désactivation du traçage à l'aide d'une ligne de commande
f server,tracenone
Exemple : Envoi de la trace à SYSPRINT à l'aide du scriptage
f server,tracetosysprint=yes
f server,tracetosysprint=no
Exemple : annulation de clusters d'applications et de serveurs à l'aide de la commande modify
Cet exemple explique comment annuler des clusters d'applications et des serveurs à l'aide de la commande modify.
Remarque préalable : vous ne pouvez pas annuler un cluster depuis la console MVS. Vous devez, à la place, annuler chacun des serveurs qui composent le cluster.
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
Exemple : obtention d'aide sur la commande modify
Vous pouvez obtenir de l'aide sur la syntaxe pour les différents niveaux de la commande modify.
f bbo6acr,help
F bbo6acr,HELP
BBOO0178I LA COMMANDE MODIFY PEUT ETRE SUIVIE DE L'UN DES MOTS CLES SUIVANTS :
BBOO0179I CANCEL - ANNULATION DE CETTE REGION DE CONTROLE
BBOO0179I TRACEALL - DEFINITION DU NIVEAU DE TRACE GLOBAL
BBOO0179I TRACEBASIC - DEFINITION DES COMPOSANTS DE TRACE DE BASE
BBOO0179I TRACEDETAIL - DEFINITION DES COMPOSANTS DE TRACE DETAILLES
BBOO0179I TRACESPECIFIC - DEFINITION DES POINTS DE TRACE SPECIFIQUES
BBOO0179I TRACEINIT - RESTAURATION DES PARAMETRES DE TRACE INITIAUX
BBOO0179I TRACENONE - DESACTIVATION DE TOUTE LES TRACES
BBOO0179I TRACETOSYSPRINT - ENVOI DU RESULTAT DE TRACE VERS L'IMPRIMANTE SYSTEME (OUI/NON)
BBOO0179I TRACETOTRCFILE - ENVOI DU RESULTAT DE TRACE VERS LA CARTE DD DU FICHIER TRC (OUI/NON)
BBOO0179I DISPLAY - AFFICHAGE DU STATUT
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUSION DES POINTS DE TRACE SPECIFIQUES
BBOO0179I TRACEJAVA - DEFINITION DES OPTIONS DE TRACE JAVA
BBOO0179I TRACETOTRCFILE - ENVOI DU RESULTAT DE TRACE VERS TRCFILE (OUI/NON)
BBOO0179I STATSMDB - STATISTIQUES DETAILLEES MDB
BBOO0179I PAUSELISTENERS - INTERROMPT LES PROGRAMMES D'ECOUTE DE COMMUNICATION
BBOO0179I RESUMELISTENERS - REPRISE DES PROGRAMMES D'ECOUTE DES COMMUNICATIONS
BBOO0179I STACKTRACE - CONSIGNE LES TRACES DE PILE DES UNITES D'EXECUTION JAVA
BBOO0179I TIMEOUTDUMPACTION - DEFINIT L'ACTION DE VIDAGE DES DELAIS D'EXPIRATION
BBOO0179I TIMEOUTDUMPACTIONSESSION - DEFINIT LA SESSION DES ACTIONS DE VIDAGE DES DELAIS D'EXPIRATION
BBOO0179I WLM_MIN_MAX - REINITIALISATION DES PARAMETRES MIN/MAX DU WLM SERVANT
f bbo6acr,display,help
F BBOS001,DISPLAY,HELP
BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING
124
KEYWORDS:
BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES
BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126
PROCESS
BBOO0179I LISTENERS - DISPLAY LISTENERS
BBOO0179I CONNECTIONS - DISPLAY CONNECTION INFORMATION
BBOO0179I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS
BBOO0179I JVMHEAP - DISPLAY JVM HEAP STATISTICS
BBOO0179I WORK - DISPLAY WORK ELEMENTS
BBOO0179I ERRLOG - DISPLAY THE LAST 10 ENTRIES IN THE ERROR LOG
BBOO0179I MODE - DISPLAY THE EXECUTION BITMODE
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP
f bbos001,timeoutdumpactionsession=help
BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
ONE OF the FOLLOWING KEYWORDS:
BBOO0179I SVCDUMP - SVC DUMP
BBOO0179I JAVACORE - JAVA CORE DUMP
BBOO0179I NONE - NO DUMP
f bbos001,dpm,help
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
FOLLOWING KEYWORDS:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY
Si vous disposez du groupe de correctifs 8.5.5.1 ou ultérieur, le résultat de sortie est similaire au suivant :BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
FOLLOWING KEYWORDS:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I CRA - MDB CRA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY
Exemple : modification de la chaîne de trace Java
Cet exemple montre comment utiliser une commande de console afin de modifier une chaîne de trace Java.
f server, tracejava='trace specification'
f bbo6acr,tracejava='*=all'
Exemple : Modification de l'action de diagnostic engagée si une situation de saturation de la mémoire JVM survient
Cet exemple illustre comment utiliser une commande de console pour modifier l'action de diagnostic engagée si une situation de saturation de la mémoire de la machine virtuelle Java (JVM) survient. Utilisez la commande suivante :
f serveur,javaoom,[interval=xxx | action=xxx]
f bbo6acr,,javaoom,[interval=1200 | action=svcdump]