Existem situações em que há necessidade de detalhar o que está sendo executado na sessão client ou quando algum erro é gerado, a configuração de um log com mais informações pode auxiliar na identificação da causa do problema. Neste post será detalhado o significado dos principais parâmetros para configuração de log que podem ser utilizados em uma sessão client.
-clientlog:
O parâmetro -clientlog permite que uma aplicação escreva automaticamente todos os erros e mensagens de aviso para o arquivo de log especificado neste parâmetro.
Na conexão e desconexão do banco de dados, uma entrada é apresentada no arquivo de log identificando o banco de dados e o nome do usuário (para conexões multi-usuário). Estas informações podem ser usadas para relacionar mensagens do client com mensagens do log do banco de dados.
Em uma sessão não-interativa, a aplicação é configurada de forma que o dispositivo de saída é associado com um arquivo (ou outro dispositivo). Nesta configuração, quando o Progress encontra um erro, escreve o erro no dispositivo de saída. Se o client logging está habilitado, então esta mensagem também será escrita no arquivo de log especificado.
É possível usar a instrução MESSAGE com o VIEW-AS ALERT-BOX para a aplicação escrever em tela a informação específica. Toda informação escrita em tela usando o MESSAGE VIEW-AS ALERT BOX também será escrita no arquivo de log.
-logentrytypes:
Use Log Entry Types (-logentrytypes) para especificar um ou mais tipos de entradas de log para escrever no arquivo de log especificado no parâmetro -clientlog.
Por padrão, o nível de log é especificado pelo parâmetro -logginglevel (que veremos a seguir), aplicado para todos os tipos de entrada de log especificados.
Segue abaixo os tipos de entradas de log:
Exemplo de utilização deste parâmetro: -logentrytypes DB.Connects,4GLTrace:2
Conforme exemplo acima, para usar vários entrytypes é necessário separá-los por vírgula (,). Além disso, também é possível usar um logginglevel diferente para cada entrytype, separando-os por dois pontos (:).
-logginglevel:
Use Logging Level (-logginglevel) para especificar o nível na qual as entradas de log serão escritas no arquivo de log especificado no parâmetro -clientlog. Cada nível de log especifica uma quantidade diferente de informações.
0 (None): Sem entradas no log. Isto equivale a não gravação de informações no log.
1 (Errors): Gravação de mensagens de erros. Isto inclui todas as mensagens de erro e é desvinculado aos tipos de entradas especificadas.
2 (Basic): O Log Entry Types determina a informação escrita no log. Cada tipo de entrada gerará alguma informação no log. Esta é a opção padrão.
3 (Verbose): O Log Entry Types determina a informação escrita no log.
4 (Extend): O Log Entry Types determina a informação escrita no log.
No próximo post serão abordados mais parâmetros para coletar informações em uma sessão client.
Assinar feeds (RSS)