Utilizando o console administrativo do HATS

A interface administrativa do HATS pode ser utilizada para gerenciar conexões e executar determinação de problemas para aplicativos da Web HATS. Este capítulo descreve como é possível utilizar essas funções de gerenciamento. Para obter informações relacionadas aos aplicativos rich client do HATS, consulte Administrando Aplicativos Rich Client do HATS.

É possível incluir arquivos de suporte do console administrativo do HATS com o conjunto de aplicativos HATS contidos dentro de um arquivo .ear (Enterprise Archive) implementado para o WebSphere Application Server. O arquivo .ear implementado fornece um ambiente de tempo de execução, no qual o console administrativo do HATS permite gerenciar aplicativos HATS. Se você incluir os arquivos do console administrativo do HATS em vários projetos, mais de um console administrativo poderá ser iniciado utilizando diferentes nomes de aplicativos; no entanto, cada console administrativo fornece as mesmas visualizações e funções.

Nota:
Esta opção não é suportada pelos projetos de portlet padrão do HATS.

Em vez de incluir os arquivos de suporte do console administrativo do HATS em cada arquivo .ear, você pode criar um arquivo .ear que contenha apenas arquivos do console administrativo do HATS. Ao implementar este arquivo .ear, é possível iniciar o HATS console administrativo e alterar o escopo de gerenciamento para gerenciar remotamente os aplicativos HATS em vários arquivos .ear (bem como portlets HATS IBM® e padrão) com uma instância do console administrativo. O aplicativo implementado do console administrativo do HATS fornece um único ponto de administração para todos os aplicativos do HATS. Ao criar um novo projeto do HATS, você especifica se deve incluir os arquivos do console administrativo do HATS no projeto. Se você criar um projeto do console administrativo do HATS, não precisará mais incluir os arquivos de suporte de administração em outros projetos que criar.

Para criar um projeto do console administrativo do HATS no HATS Toolkit, siga o caminho Arquivo > Novo > Projeto > HATS > Projeto de Administração do HATS. Você deve especificar um nome de projeto Enterprise Application que identifique exclusivamente esse projeto como o projeto do console administrativo do HATS. O projeto do console administrativo do HATS apenas aparece no HATS Toolkit na guia Navegador. Implemente e inicie o arquivo .ear criado no WebSphere Application Server (consulte Iniciando o Console Administrativo do HATS). Para alterar o escopo do gerenciamento para o projeto do console administrativo do HATS, consulte Selecionando o Escopo de Gerenciamento.

Outros tópicos de administração estão descritos em Funções do Terminal de Vídeo.

Console Administrativo do HATS e Segurança do WebSphere

O console administrativo do HATS utiliza um bean JMX (Java™ Management Extensions) para desempenhar a administração remota. Quando a segurança global do WebSphere Application Server está ativada, estas chamadas de JMX são autenticadas pela segurança do WebSphere e devem ter um nível válido de autorização no WebSphere. Conseqüentemente, a administração remota do console administrativo do HATS não funciona adequadamente, a menos que o ID do usuário esteja definido como um usuário do console administrativo do WebSphere Application Server com autoridade de Administrador ou de Operador.

O console administrativo do HATS permite visualizar e alterar configurações de determinação de problemas. Ele também permite visualizar status de conexão ou desconectar conexões do host. Quando você implementa um aplicativo do HATS com recursos administrativos do HATS, pode mapear cada uma das três funções do HATS para IDs de usuário do sistema específicos para segurança. As três funções do HATS definidas (HATSAdministrator, HATSOperator e HATSMonitor) possuem recursos diferentes dentro do console administrativo do HATS. Para obter informações adicionais, consulte Funções do Console Administrativo do HATS.

