[z/OS]

Gestion du routage du message opérateur

Utilisez les fonctionnalités de routage de message produit pour contrôler le trafic du serveur.

Vous pouvez router de nombreux messages d'erreur à préfixe BBO vers des fichiers spécifiques, au lieu de les transférer dans le SYSLOG, ce qui peut entraîner un trafic important. Ceci est mis en oeuvre via l'utilisation de deux variables d'environnement (ras_default_msg_dd et ras_hardcopy_msg_dd ) et de la spécification de l'instruction DD appropriée dans votre procédure de démarrage JCL.

La section qui suit explique plus en détail le mode d'acheminement des messages.
  • Les messages WTO émis par le serveur d'applications sont envoyés vers une sortie copie papier, mais la plupart d'entre eux peuvent être acheminés vers le fichier spécifié par la variable ras_default_msg_dd (voir Log output destinations and characteristics).
  • Les messages d'audit Java™ sont également envoyés vers une sortie copie papier mais ils peuvent être acheminés vers le fichier spécifié par la variable ras_hardcopy_msg_dd. (voir Log output destinations and characteristics).
  • Erreur de trace, service et messages fatals sont envoyés au journal des erreurs spécifiés par ras_log_logstreamName. Sinon, ils sont envoyés à CERR (SYSOUT). Certains peuvent aussi être envoyés vers une sortie copie papier. Au niveau du service W500104, la variable d'environnement ras_log_logstreamName n'est pas définie sur le nom du flot de consignation des erreurs dans les variables was.env.

    Pour définir cette variable d'environnement, cliquez dans la console d'administration sur Environment > Variables WebSphere, sélectionnez une portée, puis cliquez sur Nouveau.

  • Les messages d'erreur précoces sont envoyés vers SYSOUT jusqu'à ce que le produit se connecte au flot de consignation. Un service WTO (BBOO0153I) est émis et vous indique combien de messages sont allés dans SYSOUT avant votre connexion au flot de consignation.
  • A partir de z/OS version 1.13, vous pouvez employer des mots clés JES2 DD pour segmenter la sortie en utilisant l'écriture périodique de caractère avance page dans les flux de sortie.

    Si vous utilisez z/OS version 1.12 ou antérieure, ainsi que JES2, le paramètre SEGMENT= peut être ajouté aux cartes DD SYSPRINT et SYSOUT si vous souhaitez segmenter la sortie à l'aide de l'écriture périodique de caractères d'avance page dans les flots de sortie. Les caractères d'avance page sont écrit dans les flots de sortie en fonction des valeurs des variables d'environnement ras_stderr_ff_interval, ras_stdout_ff_interval, ras_stderr_ff_line_interval et ras_stdout_ff_line_interval. Ces variables sont décrites plus en détail dans la rubrique Propriétés personnalisées du serveur d'applications pour z/OS. Le paramètre SEGMENT= n'est pas pris en charge sur JES3.

    Pour définir ces variables d'environnement, cliquez dans la console d'administration sur Environment > Variables WebSphere, sélectionnez une portée et cliquez sur Nouveau.

  • Les messages de trace sont acheminés vers ras_trace_outputLocation.
  • System.out.println, System.err.println, STDOUT et cout sont acheminés vers SYSPRINT (pour plus d'informations, voir la rubrique Réacheminement de la sortie SYSPRINT et SYSOUT vers un fichier HFS.
  • STDERR et cerr sont acheminés vers SYSOUT
Pour utiliser ces variables de routage des messages, vous devez effectuer les deux étapes suivantes :
  1. Ajoutez ces paramètres aux définitions de serveur en sélectionnant dans la console d'administration Environnement -> Gestion des variables WebSphere :
    • ras_default_msg_dd =DEFALTDD
    • ras_hardcopy_msg_dd =HRDCPYDD
    Vous pouvez définir ces variables pour un contrôle individuel et des processus de servant, mais il est plus simple de les définir dans les variables d'environnement de la totalité de la cellule. Pour le démon, vous devez leur donner le préfixe "DAEMON_" et les définir au niveau de la cellule :
    • DAEMON_ras_default_msg_dd =DEFALTDD
    • DAEMON_ras_hardcopy_msg_dd =HRDCPYDD
  2. Mettez à jour les procédures dans PROCLIB pour ajouter ces nouvelles instructions DD :
    //* Output DDs
    //CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE 
    //SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE 
    //DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
Remarque :
  • Si vous spécifiez les nouvelles variables d'environnement, mais que vous n'indiquez pas les cartes DD dans la procédure, vous ne recevrez aucun message d'erreur indiquant que les cartes DD sont manquantes et que la sortie de traçage ne sera écrite nulle part.
  • Si vous essayez de diriger la sortie de plusieurs flots vers le même DD, par exemple en paramétrant ras_default_msg_dd et ras_hardcopy_msg_dd sur DEFALTDD (ou sur SYSPRINT), l'attribution échoue et la sortie sera envoyée à l'emplacement par défaut (JOBLOG/SYSLOG).
Par exemple, ces fichiers DD sont utilisés pour séparer les messages et garder la plupart d'entre eux hors de la console de copie papier (SYSLOG) :
  1. JESMSGLG - quelques messages de démarrage et d'arrêt
  2. JESYSMSG - messages d'attribution et de libération MVS
  3. SYSOUT - quelques messages de démarrage et d'arrêt
  4. SYSPRINT - quelques messages de démarrage et d'arrêt
  5. HRDCPYDD - messages d'audit qui vont normalement dans SYSLOG
  6. DEFALTDD - messages d'information qui vont normalement dans SYSLOG

Icône indiquant le type de rubrique Rubrique de référence



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=rtrb_msgrouting
Nom du fichier : rtrb_msgrouting.html