Propriedades CWF para Referência de Elementos e Tipos de Decimais de Elementos Locais

As propriedades de Formato Custom Wire descritas aqui aplicam-se a:

Representação Física

Propriedade Type Significado
Tipo Físico Tipo Enumerado Selecione um dos seguintes na lista exibida:
  • Número Inteiro. Equivale ao tipo de dados SHORT ou LONG em C ou ao tipo de dados numéricos COMP, COMP-4, COMP-5 ou BINARY em COBOL.
  • Decimal Compactado. Equivale ao tipo de dados COMP-3 em COBOL.
  • Decimal Externo. Equivale ao tipo de dados PIC 9 USAGE DISPLAY em COBOL.

A representação de elementos numéricos pode ser afetada pelos atributos Codificação e CodedCharSetId que são definidos para o gerenciador de filas do WebSphere MQ:

  • Elementos com Tipo Físico definido como Número Inteiro e Decimal Compactado são representados no valor Codificação do WebSphere MQ apropriado.
  • Os elementos que possuem Tipo Físico definido como Decimal Externo são representados no valor CodedCharSetId do WebSphere MQ.
Contagem do Comprimento Número Inteiro Digite o número de bytes para especificar o comprimento do elemento:
  • Se você configurar o Tipo Físico como Número Inteiro, selecione 1, 2 ou 4 (o padrão) na lista exibida.
  • Se você definir o Tipo Físico como Decimal Compactado, digite um valor entre 1 e 10.
  • Se você definir o Tipo Físico como Decimal Estendido, digite um valor entre 1 e 256. (Número maiores que a cláusula máxima COBOL PICTURE de 18 são assumidos como 18).
Unidades de Comprimento Tipo enumerado Selecione a unidade de comprimento para o elemento ou atributo. Selecione uma das seguintes opções a partir da lista exibida (alguns tipos físicos não oferecem todas estas opções):
  • Bytes.
  • Caracteres. O Comprimento é fornecido em caracteres. Isso significa que o número de bytes processados no fluxo de bits depende da página de códigos dos caracteres que estão sendo processados.
    • Para uma página de códigos de byte único (SBCS CCSID), como "latin-1" (CCSID 850), o número de bytes é igual ao número de caracteres.
    • Para uma página de códigos de byte duplo (DBCS CCSID), como "UTF-16" (CCSID 1200), o número de bytes é exatamente duas vezes o número de caracteres.
    • Para uma página de códigos multibyte (MBCS CCSID), como "UTF-8" (CCSID 1208), o número de bytes depende do conteúdo do fluxo de bits. O analisador lê um caractere por vez e determina se o caractere contém um ou mais bytes.
  • Unidades de Caracteres. Especifica que o tamanho de cada caractere (em bytes) é determinado pela página de códigos da mensagem.
    • Para páginas de códigos de byte único e byte duplo, esta opção é idêntica a Caracteres.
    • Para uma página de códigos multibyte, esta opção fornece desempenho aprimorado de análise, supondo que cada caractere esteja codificado na menor unidade de caractere suportada pela página de códigos. Entretanto, isso significa que uma mensagem deverá conter somente esses caracteres, para ser processada corretamente. Por exemplo, na página de códigos "UTF-8" (CCSID 1208), a unidade mínima de caractere é um byte; portanto, o analisador pode fazer uma única leitura (do número de bytes especificado pela propriedade Comprimento) para buscar a mensagem inteira. A mensagem deve conter somente caracteres codificados em unidades de 1 byte.
  • Final do Fluxo de Bits. Todos os dados até o fim do fluxo de bits são processados. Essa opção será válida apenas se o elemento for o último na mensagem. Se você selecionar esse valor, não precisará digitar um valor para a propriedade Contagem de Comprimento.

O padrão é Bytes.

Justificação Tipo enumerado Se a propriedade Tipo Físico for definida como Decimal Externo, selecione Alinhar à Esquerda ou Alinhar à Direita (o valor padrão) na lista. Se tiver selecionado outro valor para Tipo Físico, esta propriedade ficará inativa.
Caractere de Enchimento Cadeia O caractere de preenchimento é utilizado para preencher as posições de caracteres restantes quando o comprimento da cadeia for menor que o tamanho da cadeia especificada. Se você tiver configurado a propriedade Tipo Físico para Decimal Estendido e a propriedade Alinhamento for Alinhamento à Esquerda ou Alinhamento à Direita, especifique esse caractere de uma das seguintes formas:
  • Selecione NUL, '0' ou SPACE a partir da lista exibida.
  • Insira um caractere entre aspas duplas, por exemplo, "c" ou 'c', em que c é qualquer caractere alfanumérico.
  • Insira um valor Unicode no formato U+xxxx, em que xxxx é um valor Unicode especificado em hexadecimal. O comprimento máximo da cadeia que pode ser digitada é 10.
  • Digite um caractere hexadecimal no formato 0xYY, em que YY é um valor hexadecimal.
  • Digite um valor de byte de decimal (de 0 a 255).

