Propriedades Customizadas do Serviço de Transações

O WebSphere Application Server permite configurar um número de propriedades customizadas para serviços de transação.

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

As propriedades customizadas do serviço de transações podem ser especificadas no console administrativo. Para usar qualquer uma destas propriedades customizadas, clique em Servidores > Tipos de Servidores > Servidores de Aplicativos WebSphere > server_name > [Configurações do Contêiner] Serviços de Contêiner > Serviço de Transações > [Propriedades Adicionais] Propriedades Customizadas.

Evitar Problemas Evitar Problemas: No z/OS, certifique-se de que todos os fluxos de logs relevantes sejam configurados como AUTODELETE(NO).gotcha

DELAY_CANCELLING_ALARMS

Se antes do estágio de conclusão de um processamento de transações for provável a inclusão de processos que possam levar muito tempo para serem concluídos ou que possam falhar, então você poderá desejar que a transação expire.

Por padrão, os alarmes de tempo limite de transação são cancelados antes do início da fase de conclusão anterior da transação. A propriedade customizada DELAY_CANCELLING_ALARMS permite que a fase antes da conclusão da transação seja englobada no período de tempo limite da transação. Para fazer isso, configure a propriedade customizada no servidor de aplicativos.

Tabela 1. Propriedade Customizada DELAY_CANCELLING_ALARMS. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default FALSE
[z/OS]

DISABLE_DEFERRED_CTX_REGISTRATION

Por padrão, o registro de uma transação global do WebSphere com o contexto de transação nativo do z/OS é adiado até que o cadastramento de recursos com a transação global ocorra. Esse registro adiado é um aprimoramento projetado para melhorar o desempenho em cenários quando recursos RRS NÃO estão envolvidos na transação atual (por exemplo, quando apenas recursos XA estão cadastrados) - ele evita o processamento extra relacionado ao registro com o contexto nativo quando ele não é subsequentemente necessário. Se recursos RRS são cadastrados com a transação, o registro adiado ainda ocorre, mas não fornece nenhum aprimoramento de desempenho.

A propriedade customizada DISABLE_DEFERRED_CTX_REGISTRATION desativa o adiamento de registro de uma transação global do WebSphere com o contexto de transação nativo do z/OS. Quando o registro adiado está desativado, o registro com o contexto de transação nativo ocorre automaticamente durante a criação da transação global do WebSphere.

Existem circunstâncias nas quais não é desejável adiar o registro de contexto para recursos RRS. Nos seguintes casos, configure DISABLE_DEFERRED_CTX_REGISTRATION=true :
  • Um aplicativo ativa a capacidade de suspensão do cursor que, sob determinadas circunstâncias, permite que um conjunto de resultados seja mantido aberto nos limites da transação.
Tabela 2. Propriedade Customizada DISABLE_DEFERRED_CTX_REGISTRATION
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default FALSE
[z/OS]

DISABLE_OUTBOUND_CASCADED_SUPPORT

Especifica se o gerenciador de transações deve desativar ou não o suporte que permite a inicialização de transações em cascata e possibilita a outros WebSphere Application Servers no z/OS, que também suportem o processamento de transações em cascata RRS, fazerem parte de uma família em cascata.

Configure esse valor para true se não desejar o suporte de saída em cascata. Configurar esse valor para true fará com que o servidor seja padronizado para a propagação de transação JTS padrão.

Tabela 3. Propriedade Customizada DISABLE_OUTBOUND_CASCADED_SUPPORT. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default FALSE

DISABLE_RECOVERY_AUDIT_LOGGING

É possível controlar se as mensagens de informação são exibidas no console administrativo e gravadas no arquivo SystemOut.log durante a recuperação do serviço de transações. Para isso, configure a propriedade customizada DISABLE_RECOVERY_AUDIT_LOGGING para o serviço de transações para o servidor.