De modo semelhante, o console administrativo do WebSphere Application Server permite visualizar e alterar a configuração do ambiente do WebSphere Application Server. Ele permite instalar, iniciar, parar e desinstalar aplicativos da Web como aplicativos do HATS. Existem funções do usuário do console do WebSphere (Administrador, Configurador, Operador ou Monitor) que fornecem diferentes recursos no console administrativo do WebSphere Application Server. Os seguintes links do Centro de Informações do WebSphere Application Server fornecem detalhes adicionais sobre estas funções de segurança e políticas:

Se a segurança global do WebSphere estiver ativada, os IDs de usuários que possuem uma função do HATS poderão conectar-se ao console administrativo do HATS em um aplicativo do HATS e poderão desempenhar tarefas de administração apenas nesse aplicativo específico do HATS. Se o usuário tentar alterar o escopo de gerenciamento para administrar remotamente outro aplicativo do HATS, a segurança do WebSphere verificará a autoridade do ID do usuário. Se o ID do usuário não for um usuário válido do console administrativo do WebSphere Application Server com autoridade de Administrador ou Operador, as chamadas de JMX serão bloqueadas e a administração remota do HATS não funcionará adequadamente.

Por exemplo, se o ID do usuário não for definido como um usuário do console administrativo do WebSphere Application Server ou for definido com apenas autoridade de Monitor, a lista Selecionar Aplicativo em Escopo de Gerenciamento no console administrativo do HATS não exibirá nenhum outro aplicativo do HATS. Não será possível alterar o escopo do gerenciamento porque nenhum outro aplicativo está listado.

Como outro exemplo, se o ID do usuário estiver definido como um usuário do console administrativo do WebSphere Application Server com a autoridade de Configurador, a lista mostrará outros aplicativos do HATS e o usuário poderá alterar o escopo de um aplicativo para o outro. No entanto, as informações mostradas no console administrativo do HATS poderão estar incorretas e todas as alterações tentadas através da administração remota não terão efeito.

Portanto, se a segurança global do WebSphere estiver ativada, existirão duas opções para utilizar o console administrativo do HATS.

Opção 1: Manter as funções do usuário do HATS e do WebSphere Application Server separadas
Se não desejar fornecer autoridade de administração do WebSphere Application Server a nenhum dos IDs de usuário mapeados para funções do HATS, você deverá incluir o console administrativo do HATS em cada aplicativo do HATS e será necessário administrar cada aplicativo do HATS separadamente utilizando o console administrativo do HATS para esse aplicativo específico. Você não poderá utilizar a administração remota.
Opção 2: Combinar funções do usuário do HATS e do WebSphere Application Server
Se você desejar utilizar o console administrativo do HATS em um único aplicativo do HATS para administrar remotamente outros aplicativos do HATS alterando o escopo de gerenciamento, então, os IDs de usuário mapeados para funções do HATS também deverão ser definidos no WebSphere Application Server como usuários do console administrativo do WebSphere com função de Administrador ou de Operador. Estes usuários poderão alterar o escopo de gerenciamento no console administrativo do HATS e poderão desempenhar as outras tarefas administrativas do HATS permitidas para a função do HATS específica para a qual eles são mapeados. Além disso, os usuários também poderão efetuar logon no console administrativo do WebSphere Application Server e desempenhar tarefas administrativas do WebSphere permitidas para a função de usuário do console administrativo do WebSphere Application Server para a qual eles são mapeados.

Para cada uma das opções, se a segurança global do WebSphere estiver ativada, certifique-se de que a opção Ativar Segurança do Aplicativo esteja selecionada. Para WebSphere Application Server V6.x, a partir do Console Administrativo WebSphere, selecione Segurança > Administração, Aplicativos e Infraestrutura Seguros > Segurança do Aplicativo > Ativar Segurança do Aplicativo. Para o WebSphere Application Server V7.x, a partir do Console Administrativo WebSphere, selecione Segurança > Segurança Global > Segurança do Aplicativo > Ativar Segurança do Aplicativo.

