Definindo e Carregando um Esquema XML para um Cabeçalho MQRFH2

Para incluir metadados ou parâmetros adicionais em uma mensagem do MQ, você deve definir um cabeçalho MQRFH2 que define os parâmetros. Geralmente, esses parâmetros são específicos de um aplicativo, mas não ocorrem nos dados da própria mensagem.

Sobre Esta Tarefa

Cada parâmetro, que o MQ chama de pasta, é passado como um fragmento XML juntamente com outros dados do cabeçalho MQRFH2. Cada parâmetro pode ter sua própria estrutura XML exclusiva.

Como o Integration Appliance trabalha com mensagens XML, cada um desses fragmentos de parâmetro deve ser extraído do cabeçalho MQRFH2. Os fragmentos são consolidados em um único fragmento e passados como o parâmetro MQRFH2 para o Integration Appliance.

Para tornar esses parâmetros acessíveis, o Studio e o Integration Appliance precisam de acesso a um Esquema XML que define as estruturas de todos os parâmetros. Conclua o procedimento a seguir para criar esse Esquema XML e carregá-lo no projeto.

Procedimento

  1. Crie um Esquema XML que define os parâmetros de seu cabeçalho MQRFH2 usando o editor de Esquema XML ou editor de texto. Para um Esquema XML de exemplo, consulte Exemplos de Dados e Esquema XML do MQRFH2. Seu Esquema XML deve ser customizado para os parâmetros do aplicativo.
    Crie o Esquema XML de acordo com as seguintes diretrizes:
    • Defina a estrutura consolidada como um único elemento NameValueData.
    • Liste todos os parâmetros, na ordem em que ocorrerem no cabeçalho MQRFH2, como elementos dentro do elemento NameValueData.
    • Os nomes de parâmetros devem ser exclusivos.
    • Os nomes dos parâmetros, grupos e propriedades devem ser nomes XML válidos. Consulte a especificação XML ou a documentação do MQ para obter informações adicionais.
    • Cada parâmetro deve estar contido em um único elemento. A documentação do MQ refere-se a esse elemento de parâmetro como uma pasta.
    • Os parâmetros podem conter propriedades, grupos ou ambos.
    • Os grupos e propriedades podem se repetir.
    • Os grupos podem ser aninhados dentro de outros grupos.
    • As propriedades devem ser definidas como tipo MQRFHQPropertyType.
  2. Inclua este Esquema XML no projeto. Consulte Fazendo Upload de Arquivos para um Projeto para obter informações adicionais.
  3. Agora, o Esquema XML está disponível na caixa de diálogo Procurar Elemento do Tipo de Esquema. Na área de janela Configurar das atividades do MQ, essa caixa de diálogo aparece ao clicar na caixa de opção Fragmento de Esquema para Cabeçalho MQRFH2 e, em seguida, clicar 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.