Propriedades CWF para Tipos Binários de Elementos Compostos

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

Representação Física

Propriedade Type Significado
Contagem do Comprimento Botão e Número Inteiro Se tiver selecionado o comprimento a ser definido por Comprimento, insira o número de unidades de comprimento para o elemento.

O valor mínimo que pode ser especificado é 1.

O valor máximo que pode ser especificado é 2147483647.

O valor padrão é vazio (não definido).

Referência de Comprimento Botão e Tipo Enumerado Se você selecionou o comprimento para ser definido por Referência de Comprimento, selecione o nome do objeto de inteiro que especifica o comprimento deste objeto. Faça sua seleção a partir da lista exibida de objetos de inteiro que estão definidos como irmãos do objeto atual e ocorre antes dele na estrutura da mensagem.

Para obter informações sobre como reordenar elementos, consulte Reordenando Objetos.

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. O comprimento é fornecido em 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 ou Referência de Comprimento.

O padrão é Bytes.

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 do Objeto de Modelo de Mensagem Reprovadas
Propriedades de Elementos Compostos
Propriedades CWF de Elemento Composto
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ad16260_