Atividade Colocar Mensagem do MQ

Use a atividade Colocar Mensagem do MQ para enviar uma mensagem à fila especificada 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 e Mapeando Entradas para a atividade.

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

Detalhes da Fila e da Mensagem

Especifique os detalhes de Fila e de Mensagem usando 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 na qual as mensagens são colocadas.
Tipo de Dado da Carga Útil Especifica o tipo de dados da carga útil da mensagem, binário ou cadeia.
Tipo de Mensagem Datagrama - Selecione se a mensagem deve ser enviada e nenhuma resposta é necessária.

Pedido - Selecione se a mensagem deve ter uma resposta. Certifique-se de configurar a propriedade Responder para a Fila para mensagens de pedidos.

Resposta - Selecione se a mensagem é uma resposta a um pedido anterior.

Responder para a Fila Especifica a fila para a qual a resposta deve ser enviada para mensagens de pedidos.
Responder para o Gerenciador de Filas Especifica o nome do Gerenciador de Filas ao qual a fila (especificada no campo Responder para a Fila) pertence.
Persistente
  • Verdadeiro - As mensagens são restauradas para as filas se o Gerenciador de Filas falhar.
  • Falso - As mensagens podem se perder da fila se o Gerenciador de Filas falhar.
  • Padrão - As mensagens usam a configuração de persistência para a fila (este é o padrão).
Prioridade Especifica a prioridade da mensagem. Por padrão, a prioridade da mensagem assume a prioridade padrão da fila. Se a fila usar prioridades para ordenar mensagens e essa mensagem precisar ter um conjunto de prioridades específico, selecione Especificar e insira a prioridade. As prioridades podem estar no intervalo de 1 (mais baixo) a 9 (mais alto).
Nota: A prioridade não deve exceder o número máximo de prioridade configurado para a fila do MQ. Verifique essas informações com seu administrador do sistema MQ.
Expiração da Mensagem O número de segundos em que as mensagens são mantidas na fila antes de expirar. O padrão é Nunca, que assegura que a mensagem seja entregue e aguarda na fila até que ela seja recuperada, não importando quanto tempo isso demore.

Se as mensagens para essa fila precisarem expirar e ser descartadas após algum período de tempo, selecione Especificar e insira o número máximo de Segundos que a mensagem deve ser mantida na fila.

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
Entregar Mensagens As opções disponíveis aqui são:
  • 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.

Opções de Nova Tentativa

Configure as opções de nova tentativa para se conectar a um MQ Server. A tabela a seguir descreve as opções de nova tentativa para se conectar a um MQ Server:

Opções de Nova Tentativa Descrição
1) Aguardar ___ segundo(s) entre cada nova tentativa. O número de segundos em que o Integration Appliance aguarda antes de tentar contatar o Gerenciador de Filas para enviar uma mensagem ao MQ Server novamente.
2) Tentar se conectar ___ vezes antes de falhar. Especifica o número máximo de vezes que o Integration Appliance tenta contatar o Gerenciador de Filas para enviar uma mensagem ao MQ Server antes de emitir um erro e parar o processamento da tarefa de orquestração atual.

Se você implementar uma orquestração que contém uma atividade Colocar Mensagem do MQ e o Integration Appliance não puder se conectar ao Gerenciador de Filas do MQ Server especificado, 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 para 3. O primeiro, segundo e terceiro erros de conexão 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.

Mapeando Entradas

É necessário mapear os parâmetros de entrada para essa atividade. O parâmetro a seguir é necessário e deve ser mapeado para que a configuração seja concluída. Todos os outros parâmetros são opcionais. Consulte Criando um Mapa para obter informações adicionais.
Parâmetros de Entrada Necessários:
payload

Para visualizar os parâmetros de entrada opcionais no painel Para Atividade do painel Mapear Entradas, selecione Mapear > Mostrar Parâmetros Opcionais no menu da barra de ferramentas ou clique com o botão direito do mouse no painel Para Atividade e selecione a opção Mostrar Parâmetros Opcionais. Se a opção Mapear > Mostrar Parâmetros Opcionais não for selecionável no menu da barra de ferramentas, clique em um nó no painel Mapear Entradas para ativar esta opção.