Adiciona uma mensagem no arquivo de LOG do AppServer quando o modo de DEBUG estiver ativo no ambiente ou quando for ativado modo de execução da aplicação via chave no arquivo de profile ou chamada de função Framework.
Cada mensagem de LOG no modo DEBUG gerada no arquivo de LOG do AppServer será precedida pela TAG "[DEBUG]".
Para saber mais sobre o modo DEBUG acesse LGX - Chaves de configuração no arquivo de Profile e acesse as informações da logix.debug.
Sintaxe
LOG_consoleDebugMessage( < l_message > )
Parâmetros
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
l_message |
| Sim | Texto contendo a mensagem a ser adicionada ao arquivo de LOG do AppServer. |
Exemplo
#---------------------------------------# FUNCTION LOG_consoleDebugMessage_test() #---------------------------------------# DEFINE l_message CHAR(250) CALL LOG_consoleDebugMessage("[PROGRAMA] Mensagem com texto fixo a ser gerada no LOG do AppServer") #Mensagem gerada no LOG do AppServer utilizando uma variável LET l_message = "Teste de mensagem a ser adicionada ao LOG do AppServer" CALL LOG_consoleDebugMessage("[PROGRAMA] "||l_message CLIPPED) #Mensagem gerada no LOG do AppServer utilizando um texto fixo acrescido do conteúdo de uma variável LET l_message = "Teste de mensagem a ser adicionada ao LOG do AppServer" CALL LOG_consoleDebugMessage("[PROGRAMA] TEXTO FIXO + VARIAVEL = "||l_message CLIPPED) IF LOG_isDebugMode() THEN CALL LOG_consoleError("[PROGRAMA] Registro de um erro condicionado apenas para ser gerado em modo debug ativo.") END IF END FUNCTION
DICA
Identifique as mensagens de LOG com algum TAG de identificação do programa e/ou função para facilitar a rastreabilidade das mensagens no LOG/DEBUG.
Exemplos de TAG de identificação no início da mensagem de LOG/DEBUG:
[PROGRAMA]
[PROGRAMA][Funcao]
CALL LOG_consoleDebugMessage("[PROGRAMA][Funcao] Exemplo de mensagem gerada com TAG de identificação ")
Informações
Fontes: funcoes_genericas.4gl