Propriedades CWF para Referência de Atributos e Tipos de Flutuações de Atributos 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 da lista drop-down:
  • 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.
  • Flutuante. Equivale ao tipo de dados FLOAT ou DOUBLE em C ou ao tipo de dados COMP-1 ou COMP-2 em COBOL. Este é o valor padrão.
  • 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 Inteiro, Decimal Compactado e Flutuante são representados no valor de Codificação apropriado do WebSphere MQ.
  • Os elementos que possuem Tipo Físico definido como Decimal Externo são representados no valor CodedCharSetId do WebSphere MQ.
Contagem de Comprimento Inteiro Digite o número de bytes para especificar o comprimento do elemento:
  • Se você definir o Tipo Físico como Flutuante, selecione um valor da lista drop-down. O valor padrão é 8.
  • Se definir o Tipo Físico como Inteiro, selecione 1, 2 ou 4 (o padrão) da lista drop-down.
  • 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 Sujeito ao Tipo Físico enviado, selecione uma das seguintes opções na lista drop-down:
  • Bytes.
  • Caracteres. O significado dessa opção depende do valor definido no CCSID da mensagem ou que foi definido para a propriedade do conjunto de mensagens CCSID Padrão.
    • Se você tiver especificado um CCSID SBCS, X bytes serão processados, em que X é o valor de Contagem de Comprimento ou de INTEGER especificado por Referência de Comprimento.
    • Se você tiver especificado um CCSID DBCS, Y bytes serão processados, em que Y é o valor de Contagem de Comprimento ou de INTEGER especificado em Referência de Comprimento multiplicado por dois.
    • Se você tiver especificado um CCSID MBCS, o analisador lerá 1 caractere de cada vez e determinará se o caractere inclui 1 ou mais bytes. O analisador executará Z leituras, em que Z é o valor de Contagem de Comprimento ou de INTEGER especificado em Referência de Comprimento.
  • Unidades de Caracteres. Especifica que o tamanho da unidade de caractere é determinado pelo valor definido no CCSID da mensagem ou para a propriedade do conjunto de mensagens CCSID Padrão. O número de bytes processados é o tamanho da unidade de caractere multiplicado pelo valor de Contagem de Comprimento ou de INTEGER especificado em Referência de Comprimento.
  • Final do Fluxo de Bits. Todos os dados até o final do fluxo de bits serão processados. Essa opção será válida apenas se o elemento for o último na mensagem. Se você selecionar esse valor, não será necessário digitar um valor em Contagem de Comprimento.

O padrão é bytes.

Assinalado Booleano Selecione ou cancele a seleção (não sinalizado, o padrão) desta propriedade. Se você tiver definido Tipo Físico como Flutuante, ele será selecionado. Esta propriedade é utilizada em conjunto com a Orientação de Sinal.
Personalização Assinada de EBCDIC Booleano Se o Tipo Físico for definido como Decimal Externo e a propriedade Personalização Assinada de EBCDIC for definida, isso indicará que a representação de Assinar a Personalização de EBCDIC deve ser utilizada em um ambiente ASCII. Se esta caixa de opções não estiver configurada (o padrão), será utilizada a representação ASCII de Sinais.

A configuração da caixa de opções Sinalizar EBCDIC Customizado será apropriada apenas se a propriedade Orientação de Sinal estiver configurada como Inicial ou Final (indicando que o elemento/atributo possui uma representação de sinais incorporada.

A caixa de opções será desativada se o elemento/atributo não estiver sinalizado (por exemplo, quando a caixa de opções Sinalizado 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:
  • Inicial Incluído. Define um bit no primeiro byte ativo 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'. Este é o valor padrão.
  • Inicial 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.
  • Final Incluído. Define um bit no último byte ativo 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'.
  • Final 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 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 float contendo 1234 com um valor Decimal Virtual de 3 é 1.234.

Isto não será aplicável se você definir o Tipo Físico como Flutuante.

Justificação de Cadeia Tipo Enumerado Se a propriedade Tipo Físico for definida como Decimal Externo, selecione Alinhar à Esquerda ou Alinhar à Direita (o valor padrão) a partir da lista drop-down. 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 da Cadeia for Alinhamento à Esquerda ou Alinhamento à Direita, configure esse caractere de uma das seguintes formas:
  • Selecione NUL, '0' ou SPACE a partir da lista drop-down.
  • Insira um caractere entre aspas, por exemplo, "c" ou 'c', em que c é qualquer caractere alfanumérico.
  • Insira um código de caractere hexadecimal no formato 0xYY, em que YY é um valor hexadecimal.
  • 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 inserido é 10.

A opção de qual desses formatos de caracter de preenchimento será utilizado para um elemento MRM irá depender do caractere de preenchimento requerido e se o caractere de preenchimento deverá ser sujeito à conversão de dados. Na maioria dos casos, a especificação de um caractere de preenchimento será suficiente e quando este caractere de preenchimento for utilizados, ele será convertido para a página de códigos de destino da saída da mensagem MRM gerada. Se for requerido um caractere de preenchimento que não seja facilmente inserido no campo de caracteres de preenchimento, poderá ser utilizado o formato mnemônico do Unicode para especificá-lo. Quando utilizado, esse valor do Unicode também será convertido para a página de código de destino da mensagem do MRM que está sendo gerada. Se for requerido um caractere de preenchimento que não esteja sujeito à conversão de dados, será utilizado o formato hexadecimal. Isso permite especificar a opção de um caractere de preenchimento que seja inserido diretamente na mensagem de saída. Se esse formato for utilizado, você deverá assegurar-se de que esse hexadecimal seja válido para a página de código das mensagens de saída criadas com essas definições do MRM.

Se estiver convertendo uma mensagem de uma página de código para outra, você deverá assegurar-se de que o valor convertido do caractere de preenchimento seja válido para essa página de código. Por exemplo, ao converter de ASCII para a página de códigos 500, se você tiver especificado o número 8 como caractere de preenchimento, ele será convertido de 0x08 para 0x15, as representações de ASCII e EBCDIC para 'back space'.

Atualmente existe uma restrição que o valor de seu caractere de preenchimento não deve ser maior que U+007F. Observe que se um mnemônico Unicode ou valor numérico for digitado, ele será considerado como o caractere representado por esse número em UTF-8.

Alinhamento de Bytes

Propriedade Type 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 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 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.

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 de Ligação Tagged/Delimited String para 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
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 04/11/2005
ad15170_