Apêndice A. Arquivo de Propriedades de Tempo de Execução

As configurações de tempo de execução, assim como as de log, rastreio e licença, são armazenadas em um destes dois arquivos diferentes:

Para obter mais informações sobre como administrar as configurações de tempo de execução para aplicativos da Web, consulte Administrando Componentes de Determinação de Problemas. Para obter mais informações sobre como administrar as configurações de tempo de execução para aplicativos do rich client, consulte Administrando Aplicativos Rich Client do HATS.

Os arquivos runtime.properties e runtime-debug.properties contêm as seguintes propriedades:

adminPortNum
O adminPortNum é o valor padrão utilizado pelo console administrativo do HATS quando o escopo de gerenciamento tiver que ser alterado. O valor de porta deve ser uma porta WebSphere BOOTSTRAP_ADDRESS ativa. O padrão é 2809, que é a porta padrão BOOTSTRAP_ADDRESS de server1 para uma instalação-base do WebSphere ou do servidor de agente do nó quando você federar um nó do servidor de aplicativos em uma célula do gerenciador de implementação.
ioPatternKey Apenas Web 
Um ou mais padrões especificando os Objetos de Integração que serão rastreados. Consulte a descrição de trace.INTEGRATIONOBJECT abaixo.

Cada padrão pode conter um ou mais caractere (*) curinga. Por exemplo, IntegrationObject.Callup* especifica se o rastreamento será ativado para todos os Objetos de Integração que se iniciam 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.

numLicenses
Especifica o número de licenças adquiridas. O HATS rastreia o número de conexões do HATS para os recursos do host e registra uma mensagem quando o valor excede o número de licenças adquiridas.

O valor é um número inteiro. Não há padrão. Os valores válidos para licenças de Usuário Autorizado são 1 - 50000. Para licenças de Unidade de Valor, o valor deve ser -1.

licenseHardLimit
Um campo criptografado contendo autorização de licenciamento do HATS. Não altear este campo manualmente.
licenseTracking
Especifica se o HATS registra o uso da licença ou não. O valor é binário. O padrão é 0.
0
O HATS não registra o uso da licença.
1
O HATS registra o uso da licença para todos os servidores de aplicativos em um nó. O HATS rastreia o número de conexões do HATS para os recursos do host ou do banco de dados e registra uma mensagem quando o valor excede o número de licenças adquiridas. As informações de utilização da licença são gravadas em um arquivo chamado licensex.txt no diretório log do diretório de instalação do HATS no servidor, em que x é 1 ou 2.

O tamanho máximo dos arquivos de utilização de licenças é de 512 KB. Quando o tamanho do arquivo license1.txt atingir 512 KB ou se o servidor HATS for reiniciado, o arquivo será renomeado para license2.txt e um novo arquivo license1.txt será criado. O novo arquivo license1.txt contém as informações mais recentes de utilização da licença. Quando o novo license1.txt atinge 512 KB e é renomeado, o license2.txt antigo é excluído.

Os arquivos de uso de licenças contêm as seguintes informações, organizadas em linhas, com cada linha representando uma hora de operação. Os valores são separados por um espaço ( ).

  1. Date
  2. Tempo
  3. A contagem mais alta de licenças desde que o servidor foi iniciado
  4. A contagem mais alta de licenças na última hora (o máximo das 60 últimas entradas)
  5. A contagem de licenças de cada minuto (1-60)
licenseFile
O nome utilizado como modelo para gerar nomes para os arquivos de licença para informações de uso da licença. O valor padrão para esta propriedade é license.txt.
logFile
O nome utilizado como modelo para gerar os nomes para cada conjunto de arquivos do servidor de aplicativos nos quais as mensagens de log são gravadas. O nome base padrão para um arquivo de log é messages.txt.
maxLogFiles
Número máximo de arquivos de mensagens. O padrão é 2.

O nome do arquivo de log base em runtime.properties é utilizado como um modelo para gerar conjuntos exclusivos de arquivos de log de mensagens para cada servidor de aplicativos. O nome básico padrão para um arquivo de log pode ser alterado em runtime.properties. O servidor de aplicativos que executa o HATS é a concatenação de: caractere de sublinhado (_), seguido pelo nome da instância do HATS, seguido por outro caractere de sublinhado (_).

