Atividade Sondar Fila do MQ

Use a atividade Pesquisar Fila do MQ periodicamente para verificar a Fila do MQ para mensagens baseadas em um intervalo de novas tentativas especificado durante o tempo de execução.

Nota: Você deve ter criado um terminal para a atividade do MQ antes de configurar a atividade.
A tarefa Configurar possui três seções:

Após concluir as tarefas Configurar, Mapeando Saídas para a atividade.

Nota: O tamanho máximo de mensagem é 100 MBytes.

Detalhes da Fila e da Mensagem

Especifique os detalhes Fila e Mensagem para os campos na tabela a seguir. Os campos necessários são marcados com um asterisco.
Campo Descrição
Nome da Fila * Especifica o nome da fila que é sondada para mensagens.
Tipo de Dado da Carga Útil Especifica o tipo de dados da carga útil da mensagem, binário ou cadeia.
Fragmento do Esquema para Cabeçalho MQRFH2 Especifica se um cabeçalho MQRFH2 está incluído na mensagem. Se a mensagem for uma mensagem XML e incluir um cabeçalho MQRFH2, selecione esta caixa de opção e clique em [...]. Na caixa de diálogo Procurar Elemento do Tipo de Esquema, localize o Esquema XML que define o cabeçalho, selecione o elemento NameValueData nesse Esquema XML e clique em OK. O fragmento de esquema é o elemento NameValueData e todos os seus elementos filhos.
Nota: O Esquema XML que define o cabeçalho deve primeiro ser criado e carregado no projeto, antes que seja possível selecioná-lo. Para obter informações adicionais, consulte Definindo e Carregando um Esquema XML para um Cabeçalho MQRFH2.

Regras de Entrega

Campo Descrição
Sondar Mudanças Especifica com que frequência o Integration Appliance deve sondar mudanças na fila. Para obter informações adicionais, consulte Comportamento do Intervalo de Sondagem.
Local em que as mensagens têm IDs Exclusivos Especifica se as mensagens na fila têm IDs exclusivos.
Entregar Mensagens As opções disponíveis aqui dependem se a caixa de opção IDs Exclusivos está selecionada. Se selecionada, todas as três opções estarão disponíveis. Se não, apenas Pelo Menos Uma Vez será exibido.
  • Pelo Menos Uma Vez - Especifica que a mensagem é entregue pelo menos uma vez, mas pode ser entregue mais de uma vez. As falhas da conexão ou do Integration Appliance podem fazer com que as mensagens sejam recuperadas e processadas mais de uma vez. Esta opção de entrega é geralmente usada quando o sistema de recebimento pode detectar ou tolerar mensagens duplicadas.
  • No Máximo Uma Vez - Especifica que a mensagem é entregue apenas uma vez ou nenhuma. As falhas da conexão ou do Integration Appliance podem resultar na perda de mensagens. Esta opção de entrega é geralmente usada quando o sistema de recebimento não pode tolerar mensagens duplicadas, mas pode tolerar mensagens perdidas.
  • Exatamente Uma Vez - Especifica que a mensagem é entregue apenas uma única vez. As falhas da conexão ou do Integration Appliance não afetam a entrega com esta opção. O Integration Appliance usa IDs de mensagens do MQ para assegurar que cada mensagem seja recuperada e processada exatamente uma vez.
    Nota: Se selecionar a opção Exatamente Uma Vez, você deverá ativar a persistência. Para obter informações adicionais, consulte Ativando a Persistência.

Opções de Nova Tentativa

Configure as opções de nova tentativa da atividade Sondar Fila do MQ, conforme definido na tabela a seguir:

Opções de Nova Tentativa Descrição
1) Aguardar __ segundo(s) entre cada nova tentativa. O número de segundos que o Integration Appliance aguarda antes de tentar recuperar mensagens do MQ Server novamente.
2) Tentar se conectar __ vezes antes de falhar. Especifica o número máximo de vezes que o Integration Appliance tenta recuperar mensagens do MQ Server antes de falhar.

Se uma orquestração que inicia com uma atividade Pesquisar Fila do MQ for implementada e o Integration Appliance não puder se conectar ao servidor MQ especificado ou não puder recuperar mensagens da fila, o Integration Appliance registrará os erros como avisos no log do sistema até o valor da contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro no log do sistema, reconfigura a contagem de novas tentativas atual para zero e continua tentando estabelecer uma conexão com o servidor MQ.

Por exemplo, você configura a contagem de novas tentativas como 3. O primeiro, o segundo e o terceiro erros aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro como um erro e reconfigura a contagem de novas tentativas para zero. Portanto, o quinto erro de conexão gera um aviso no log do sistema. O Integration Appliance continua a tentativa de recuperar mensagens da fila.

Mapeando Saídas

Não é necessário mapear os parâmetros de saída para essa atividade. Entretanto, se você mapear qualquer um destes parâmetros, observe os pontos a seguir:
Parâmetros:
  • Os parâmetros payload e mqmdheader são obtidos da mensagem que é recebida da fila.
  • rfh2header será obtido se o esquema para o Cabeçalho RFH2 for especificado na tarefa Configurar.



Feedback | notices