[AIX Solaris HP-UX Linux Windows][IBM i]Em plataformas distribuídas, o padrão é as mensagens de informação aparecerem no console administrativo e no arquivo SystemOut.log durante a recuperação de serviços de transações. Se você não quiser que essas mensagens sejam exibidas, é possível utilizar a propriedade customizada DISABLE_RECOVERY_AUDIT_LOGGING.

[z/OS]No z/OS®, as mensagens de informação não aparecem por padrão, no console administrativo ou no arquivo SystemOut.log durante a recuperação de serviços de transações. Se desejar que essas mensagens sejam exibidas, é possível utilizar a propriedade customizada DISABLE_RECOVERY_AUDIT_LOGGING.

[z/OS]Nota: No z/OS, se você escolher ativar as mensagens de auditoria de recuperação de transações, outras mensagens de auditoria (como as relacionadas à recuperação do servidor e recuperação do recurso XA) também serão exibidas no console e no arquivo SystemOut.log.
Tabela 4. Propriedade Customizada DISABLE_RECOVERY_AUDIT_LOGGING. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleano
Valores aceitáveis TRUE, FALSE
Padrão

[AIX Solaris HP-UX Linux Windows][IBM i]FALSE

[z/OS]TRUE

[z/OS]

DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD

Especifica se há um atraso entre um tempo limite de transação e o fim anormal da região servidora que estava executando a transação.

Se você definir esse valor como false, uma transação global que esgotar o tempo limite será marcada como somente recuperação. O servidor de transações fornece ao aplicativo associado um período adicional, de aproximadamente quatro minutos, para a conclusão. Se o aplicativo for concluído nesse tempo, a transação será recuperada. Se o aplicativo não for concluído nesse tempo, o aplicativo e a região servidora associada serão encerrados anormalmente, com um erro ABENDEC3 ou ABENDSEC3.

Defina esse valor como true para remover o atraso e encerrar anormalmente o aplicativo e a região servidora imediatamente.

Tabela 5. Propriedade Customizada DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default FALSE
[z/OS]

DISABLE_WSTX_RMFAIL_LOGGING

Especifica se uma mensagem RMFAIL será enviada para o arquivo do log de erros quando um participante WS-AT não conseguir enviar uma resposta dentro do período de tempo limite de resposta assíncrono, fazendo com que ocorra uma exceção de transação XAER_RMFAIL.

Se você configurar esse valor como false, uma mensagem RMFAIL será enviada para o arquivo do log de erros quando um participante WS-AT não conseguir enviar uma resposta dentro do período de tempo limite de resposta assíncrono.

Configure esse valor como true, para que uma mensagem RMFAIL não seja enviada para o arquivo do log de erros quando um participante WS-AT não conseguir enviar uma resposta dentro do período de tempo limite de resposta assíncrono.

Tabela 6. Propriedade Customizada DISABLE_WSTX_RMFAIL_LOGGING. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Padrão FALSE

ENABLE_XARESOURCE_TIMEOUT

Se você configurar esse valor como true, o serviço de transações fornecerá um valor de tempo limite para recursos XA quando forem listados em transações globais. O tempo limite fornecido será o número restante de segundos antes que a transação seja configurada como tempo limite.

Tabela 7. Propriedade Customizada ENABLE_XARESOURCE_TIMEOUT. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default FALSE

REMOVE_PARTNER_LOG_ENTRY

É possível remover as entradas do arquivo de log de parceiro de transação. Para isto, configure a propriedade customizada REMOVE_PARTNER_LOG_ENTRY para o serviço de transações no servidor que possui o log do parceiro.

Como parte do processo de recuperação de transação, o log do parceiro é verificado para estabelecer quais recursos são necessários. Se desejar remover determinadas entradas do log de parceiros, como um recurso que não exista mais, configure esta propriedade customizada no servidor de aplicativos que possui o log de parceiros de transações contendo as entradas que deseja remover.

A propriedade customizada REMOVE_PARTNER_LOG_ENTRY é efetiva apenas quando duas das seguintes situações forem aplicáveis.

  • O servidor de aplicativos é iniciado em modo de recuperação.
  • O servidor de aplicativos não tem transações que requerem recuperação atualmente. É possível fazer isso verificando o arquivo SystemOut.log.