A opção de qual dessas formas de caractere de preenchimento é utilizada para um elemento MRM depende do caractere de preenchimento que é requerido e se o caractere de preenchimento deve estar sujeito à conversão de dados. Na maioria dos casos, a especificação de um caractere de preenchimento entre aspas duplas é suficiente e quando este caractere de preenchimento é utilizado, ele é convertido para a página de códigos de destino da mensagem MRM de saída que está sendo gerada. Por exemplo, ao converter de ASCII para a página de códigos 500, se você tiver especificado U+0008 como seu caractere de preenchimento, ele será convertido de 0x08 para 0x15, as representações de ASCII e de EBCDIC para 'back space'.

Se um caractere de preenchimento que não pode ser facilmente digitado for requerido no campo de caractere de preenchimento, o formato mnemônico Unicode pode ser utilizado para especificar o caractere requerido. Quando utilizado, o valor de Unicode também é convertido para a página de códigos de destino da mensagem MRM que está sendo gerada.

Se você estiver convertendo uma mensagem de uma página de códigos para outra, você deve assegurar que os valores convertidos do caractere de preenchimento seja válido para essa página de código. Se o caractere de preenchimento não puder ser representado na página de códigos de destino, ele será substituído por um caractere de substituição. O caractere de substituição é fixo e seu valor depende da página de códigos de destino especificada.

Se um caractere de preenchimento que não esteja sujeito a conversão de dados for requerido, o formato hexadecimal ou decimal poderá ser utilizado. Isso fornece a opção de especificar um valor absoluto como um caractere de preenchimento que é inserido diretamente na mensagem de saída. Se esse formato for utilizado, você deve ainda ter a intenção de assegurar que esse valor seja válido para a página de códigos de qualquer mensagem de saída criada utilizando essas definições MRM.

Representação Numérica

Propriedade Type Significado
Assinalado Caixa de Opções Selecione (o padrão) ou limpe esta propriedade. Esta propriedade é utilizada em conjunto com a Orientação de Sinal.
Sinal com Overpunch Customizado EBCDIC Caixa de Opções Se o Tipo Físico estiver configurado para Decimal Externo e a propriedade EBCDIC Sinalizado Customizado estiver configurada, isso indica que a representação do Sinal EBCDIC Customizado com Overpunch deve ser utilizada em um ambiente ASCII. Se esta caixa de opções não estiver selecionada (o padrão), a representação Sign ASCII será utilizada.

A configuração da caixa de opção Sinal EBCDIC Customizado com Overpunch é apropriada apenas se a propriedade Orientação de Sinal estiver definida como Espaço Inicial ou Espaço Final (indicando que o elemento /atributo possui uma representação de sinal incorporado).

A caixa de opção não ficará disponível se o elemento/atributo não estiver sinalizado (por exemplo, se a caixa de opção Assinalado não estiver configurada).

Orientação de Sinal Tipo enumerado Se Tipo Físico foi definido como Decimal Externo e Assinado foi selecionado, escolha a partir das opções a seguir que representam as opções de COBOL para a visualização de dados numéricos:
  • À Esquerda com Overpunch. Isso configura um bit no primeiro byte se o número for negativo. Nenhuma definição será feita se o número for positivo. Por exemplo, a representação hexadecimal ASCII do número 22 é x'3232'. Utilizando essa opção, o número +22 seria x'3232' e o número -22 seria x'7232'. Esse é o valor padrão.
  • À Esquerda Separado. Isso define o primeiro byte do elemento como '+' se o número for positivo e como '-' se o número for negativo. Para essa opção, o comprimento deve incluir o byte de sinal.
  • À Direita com Overpunch. Isso configura um bit no último byte se o número for negativo. Nenhuma definição será feita se o número for positivo. Utilizando esta opção, o número +22 seria x'3232' e o número -22 seria x'3272'.
  • À Direita Separado. Isso define o último byte do elemento como '+' se o número for positivo e como '-' se o número for negativo. Para essa opção, o comprimento deve incluir o byte de sinal.
Se você tiver definido Tipo Físico como qualquer outro valor, o valor Não Aplicável será definido.
Ponto Decimal Virtual Número Inteiro Especifique o número de locais à esquerda (para um valor positivo) ou à direita (para um valor negativo) para os quais um ponto decimal deve ser movido de sua posição assumida. Por exemplo, um elemento decimal contendo 1234 com um valor Decimal Virtual de 3 é 1.234. É equivalente a 'V' ou 'P' em uma cláusula COBOL picture. Não existe equivalente em C

Representação de Valores Nulos

