[z/OS]

Gerenciando o Roteamento de Mensagem do Operador

Utilize os recursos de roteamento de mensagens do produto para controlar o fluxo de tráfego do servidor.

É possível rotear muitas mensagens de erros prefixados do BBO para especificar os conjuntos de dados em vez de tê-los como SYSLOG, o que pode criar um lote de tráfico. Isso está implementado com o uso de duas variáveis de ambiente, ras_default_msg_dd e ras_hardcopy_msg_dd, e a especificação da instrução DD apropriada no seu procedimento de inicialização de JCL.

O texto a seguir explica mais detalhadamente como as mensagens são roteadas.
  • As mensagens WTO emitidas pelo Servidor de Aplicativos durante a inicialização são enviadas para a cópia impressa, mas a maioria pode ser roteada para o conjunto de dados especificado por ras_default_msg_dd (consulte Log output destinations and characteristics).
  • As mensagens de auditoria Java™ também são enviadas para a cópia impressa, mas podem ser roteadas para o conjunto de dados especificado por ras_hardcopy_msg_dd. (Consulte Log output destinations and characteristics).
  • Mensagens fatais, de serviços e erros de rastreio podem ser enviadas para o log de erros especificados por ras_log_logstreamName. Caso contrário, eles vão para CERR (SYSOUT). Algumas também podem ir para a cópia impressa. No nível de serviço W500104, a variável de ambiente ras_log_logstreamName não é configurada com o nome do fluxo de logs de erros nas variáveis was.env.

    Para configurar essa variável de ambiente, no console administrativo, clique em Ambiente > Variáveis do WebSphere, selecione um escopo e clique em Novo.

  • As mensagens de erro antecipadas vão para o SYSOUT até que o produto se conecta ao fluxo de logs. Um WTO (BBOO0153I) é emitido dizendo quantas mensagens foram para o SYSOUT antes da conexão com o fluxo de logs.
  • Iniciando com o z/OS Versão 1.13, é possível usar palavras-chave JES2 DD para segmentar a saída usando a gravação periódica de caracteres de alimentação de formulário nos fluxos de saída.

    Se estiver executando no z/OS Versão 1.12 ou anterior, e usando JES2, o parâmetro SEGMENT= poderá ser incluído nas placas SYSPRINT e SYSOUT DD se desejar segmentar a saída usando a gravação periódica de caracteres de alimentação de formulário nos fluxos de saída. Os caracteres de alimentação de formulário são gravados nos fluxos de saída com base nos valores das variáveis de ambiente ras_stderr_ff_interval, ras_stdout_ff_interval, ras_stderr_ff_line_interval e ras_stdout_ff_line_interval. Estas variáveis são descritas com mais detalhes no tópico Propriedades Customizadas do Servidor de Aplicativos para z/OS. O parâmetro SEGMENT= não é suportado no JES3.

    Para configurar essas variáveis de ambiente, no console administrativo, clique em Ambiente > Variáveis do WebSphere, selecione um escopo e, em seguida, clique em Novo.

  • As mensagens de rastreio são roteadas para ras_trace_outputLocation.
  • System.out.println, System.err.println, STDOUT e cout vão para SYSPRINT (consulte o tópico Redirecionando a Saída SYSPRINT e SYSOUT para um Arquivo HFS para obter mais informações.
  • STDERR e cerr vão para SYSOUT
Para usar essas variáveis de roteamento de mensagens, você deve fazer duas coisas:
  1. Inclua esses parâmetros nas definições do servidor usando o Console Administrativo sob Ambiente -> Gerenciar Variáveis do WebSphere:
    • ras_default_msg_dd =DEFALTDD
    • ras_hardcopy_msg_dd =HRDCPYDD
    Você pode definir essas variáveis para controle individual e processos servants, mas é mais fácil defini-las nas variáveis de ambiente para a célula toda. Para o Daemon, você deve prefixá-las com "DAEMON_" e defini-las no nível da célula:
    • DAEMON_ras_default_msg_dd =DEFALTDD
    • DAEMON_ras_hardcopy_msg_dd =HRDCPYDD
  2. Atualize os procedimentos de PROCLIB para incluir estas novas instruções 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
Nota:
  • Se especificar as novas variáveis de ambiente, mas não especificar as placas DD no procedimento, não receberá uma mensagem de erro indicando que as placas DD estão ausentes e a saída do rastreio não será gravada em lugar nenhum.
  • Se você tentar direcionar a saída de diversos fluxos para o mesmo DD, por exemplo, definindo ras_default_msg_dd e ras_hardcopy_msg_dd como DEFALTDD (ou como SYSPRINT,) a alocação falhará e a saída será enviada para o local padrão (JOBLOG/SYSLOG).
Por exemplo, esses arquivos DD são utilizados para segregar as mensagens e manter quase todas elas fora do console de cópia impressa (SYSLOG):
  1. JESMSGLG - algumas mensagens de inicialização e encerramento
  2. JESYSMSG - mensagens de alocação de desalocação do MVS
  3. SYSOUT - algumas mensagens de inicialização e de encerramento
  4. SYSPRINT - algumas mensagens de inicialização e encerramento
  5. HRDCPYDD - mensagens de auditoria que normalmente iriam para o SYSLOG
  6. DEFALTDD - mensagens informativas que normalmente iriam para SYSLOG

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_msgrouting
Nome do arquivo: rtrb_msgrouting.html