Quando os aplicativos clientes independentes (como aplicativos Java™ que acessam
enterprise beans hospedados no WebSphere Application Server) têm problemas
ao interagir com o WebSphere Application Server, pode ser útil ativar o rastreio
do aplicativo. Ativar o rastreio de programas clientes fará com que as classes do
WebSphere Application
Server utilizadas por esses aplicativos, como classes do cliente de serviço de nomenclatura, gerem informações de rastreio.
Sobre Esta Tarefa
Uma
técnica comum de resolução de problemas é ativar o rastreio nos servidores de aplicativos e
do aplicativos cliente e corresponder os registros de acordo com a data e hora para tentar
compreender o problema em ocorrência.
Também é possível configurar o rastreio a partir do console MVS utilizando
o comando modify.
Procedimento
- Para ativar o rastreio das classes do WebSphere Application Server em um aplicativo cliente,
inclua as propriedades do sistema mostradas no exemplo a seguir para o script de inicialização
ou o comando do aplicativo cliente. O local da saída e as classes e os detalhes incluídos no
rastreio seguem as mesmas regras de inclusão de rastreio nos WebSphere Application Servers. Por exemplo,
para rastrear o programa aplicativo cliente independente denominado com.ibm.sample.MyClientProgram,
digite o seguinte comando:
java -DtraceSettingsFile=MyTraceSettings.properties
-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager
-Djava.util.logging.configureByServer=true com.ibm.samples.MyClientProgram
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
O arquivo identificado por nome do arquivo deve
ser um arquivo de propriedades colocado no caminho de classe do aplicativo cliente ou
processo independente. Você deve criar um arquivo de propriedades de rastreio copiando o arquivo %install_root\properties\TraceSettings.properties para o mesmo diretório do seu arquivo JAR (Java) do aplicativo cliente.
O arquivo identificado por nome do arquivo deve
ser um arquivo de propriedades colocado no caminho de classe do aplicativo cliente ou
processo independente. Você deve criar um arquivo de propriedades de rastreio copiando o arquivo app_server_root/properties/TraceSettings.properties para o mesmo diretório do seu
arquivo JAR (Java archive) do aplicativo cliente.
Você
pode utilizar propriedades
-DtraceSettingsFile=TraceSettings.properties para ativar o rastreio
do componente ORB para clientes thin. A saída de rastreio ORB para clientes thin
podem pode ser direcionada, definindo o parâmetro com.ibm.CORBA.Debug.Output
= debugOutputFilename na linha de comandos.
As propriedades do sistema
java.util.logging.manager and java.util.logging.configureByServer configuram a criação de log Java para utilizar uma classe LogManager específica do WebSphere Application Server e utilizar a configuração
do arquivo especificada pela propriedade traceSettingsFile. O padrão do arquivo de propriedades da Criação de Log Java, localizado no JRE6
(Java SE
Runtime Environment 6), não será aplicado.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Você pode configurar o arquivo MyTraceSettings.properties para
enviar a saída de rastreio para um arquivo utilizando a propriedade traceFileName.
Especifique
uma das duas opções: - O nome completo de um arquivo de saída. Por exemplo, traceFileName=c:\\MyTraceFile.log.
Você deve especificar essa propriedade para gerar uma saída visível.
- stdout. Quando especificado, a saída é gravada no System.out.
- Você também pode especificar uma cadeia de rastreio para gravar mensagens
com a propriedade Cadeia de Rastreio e especificar uma especificação de rastreio de
inicialização semelhante àquela disponível no servidor. Para facilitar, você
pode inserir várias cadeias individuais de rastreio no arquivo de definições de rastreio,
sendo uma cadeia de rastreio por linha.
Resultados
Seguem os resultados da utilização de cada
definição opcional de propriedade:
- Especifique uma definição válida para a propriedade traceFileName sem
uma cadeia de rastreio para gravar mensagens no arquivo especificado ou apenas System.out.
- Especifique uma cadeia de rastreio sem um valor de propriedade traceFileName para
não gerar saída.
- Especifique uma propriedade traceFileName válida e uma cadeia de rastreio
para gravar entradas de mensagem e de rastreio na localização especificada na propriedade traceFileName.