Propriedade Type Significado
Codificação Nula Tipo enumerado Selecione uma das opções a seguir na lista exibida:
  • NULLPadFill. Isto é válido apenas se Tipo Físico for Decimal Externo. O campo é preenchido com o valor especificado pelo Caractere de Preenchimento. Valor de Codificação Nulo deve ser definido como uma cadeia vazia.
  • NULLLogicalValue. O Valor de Codificação Nulo é transformado para corresponder ao formato requerido do campo. Esse é o valor padrão.
  • NULLLiteralValue. O Valor de Codificação Nulo é diretamente substituído como se fosse uma cadeia. Você pode especificar um valor não numérico para Valor de Codificação Nulo.
  • NULLLiteralFill. O campo é preenchido com o valor especificado pelo Valor Nulo de Codificação. O Valor Nulo de Codificação deve ser resolvido para um único caractere.
Valor Nulo de Codificação Cadeia A utilização dessa propriedade depende da propriedade Codificação Nula descrita acima, com exceção de NULLLiteralFill. O valor padrão é zero.
Se você definir a propriedade Codificação Nula como NULLLiteralFill, o valor deverá ser resolvido para um único caractere. Defina o caractere da seguinte forma:
  • Selecione SPACE, NUL, 0x00 ou 0xFF na lista exibida
  • Digite um caractere entre aspas, por exemplo 'c' ou "c", em que c é qualquer caractere alfanumérico.
  • Digite um caractere hexadecimal no formato 0xYY, em que YY é um valor hexadecimal.
  • Insira um código de caractere decimal no formato YY, em que YY é um valor decimal.
  • Insira um valor Unicode no formato U+xxxx, em que xxxx é um valor Unicode especificado em formato hexadecimal.

Alinhamento de Bytes

Propriedade Tipo Significado
Alinhamento de Byte Tipo enumerado Especifique como o objeto será alinhado no início da mensagem. Selecione uma das opções:
  • 1 Bytes. Este é o valor padrão.
  • 2 Bytes
  • 4 Bytes
  • 8 Bytes
  • 16 Bytes
Ignorar Contagem Inicial Número Inteiro Especifique o número de bytes a serem ignorados antes da leitura ou gravação desse objeto. O padrão é 0, o valor mínimo é 0 e o valor máximo é 999999. Você pode utilizar este valor para ignorar campos não desejados em uma estrutura ou para modelar um campo definido por dados C ou COBOL que requerem alinhamento em um limite de 2, 4, 8 ou 16 bytes. Especifique o número de bytes a serem ignorados antes da leitura ou gravação desse objeto. Quando uma mensagem de saída é gravada, a opção Ignorar Contagem de bytes recebe designação do valor da propriedade Preenchimento do Alinhamento de Bytes do conjunto de mensagens.

Para objetos de repetição, essa propriedade é aplicada apenas à primeira instância.

Ignorar Contagem Final Número Inteiro Especifique o número de bytes a serem ignorados após a leitura ou gravação desse objeto. O padrão é 0, o valor mínimo é 0 e o valor máximo é 999999.Você pode utilizar este valor para ignorar campos não desejados em uma estrutura, ou para modelar uma estrutura de repetição contendo campos que requerem alinhamento em um limite de 2, 4, 8 ou 16 bytes. Quando uma mensagem de saída é gravada, a opção Ignorar Contagem de bytes recebe designação do valor da propriedade Preenchimento do Alinhamento de Bytes do conjunto de mensagens.

Para objetos de repetição, esta propriedade é aplicada a todas as instâncias.

Repetição

Propriedade Tipo Significado
Referência de Repetição Tipo enumerado Utilize esta propriedade se o objeto ocorrer várias vezes e o número de ocorrências for especificado dinamicamente por um campo anteriormente na mensagem. Selecione um objeto de inteiro a partir da lista exibida de objetos de inteiro que ocorre antes deste objeto na estrutura da mensagem. O valor do inteiro selecionado especifica o número de ocorrências deste objeto. Se nenhum objeto estiver listado, não haverá objetos inteiros antes desse na estrutura da mensagem.

Se uma Referência de Repetição for especificada, ela substituirá qualquer configuração da propriedade lógica Máx. de Ocorrências na análise e gravação da mensagem, mas não para validação da mensagem.

Conceitos relacionados
Modelagem de Mensagens
O Modelo de Mensagem
Custom Wire Format: Relacionamento com o Modelo Lógico
Tarefas relacionadas
Desenvolvendo Modelos de Mensagens
Trabalhando com Objetos de Modelo de Mensagem
Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Objeto de Modelo de Mensagem
Propriedades Lógicas para os Objetos de Modelo de Mensagem
Propriedades Físicas com Custom Wire Format para os Objetos de Modelo de Mensagem
Propriedades Físicas do Formato de Ligação XML para os Objetos de Modelo de Mensagem
Propriedades Físicas do Formato TDS para os Objetos de Modelo de Mensagem
Propriedades da Documentação para Todos os Objetos do Conjunto de Mensagens
Propriedades dos Objetos de Modelo de Mensagem por Objeto
Informações adicionais do domínio MRM
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:13

ad15380_