Em resumo, se a segurança global do WebSphere estiver ativada, os IDs de usuário que são mapeados para qualquer função do HATS também deverão ser mapeados para as funções de Administrador ou Operador do WebSphere Application Server para que a administração remota do HATS funcione adequadamente.

Funções do Console Administrativo do HATS

O console administrativo do HATS está vinculado à segurança do WebSphere. Isto significa que, quando a segurança do WebSphere Application Server está ativada, seus administradores de sistema devem ter a autenticação apropriada para desempenhar tarefas administrativas do HATS. As funções de segurança utilizadas pelo HATS são baseadas no processo de autenticação baseado em formulários do Java EE. Quando a segurança do WebSphere Application Server está ativada, as operações do console administrativo do HATS estarão restritas com base na função definida para um ID do usuário. Existem três funções definidas para utilização do console administrativo do HATS. Cada função tem recursos diferentes.

HATSAdministrator
Esta função possui capacidade de administração completa, capaz de fazer todas as seguintes tarefas: Por padrão, a função do HATSAdministrator é mapeada para os usuários "Todos Autenticados".
HATSOperator
Esta função é equivalente à função do HATSAdministrator, mas não pode acessar os dados potencialmente sensíveis. Um usuário com essa função não pode ativar o rastreio do terminal de vídeo nem os arquivos de rastreio de download.
HATSMonitor
Esta função permite apenas que o usuário exiba os dados não sensíveis, como conexões ativas, conjuntos de conexão, listas do usuário e logs. Um usuário com essa função não pode alterar nenhuma definição, como as definições de gerenciamento de licença, log e opções de arquivo de rastreio, definições do terminal de vídeo nem os arquivos de rastreio de download.

O mapeamento de funções para usuários ou grupos de usuários é executado utilizando o console administrativo do WebSphere.

Para o WebSphere Application Server V6.x, certifique-se de a opção Todos Autenticados no painel Mapear Funções de Segurança para Usuários/Grupos esteja marcada para a função apropriada do HATS. Para o WebSphere Application Server V7.x, certifique-se de que a opção Todos Autenticados na Região do Aplicativo esteja selecionada utilizando a opção suspensa Mapear Assuntos Especiais no painel Mapear Funções de Segurança para Usuários/Grupos para a função apropriada do HATS.

Iniciando o Console Administrativo do HATS

O console administrativo do HATS é baseado na Web. As tarefas de administração são desempenhadas utilizando um navegador da Web, através de uma interface com o usuário fornecida pelo servlet do console administrativo do HATS, HATSAdminServlet.

Para iniciar o console administrativo do HATS, carregue esta URL em seu navegador: http://host:port/appname/hatsadmin/admin, em que host é seu nome do host, port é o número de porta do transporte HTTP do servidor de aplicativos no qual o aplicativo do HATS está em execução e appname é o nome de um aplicativo do HATS que inclui o suporte à administração.

Nota:
A especificação de porta não é necessária se os pedidos da URL forem direcionados para um servidor da Web configurado para o WebSphere.

Quando você iniciar o console administrativo do HATS, ele utilizará o idioma padrão do servidor. Você pode, no entanto, alterar o idioma selecionando Preferências no quadro de navegação, escolhendo o idioma que você deseja e reiniciando o navegador. A nova opção de idioma permanece em vigor para esse navegador até que você selecione outro idioma em Preferências.

Notas:
  1. Se os cookies forem desativados para o navegador que está acessando o console administrativo do HATS, ocorrerão as seguintes alterações:
  2. Para obter uma lista de navegadores da Web suportados e limitações, consulte a Seção de Pré-requisitos do HATS do Centro de Informações do HATS no endereço http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.

Iniciando o Console Administrativo Enquanto Está no HATS Toolkit

O console administrativo do HATS pode ser iniciado no HATS Toolkit, utilizando o modo Depurar no Servidor ou Executar no Servidor.

Para ativar o console administrativo do HATS para um projeto específico, clique com o botão direito do mouse no projeto na visualização Projetos HATS e clique em Abrir Console Administrativo.