O ID da instância do HATS (por exemplo _SSS_) será então anexado ao nome do arquivo base para gerar o modelo para os arquivos de log de um servidor de aplicativos. Para o arquivo do log, isto se tornará messages _SSS_.txt. Finalmente, um índice (1, 2, 3 e assim por diante) será incluído nesse nome para diferenciar vários arquivos. Portanto, por exemplo, se o ID da instância do HATS for cell_node_server, o arquivo de log para o servidor de aplicativos será chamado messages_cell_node_server_.txt. Com vários arquivos de log configurados, os nomes do arquivo de log desse servidor de aplicativos serão messages_cell_node_server_1.txt, messages_cell_node_server_2.txt e assim por diante.

Quando messages_cell_node_server_1.txt atingir maxLogFileSize, ele será fechado e renomeado para messages_cell_node_server_2.txt. Um novo messages_cell_node_server_1.txt é aberto.

Quando messages_cell_node_server_1.txt atingir maxLogFileSize novamente, os arquivos de log anteriores serão renomeados--por exemplo, messages_cell_node_server_2.txt será renomeado para messages_cell_node_server_3.txt. Em seguida, messages_cell_node_server_1.txt será renomeado para messages_cell_node_server_2.txt e um novo arquivo messages_cell_node_server_1.txt será aberto.

Quando o número de maxLogFiles é excedido, o arquivo mais antigo é excluído.

Nota:
Quando executado no WebSphere Application Server para z/OS, a parte do servidor do nome do arquivo de log também inclui o ID do Espaço de Endereçamento do Servant que está gravando no log (exemplo: messages_asid_1.txt). Consulte Nomes dos Arquivos de Rastreio e Log para obter informações adicionais.
maxLogFileSize
Especifica o tamanho máximo, em kilobytes, que um arquivo de log de mensagens atinge antes que um arquivo de log adicional seja aberto.

O valor é um número inteiro. O padrão é 512 KB.

traceFile
O nome utilizado como modelo para gerar nomes de arquivos para os quais as mensagens de rastreio do HATS são gravadas. O nome básico padrão para um arquivo de rastreio é trace.txt.
maxTraceFiles
Número máximo de arquivos de informações de rastreio. O padrão é 5.

O nome do arquivo de rastreio base em server.properties é utilizado como modelo para gerar conjuntos exclusivos de arquivos de rastreio para cada servidor de aplicativos. O nome básico padrão para um arquivo de rastreio pode ser alterado em runtime.properties. O servidor de aplicativos que executa o HATS é a concatenação de: caractere de sublinhado (_), seguido pelo nome da instância do servidor HATS, seguido por outro caractere de sublinhado (_).

O ID da instância do servidor HATS (por exemplo _SSS_) será anexado ao nome do arquivo base para gerar o modelo para os arquivos de rastreio de um servidor de aplicativos, que se tornará trace _SSS_.txt. Finalmente, um índice (1, 2, 3 e assim por diante) será incluído nesse nome para diferenciar vários arquivos de rastreio. Portanto, por exemplo, se o ID da instância do servidor HATS for cell_node_server, o arquivo de rastreio para o servidor de aplicativos será chamado trace_cell_node_server_.txt. 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.

Quando trace_cell_node_server_1.txt atingir maxTraceFileSize, ele será fechado e renomeado para trace_cell_node_server_2.txt. Um novo trace_cell_node_server_1.txt é aberto.

Quando trace_cell_node_server_1.txt atinge maxTraceFileSize novamente, os arquivos de rastreio anteriores são renomeados--por exemplo, trace_cell_node_server_2.txt é renomeado para trace_cell_node_server_3.txt. Em seguida, trace_cell_node_server_1.txt será renomeado para trace_cell_node_server_2.txt e um novo arquivo trace_cell_node_server_1.txt será aberto.

Quando o número de maxTraceFiles for excedido, o arquivo mais antigo será excluído.

Nota:
Quando executado no WebSphere Application Server para z/OS, a parte do servidor do nome do arquivo de rastreio também inclui o ID do Espaço de Endereçamento do Servant que está gravando no log (exemplo: trace_asid_1.txt). Consulte Nomes dos Arquivos de Rastreio e Log para obter informações adicionais.
maxTraceFileSize
Especifica o tamanho máximo, em kilobytes, que um arquivo de rastreio atinge antes que um arquivo de rastreio adicional seja aberto.

O valor é um número inteiro. O padrão é 10240 KB.

