WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Conjuntos de mensajes: propiedades de conjunto de mensajes de formato físico personalizado

Las tablas definen las propiedades que se pueden establecer para un conjunto de mensajes Formato físico.

Algunas de las propiedades de conjunto de mensajes (marcadas con un asterisco (*)) sólo son relevantes si el mensaje que se está procesando no utiliza WebSphere MQ como protocolo de transporte.

Si el protocolo de transporte es WebSphere MQ, los valores se derivan de las cabeceras de mensaje (por ejemplo MQMD) y se ignoran las propiedades de conjunto de mensajes, si se han establecido.

Representación binaria de valores booleanos

Propiedad Tipo Significado
Valor booleano true (verdadero) Serie Entre un máximo de ocho dígitos hexadecimales. No incluya el indicador hexadecimal (0x) precediendo a este número. Cada dígito es medio byte. La longitud máxima es de 4 bytes. Debe entrar un número par de dígitos (un número entero de bytes). Este valor debe ser diferente del Valor booleano false (falso) pero debe tener la misma longitud que éste. El valor predeterminado es 00000001.
Valor booleano false (falso) Serie Entre un máximo de ocho dígitos hexadecimales. No incluya el indicador hexadecimal (0x) precediendo a este número. Cada dígito es medio byte. La longitud máxima es de 4 bytes. Debe entrar un número par de dígitos (un número entero de bytes). Este valor debe ser diferente del Valor booleano true (verdadero) pero debe tener la misma longitud que éste. El valor predeterminado es 00000000.
Valor booleano nulo Serie Entre un máximo de ocho dígitos hexadecimales. No incluya el indicador hexadecimal (0x) precediendo a este número. Cada dígito es medio byte. La longitud máxima es de 4 bytes. Debe entrar un número par de dígitos (un número entero de bytes). Este valor puede ser igual que el Valor booleano true (verdadero) o el Valor booleano false (falso) o puede ser diferente. El valor predeterminado es 00000000.

Valores de salida

Utilice estos valores cuando se generan mensajes.

Propiedad Tipo Significado
Relleno de alineación de bytes Serie Si las propiedades de formato físico personalizado de xsd:element Alineación de bytes, Cuenta de saltos de cabecera y Cuenta de saltos de cola hacen que se salten bytes en la corriente de bits cuando se serializa el mensaje, esta propiedad proporciona el carácter que se debe utilizar en las posiciones saltadas. Establezca este carácter de uno de los modos siguientes:
  • Seleccione SPACE, NUL o 0 (el valor predeterminado), en la lista de valores mostrados.
  • Entre un carácter entre comillas, por ejemplo "c" o 'c', donde c es un carácter alfanumérico.
  • Entre un código de carácter decimal con el formato YY, donde YY es un valor decimal.
  • Entre un código de carácter hexadecimal con el formato 0xYY, donde YY es un valor hexadecimal.
  • Entre un valor Unicode con el formato U+xxxx, donde xxxx es un valor Unicode especificado en formato hexadecimal.
Política para elementos que faltan Tipo enumerado Esta propiedad determina la acción realizada por el intermediario cuando faltan campos en el árbol de mensaje cuando se ha serializado el mensaje (para la salida):
  • Utilice Valor predeterminado (el valor predeterminado). Si existe un Valor predeterminado para el elemento, regístrelo; de lo contrario emita una excepción.
  • Utilice Valor nulo. Si se ha seleccionado la propiedad Nulos permitidos del elemento y se ha especificado Valor de codificación de nulo para el elemento, registre el Valor de codificación de nulo de acuerdo con las reglas definidas en la propiedad Codificación de nulo; de lo contrario, emita una excepción.
Truncar series de longitud fija Recuadro de selección Esta propiedad sólo se aplica a las series de salida.

Si se ha seleccionado este recuadro y el elemento o el atributo es una serie de longitud fija (es decir, el tipo lógico es xsd:string y el tipo físico es Serie de longitud fija) que es mayor que la longitud que se ha especificado en el modelo o la referencia de longitud, la serie se trunca a esta longitud. No se genera ninguna excepción durante la salida, a menos que la validación (vea Validar mensajes) esté activa.

El final a partir del cual se truncan los datos se determina mediante el valor de la propiedad Justificación. Si el valor de la propiedad Justificación es Justificado por la izquierda, los datos se truncan desde la desde la derechas; si el valor de la propiedad Justificación es Justificar por la derecha, los datos se truncan por la izquierda. No obstante, si el valor de la propiedad Justificación es No aplicable, el truncamiento o se produce y se genera una excepción si la serie es demasiado larga.