Se o projeto ainda não estiver executando em um ambiente de teste local, então, ele será ativado utilizando o modo Depurar no Servidor e uma página do navegador da Web será aberta para a URL do console administrativo.

Se o projeto já estiver em execução utilizando o modo Executar no Servidor, será exibido um aviso informando que o servidor não está em execução no modo Depurar. Se você selecionar a opção Continuar no Modo Atual, o console administrativo abrirá no modo Executar no Servidor.

Para obter informações adicionais sobre a execução em modos de teste diferentes, consulte Testando modos para projetos da Web em Introdução ao HATS.

As configurações de tempo de execução alteradas ao executar o console administrativo no HATS Toolkit dependem de qual modo está sendo utilizado. Para obter informações adicionais, consulte Administrando Componentes de Determinação de Problemas.

Utilizando as Funções no Console Administrativo do HATS

Esta seção guiará você pelas diversas funções no console administrativo do HATS.

Selecionando o Escopo de Gerenciamento

É possível selecionar o escopo de gerenciamento. O console administrativo do HATS mantém uma lista dos escopos de gerenciamento para a vida útil do HttpSession. Por padrão, o escopo inicial do gerenciamento é selecionado como o aplicativo corporativo HATS (.ear) do aplicativo HATS utilizado para acessar o console administrativo do HATS. Você pode alterar o escopo do gerenciamento para gerenciar outros aplicativos corporativos do HATS implementados na mesma célula do WebSphere.

A chave para alterar o escopo de gerenciamento é fornecer as informações de host e porta para o console administrativo do HATS para localizar os aplicativos corporativos HATS instalados. O valor de porta especificado deve ser uma porta BOOTSTRAP_ADDRESS do WebSphere ativa. Cada WebSphere Application Server, nó e célula possui uma porta BOOTSTRAP_ADDRESS. A especificação do valor de porta para um destes recursos do WebSphere ativa a administração dos aplicativos corporativos do HATS implementados para esse recurso. Especificar um host e porta de um nó do WebSphere ativa a administração de todos os aplicativos corporativos do HATS instalados nesse nó. Consulte a documentação do WebSphere Application Server para obter informações adicionais sobre a porta BOOTSTRAP_ADDRESS.

Em um ambiente seguro, um administrador pode ver a seguinte mensagem no console administrativo do HATS ao tentar alterar o escopo de administração:

Houve um problema ao tentar gerenciar o escopo selecionado. Não foi localizado nenhum aplicativo HATS. Seu escopo de gerenciamento não foi alterado.

Isto pode ocorrer porque em um ambiente protegido do WebSphere, o usuário não está autorizado a realizar a comunicação requerida para preencher a lista de aplicativos disponíveis a serem administrados.

Se o WebSphere estiver utilizando o sistema operacional local como o registro do usuário, o nome do usuário utilizado para acessar o console administrativo do HATS deverá ter direitos de administrador no registro do sistema operacional local. Se o WebSphere estiver utilizando LDAP como o registro do usuário, o nome do usuário utilizado para acessar o console administrativo do HATS deverá ser o ID do servidor utilizado pelo WebSphere para acessar o LDAP.

Gerenciando Licenças

Existem dois painéis sob o título Gerenciamento de Licença no quadro de navegação esquerdo para gerenciar as informações de licença:

Monitorando Conexões

Existem painéis separados sob o título de Gerenciamento de Conexão no quadro de navegação esquerdo com o qual você pode monitorar os diferentes tipos de conexões:

Cada conexão mostrada nessas exibições representa um link de comunicação à origem de dados backend, como um aplicativo 3270 ou um banco de dados. As exibições permitem que você veja detalhes sobre quais usuários estão conectados a quais origens de dados e quais identificadores de conexão eles estão utilizando. Se existir um nome de LU ou Conjunto para uma conexão 3270, ele também será exibido. Você também pode encerrar sessões.