Tabela 8. Propriedade Customizada REMOVE_PARTNER_LOG_ENTRY. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Integer
Valores aceitáveis (um ou mais IDs de recuperação de número inteiro delimitados por vírgula)
Default (nulo)
[z/OS]

RLS_LOGSTREAM_COMPRESS_INTERVAL

Especifica, em segundos, o intervalo no qual o serviço de log de recuperação tenta compactar qualquer fluxo de log que os componentes de aplicativo estão utilizando. O Serviço de Transações (registro do parceiro XA) e os componentes do Serviço de Compensação podem ser configurados para usar o serviço do registro de recuperação.

O fluxo de log é verificado quanto à compactação uma vez por intervalo. Essa operação poderá causar uso desnecessário de CPU se o fluxo de logs não estiver sendo utilizado.

Nota:
  • Se você não utilizar um fluxo de logs para o serviço de compactação, defina essa propriedade com um valor superior ao valor padrão.
  • Se o serviço de log de recuperação utilizar fluxos de log, não defina essa propriedade com um valor muito alto. Se os fluxos de log do serviço de log de recuperação se tornarem cheios antes que o intervalo de compactação expire, o início das transações poderá falhar até que os fluxos de log sejam compactados.
  • Se nenhum componente estiver configurado para utilizar um fluxo de logs, defina essa propriedade como 0 (zero) para desativar essa função.
Tabela 9. Propriedade Customizada RLS_LOGSTREAM_COMPRESS_INTERVAL. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Integer
Valores aceitáveis 0 - 2,147,483,647 (0 desativa a função)
Default 30 segundos

ZOS_RECOVER_BEFORE_COMMIT

Especificar essa propriedade evita que ocorra um conflito após uma chamada xa_recover ser emitida em oposição a um recurso do MQ Server no momento de recuperação. O MQ Server usa as interfaces em fluxo de transação do JCA 1.5 como parte de sua operação normal. Essas interfaces permitem que o membro do barramento do MQ Server coordene os recursos WMQ e do Barramento de Integração de Serviços usando as transações do WebSphere Application Server. Durante a confirmação de qualquer transação no tempo de recuperação, o xa_recover é chamado para assegurar que alguns drivers DB2 mais antigos não retornem XAER_NOTA, mesmo se a transação existir quando a chamada xa_commit ou xa_rollback for emitida.

Esse conflito ocorre por que o recurso do MQ Server emite chamadas de volta ao controlador e tenta bloquear todas as transações conhecidas, para que o recurso do MQ Server possa gerar uma lista de transações que precisam responder a uma chamada xa_recover. No entanto, como a transação IN-COMMIT sendo confirmada é sempre bloqueada, a chamada xa_recover espera indefinidamente para bloquear a transação IN-COMMIT, por que essa transação não será desbloqueada até que a transação seja confirmada.

A configuração desta propriedade para FALSE assegura que, durante o processamento das transações no tempo de recuperação, a chamada xa_recover não é emitida antes de uma chamada xa_commit ou xa_rollback.

Evitar Problemas Evitar Problemas: Todos os drivers DB2 atualmente suportados possuem um recurso de recuperação automática que torna desnecessário a emissão de uma chamada xa_recover antes de emitir uma chamada xa_commit ou xa_rollback. Se, após ler a documentação de seu driver DB2, você não estiver seguro se o driver DB2 inclui o recurso de recuperação automática, entre em contato com o suporte da IBM DB2 para esclarecimento final sobre se a configuração dessa propriedade é segura para uso para servidores hosts de aplicativos que acessam DB2.gotcha
Tabela 10. Propriedade Customizada ZOS_RECOVER_BEFORE_COMMIT. A tabela inclui o tipo de dado, os valores aceitáveis e o padrão para a propriedade.
Informações Valor
Tipo de Dados Booleana
Valores aceitáveis TRUE, FALSE
Default TRUE

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjta_transerv_custproperties
Nome do arquivo: rjta_transerv_custproperties.html