Si este recuadro está deseleccionado, se produce una excepción si el elemento o el atributo es una serie de longitud fija (es decir, el tipo lógico es xsd:string y el tipo físico es Serie de longitud fija) que es mayor que la longitud que se ha especificado en el modelo o la referencia de longitud. Este comportamiento se produce en los releases de WebSphere Message Broker anteriores a la Versión 6.1.

Por omisión, este recuadro de selección está borrado.

Representación binaria de valores decimales

Propiedad Tipo Significado
Código positivo de decimal empaquetado Tipo enumerado Seleccione, en la lista, el signo positivo que se utiliza para los números decimales empaquetados. El valor predeterminado es C, que indica que se utiliza 0x0C como signo positivo; este valor se utiliza en la mayoría de los sistemas. También puede seleccionar F, que indica que 0x0F se utiliza como signo positivo; este valor se utiliza en algunos sistemas.

Valores de fecha y hora

Propiedad Tipo Significado
Derivar formato de fecha y hora predeterminado de tipo lógico Botón Seleccione esta opción si desea que el formato de fecha y hora predeterminado se determine mediante el tipo lógico del elemento o atributo.

Puede alterar temporalmente esta propiedad para un elemento o atributo de un tipo complejo.

Utilizar formato de fecha y hora predeterminado Botón y serie Seleccione esta opción si desea especificar un formato de fecha y hora predeterminado que sea fijo para todos los elementos o atributos de un tipo lógico dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay y gDay.

Puede alterar temporalmente esta propiedad para un elemento o atributo de un tipo complejo.

Para obtener más información, consulte Conjuntos de mensajes: formatos de fecha y hora.

Principio de siglo para años de 2 dígitos Entero Esta propiedad determina cómo se interpretan los años de dos dígitos. Especifique los dos dígitos que empiezan un periodo de 100 años que contiene el año actual. Por ejemplo, si especifica 89 y el año actual es 2002, todas las fechas de dos dígitos se interpretarán como pertenecientes al rango de 1989 y 2088.
Días de la primera semana del año Tipo enumerado Especifique el número de días del año nuevo que deben estar en la primera semana.

El inicio de un año suele estar en medio de una semana. Si el número de días de dicha semana es menor que el valor especificado aquí, se considera que la semana es la última semana del año anterior; de este modo la semana 1 empieza en unos días que están en el año nuevo. De lo contrario, se considera la primera semana del año nuevo; de este modo la semana 1 empieza unos días antes del inicio del año nuevo.

Seleccione Utilizar entorno local del intermediario, que hace que el intermediario obtenga la información de la plataforma subyacente, o seleccione un número en la lista.

Primera día de la semana Tipo enumerado Especifique el día en que empieza cada semana nueva.

Seleccione Utilizar entorno local del intermediario, que hace que el intermediario obtenga la información de la plataforma subyacente, o seleccione un valor en la lista.

Comprobación estricta de fecha y hora Recuadro de selección Seleccione esta opción si desea restringir las fechas y horas a un formato de fecha y hora válido. Si se selecciona Comprobación estricta de fecha y hora, se producirá un error cuando se reciba una fecha y hora incorrectas.
Comprobación estricta de fecha y hora
Ejemplos de comprobación estricta de fecha y hora:
  • Las fechas y horas se limitarán a valores de fecha y hora válidos. Cuando utilice esta opción, una fecha como por ejemplo, el 35 de marzo no se procesará como el 4 de abril y 10:79 no se procesará como 11:19. Si se recibe una fecha y hora fuera de banda como las de estos ejemplo, se generará un error.
  • El número de caracteres de un componente de fecha y hora numérico debe estar entre los límites de los símbolos de formato correspondientes. Repita el símbolo para especificar el número mínimo de dígitos que se necesitan. El número máximo de dígitos que se permite se convierte en el umbral superior de un símbolo determinado. Por ejemplo, día del mes tiene un límite superior de 41; por consiguiente, una serie de formato de 'd' permite analizar los valores 2 y 21, pero no permite los valores 32 y 210. En la salida, los números se rellenan con ceros hasta alcanzar la longitud especificada. Un año es un caso especial; vea la propiedad del conjunto de mensajes Principio de siglo para años de 2 dígitos. La longitud de las fracciones de segundos debe coincidir implícitamente con le número de símbolos de formato de la entrada. La salida se redondea hasta la longitud especificada.
  • No se ignoran los espacios en blanco. El espacio en blanco de la serie de entrada se debe corresponder con el mismo número y posición del espacio en blanco de la serie del formato.
  • Si quedan datos por analizar en la serie de entrada cuando todos los símbolos de la serie del formato ya se han hecho coincidir, se generará un error.
