Propriedades do Conjunto de Mensagens CWF

As tabelas definem as propriedades que podem ser configuradas para um conjunto de mensagens de Formato de Ligação Customizada.

Algumas das propriedades do conjunto de mensagens (marcadas com um asterisco(*)) são relevantes apenas se a mensagem que está sendo processada não estiver utilizando WebSphere MQ como protocolo de transporte.

Se o protocolo de transporte for WebSphere MQ, os valores serão derivados dos cabeçalhos de mensagem (por exemplo, MQMD) e as propriedades do conjunto de mensagens, se definidas, serão ignoradas.

Representação Binária de Valores Booleanos

Propriedade Type Significado
Boolean True Value String Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito é meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor deve ser diferente, mas tem o mesmo comprimento que o Valor Booleano Falso. O valor padrão é 00000001.
Boolean False Value String Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito é meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor deve ser diferente, mas tem o mesmo comprimento que o Valor Booleano Verdadeiro. O valor padrão é 00000000.
Boolean Null Value String Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito é meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor pode ser igual ao Valor Booleano Verdadeiro ou Valor Booleano Falso ou diferente. O valor padrão é 00000000.

Configurações de Saída

Utilize estas configurações quando estiver ocorrendo a saída de mensagens.

Propriedade Type Significado
Preenchimento de Alinhamento de Bytes String Se as propriedades do Custom Wire Format xsd:element Byte Alignment, Leading Skip Count e Trailing Skip Count fizerem com que os bytes sejam ignorados no fluxo de bits, quando a mensagem for serializada, essa propriedade fornecerá o caractere a ser utilizado nas posições ignoradas. Defina este caractere de uma das seguintes formas:
  • Selecione SPACE, NUL ou 0 (o padrão) da lista de valores mostrados.
  • Digite um caractere entre aspas, por exemplo, "c" ou 'c', em que c é qualquer caractere alfanumérico.
  • Digite um código de caractere decimal no formato YY em que YY é um valor decimal.
  • Digite um código de caractere hexadecimal no formato 0xYY em que YY é um valor hexadecimal.
  • Digite um valor Unicode no formato U+xxxx em que xxxx é um valor Unicode especificado em formato hexadecimal.
Política para Elementos Ausentes Enumerado Esta propriedade determina a ação executada pelo intermediário quando campos estiverem ausentes da árvore de mensagens quando a mensagem for serializada (para saída):
  • Utilizar Default Value (o padrão). Se existir um Valor Padrão para o elemento, efetue sua saída; caso contrário, emita uma exceção.
  • Utilizar Null Value. Se a propriedade Nillable do elemento for selecionada e um Valor de Codificação Nula for especificado para o elemento, efetue a saída do Valor de Codificação Nula, de acordo com as regras definidas pela propriedade Codificação Nula; caso contrário, emita uma exceção.

Representação Binária de Valores Decimais

Propriedade Type Significado
Código Positivo Decimal Compactado Enumerado Selecione da lista o sinal positivo utilizado para números decimais compactados. O valor padrão é C, que indica que 0x0C é utilizado como o sinal positivo; este valor é utilizado na maioria dos sistemas. Também é possível selecionar F, que indica que 0x0F é utilizado como o sinal positivo; este valor é utilizado em alguns sistemas.

Definições de Data/Hora

Propriedade Type Significado
Derivar formato padrão dateTime de tipo lógico Botão Selecione esta opção se desejar que o formato dateTime padrão seja determinado pelo tipo lógico do elemento ou atributo.

É possível substituir essa propriedade para um elemento ou atributo em um tipo complexo.

Utilizar o formato data/hora padrão Botão e Cadeia Selecione esta opção se desejar especificar um formato de data/hora padrão que é fixado para todos os elementos ou atributos do tipo lógico dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay e gDay.

É possível substituir essa propriedade para um elemento ou atributo em um tipo complexo.

Para obter informações adicionais, consulte Formatos DateTime.

