Propriedades CWF para Referência de Elementos e Tipos de Data/Hora 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 da lista drop-down:
  • Cadeia de Comprimento Fixo. O comprimento do elemento é determinado por outras propriedades de comprimento abaixo.
  • Cadeia de Comprimento Codificado 1. O primeiro byte do elemento contém o comprimento da cadeia após o byte de comprimento em unidades de comprimento. O comprimento máximo de um elemento Cadeia de Comprimento Codificado 1 é de 255 unidades de comprimento.
  • Cadeia de Comprimento Codificado 2. Os dois primeiros bytes do elemento contêm o comprimento da cadeia após os 2 bytes de comprimento em unidades de comprimento. O comprimento máxima de um elemento Cadeia de Comprimento Codificado 2 é de 65535 unidades de comprimento. Os dois bytes de comprimento estão no formato de Codificação do gerenciador de filas do WebSphere MQ.
  • Cadeia Nula Finalizada. A cadeia é finalizada com o caractere hexadecimal NULL, X'00'.
  • Decimal Compactado. dateTime é codificado como um número Decimal Compactado. Válido apenas se a propriedade Formato DateTime representar dados apenas numéricos.
  • Binário. DateTime é codificado como uma seqüência binária de bytes. Se você selecionar esta opção, o intervalo de símbolos que podem ser especificados para a propriedade Cadeia de Formatações será menor que o intervalo de símbolos que poderão ser especificados se for selecionada uma opção de cadeia (consulte Formatos DateTime para obter detalhes).
  • Tempo em Segundos. Este valor suporta objetos de Data e Hora C time_t e Java. Válido apenas se a propriedade Formato DateTime representar dados apenas numéricos.
  • Tempo em Milissegundos. Este valor suporta objetos de Data e Hora C time_t e Java. Válido apenas se a propriedade Formato DateTime representar dados apenas numéricos.

O valor padrão é cadeia de comprimento fixo.

Formato DateTime Cadeia Especifique um gabarito para data e hora.

O formato dateTime padrão depende do tipo lógico do objeto. Para obter informações sobre os padrões do formato dateTime conforme o tipo lógico, consulte DateTime Padronizado pelo Tipo Lógico.

Se você definir o Tipo Físico como Binário, o gabarito será restrito aos componentes definidos em DateTime como Dados de Cadeia. Se definir o Tipo Físico como Decimal Compactado, Tempo em Segundos ou Tempo em Milissegundos, o gabarito ficará restrito aos componentes que representam números. Nestes casos, é necessário atualizar essa propriedade Formato DateTime.

Consulte Formatos DateTime para obter detalhes sobre formatos de data e hora.

Contagem de Comprimento Botão e Inteiro Se você tiver selecionado um Tipo Físico de Cadeia de Comprimento Fixo, Decimal Compactado ou Binário e tiver definido Tipo de Comprimento como Contagem, insira o número de unidades de comprimento para o elemento.

O valor mínimo que pode ser especificado é 1 para todos os três tipos físicos.

O valor máximo que pode ser especificado é 256 para Cadeia de Comprimento Fixo, 10 para Decimal Compactado e 2147483647 para Binário.

O valor padrão é 0 (zero).

Referência de Comprimento Botão e Tipo Enumerado Se você tiver selecionado o comprimento a ser definido por Referência de Comprimento, selecione o nome do objeto Inteiro que especifica o comprimento desse objeto. Na lista drop-down, selecione os objetos Inteiros que estão definidos como irmãos do objeto atual e ocorrem antes na estrutura da mensagem.

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

Unidades de Comprimento Tipo Enumerado Sujeito ao Tipo Físico enviado, selecione uma das seguintes opções na lista drop-down:
  • Bytes. Isso especifica que X bytes são processadas, em que X é o valor da Contagem de Comprimento ou do INTEGER especificado em Referência de Comprimento.
  • 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 ou Referência de Comprimento.

O padrão é bytes.

Assinalado Booleano Se tiver definido a propriedade Tipo Físico como Decimal Compactado, Tempo em Segundos ou Tempo em Milissegundos, selecione (o padrão) ou cancele a seleção de Sinalizado. Se tiver selecionado outro valor para Tipo Físico, essa propriedade será inválida.
Justificação de Cadeia Tipo Enumerado Se a propriedade Tipo Físico for definida como Cadeia de Comprimento Fixo, selecione Alinhar à Esquerda (o valor padrão) ou Alinhar à Direita 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 Cadeia de Comprimento Fixo 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.

Representação de Valores Nulos

Propriedade Type Significado
Codificação Nula Tipo Enumerado Selecione uma das seguintes opções na lista drop-down. A opção selecionada determina o valor que deve ser definido para a propriedade Valor de Codificação Nulo:
  • NULLPadFill. Válido apenas se Tipo Físico for Cadeia de Comprimento Fixo. O campo é preenchido com o valor especificado pelo Caractere de Preenchimento. Este é o valor padrão.
  • NULLLogicalValue. A propriedade Valor de Codificação Nulo é convertida primeiro para um valor real e processada da forma especificada para o campo.
  • NULLLiteralValue. Especifica que Valor de Codificação Nulo contém um valor que é diretamente substituído como se fosse uma cadeia. Utilize esta opção quando o valor definido para Valor de Codificação Nulo para especificar uma data nula não for um valor de dateTime ou não estiver de acordo com o formato de dateTime aaaa-MM-dd 'T'HH:mm:ss.
  • 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

Se você definir a propriedade Codificação Nula como NULLPadFill, esta propriedade será desativada (esmaecida).

Se você definir a propriedade Codificação Nula como NULLLogicalValue, deverá definir essa propriedade como um formato de dateTime ISO8601. Estes formatos estão descritos em DateTime como Dados de Cadeia. Por exemplo, especifique um valor em conformidade com aaaa-MM-dd'T'HH:mm:ss, como 1970-12-01.

Se você definir a propriedade Codificação Nula como NULLLiteralValue, poderá inserir qualquer valor que tenha o mesmo comprimento que o campo.

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 drop-down.
  • Digite 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 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 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.

Repetição

Propriedade Type 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 inteiro da lista drop-down de objetos inteiros que ocorrem antes deste objeto na estrutura da mensagem. O valor do inteiro selecionado especifica o número de ocorrências deste objeto. Se não houver objetos listados, não haverá objetos inteiros antes deste na estrutura da mensagem.

Se uma Referência de Repetição for especificada, ela substituirá qualquer configuração para a 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 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
ad15370_