Depurando o EmailPlus

Sobre Esta Tarefa

Siga estas etapas para ativar a funcionalidade de depuração do EmailPlus:

Procedimento

  1. Defina uma variável de ambiente do sistema denominada EMP_DEBUGOUT_LEVEL. Configure o valor da variável EMP_DEBUGOUT_LEVEL para um destes valores:
    Opção Descrição
    1 Liste todas as chamadas de função do EmailPlus e os parâmetros passados para as funções
    2 Liste todas as chamadas de função do EmailPlus, os parâmetros passados para as funções e os valores de retorno
    3 Depuração Integral, o que pode gerar muito conteúdo de saída
  2. Se estiver depurando nos sistemas Linux ou UNIX, você deverá configurar o valor da variável EMP_DEBUGOUT_FILE ao nome de um arquivo em que o IBM® Rational ClearQuest possa gravar. Não inclua espaços no caminho completo do nome de arquivo de depuração. Por exemplo, crie um nome de arquivo similar a esta linha: EMP_DEBUGOUT_FILE=/tmp/EmailPlusDebug.log.

O que Fazer Depois

Para visualizar a saída de depuração no Microsoft Windows, execute o Windows Debugger (dbwin32.exe). A saída de depuração que é gerada pelo EmailPlus tem este prefixo:

#EMP_DEBUGOUT# <DATE> : <FUNCTION NAME> : <DEBUG MESSAGE>

Por exemplo, quando o valor da variável EMP_DEBUGOUT_LEVEL é 2, a seguinte saída pode ser gerada:
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: START
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: START - Cache EmailPlusConfig
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: END
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: EMP::ConfigCache::isEmailPlusActive = <YES>
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: END  - isEmailPlusActive=<1>
Para visualizar a saída de depuração nos sistemas Linux ou UNIX, visualize o conteúdo do arquivo que você definiu na variável EMP_DEBUGOUT_FILE. Ao ativar a depuração do EmailPlus, o desempenho do ClearQuest é afetado. Ative a depuração somente quando for necessário fazê-lo e, em seguida, desative-o quando a depuração estiver concluída. Você deve definir ou modificar a variável EMP_DEBUGOUT_FILE antes de iniciar o cliente ClearQuest. As mudanças que você fizer à variável EMP_DEBUGOUT_FILE enquanto o cliente ClearQuest estiver executando não serão reconhecidas até que o cliente ClearQuest seja reiniciado.

Feedback