Monitorando Conjuntos de Conexões

O painel Conjuntos de Conexões sob o título Gerenciamento de Conexão no quadro de navegação esquerdo exibe as informações sobre os conjuntos de conexão definidos. Um conjunto de conexões não é relacionado até que pelo menos uma conexão seja alocada no conjunto.

Os conjuntos de conexões são coleções de links de comunicação para origem de dados de backend, tais como bancos de dados ou aplicativos 3270. Quando um Objeto de Integração ou um aplicativo for executado devido à solicitação de um cliente, ele obtém uma conexão disponível de um conjunto, a utiliza para acessar a origem de dados e, em seguida retorna a conexão ao conjunto. Quando o conjunto de conexões é ativado, o uso do processador para estabelecer uma conexão é absorvido em sua primeira utilização. Cada reutilização desta conexão obtém benefícios da conexão estabelecida anteriormente e pode ser executada mais rápido.

Monitorando Configurações de Conjuntos

O painel Definições do Conjunto de Conexões sob o título Gerenciamento de Conexão no quadro de navegação esquerdo exibe as informações de definição do conjunto para conexões do host e do banco de dados. Uma definição de conjunto não será listada até que ao menos uma conexão seja alocada a partir do conjunto definido.

Uma definição do conjunto fornece informações sobre uma coleção de conexões de fontes de dados. Algumas definições relacionadas estão associadas a uma definição de conjunto, por exemplo, definições de conexão e de macro e nome da lista de usuários. Além de criar associações entre várias outras definições, a definição do conjunto fornece parâmetros de configuração para todas as conexões no conjunto, como tamanho mínimo e máximo do conjunto (em termos de número de conexões ativas) e temporizadores de conexão.

Monitorando Listas de Usuários e Membros de Listas de Usuários

O painel Listas de Usuários sob o título Gerenciamento de Usuário no quadro de navegação esquerdo exibe as informações sobre as listas de usuários.

As listas de usuários identificam os IDs de usuário e outros parâmetros específicos da conexão associados a uma determinada definição de conjunto de conexões. Para sistemas que permitem apenas uma única conexão por ID de usuário, o número de IDs de usuário determina o número de conexões que podem estar ativas em um único conjunto.

Administrando Componentes de Determinação de Problemas

O console administrativo do HATS permite monitorar a criação de log e rastreio para ajudá-lo a resolver problemas. Você pode visualizar as mensagens no log e alterar as configurações de log e de rastreio, selecionando os links sob o título Resolução de Problemas no quadro de navegação esquerdo. Arquivos de propriedades mantêm configurações para esses auxílios de determinação de problemas.

Quando você altera configurações enquanto acessa o console administrativo do HATS em execução em um ambiente de tempo de execução, as alterações são salvas no arquivo runtime.properties. Embora não seja recomendado, você também pode editar o arquivo diretamente para alterar as configurações. O arquivo é localizado no diretório was_dir/installedApps/ear_name para um aplicativo corporativo HATS.

Quando você altera configurações enquanto acessa o console administrativo do HATS em execução em um ambiente de teste local no HATS Toolkit, as alterações são salvas em um de dois arquivos diferentes. As alterações são salvas no arquivo runtime.properties ao executar no modo Executar no Servidor e no arquivo runtime-debug.properties ao executar no modo Depurar no Servidor. Para obter informações adicionais, consulte Iniciando o Console Administrativo Enquanto Está no HATS Toolkit. Você também pode editar os arquivos diretamente para alterar as configurações. Os arquivos estão localizados na raiz do projeto .ear no HATS Toolkit. Esteja ciente de que qualquer alteração feita no arquivo runtime.properties no HATS Toolkit será retida e se tornará efetiva quando você implementar o aplicativo do HATS em um ambiente de tempo de execução. O arquivo runtime-debug.properties é ignorado no ambiente de tempo de execução.

