Migração do Conjunto de Mensagens

Quando você migrar um fluxo de mensagens que usa conjuntos de mensagens, revise as alterações no comportamento em WebSphere Message Broker Versão 7.0.

Revise essas informações sobre as mudanças no conjunto de mensagens e os efeitos potenciais, se estiver migrando do Versão 6.0; nenhuma migração do conjunto de mensagens é necessária para o Versão 6.1.

Você não tem de executar comandos de migração; o WebSphere Message Broker Toolkit Versão 7.0 pode ler um projeto de conjunto de mensagens do Versão 6.0 e automaticamente convertê-lo para o formato Versão 7.0 quando você modifica e salva-o pela primeira vez.

Para obter orientação sobre alterações no comportamento de analisadores e para obter informações gerais de migração, consulte as seguintes seções:

Alterações Comportamentais no Analisador XMLNSC

As alterações a seguir são implementadas no Versão 7.0:

  • No Versão 6.0, os atributos de um elemento XML são exibidos na árvore de mensagens que é criada pelo analisador XMLNSC na ordem em que eles são exibidos no elemento no documento XML.

    No Versão 7.0, o analisador XMLNSC sempre exibe os atributos de espaço de nomes antes de outros atributos quando ele cria a árvore de mensagens. Entretanto, os atributos XML são desordenados de forma herdada, portanto não gravam a lógica do fluxo de mensagens que presume a posição do atributo.

  • Na Versão 6.0, o analisador XMLNSC aceita o EBCDIC NEL com caractere de avanço de linha XML apenas no z/OS.

    Na Versão 7.0, NEL é aceito em todas as plataformas.

  • Na Versão 6.0, o analisador XMLNSC ignora a configuração da propriedade Validar de um nó.

    Na Versão 7.0, o analisador XMLNSC considera a configuração da propriedade Validar. Se essa propriedade tiver sido configurada para Content ou Content And Value, o analisador valida a mensagem em relação ao conjunto de mensagens definido pela propriedade Conjunto de Mensagens.

    Portanto, se você tiver configurado acidentalmente a propriedade Validar na Versão 6.0 para Content ou Content And Value, o fluxo de mensagens emite uma exceção após a migração para a Versão 7.0.

    Para corrigir essa situação, configure a propriedade Validar para None.

  • Na Versão 6.0, o analisador XMLNSC utiliza o formato ESQL padrão "YYYY-MM-DD hh:mm:ss" ao gravar um campo do tipo TIMESTAMP ou GMTTIMESTAMP. Esse formato não está de acordo com a especificação do Esquema XML 1.0.

    Na Versão 7.0, o analisador XMLNSC utiliza o formato "YYYY-MM-DD'T'hh:mm:ss.sss", que está de acordo com a especificação do Esquema XML 1.0. Se precisar que outro formato seja gravado, você deve lançar TIMESTAMP ou GMTTIMESTAMP para um CHARACTER. (Se o elemento tiver sido originalmente analisado pelo analisador XMLNSC e tinha um indicador de fuso horário, o indicador de fuso horário também é gravado no campo da mensagem de saída.)

  • Na Versão 6.0, o analisador XMLNSC utiliza as cadeias ESQL padrão "TRUE" e "FALSE" ao gravar um campo do tipo BOOLEAN. Essa utilização não está em conformidade com a especificação do Esquema XML 1.0.

    Na Versão 7.0, o analisador XMLNSC grava "true" e "false", que está de acordo com a especificação do Esquema XML 1.0. Se precisar que outras cadeias diferentes de "true" e "false" sejam gravadas, lance o campo BOOLEAN para um CHARACTER.

  • Na Versão 6.0, o analisador não valida documentos XML em relação ao Esquema XML gerado a partir de um conjunto de mensagens.

    No Versão 7.0, o analisador XMLNSC oferece esta função. Quando você inclui um fluxo de mensagens a um arquivo Broker Archive (BAR), se a propriedadeDomínio da Mensagem do conjunto de mensagens for configurado como XMLNSC, um Esquema XML é gerado para cada arquivo de definição de mensagem no conjunto de mensagens para uso potencial pelo analisador XMLNSC. Estes Esquemas XML são verificados pelo analisador XMLNSC quando o arquivo BAR é implementado.

    No entanto, as verificações são mais rígidas quando as verificações realizadas pelo editor de arquivo de definição de mensagem e a implementação pode falhar. Se a implementação falhar, você deve corrigir o arquivo de definição de mensagem para estar em conformidade com as regras do Esquema XML. Se o conjunto de mensagens contiver um dos arquivos de definição de mensagem SOAP Envelope fornecidos pela IBM®, reimporte o arquivo de definição de mensagem usando o assistente de Novo Arquivo de Definição de Mensagem fornecida pela IBM.

Alterações Comportamentais no Analisador MRM