Comprobación de fecha y hora flexibles.
Ejemplos de comprobación flexible de fecha y hora:
  • El analizador convertirá los valores de fecha y hora que estén fuera de banda a los valores de banda adecuados. Por ejemplo, una fecha 2005-05-32 se convertirá a 2005-06-01.
  • La salida de fecha y hora siempre se adhiere al recuento del símbolo. Por ejemplo, una serie con el formato aaaa-MM-dd (donde '-' es el separador de campos) permite analizar uno o más caracteres en MM y dd. Por consiguiente, se pueden entrar fechas que no son válidas; por ejemplo, 2005-1-123 y 2005-011-12. La salida del primer valor de 2005-1-123 será la fecha 2005-05-03 y la salida del segundo valor 2005-011-12 será la fecha 2005-11-12.
  • El número de símbolos de formato de huso horario Z se aplica sólo al formato de fecha y hora de salida.
  • Se ignoran los espacios en blanco.
Huso horario Tipo enumerado Se utilizará el valor que establezca para esta propiedad si el valor que ha especificado para la propiedad Formato de fecha y hora predeterminado no incluye información de huso horario.

El valor inicial es Utilizar entorno local del intermediario que hace que el intermediario obtenga la información de la plataforma subyacente.

Puede cambiar esta propiedad seleccionado un valor de la lista de valores.

Horario de verano Recuadro de selección Seleccione esta opción si el área de la propiedad Huso horario cumple con el horario de verano. Si no cumple con el horario de verano, no se deberá seleccionar esta opción.

Por ejemplo, si se selecciona un área en Huso horario y no se selecciona esta opción, el valor pasado representa el huso horario sin horario de verano.

Utilizar formato UTC de entrada en la salida Recuadro de selección Esta propiedad se aplica a los elementos y atributos de tipo lógico xsd:dateTime o xsd:time que contienen una fecha y hora como serie y que tienen un formato de fecha y hora de I, IU, T o TU, o que incluyen ZZZ o ZZZU.

Estos elementos y atributos pueden especificar la hora UTC (Coordinated Universal Time) utilizando el carácter Z o el huso horario +00:00 en el valor. En la entrada, el analizador MRM recuerda el modo en que se ha especificado UTC.

Si se selecciona esta propiedad y se copia el elemento o atributo en un mensaje de salida, entonces se conservará el formato UTC en el mensaje de salida y se alterará temporalmente el implícito en la propiedad de formato de fecha y hora.

Si no se selecciona esta propiedad o no se copia el elemento o atributo en un mensaje de salida, entonces se conservará el formato UTC en el mensaje de salida se controlará únicamente mediante la propiedad de formato de fecha y hora.

Codificación de caracteres y numérica para mensajes que no son de WebSphere MQ

Utilice estos valores únicamente para mensajes que no tienen MQMD.

Propiedad Tipo Significado
CCSID predeterminado* Entero Entre un valor numérico para el Identificador del juego de caracteres codificado predeterminado. El valor predeterminado es 500.

Si el mensaje de entrada es un mensaje de WebSphere MQ, se utiliza el atributo equivalente que se establece para el gestor de colas y se omite esta propiedad.

Orden de bytes predeterminado* Tipo enumerado Seleccione Big Endian (el valor predeterminado) o Little Endian para especificar el orden de bytes de los números representados como enteros binarios.

En C, esto equivale al tipo de datos corto (short) o largo (long). En COBOL, esto equivale a un tipo de datos PIC 9, COMP, COMP-4, COMP-5 o BINARY.

La elección debe coincidir con la codificación con la que se crean los mensajes. Normalmente, Big Endian es la opción correcta para los mensajes que se crean en UNIX o z/OS; Little Endian es la opción correcta para los mensajes que se crean en Windows.

No utilice esta propiedad si el mensaje se recibe a través del protocolo de transporte de WebSphere MQ; en este caso, la propiedad se deduce del MQMD del mensaje o de la codificación del gestor de colas de intermediario.

Orden de bytes decimales empaquetados predeterminado* Tipo enumerado Seleccione Big Endian (el valor predeterminado) o Little Endian para especificar el orden de bytes de los números representados como decimales empaquetados. En COBOL, esto equivale al tipo de datos PIC 9 COMP-3. No existe ningún tipo de datos equivalente en C.

La elección debe coincidir con la codificación con la que se crean los mensajes. Normalmente, Big Endian es la opción correcta para los mensajes que se crean en UNIX o z/OS; Little Endian es la opción correcta para los mensajes que se crean en Windows.

Formato flotante predeterminado* Tipo enumerado Seleccione uno de S390 (el valor predeterminado),IEEE o IEEE invertida en la lista visualizada para especificar el orden de bytes de los números del mensaje que están representados como coma flotante.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:59:12


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ad09255_