Nota:
Ao executar no WebSphere Application Server para z/OS, o arquivo runtime.properties deve ser editado com um editor ASCII. Isto pode ser feito transferindo o arquivo para uma estação de trabalho, por exemplo utilizando FTP, editando o arquivo e transferindo-o de volta. Além disso, há uma cópia do runtime.properties para cada Servant ativo dentro de um servidor de aplicativos (caracterizado com o ID do Espaço de Endereçamento do Servant). O arquivo base runtime.properties deve ser alterado para que as alterações persistam entre os reinícios do servidor de aplicativos.

Para obter informações adicionais sobre configurações de log e rastreio nestes arquivos, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução.

Nomes dos Arquivos de Rastreio e Log

Os nomes de base dos arquivos de rastreio e log em runtime.properties são utilizados como modelos para gerar conjuntos exclusivos de arquivos de rastreio e log para cada servidor de aplicativos. O nome base padrão do arquivo de rastreio é trace.txt; o nome base padrão do arquivo de log é messages.txt. O nome do servidor de aplicativos é anexado ao nome básico do arquivo para gerar o modelo para os arquivos de rastreio e log para um servidor de aplicativos. O nome do servidor de aplicativos é o mesmo que o nome completo do servidor de aplicativos, conforme definido pelo WebSphere. Esse nome é cell_node_server, em que:

O servidor de aplicativos executando o HATS é a concatenação do caractere de sublinhado (_) seguido pelo nome do servidor de aplicativos, seguido por outro caractere de sublinhado (_).

Utilizando o arquivo de rastreio como exemplo, o nome se torna trace _cell_node_server_.txt. Finalmente, um índice (1, 2, 3 e assim por diante) será incluído nesse nome para diferenciar vários arquivos. Com vários arquivos de rastreio configurados, os nomes do arquivo de rastreio para este servidor de aplicativos são trace_cell_node_server_1.txt, trace_cell_node_server_2.txt e assim por diante.

Nota:
Ao executar no WebSphere Application Server para z/OS, um servidor de aplicativos pode ter mais de um Servant em execução, com cada Servant gerando arquivos de log e de rastreio exclusivos. Para distingui-los, o componente do servidor do nome tem o prefixo de Address Space ID (ASID) do Servidor (exemplo: trace_asid_1.txt).

Visualizar Log

Utilizando o painel Visualizar Log, você pode visualizar o arquivo de log do HATS, fazer download do arquivo inteiro ou limpar o arquivo. O arquivo de log registra as informações sobre dois tipos de eventos:

Eventos de erro
Problemas que impedem a conclusão de uma operação. Os eventos de erro geralmente requerem que você execute alguma ação para corrigir o problema.
Eventos de aviso
Ocorrências inesperadas que podem requerer ação para corrigir o problema. Os eventos de aviso não são tão sérios quanto os eventos de erro.

O arquivo de registro é destinado para você ler e utilizar como uma referência quando detectar problemas. A maioria das mensagens que aparecem no log é documentada na publicação Mensagens do HATS. Essa publicação contém sugestões para ações que você pode tomar para corrigir os problemas, quando necessário.

Nota:
No Windows®, você não pode renomear ou excluir a saída padrão e os logs de erro padrão enquanto os aplicativos do HATS estão em execução. Se você renomear ou excluir esses logs como parte dos procedimentos de resolução de problemas, para recuperar espaço em disco ou minimizar o tamanho de um arquivo de pacote de informações, você deve parar o servidor de aplicativos que representa o HATS. No entanto, o nó do WebSphere pode permanecer em execução.

Definir Opções de Log

Utilizando o painel Configurações de Log, é possível controlar se as informações e eventos de avisos serão gravados no arquivo de log e definir o arquivo no qual os eventos de log serão gravados. Consulte Nomes dos Arquivos de Rastreio e Log para obter informações sobre como os arquivos de log são nomeados. Se o arquivo já existir, novos eventos serão anexados a ele. Eventos de erro são sempre gravados no arquivos de registro. Também é possível definir como os arquivos de log são mantidos e o tamanho máximo de cada arquivo de log.

