Propriedades Customizadas do Serviço Listener de Mensagens

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.

Esta propriedade controla o comportamento da porta listener quando um servidor de aplicativos se conecta ao IBM MQ para z/OS.

Reinicie o servidor depois de incluir a propriedade.

Se estiver se conectando ao IBM MQ para z/OS por meio de conexões de ligações, você também não precisará aplicar o APAR PK53912 do IBM MQ, que é fornecido em IBM MQ Versão 6.0.2.4.

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.

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.

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.

O tempo limite em milissegundos para recebimento de mensagens síncronas efetuado por sessões do atendente do bean orientado por mensagens no modo de operação não ASF.

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).

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 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.

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.

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.

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 se aplicará se seu sistema de mensagens estiver em execução no modo não ASF.

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 se aplicará se seu sistema de mensagens estiver em execução no modo não ASF.