Propriedades Customizadas do Serviço Listener de Mensagens
Utilize este painel para visualizar ou alterar propriedades customizadas do serviço listener de mensagens.
Para visualizar essa página do console administrativo, clique em .
- DYNAMIC.CONFIGURATION.ENABLED
ENABLE.ZOS.LP.RECOVERY
- MAX.RECOVERY.RETRIES
- MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
- MQJMS.POOLING.THRESHOLD
- MQJMS.POOLING.TIMEOUT
- NON.ASF.RECEIVE.TIMEOUT
- NON.ASF.BMT.ROLLBACK.ENABLED
- RECOVERY.RETRY.INTERVAL
- SERVER.SESSION.POOL.REAP.TIME
- SERVER.SESSION.POOL.UNUSED.TIMEOUT
- SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
DYNAMIC.CONFIGURATION.ENABLED
Essa propriedade controla se o servidor de aplicativos no qual uma porta listener é criada exige reinício. Defina essa propriedade como true para ativar a configuração dinâmica.
Informações | Valor |
---|---|
Tipo de dados | Booleano |
Padrão | False (não selecionado) |
![[z/OS]](../images/ngzos.gif)
ENABLE.ZOS.LP.RECOVERY
Esta propriedade controla o comportamento da porta listener quando um servidor de aplicativos se conecta ao WebSphere MQ para z/OS.
- Uma porta listener para tentar recuperar se uma conexão entre o servidor de aplicativos e o WebSphere MQ foi perdida, por exemplo, se o gerenciador de filas parou. Se você não ativar este recurso, a porta listener não tenta a recuperação após a parada de um gerenciador de filas.
- Múltiplas classificações de gerenciamento de carga de trabalho a ser configuradas para uma porta listener. Se você não ativar esta propriedade, as mensagens permanecem na fila do WebSphere MQ quando múltiplas classificações de carga de trabalho são configuradas para uma porta listener.
Reinicie o servidor depois de incluir a propriedade.
Se estiver se conectando ao WebSphere MQ para z/OS por meio de conexões de ligações, você também não precisará aplicar o APAR PK53912 do WebSphere MQ, que é fornecido em WebSphere MQ Versão 6.0.2.4.
Informações | Valor |
---|---|
Tipo de dados | Booleano |
Padrão | True (ativado) |
MAX.RECOVERY.RETRIES
O número máximo de vezes que uma porta listener gerenciada por este serviço tenta recuperar-se de uma falha antes de desistir e parar. Quando parada, a porta listener associada é alterada para o estado parado. O intervalo entre novas tentativas é definido pela propriedade RECOVERY.RETRY.INTERVAL.
- Ocorreu um erro inesperado quando uma porta listener tentou obter uma mensagem do provedor JMS.
- A conexão entre o servidor de aplicativos e o provedor JMS foi perdida, geralmente, isso se deve a um erro de rede.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Novas tentativas |
Padrão | 5 |
Intervalo | 0 (sem repetições) até 2147483647 |
MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
Um indicador de regulagem que permite que o processamento de mensagens do controlador continue quando o limite baixo de mensagem for atingido. Quando o serviço de Listener de Mensagens tiver sido configurado com a propriedade customizada MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH e ela estiver configurada para um valor de "true", o valor do limite baixo será configurado internamente para o valor do limite alto (que é a propriedade Número máximo de sessões configurada externamente da porta do listener).
Informações | Valor |
---|---|
Tipo de dados | Sequência de caracteres |
Padrão | True |
MQJMS.POOLING.THRESHOLD
O número máximo de conexões não utilizadas do conjunto.
Um MQSimpleConnectionManager aloca conexões com base na mais utilizada recentemente e destrói conexões com base na menos utilizada recentemente. Por padrão, uma conexão é destruída se houver mais do que dez conexões não utilizadas no conjunto.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Número de conexões |
Padrão | 10 |
MQJMS.POOLING.TIMEOUT
O número de milissegundos depois dos quais uma conexão do conjunto é destruída caso não tenha sido utilizada.
Um MQSimpleConnectionManager aloca conexões com base na mais utilizada recentemente e destrói conexões com base na menos utilizada recentemente. Por padrão, uma conexão é destruída se não tiver sido utilizada por cinco minutos.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Milissegundos |
Padrão | 5 minutos |
NON.ASF.RECEIVE.TIMEOUT
O tempo limite em milissegundos para recebimento de mensagens síncronas efetuado por sessões do listener do bean orientado por mensagens no modo de operação não-ASF.
- O modo ASF fornece suporte simultâneo e transacional para aplicativos. Para beans acionados por mensagens de publicação/assinatura, o modo ASF fornece melhor rendimento e simultaneidade, pois no modo não ASF o listener tem apenas um encadeamento.
- O modo não ASF é utilizado principalmente com provedores de sistemas de mensagens de terceiros que não suportam a ASF JMS, que é uma extensão opcional da especificação JMS. O modo não ASF também é transacional, mas como o comprimento do caminho é menor que o modo ASF, geralmente fornece melhor desempenho.
Para ativar o modo de operação não ASF para todos os listeners de bean acionado por mensagens no servidor de aplicativos, configure essa propriedade para um valor que não seja zero.
O modo não ASF não pode ser selecionado em sistemas z/OS,
portanto, você não deve configurar um valor diferente de zero para esta propriedade neste caso.
Se seu sistema de mensagens estiver em execução no modo não ASF, para evitar tempos limites de transação não desejados, você deverá permitir uma quantidade suficiente de tempo para que o processamento seja concluído antes do tempo limite total do tempo de vida da transação ser atingido. Portanto, você deve certificar-se de que o valor especificado para a propriedade customizada do serviço de listener de mensagens NON.ASF.RECEIVE.TIMEOUT seja menor do que o valor especificado para a propriedade do serviço de transações Tempo Limite Total do Tempo de Vida da Transação e, também, que a diferença entre os valores das duas propriedades seja maior do que a quantidade de tempo que o método onMessage() do bean acionado por mensagens (MDB) demora para processar a mensagem.
Por exemplo, se o método onMessage() do bean acionado por mensagens normalmente leva no máximo 10 segundos, e o tempo limite da transação estiver configurado para 120 segundos, é possível configurar a propriedade NON.ASF.RECEIVE.TIMEOUT para não mais de 110000 milissegundos (ou seja, 110 segundos).
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Milissegundos |
Padrão | Modo ASF (propriedade customizada não criada) |
Intervalo | 0 ou mais milissegundos
|
NON.ASF.BMT.ROLLBACK.ENABLED
Quando o modo não Application Server Facilities (não ASF) de operação está em uso (já que você configurou a propriedade NON.ASF.RECEIVE.TIMEOUT para um valor não zero), e um bean acionado por mensagens que utiliza transações gerenciadas por bean gera uma exceção de tempo de execução, a propriedade NON.ASF.BMT.ROLLBACK.ENABLED determina se as mensagens são retornadas para o destino.
- O modo ASF fornece suporte simultâneo e transacional para aplicativos. Para beans acionados por mensagens de publicação/assinatura, o modo ASF fornece melhor rendimento e simultaneidade, pois no modo não ASF o listener tem apenas um encadeamento.
- O modo não ASF é utilizado principalmente com provedores de sistemas de mensagens de terceiros que não suportam a ASF JMS, que é uma extensão opcional da especificação JMS. O modo não ASF também é transacional, mas como o comprimento do caminho é menor que o modo ASF, geralmente fornece melhor desempenho.
O modo não ASF não pode ser selecionado em sistemas z/OS.
Quando esta propriedade está definida para false (padrão), a mensagem é automaticamente reconhecida antes de ser passada para o bean acionado por mensagem.
Quando esta propriedade está definida para true, o serviço listener de mensagens envia uma confirmação de mensagem ao cliente após a mensagem ser processada com êxito pelo bean acionado por mensagem, e o serviço listener de mensagens solicita a recuperação de qualquer mensagem para a qual o bean gera uma exceção.
Informações | Valor |
---|---|
Tipo de dados | Booleano |
Padrão | False |
RECOVERY.RETRY.INTERVAL
O tempo em segundos entre tentativas de repetição por uma porta listener para recuperação de uma falha. O número máximo de novas tentativas é definido pela propriedade MAX.RECOVERY.RETRIES.
- Ocorreu um erro inesperado quando uma porta listener tentou obter uma mensagem do provedor JMS.
- A conexão entre o servidor de aplicativos e o provedor JMS foi perdida, geralmente, isso se deve a um erro de rede.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Segundos |
Padrão | 60 |
Intervalo | 1 a 2147483647 |
SERVER.SESSION.POOL.REAP.TIME
O tempo em segundos entre as verificações nos conjuntos da sessão do servidor. Para ativar o monitoramento do conjunto da sessão do servidor, defina esta propriedade para um valor não-negativo.
A propriedade customizada SERVER.SESSION.POOL.REAP.TIME não se aplicará se seu sistema de mensagens estiver em execução no modo não ASF.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Segundos |
Padrão | -1 (desativado) |
Intervalo | -2147483648 a 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT
O tempo limite do conjunto da sessão do servidor padrão em segundos.
Quando essa propriedade é configurada para um valor não negativo, ela é comparada com o tempo decorrido desde que uma sessão do servidor foi utilizada. Se o valor de tempo limite for menor que o tempo decorrido, a sessão do servidor será removida do conjunto de sessões do servidor e sua sessão JMS será retornada ao conjunto de sessões JMS. Por exemplo, se o valor de tempo limite for de um segundo e o tempo decorrido desde que uma determinada sessão do servidor foi usada for de dois segundos, essa sessão do servidor será removida do conjunto de sessões do servidor e sua sessão JMS será retornada ao conjunto de sessões JMS.
A propriedade customizada SERVER.SESSION.POOL.UNUSED.TIMEOUT não será aplicável se seu sistema de mensagens estiver sendo executado no modo não ASF.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Segundos |
Padrão | -1 (desativado) |
Intervalo | -2147483648 a 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
Essa propriedade substitui o valor SERVER.SESSION.POOL.UNUSED.TIMEOUT padrão para a porta listener pelo nome definido para lpname. Esse valor se aplica a todos os beans acionados por mensagens que utilizam a porta listener especificada.
Se essa substituição estiver configurada como um valor não negativo, ela substituirá a propriedade SERVER.SESSION.POOL.UNUSED.TIMEOUT, mesmo se a propriedade SERVER.SESSION.POOL.UNUSED.TIMEOUT tiver um valor negativo.
Se esta substituição estiver definida para um valor negativo, ela desativa o monitoramento do conjunto da sessão do servidor para a porta listener especificada.
A propriedade customizada SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname não será aplicável se seu sistema de mensagens estiver sendo executado no modo não ASF.
Informações | Valor |
---|---|
Tipo de dados | Inteiro |
Unidades | Segundos |
Padrão | Não definida |
Intervalo | -2147483648 a 2147483647 |