traceLogDirectory
Define o diretório a ser utilizado para gravação de saída de log e de rastreio quando o aplicativo EAR for implementado. Se esta palavra-chave não for especificada ou se o valor especificado não for válido, o diretório utilizado será logs e será colocado sob o diretório instalado do EAR. Este valor será utilizado apenas quando o EAR for implementado em um servidor de aplicativos. Ele não tem efeito no ambiente do Kit de Ferramentas.
maxHODThreadManagerThreads
Especifica o número máximo de encadeamentos que podem ser criados no conjunto de encadeamentos ThreadManager do Host On-Demand. É possível especificar um valor entre 10 e 10000. É possível especificar um valor fora desta faixa, a configuração é ignorada e o valor de Host On-Demand padrão de 10000 é utilizado.

Opções de Rastreio

Os valores de nível de rastreio utilizados pelas opções de rastreio utilizados pelas opções de rastreio descritas nesta seção representam uma cadeia de dígitos hexadecimais. Cada bit da cadeia de dígitos controla um tipo de rastreio para o tempo de execução. Os padrões são:

tracelevel.1 : 0000000000020000
tracelevel.2 : 000000000000020f
tracelevel.3 : 000000000004023f  (mínimo)
tracelevel.4 : 0000000000041a3f
tracelevel.5 : 00000000000c1bbf  (normal)
tracelevel.6 : 00000000000c1bbf
tracelevel.7 : 00000000001c1bbf  (máximo)
tracelevel.8 : 00000000001c1bbf
tracelevel.9 : 00000000001c1bbf

A seguir estão as definições de bit na máscara de rastreio:

x000001  - Mensagens informativas
x000002  - Mensagens de aviso
x000004  - Mensagens de erro
x000008  - Mensagens de erro críticas
x000010  - Rastreios de API
x000020  - Rastreio de API de retorno de chamada
x000080  - Entrada de método
x000100  - Saída de método
x000200  - Exceções
x000400  - Rastreios diversos
x000800  - Criação de objeto
x001000  - Descarte de objeto
x020000  - rastreio de desempenho - utilize este valor sozinho
x040000  - Dados diversos - nível 1
x080000  - Dados diversos - nível 2
x100000  - Dados diversos - nível 3

Para customizar os valores de nível de rastreio, reúna os valores hexadecimais na máscara de rastreio. por exemplo, se você especificar tracelevel.9=180 e então utilizar trace.RUNTIME=9, apenas os rastreios de entrada de método e saída de método serão executados.

trace.RUNTIME
Especifica o nível de rastreio para o tempo de execução principal e para todas as definições sob RUNTIME.* que não especifiquem um nível de rastreio.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreamento de tempo de execução é executado.

trace.RUNTIME.ACTION
Especifica o nível de rastreio para as ações do evento. Esta definição substitui a definição trace.RUNTIME.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreio de ação de evento é executado.

trace.TRANSFORM
Especifica o nível de rastreio para transformações do HATS e para todas as definições em TRANSFORM.* que não especificam um nível de rastreio.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreamento de transformação é executado.

trace.TRANSFORM.COMPONENT
Especifica o nível de rastreio para componentes do HATS. Esta definição substitui a definição trace.TRANSFORM.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreamento de componente é executado.

trace.TRANSFORM.WIDGET
Especifica o nível de rastreio para widgets do HATS. Esta definição substitui a definição trace.TRANSFORM.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreamento de widget é executado.

trace.INTEGRATIONOBJECT Apenas Web 
Especifica o nível de rastreio para Objetos de Integração.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreio de Objeto de Integração será executado.

trace.UTIL
Especifica o nível de rastreio para utilitários de tempo de execução do HATS.

O valor é um inteiro de 0 a 9. O padrão é 0, o que significa que nenhum rastreamento de utilitário de tempo de execução é executado.

trace.APPLET Apenas Web 
Especifica o nível de rastreio para o applet.

O valor é um número inteiro, em que

0
Nenhum rastreio será executado.
3
Um nível mínimo de rastreio será executado.
5
Rastreio normal será executado.

O padrão é 0.

Rastreio Host On-Demand

trace.HOD.COMMEVENT
Especifica o nível de rastreio para eventos COMM Host On Demand.
0
O rastreio de eventos COMM Host On Demand não está ativado.
1
O rastreio de eventos COMM Host On Demand está ativado.