Definir Opções de Rastreio

Utilizando o painel Configurações do Rastreio, você pode selecionar um ou mais dos seguintes tipos de opções de rastreio:

Ativar Rastreio de Tempo de Execução
Ativa o rastreio no tempo de execução do HATS para conexões em seu projeto. Para rastrear essas conexões de tempo de execução em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre as configurações de rastreio.
Ativar Rastreio de Widget
Ativa o rastreio no tempo de execução do HATS para widgets em seu projeto. Para rastrear widgets em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre configurações de rastreio.
Ativar Rastreio de Ação
Ativa o rastreio no tempo de execução do HATS para ações de eventos em seu projeto. Para rastrear eventos em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre configurações de rastreio.
Ativar Rastreio do Componente
Ativa o rastreio no tempo de execução do HATS para componentes em seu projeto. Para rastrear componentes em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre configurações de rastreio.
Ativar Rastreio de Util
Ativa o rastreio no tempo de execução do HATS para utilitários de tempo de execução em seu projeto. Para rastrear esses utilitários de tempo de execução em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre as configurações de rastreio.
Rastreio de Objetos de Integração
Ativa o rastreio em Objetos de Integração específicos no seu projeto. Utilize o campo de especificação Nome da Classe para especificar quais Objetos de Integração rastrear, utilizando um ou mais padrões. Cada padrão pode conter um ou mais caractere (*) curinga. Por exemplo, o IntegrationObject.Callup* especifica que o rastreio é ativado para todos os Objetos de Integração que comecem com as letras Callup. Para rastrear todos os Objetos de Integração, especifique IntegrationObject.*. Se vários padrões estiverem especificados, deverão ser delimitados com vírgulas. O console administrativo do HATS configura a definição Objeto de Integração para o nível máximo de rastreio. Para rastrear Objetos de Integração em um nível diferente, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução para obter informações sobre configurações de rastreio.
Rastreio de Applet
Ativa o rastreio do applet. O nível mais alto de rastreio produzirá informações adicionais sobre rastreio. Quando o rastreio de applet estiver ativado, ele gerará mensagens do lado do servidor para resolução de problemas. Para obter informações adicionais sobre configurações de rastreio de applet, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução.
Rastreio da Macro do Usuário
Rastreia a execução de macros. Como afeta o desempenho do sistema, recomendamos que você utilize esse rastreio somente para depuração de macros.
Terminal de Vídeo
Permite visualizar a tela do terminal host de qualquer conexão conforme é executada em tempo real no servidor. Depois de ativar o terminal de vídeo, as configurações de terminal são mostradas apenas para as conexões recém-criadas. Para obter informações adicionais sobre Terminal de Vídeo, consulte Utilizando o Terminal de Vídeo para Teste e Depuração.
Nota:
Você pode decidir se o HATS deve exibir um diálogo perguntando se você deseja ligar o terminal de exibição ao executar no Servidor. Para obter informações adicionais, consulte Utilizando Preferências do HATS.
Registrar Rastreio de Simulação do Host
Selecione a caixa Ativar Registro de Simulação do Host para ativar o registro de simulação do host durante o tempo de execução. O registro inicia na próxima vez que uma sessão do host inicia e finaliza quando a sessão do host é fechada, por exemplo, quando o usuário clica no botão Desconectar no teclado numérico do aplicativo. Se o usuário fechar o navegador da Web enquanto o rastreio estiver ativo, o rastreio continuará até que a sessão HTTP exceda o tempo limite. O arquivo de rastreio é salvo na pasta de simulações do host no servidor, por exemplo, <raiz de instalação do WebSphere>\AppServer\profiles\AppSrv01\installedApps\<ID do Nó>\<nome do arquivo ear>\<ApplicationName>.war\WEB-INF\profiles\hostsimulations. Os arquivos de rastreio são denominados utilizando o seguinte modelo, ApplicationName_ConnectionName_Date(yyyymmdd)_Time(hhmmss)_Number, por exemplo, MyApplication_main_20060101_134543_1.