Iniciar o século para anos de 2 dígitos Número Inteiro Essa propriedade determina como os anos de dois dígitos são interpretados. Especifique os dois dígitos que começam com uma janela de 100 anos que contenha o ano atual. Por exemplo, se você especificar 89, e o ano corrente for 2002, todas as datas de dois dígitos serão interpretadas como sendo no intervalo de 1989 a 2088.
Dias na Primeira Semana do Ano Enumerado Especifique o número de dias do ano novo que devem estar na primeira semana.

O início de um ano está normalmente na metade de uma semana. Se o número de dias nessa semana for inferior ao valor especificado aqui, a semana será considerada como a última no ano anterior; portanto, a semana 1 começa alguns dias após o ano novo. Caso contrário, ela será considerada como a primeira semana do ano novo; nesse caso, a semana 1 começa alguns dias antes do ano novo.

Selecione Utilizar Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente, ou selecione um número na lista que é exibida.

Primeiro Dia da Semana Enumerado Especifique o dia no qual cada nova semana é iniciada.

Selecione Utilizar Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente, ou selecione um valor na lista que é exibida.

Verificação Precisa de Data/Hora Caixa de Opções Selecione essa opção se desejar restringir os dateTimes a um formato válido de dateTime. Se Verificação Estrita de DateTime for selecionada, receber um dateTime incorreto provocará um erro.
Verificação Estrita de dateTime
Os exemplos de verificação estrita de dateTime são:
  • DateTimes são restritos apenas para dateTimes válidos. Quando você utiliza esta opção, uma data tal como 35 de Março não é processada como 4 de Abril e 10h79 não é processada como 11h19. Receber um dateTime fora da banda, como esses exemplos, faz com que ocorra um erro.
  • O número de caracteres para um componente dateTime numérico deve estar dentro dos limites dos símbolos de formatação correspondentes. Repita o símbolo para especificar o número mínimo de dígitos que você requer. O número máximo de dígitos que são permitidos se torna o limite superior para um símbolo específico. Por exemplo, dia no mês possui um limite superior de 31; portanto, uma cadeia de formatações de 'd' permite que os valores 2 e 21 sejam analisados, mas não permite os valores 32 e 210. Na saída, os números são preenchidos com zeros para o comprimento especificado. Um ano é um caso especial; consulte a propriedade do conjunto de mensagens Início do Século para Anos de 2 Dígitos. Para segundos fracionários, o comprimento deve corresponder implicitamente ao número de símbolos de formato na entrada. A saída é arredondada para o comprimento especificado.
  • O espaço em branco não é ignorado. O espaço em branco na cadeia de entrada deve corresponder ao mesmo número e posição do espaço em branco na cadeia de formatações.
  • Se ainda houver dados a serem analisados na cadeia de entrada depois que todos os símbolos na cadeia de formatações tiverem sido correspondidos, ocorrerá um erro.
Verificação de dateTime Tolerante
Os exemplos de verificação de dateTime tolerante são:
  • O analisador converte valores dateTime fora da banda para o valor dentro da banda apropriado. Por exemplo, uma data 2005-05-32 é convertida em 2005-06-01.
  • A saída de dateTimes sempre está de acordo com a contagem de símbolos. Por exemplo, uma cadeia de formatações de yyyy-MM-dd (em que '-' é o separador de campo) permite que um ou mais caracteres sejam analisados em relação a MM e dd. Portanto, as datas que não são válidas - por exemplo, 2005-1-123 e 2005-011-12 - podem ser inseridas. O primeiro valor de 2005-1-123 gera a saída como a data 2005-05-03, e o segundo valor de 2005-011-12 gera a saída como a data 2005-11-12.
  • O número do símbolo Z de formatação de fuso horário é aplicável apenas ao formato dateTime de saída.
  • O espaço em branco é ignorado.
Fuso Horário Enumerado O valor definido para essa propriedade será utilizado se o valor especificado para a propriedade Formato Padrão de DateTime não incluir informações sobre Fuso Horário.