As alterações a seguir são implementadas no Versão 7.0:

  • Na Versão 6.0, o Comprimento Fixo com Tags de Separações de Elementos de Dados, Delimitado pela Tag e Comprimento Codificado pela Tag do formato físico TDS do analisador MRM gravam qualquer atributo xsi:type encontrado na árvore de mensagens, usando um nome de tag "type".

    Na Versão 7.0, o formato físico TDS supõe que todos os atributos xsi:type sejam específicos de XML e não grava os mesmos.

  • Na Versão 6.0, o Comprimento Fixo de Separações de Elementos de Dados, Comprimento Fixo AL3 e Comprimento Fixo pela Tag do formato físico MRM TDS tratam um elemento com um Comprimento TDS de zero como comprimento fixo ao analisar, mas como comprimento variável ao gravar. Portanto, todos os dados na árvore de mensagens para esse elemento são gravados no fluxo de bits sem ser emitida uma exceção.

    Na Versão 7.0, o elemento é tratado como comprimento fixo ao analisar e gravar. Assim, todos os dados na árvore de mensagens para esse elemento fazem com que a mensagem BIP5436E seja gerada, a menos que você tenha configurado a propriedade TDS Truncar na saída, caso no qual nada é gravado.

  • Na Versão 6.0, a mensagem BIP5374E é gerada quando um elemento de repetição obrigatório ausente (minOccurs > 1) é detectado durante a validação de uma mensagem MRM.
    Na Versão 7.0, duas condições diferentes são detectadas durante a validação:
    • Um elemento obrigatório que se repete, mas não tem nenhuma instância na árvore de mensagens. Nesse caso, a mensagem BIP5378E é gerada, a qual fornece detalhes dos elementos que existem antes e depois do local esperado do elemento ausente. Por causa dessa mudança, é possível ter de alterar ou aprimorar os processos de erro automáticos que estão vigentes.
    • Um elemento obrigatório que se repete e possui o número de instâncias incorreto na árvore de mensagens. Nesse caso, a mensagem BIP5374E é gerada como antes, dando detalhes das instâncias existentes e esperadas do elemento.

Informações Gerais de Migração

As alterações a seguir são implementadas no Versão 7.0:

  • Um único conjunto de mensagens pode conter modelos para os domínios MRM ou IDOC e também para outros domínios como XMLNSC. No Versão 6.0, um arquivo .dictionary para uso pelo analisador MRM sempre é gerado quando o conjunto de mensagens é incluído em um arquivo BAR.

    No Versão 7.0, um arquivo .dictionary é gerado apenas se você tiver especificado MRM ou IDOC como o domínio de mensagem padrão ou incluído MRM ou IDOC aos Domínios de mensagens suportados no arquivo do conjunto de mensagens. Se um arquivo .dictionary não for mais gerado, inclua MRM ou IDOC aos Domínios de mensagens suportados.

  • O analisador XML está reprovado e pode ser removido em um release futuro. Os fluxos de mensagens existentes que utilizam o analisador XML continuam a operar na Versão 7.0. Utilize o domínio XMLNSC para obter a maioria dos novos fluxos de mensagens que precisam analisar ou gravar documentos XML. Para obter informações adicionais, consulte Qual Analisador XML Você Deve Utilizar?.
  • O domínio e o analisador IDOC estão reprovados e podem ser removidos em um release futuro. Os fluxos de mensagens existentes que utilizam o analisador IDOC continuam a operar na Versão 7.0. Utilize o formato físico TDS do domínio MRM para novos fluxos de mensagens que precisam analisar ou gravar IDocs ALE SAP em formato de texto originários do link do WebSphere MQ para R3.
  • O local e o rótulo de algumas propriedades MRM TDS foram atualizados; nenhuma alteração comportamental está associada a essas alterações.
    • A propriedade Delimitador de Elemento de Repetição agora está dentro da caixa rotulada "Ocorrências", para manter todas as propriedades de repetição juntas.
    • As propriedades Ponto Decimal Virtual e Precisão estão abaixo do grupo de propriedades "Sinal", para serem alinhadas com as propriedades CWF.
    • A propriedade Referência de Comprimento não era utilizada para os grupos locais, referências de grupos e elementos complexos e foi removida de suas folhas de propriedades.
    • A folha de propriedades do grupo local agora tem duas caixas rotuladas "Identificação de Campo", para distinguir a propriedade Padrão de Dados do restante, pois Padrão de Dados aplica-se não ao próprio grupo, mas à sua inclusão em seu pai.
    • As propriedades de representação booleana do conjunto de mensagens agora são exibidas com o prefixo "Text" para dinstigüí-las das novas propriedades de representação boolena binária.
    • O valor de enumeração da propriedade Tipo Físico Character foi renomeado para Text.
    • O valor de enumeração da propriedade Tipo Físico Messaging Standard Alternative foi renomeado para TLOG Specific.
    • A propriedade Cortar Cadeia de Comprimento Fixo foi renomeada para Cortar na Entrada e movida para uma nova caixa rotulada "Cadeias de Comprimento Fixo".
    • A propriedade Derivar Comprimento Padrão do Tipo Lógico foi movida para uma nova caixa rotulada "Configurações Gerais".
  • O local e o rótulo de algumas propriedades MRM CWF foram atualizados; nenhuma alteração comportamental está associada a essas alterações.
    • A propriedade Formato foi movida para a última seção "Representação Física", para ser alinhada com as propriedades TDS.
    • A folha de propriedades do elemento agora tem uma seção rotulada "Representação Numérica" que contém o grupo de propriedades Sinal e Ponto Decimal Virtual para alinhar essas propriedades às propriedades TDS.
    • A propriedade Contagem de Comprimento foi renomeada para Comprimento, para alinhar essa propriedade com as propriedades TDS.
    • A propriedade Alinhamento de Cadeia foi renomeada para Alinhamento, para alinhar essa propriedade às propriedades TDS.
    • A propriedade Sinal EBCDIC Customizado foi renomeada para Sinal EBCDIC Customizado com Overpunch, para alinhar essa propriedade com as propriedades TDS.
    • Os valores de enumeração da propriedade Orientação de Sinal À Esquerda e À Direita foram renomeados para À Esquerda com Overpunch e À Direita com Overpunch, para alinhas essas propriedades às propriedades TDS.
    • As propriedades de ordem de byte do conjunto de mensagens agora são exibidas com o prefixo "Default" para alinhar essas propriedades às propriedades TDS.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:48:16


Tópico de TarefaTópico de Tarefa | Versão 7.0.0.5 | ah20250_