O valor é binário. O padrão é 0.

trace.HOD.DISPLAYTERMINAL
Especifica se Host On Demand exibe uma janela de terminal para cada conexão.
0
O Host On Demand não exibirá uma janela de terminal para cada conexão.
1
O Host On Demand exibirá uma janela de terminal para cada conexão.

O valor é binário. O padrão é 0.

Se trace.HOD.DISPLAYTERMINAL for 1, quando o HATS criar uma conexão host (por exemplo, em resposta a um pedido de um aplicativo), ele criará automaticamente uma exibição de terminal host. Se essa propriedade for configurada como 0, isso não ocorrerá; entretanto, independente da exibição do terminal host ser criada automaticamente durante a criação da conexão host, um administrador do HATS poderá utilizar o console administrativo do HATS para ativar ou desativar as exibições do terminal host para conexões host individuais.

trace.HOD.DS
Especifica o nível de rastreio para o rastreio de fluxo de dados Host On Demand.

O valor é um número inteiro no intervalo de 0 a 3, em que

0
Nenhum rastreio será executado.
1
Um nível mínimo de rastreio será executado.
2
Rastreio normal será executado.
3
Nível máximo de rastreio será executado.

O padrão é 0.

trace.HOD.MACRO
Especifica o nível de rastreio para as macros Host On Demand.

O valor é um número inteiro no intervalo de 0 a 2, em que

0
O rastreio de macro Host On Demand não está ativado.
1
O rastreio de evento Host On Demand está ativado.
2
O rastreio de suporte Host On Demand está ativado.

O padrão é 0.

trace.HOD.PS
Especifica o nível de rastreio do espaço de apresentação do Host On Demand.

O valor é um inteiro no intervalo de 0 a 3, em que:

0
Nenhum rastreio será executado.
1
Um nível mínimo de rastreio será executado.
2
Rastreio normal será executado.
3
Nível máximo de rastreio será executado.

O padrão é 0.

trace.HOD.PSEVENT
Especifica o nível de rastreio para eventos PS Host On Demand.
0
O rastreio de evento PS Host On Demand não está ativado.
1
O rastreio de evento PS Host On Demand está ativado.

O valor é binário. O padrão é 0.

trace.HOD.OIAEVENT
Especifica o nível de rastreio para eventos OIA Host On Demand.
0
O rastreio de eventos OIA Host On Demand não está ativado.
1
O rastreio de evento OIA Host On Demand está ativado.

O valor é binário. O padrão é 0.

trace.HOD.SESSION
Especifica o nível de rastreio das sessões do Host On Demand.

O valor é um número inteiro no intervalo de 0 a 3, em que

0
Nenhum rastreio será executado.
1
Um nível mínimo de rastreio será executado.
2
Rastreio normal será executado.
3
Nível máximo de rastreio será executado.

O padrão é 0.

trace.HOD.TRANSPORT
Especifica o nível de rastreio do transporte do Host On Demand.

O valor é um número inteiro no intervalo de 0 a 3, em que

0
Nenhum rastreio será executado.
1
Um nível mínimo de rastreio será executado.
2
Rastreio normal será executado.
3
Nível máximo de rastreio será executado.

O padrão é 0.

trace.HOD.USERMACRO
Especifica o nível de rastreio para ações de rastreio nas macros do usuário Host On Demand.

O valor é um número inteiro no intervalo de 0 a 3, em que

0
Nenhum rastreio será executado.
1
Um nível mínimo de rastreio será executado.
2
Rastreio normal será executado.
3
Nível máximo de rastreio será executado.

O padrão é 0.

Rastreio de Simulação de Host

recordSimulationTrace
Especifica se a gravação de rastreio da simulação do host está ou não ativada no tempo de execução.
0
A gravação de rastreio da simulação do host não está ativada.
1
A gravação de rastreio da simulação do host está ativada.

O valor é binário. O padrão é 0.

startPort
Especifica a porta inicial do intervalo de portas a ser utilizada durante o tempo de execução para executar o registro de rastreio de simulação do host para múltiplas sessões do host simultaneamente. O padrão é a porta 7021.
endPort
Especifica a porta final do intervalo de portas a ser utilizada durante o tempo de execução para executar o registro de rastreio de simulação do host para múltiplas sessões do host simultaneamente. O padrão é a porta 7050.