As especificações de ativação são a forma padronizada para gerenciar e configurar o relacionamento entre um bean acionado por mensagens (MDB) em execução no WebSphere® Application Server e um destino no WebSphere MQ. Esta tarefa explica como configurar o WebSphere Application Server para usar modo não ASF para processar mensagens.
Antes de Iniciar
Nota: O modo não ASF não pode ser selecionado em sistemas z/OS.
Sobre Esta Tarefa
As propriedades de uma especificação de ativação determinam como um bean acionado por mensagens (MDB) recebe mensagens JMS a partir de uma fila do WebSphere MQ. Para configurar o modo não ASF, defina as propriedades de uma ou mais especificações de ativação.
Para
configurar não ASF, configure a propriedade customizada de Especificação de Ativação nonASFTimeout para
um número inteiro positivo, que indica que a entrega não ASF é usada.
O valor é o tempo, em milissegundos, que uma solicitação get aguardará
mensagens que podem ainda não ter chegado (uma chamada get com wait). O valor padrão 0 indica que a entrega ASF é usada.
Procedimento
- Inicie o console administrativo do WebSphere
Application Server.
- Na área de janela de navegação, selecione .
- Opcional: Na área de janela Especificações de ativação,
mude a configuração Escopo para o nível no qual
a definição de recurso é visível aos aplicativos.
- Selecione o nome do recurso JMS do provedor de sistema de mensagens do WebSphere MQ específico para o qual você deseja especificar a propriedade customizada. Isso exibe as informações sobre o recurso.
- Clique no nome do recurso JMS e abra a página Configuração.
- Sob a seção Propriedades adicionais,
clique em Propriedades customizadas.
- Na página Propriedades customizadas, crie
duas propriedades customizadas: nonASFTimeout e nonASFRollbackEnabled.
- nonASFTimeout
- O tempo, em milissegundos, a aguardar em uma obtenção síncrona para consumir
uma mensagem. Por padrão, ele é zero, se configurado para um número positivo,
um número de encadeamentos especificado pelo tamanho do conjunto de sessões do servidor
será usado para obter mensagens.
- nonASFRollbackEnabled
- Por padrão, ele é true. Se configurado para true e nonASFTimeout for
maior que zero, as mensagens serão retornadas na falha. Se configurado para false,
as mensagens serão recebidas fora do escopo transacional e serão perdidas
na falha.
- No campo Nome, digite nonASFTimeout.
- No campo Valor, digite um número
positivo.
- No campo Tipo, selecione o tipo java.lang.Integer
na lista.
- No campo Nome, digite nonASFRollbackEnabled.
- No campo Valor, digite true.
- No campo Tipo, selecione o tipo java.lang.Boolean
na lista.
- Salve suas alterações na configuração master.
- Para ativar a configuração alterada, pare e, em seguida, reinicie o servidor de aplicativos.
Resultados
Você configurou as propriedades de uma especificação de ativação do provedor de sistemas de mensagens WebSphere MQ
para usar o modo não ASF.
Nota: Ao usar o modo não ASF, você deverá assegurar-se de permitir um período de tempo suficiente para que o processamento seja concluído antes que o tempo limite do ciclo de vida total da transação seja atingido, para evitar que sejam atingidos tempos limites indesejáveis da transação.