O valor inicial é Utilizar Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente.

Você pode alterar essa propriedade, selecionando da lista de valores.

Horário de Verão Caixa de Opções Selecione esta opção, se a área na propriedade Fuso Horário observar o Horário de Verão. Se não observar o Horário de Verão, não selecione esta opção.

Por exemplo, se uma área for selecionada em Fuso Horário e esta opção não for selecionada, o valor transmitido representará o fuso horário sem o Horário de Verão.

Utilizar o Formato UTC de Entrada na Saída Caixa de Opções Esta propriedade se aplica aos elementos e atributos de tipo lógico xsd:dateTime ou xsd:time que contém uma data/hora como uma cadeia e que possuem um formato de data/hora igual a I, IU, T ou TU ou que incluem ZZZ ou ZZZU.

Esses elementos e atributos podem especificar UTC (Coordinated Universal Time), utilizando o caractere Z ou o fuso horário +00:00 no valor. Na entrada, o analisador MRM lembra a forma como o UTC foi especificado.

Se esta propriedade for selecionada e o elemento ou o atributo forem copiados para uma mensagem de saída, o formato UTC será preservado na mensagem de saída e substituirá o formato implícito pela propriedade de formato dateTime.

Se esta propriedade for limpa ou se o elemento ou atributo não foi copiado de uma mensagem de entrada, o formato UTC na mensagem de saída será controlado somente pela propriedade de formato dateTime.

A codificação numérica e de caracteres para mensagens que não são WebSphere MQ

Utilize estas configurações apenas para mensagens sem nenhum MQMD.

Propriedade Type Significado
CCSID* Padrão Número Inteiro Digite um valor numérico para o Identificador do Conjunto de Caracteres Codificados padrão. O padrão é 500.

Se a mensagem de entrada for uma mensagem do WebSphere MQ, será utilizado o atributo equivalente configurado para o gerenciador de filas e esta propriedade será ignorada.

Ordem de Bytes Padrão* Enumerado Selecione Big Endian (o padrão) ou Little Endian da lista para especificar a ordem de bytes de números representados como inteiros binários.

Em C, isto é equivalente ao tipo de dados curto ou longo. Em COBOL, isto é equivalente a um tipo de dados PIC 9, COMP, COMP-4, COMP-5 ou BINARY.

Sua opção deve corresponder à codificação com a qual as mensagens são criadas. Geralmente, Big Endian é a opção correta para mensagens criadas no UNIX ou z/OS; Little Endian é a opção correta para mensagens criadas no Windows.

Não utilize esta propriedade se a mensagem for recebida no protocolo de transporte do WebSphere MQ; neste caso, a propriedade é deduzida do MQMD da mensagem, ou da codificação do gerenciador de filas do intermediário.

Ordem de Bytes Decimais Compactados Padrão* Enumerado Selecione Big Endian (o padrão) ou Little Endian da lista exibida para especificar a ordem de bytes de números representados como decimais compactados. Em COBOL, isto é equivalente ao tipo de dados PIC 9 COMP-3. Não há um tipo de dados equivalente em C.

Sua opção deve corresponder à codificação com a qual as mensagens são criadas. Geralmente, Big Endian é a opção correta para mensagens criadas no UNIX ou z/OS; Little Endian é a opção correta para mensagens criadas no Windows.

Formato de Flutuação Padrão* Enumerado Selecione um de S390 (o padrão), IEEE ou IEEE Reverso da lista exibida para especificar a ordem de bytes de números na mensagem representados como um ponto flutuante.
Conceitos relacionados
Formatos Físicos no Domínio MRM
MRM Custom Wire Format
Custom Wire Format: Relacionamento com o Modelo Lógico
Tarefas relacionadas
Trabalhando com Formatos Físicos
Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Conjunto de Mensagens
Propriedades do Conjunto de Mensagens de Formato de Ligação XML
Propriedades do Conjunto de Mensagens de Formato TDS
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ad09255_