Use a atividade Obter Mensagem do MQ para recuperar mensagens de uma fila do MQ durante o tempo de execução.
Após concluir as tarefas Configurar, Mapeando Entradas e Mapeando Saídas da atividade.
Campo | Descrição |
---|---|
Nome da Fila * | Especifica o nome da fila do MQ a partir da qual o Integration Appliance tenta recuperar a mensagem. |
Tempo limite | O número de segundos antes de um tempo limite ocorrer entre a
atividade Obter Mensagem do MQ que solicita para
recuperar uma mensagem da fila e o tempo que demora para a mensagem ser
retornada.
Se esse período de tempo limite expirar e
nenhuma mensagem for retornada da fila, o Integration Appliance aguardará
o tempo de nova tentativa especificado antes de tentar recuperar uma mensagem novamente. Para uma explicação detalhada dos tempos limites e das opções de nova tentativa, consulte Opções de Tempo Limite e Nova Tentativa. Para especificar o número de segundos que o Integration Appliance deve aguardar antes de emitir um tempo limite, selecione a opção Após e insira o número de segundos no campo Segundos. Por padrão, a opção Nunca está selecionada. Essa opção especifica que o Integration Appliance aguarda indefinidamente para recuperar uma mensagem da fila — não há nenhum período de tempo limite. |
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 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 para
localizar 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.
|
Campo | Descrição |
---|---|
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.
|
Local em que as mensagens têm IDs Exclusivos | Especifica se as mensagens na fila têm IDs exclusivos. |
Configure as opções de nova tentativa para obter uma mensagem da fila do MQ, conforme descrito na tabela a seguir:
Opções de Nova Tentativa | Descrição |
---|---|
1) Aguardar ___ segundos entre cada nova tentativa. | O número de segundos que o Integration Appliance aguarda antes de tentar recuperar uma mensagem da fila. Para saber mais sobre como essa opção está relacionada ao campo Tempo Limite na área de janela Configurar ou ao parâmetro de entrada timeout, consulte Opções de Tempo Limite e Nova Tentativa. |
2) Tentar se conectar ___ vezes antes de falhar. | Especifica o número máximo de vezes que o Integration Appliance
tenta recuperar uma mensagem da fila antes de emitir um erro e para o
processamento da tarefa de orquestração atual. Se você implementar uma orquestração que contém uma atividade Obter Mensagem do MQ e o Integration Appliance não puder se conectar ao MQ Server especificado ou não puder obter uma mensagem da fila, o Integration Appliance registrará os erros como avisos nos logs do sistema e de orquestração até o valor da contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual. 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 para o processamento da tarefa de orquestração atual. Para saber mais sobre como essa opção está relacionada ao campo Tempo Limite na área de janela Configurar ou ao parâmetro de entrada timeout, consulte Opções de Tempo Limite e de Nova Tentativa. |
Os parâmetros de entrada da atividade são exibidos no painel Para Atividade.
Durante o tempo de execução, a atividade é iterada sequencialmente por todas as mensagens na fila. Se nada estiver mapeado para esses nós, nada será restringido e, deste modo, a primeira mensagem na fila será retornada pela atividade Obter Mensagem do MQ e a próxima atividade na orquestração será processada.
Se qualquer um destes nós for mapeado, durante o tempo de execução, a atividade Obter Mensagem do MQ será iterada através de cada mensagem na fila até localizar a primeira mensagem que corresponda aos valores de tempo de execução de todos os nós mapeados. A primeira mensagem correspondente será retornada pela atividade Obter Mensagem do MQ e a próxima atividade na orquestração será processada.
Opcionalmente, é possível substituir as configurações especificadas para o Nome da Fila e o Tempo Limite na tarefa Configurar da Lista de Verificação dinamicamente durante o tempo de execução, usando os parâmetros de entrada definidos na tabela a seguir.
Por exemplo, o nome da fila do MQ pode ser configurado na tarefa Configurar para poqueue. Durante o tempo de execução, o nome da fila do MQ: newqueue pode ser passado para a atividade usando o parâmetro de entrada queuename. O nome da fila especificado dinamicamente durante o tempo de execução substitui a configuração original especificada no painel Configurar. Neste exemplo, o Integration Appliance consulta a fila do MQ nomeada newqueue para mensagens.
Nome do Parâmetro de Entrada/Nó | Descrição | Substitui a Configuração na Tarefa? |
---|---|---|
timeout | Especifica o período de tempo que o Integration Appliance
aguarda após solicitar para recuperar uma mensagem da fila, antes de
tentar novamente. Especifique um número negativo para especificar nenhum período de tempo limite — o Integration Appliance aguarda indefinidamente para recuperar uma mensagem da fila. A especificação de um número negativo é igual à especificação da opção Nunca na tarefa Configurar. |
O parâmetro de entrada timeout substitui o campo Tempo Limite da tarefa Configurar. |
queuename | Especifica o nome da fila do MQ na qual o Integration Appliance procura mensagens. | O parâmetro de entrada queuename substitui a codificação especificada no campo Nome da Fila da tarefa Configurar. |
Consulte Criando um Mapa para obter instruções gerais sobre o mapeamento.
Não é necessário mapear os parâmetros de saída para essa atividade. Consulte Criando um Mapa para obter instruções gerais sobre o mapeamento.
O tempo limite especificado no campo Tempo Limite na tarefa Configurar ou o parâmetro de entrada timeout especifica o número de segundos antes de um tempo limite ocorrer entre a atividade Obter Mensagem do MQ que solicita para recuperar uma mensagem da fila e o tempo que demora para a mensagem ser retornada. Se esse período de tempo limite expirar e nenhuma mensagem for retornada da fila, o Integration Appliance aguardará o período de tempo especificado na opção 1) Aguardar ___ segundo(s) entre cada nova tentativa antes de tentar recuperar uma mensagem novamente. O Integration Appliance continua tentando obter a mensagem até a contagem de novas tentativas especificada. A contagem de novas tentativas é especificada com 2) Tentar se conectar ___ vezes antes de falhar. As opções 1) Aguardar ___ segundo(s) entre cada nova tentativa e 2) Tentar se conectar ___ vezes antes de falhar são especificadas na tarefa Opções de Nova Tentativa.