WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Conjuntos de Mensagens: Propriedades do Conjunto de Mensagens Custom Wire Format

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 False. 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 True. 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 True ou Valor Booleano False ou diferente. O valor padrão é 00000000.

Configurações de Saída

Use estas configurações quando as mensagens estiverem sendo produzidas.

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 broker quando campos estiverem ausentes da árvore de mensagens quando a mensagem for serializada (para saída):
  • Utilizar Default Value (o padrão). Se um Valor Padrão existir para o elemento, grave-o; caso contrário, emita uma exceção.
  • Utilizar Null Value. Se a propriedade Nillable do elemento for selecionada e um Encoding Null Value for especificado para o elemento, grave o Encoding Null Value de acordo com as regras que são definidas pela propriedadeEncoding Null; caso contrário, emita uma exceção.
Trunca cadeias de comprimento fixo Caixa de Opções Esta propriedade se aplica apenas a cadeias de saída.

Se esta caixa de opção estiver selecionada e o elemento ou atributo for uma cadeia de comprimento fixo (ou seja, o tipo lógico é xsd:string e o tipo físico é Cadeia de Comprimento Fixo) com um comprimento maior do que o especificado no modelo ou na referência de comprimento, a cadeia será truncada para esse comprimento. Nenhuma exceção é gerada na saída, a menos que a validação (consulte Validando Mensagens) esteja ativa.

A extremidade da qual os dados serão truncados é determinada pelo valor da propriedade Justificação. Se o valor da propriedade Justificação for Justificar à Esquerda, os dados serão truncados a partir da direita; se o valor da propriedade Justificação for Justificar à Direita, os dados serão truncados a partir da esquerda. No entanto, se o valor da propriedade Justificação for Não Aplicável, o truncamento não ocorrerá e ocorrerá uma exceção se a cadeia for muito longa.

Se esta caixa de opção estiver desmarcada, ocorrerá uma exceção se o elemento ou atributo for uma cadeia de comprimento fixo (ou seja, o tipo lógico é xsd:string e o tipo físico é Cadeia de Comprimento Fixo) com um comprimento maior do que o especificado no modelo ou na referência de comprimento. Este comportamento ocorre em releases do WebSphere Message Broker anteriores à Versão 6.1.

Por padrão, essa caixa de opções é limpa.

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 mais informações, consulte Conjuntos de Mensagens: Formatos DateTime.

Início do século para anos de 2 dígitos Inteiro Esta propriedade determina como anos de 2 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 especificar 89, e o ano atual for 2002, todas as datas de 2 dígitos serão interpretadas como estando no intervalo 1989 - 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 Broker, que faz com que o broker 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 Broker, que faz com que o broker 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 é permitido 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 os dados permanecerem não analisados na cadeia de entrada após todos os símbolos na cadeia de formatações terem 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, 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 de formatação de fuso horário Z é 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 Broker, que faz com que o broker 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 essa 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 essa opção.

Por exemplo, se uma área for selecionada no Fuso Horário e essa opção não estiver selecionada, o valor passado representa 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 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 broker.

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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:10


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ad09255_