Para rastrear várias sessões do host simultaneamente, a simulação do host utiliza várias portas TCP/IP. Utilize os campos Intervalo de Portas TCP/IP para Registro para configurar o intervalo de números de portas para uso de tempo de execução do servidor. A porta de início padrão no intervalo é 7021 e a porta de finalização padrão é 7050.

Opções de Rastreio de Serviço da IBM
O console administrativo do HATS também inclui uma caixa de opções Exibir Opções de Rastreio do Serviço com a qual é possível ativar rastreios (se instruído para isso pelo serviço IBM). Você não deve utilizar estes rastreios, a menos que seja solicitado pelo serviço IBM.
Saída do Rastreio
Permite controlar se as informações de rastreio são gravadas para o arquivo de rastreio e definir o arquivo para o qual os eventos de log serão gravados. Consulte Nomes dos Arquivos de Rastreio e Log para obter informações sobre como os arquivos de rastreio são nomeados. Se o arquivo já existir, novas informações de rastreio serão anexadas. Também é possível definir quantos arquivos de rastreio manter e o tamanho máximo de cada arquivo de rastreio.

Funções do Terminal de Vídeo

Utilizando o Terminal de Vídeo para Teste e Depuração

Ao depurar aplicativos em um sistema de teste, você pode controlar se uma janela do terminal que exibe telas do host é criada no vídeo do servidor. Você pode utilizar telas do host exibidas na janela do terminal para observar as interações entre os aplicativos HATS e o aplicativo host no tempo de execução. Você também pode interagir com o aplicativo do host utilizando a tela do host na janela do terminal. As telas do terminal são criadas apenas para conexões estabelecidas enquanto esta opção está ativada. Não são criadas para conexões existentes ou inativas. No entanto, o painel Conexões do Host no console administrativo do HATS inclui um botão Comutar Status de Vídeo que liga e desliga o terminal de vídeo para as conexões selecionadas.

CUIDADO:
Ativar a opção terminal de vídeo pode afetar seriamente o desempenho ou sobrecarregar o servidor. Não a utilize em servidores com várias conexões. O terminal de vídeo foi idealizado para utilização em depurações durante o desenvolvimento de aplicativos em um sistema de teste; não foi desenvolvido para utilização em um servidor de produção com carga pesada.

Você pode ativar o terminal de vídeo para quaisquer novas conexões do host, selecionando a caixa Ativar Terminal de Vídeo no painel Configurações de Rastreio, sob o título Resolução de Problemas, no quadro de navegação esquerdo; no entanto, você pode utilizar Comutar Terminal de Vídeo no painel Conexões do Host para ativar e desativar o terminal de vídeo para uma conexão específica a qualquer momento, independentemente de você ter selecionado a caixa Ativar Terminal de Vídeo no painel Configurações de Rastreio.

Notas:
  1. Para o terminal de exibição trabalhar apropriadamente quando o WebSphere Application Server é iniciado como um serviço na plataforma Windows, você deve selecionar Permitir que o serviço interaja com o desktop nas configurações do serviço para o WebSphereApplication Server.
  2. Para obter informações sobre a exibição de gráficos, necessária para a função do terminal de exibição, utilizando o NAWT (Native Abstract Windowing Toolkit) na plataforma IBM i, consulte a seção Running your Java application on a host that does not have a graphical user interface, no documento System i Programming IBM Developer Kit for Java, no endereço http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/rzaha/rzaha.pdf.
  3. Para obter informações sobre a configuração das funções do terminal de exibição em outras plataformas, consulte a seção, System i, System z, and Unix platform-specific information, no Centro de Informações do HATS no endereço http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.