Gerando um Novo Conversor de Página de Códigos

Crie um conversor de página de códigos para lidar com a conversão de dados pertencentes a uma página de códigos que não esteja incluída no conjunto padrão de páginas de códigos fornecido pelo IBM® App Connect Enterprise.

Antes de Começar

  • Leia a seção “Conversores de página de códigos”, que fornece informações sobre o que é um conversor de página de códigos e sobre as páginas de códigos compatíveis com o IBM App Connect Enterprise.
  • Se você aplicar um pacote de correções ao IBM App Connect Enterprise que aumente a versão do ICU, recompile os conversores de página de código utilizados pelos fluxos de mensagens d IBM App Connect Enterprise ou pelo analisador DFDL. (A versão de ICU é listada no documento de fix pack no site de Suporte IBM.)

Sobre esta tarefa

Essas informações são divididas nas seguintes seções:

Criando um novo conversor de página de códigos

Procedimento

  1. Crie ou encontre um arquivo de dados de mapeamento com a extensão de arquivo .ucm para o conversor que você requer.
    É possível fazer download de arquivos .ucm a partir do archive ICU Arquivos de mapeamento do conjunto de caracteres . Esses arquivos de dados de mapeamento estão disponíveis e podem ser modificados sem restrição.
    Um arquivo de dados de mapeamento de exemplo é ibm-1284_P100-1996.ucm. (A ICU é um projeto de código aberto externo, não uma ferramenta IBM .)
  2. Renomete o .ucm para um nome de arquivo com o formato ibm-number.ucm onde number é um número que você escolhe para identificar a página de código. Certifique-se de que esse número ainda não seja usado em uma das Páginas de códigos suportadas.
    Por exemplo, você poderia renomear ibm-1284_P100-1996.ucm para ibm-1284.ucm.
  3. Entre em contato com o Suporte IBM para obter os utilitários necessários para o seu sistema, especificando o APAR IT38033.
  4. Extraia os arquivos do archive de distribuição binária em um diretório temporário.
  5. Copie a biblioteca e os arquivos binários em um diretório no ambiente PATH e LIBPATH. (Como alternativa, copie os arquivos de biblioteca e binários para um diretório que não seja temporário e modifique o PATH e LIBPATH do ambiente para incluir esse diretório).
  6. Um dos arquivos extraídos é makeconv.exe; use esta ferramenta makeconv para converter o arquivo de dados de mapeamento (arquivos.ucm ) em um arquivo de conversor binário (arquivo.cnv ), inserindo o seguinte comando:
    makeconv mapping_file.ucm
    em que mapping_file.ucm é o arquivo de dados de mapeamento que você está utilizando.
    O nome do arquivo conversor binário que makeconv produz é:
    mapping_file.cnv
    em que mapping_file.cnv é o nome do arquivo de dados de mapeamento que foi convertido.
    Para criar o arquivo .cnv para ibm-1284.ucm, utilize o comando a seguir:
    makeconv ibm-1284.ucm

Disponibilizar o novo conversor de páginas de códigos para os fluxos de mensagens d IBM App Connect Enterprise

Procedimento

  1. Copie o arquivo com a extensão .cnv correspondente à página de códigos necessária para um diretório ao qual o ` IBM App Connect Enterprise ` tenha acesso.
    O nome e o local do arquivo estão no formato
    ibm-1284.cnv
    e está localizado no diretório $ICU_DATA/icudt##<platform-suffix> , em que icudt## é a versão do ICU, que pode ser localizada no documento de fix pack no site de suporte IBM ; por exemplo, icudt51 para IBM Integration Bus versão 10.0.0.11. < platform-suffix> é um dos seguintes valores:
    • l para plataformas ASCII little-endian
    • b para plataformas ASCII big-endian
    • e para plataformas EBCDIC
  2. Opcional: Se você não quiser que o novo conversor de página de código esteja no mesmo local que outros dados do ICU, deve-se associar o intermediário ao novo diretório onde o conversor é armazenado (o diretório incluído deve conter o caminho completo, não incluindo o subdiretório icudt48x ):
    • Para criar um novo intermediário que esteja associado ao conversor, inclua o parâmetro -c no comando mqsicreatebroker .
    • Para afetar todos os produtos e as ferramentas de linha de comandos do broker que estão utilizando ICU, inclua o diretório na variável de ambiente ICU_DATA. Se você tiver usado o comando mqsicreatebroker para especificar o conversor de página de código a ser usado, o intermediário ignora o valor ICU_DATA .
      Nota: Para garantir um comportamento consistente em todos os componentes, modifique a variável de ambiente ICU_DATA .

Disponibilizando o novo conversor de página de códigos para o analisador DFDL

Antes de Começar

O componente DFDL inclui sua própria cópia das bibliotecas ICU. Esta cópia pode ter uma versão diferente daquelas utilizadas pelo IBM App Connect Enterprise. Nesse caso, se a nova página de códigos tiver que ser utilizada para análise DFDL, o novo conversor de página de códigos também deverá ser copiado para um local específico que possa ser acessado pelo DFDL. O componente DFDL usa a variável de ambiente ICU_DATA como um local raiz para procurar tabelas de conversão. Essa variável de ambiente já deverá ter sido configurada para você ao executar mqsiprofile.

Procedimento

  1. Copie a nova página de código converte .cnv arquivo para um subdiretório abaixo do local especificado na variável de ambiente ICU_DATA . Esse subdiretório poderá não precisar ser criado e o seu nome deverá corresponder à versão das bibliotecas ICU que são fornecidas com o componente DFDL.

    No caso de IBM App Connect Enterprise, o novo arquivo conversor de página de códigos é copiado para o $ICU_DATA/icudt48<platform-suffix> diretório, onde o número 48 indica a versão do ICU ( 4.8 ) utilizada pelo IBM App Connect Enterprise.

    Para verificar se o nível de ICU utilizado pelo DFDL é diferente daquele utilizado pelo IBM App Connect Enterprise, execute uma das seguintes tarefas para a sua plataforma:
    1. Plataforma LinuxPlataforma UNIX No sistema Linux® e UNIX , consulte o caminho a seguir para localizar um nome de biblioteca que comece com libicudata*:
      <product installation path>/dfdlc/lib
      O sufixo numérico do nome do arquivo denota a versão do ICU.
    2. Plataforma WindowsNos sistemas Windows , consulte o seguinte caminho para localizar bibliotecas com nomes que começam com icudt*:
      <product installation path>\bin
      Quaisquer bibliotecas que tiverem um sufixo numérico que não seja 48 são as bibliotecas ICU DFDL e o sufixo denota a versão do ICU.
  2. Se a versão do ICU utilizada pelo componente DFDL no ` IBM App Connect Enterprise ` não for a 48correta, deve-se criar um novo icudt<DFDL-icu-version><platform-suffix> subdiretório chamado `ICU` dentro desse $ICU_DATAdiretório.
    Por exemplo: Se bibliotecas de ICU com um sufixo de 51 forem encontradas, então o novo arquivo conversor de página de código para DFDL deve ser copiado para o diretório $ICU_DATA/icudt51<platform-suffix> , onde o < platform-sufix> é um dos seguintes valores:
    • l para plataformas ASCII little-endian
    • b para plataformas ASCII big-endian
    • e para plataformas EBCDIC