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

CHAR

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

(ideia) 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

Veja também

LOG_file_exist