Propiedades de conjunto de mensajes de formato físico personalizado

La tabla siguiente define las propiedades que puede establecer para el conjunto de mensajes. 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) STRING 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 por omisión es 00000001.
Valor booleano false (falso) STRING 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 por omisión es 00000000.
Valor booleano nulo STRING 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 por omisión es 00000000.

Valores de salida

Estos valores se utilizan cuando se están serializando mensajes.

Propiedad Tipo Significado
Relleno de alineación de bytes Serie de caracteres 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 por omisión) en la lista desplegable.
  • 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 El valor de esta propiedad controla la acción realizada por el intermediario si faltan campos en el árbol de mensaje cuando se ha serializado el mensaje:
  • Utilizar Valor por omisión (el valor por omisión). Si existe un Valor por omisión para el elemento, ponerlo en la salida; de lo contrario, emitir una excepción.
  • Utilizar Valor nulo. Si se ha marcado la propiedad Nulos permitidos del elemento y se ha especificado un Valor de codificación de nulo para el elemento, poner en la salida el Valor de codificación de nulo de acuerdo con las normas definidas por la propiedad Codificación de nulo. De lo contrario, se emite una excepción.

Representación binaria de valores decimales

Propiedad Tipo Significado
Código positivo decimal empaquetado Tipo enumerado Seleccione en la lista desplegable el signo positivo utilizado para los números decimales empaquetados. El valor por omisión es C, que indica que se utiliza 0x0C como signo positivo, que es el valor usual. También puede seleccionar F, que indica que se utiliza 0x0F como signo positivo: algunos sistemas necesitan este valor.

Valores de fecha y hora

Propiedad Tipo Significado
Derivar formato de fecha y hora por omisión de tipo lógico Botón Seleccione esta opción si desea que el formato de fecha y hora por omisión se determine mediante el tipo lógico del elemento o atributo. Los valores por omisión son:
dateTime
aaaa-MM-dd'T'HH:mm:ssZZZ
date
aaaa-MM-dd
time
HH:mm:ssZZZ
gYear
aaaa
gYearMonth
aaaa-MM
gMonth
--MM--
gMonthDay
--MM-dd
gDay
---dd

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

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

El valor inicial para esta propiedad es aaaa-MM-dd'T'HH:mm:ssZZZ, que puede cambiar escribiendo encima del mismo.

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

Si desea ver más información sobre los formatos de fecha y hora, consulte el apartado 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 1989 a 2088.

El valor inicial es 53, que puede cambiar escribiendo encima del mismo.

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 desplegable. El valor inicial es 4.

Primer 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 de la lista desplegable. El valor inicial es Lunes.

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. Esto no permitirá que se procese el 35 de marzo como el 4 de abril ni que 10:79 se procese como 11:19. Si se establece Comprobación estricta de fecha y hora, se producirá un error cuando se reciba una fecha y hora incorrecta. El valor por omisión es restringir las fechas y horas.
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. Esto no permitirá que se procese el 35 de marzo como el 4 de abril ni que 10:79 se procese 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 necesario. El número máximo de dígitos permitidos será el límite superior de un símbolo determinado. Por ejemplo, un día del mes tiene un límite superior de 31, por lo tanto, una serie de caracteres con el formato d permitirá analizar los valores 2 ó 21 pero no permitirá el valor 32 ó 210. En la salida, los números se rellenan con ceros hasta alcanzar la longitud especificada. Un año es un caso especial, consulte 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 ignorarán los espacios en blanco. El espacio en blanco de la serie de entrada debe corresponder con el mismo número y posición de los espacios en blanco de la serie del formato.
  • Si todavía quedan datos por analizar en la serie de entrada cuando ya se han hecho coincidir en la serie del formato, 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 las fechas y horas 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. Esto permite la entrada de fechas no válidas como 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 sólo se aplica al formato de fecha y hora de salida.
  • Se ignorarán 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 por omisión 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.

Esto se puede cambiar utilizando el recuadro desplegable.

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 representará el huso horario sin horario de verano.

El valor por omisión es no cumplir con el horario de verano.

Utilizar formato UTC de entrada en la salida Recuadro de selección Esta propiedad se aplica a los elementos y atributos del tipo lógico xsd:dateTime o xsd:time que contienen una fecha y hora como serie de caracteres 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 (Consolidated 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.

El valor por omisión para esta propiedad no se selecciona.

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

Estos valores sólo se utilizan para mensajes que no tienen MQMD.

Propiedad Tipo Significado
CCSID por omisión* INTEGER Entre un valor numérico para el Identificador de juego de caracteres codificado por omisión. El valor por omisión es 500.

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

Orden de bytes* Tipo enumerado Seleccione Big Endian (el valor por omisión) o Little Endian en la lista desplegable 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 creados en UNIX o z/OS y Little Endian para los creados en Windows.

Esta propiedad no se utiliza 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* Tipo enumerado Seleccione Big Endian (el valor por omisión) o Little Endian en la lista desplegable 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 creados en UNIX o z/OS y Little Endian para los creados en Windows NT.

Formato flotante* Tipo enumerado Seleccione uno de S390 (el valor por omisión), IEEE o IEEE invertida en la lista desplegable para especificar el orden de bytes de los números del mensaje que están representados como coma flotante.
Conceptos relacionados
Formatos físicos del dominio de MRM
Formato físico personalizado
Formato físico personalizado : Relación con el modelo lógico
Tareas relacionadas
Cómo trabajar con propiedades físicas
Referencia relacionada
Información de referencia de modelo de mensaje
Propiedades de conjunto de mensajes
Propiedades de conjunto de mensajes de formato físico XML
Propiedades de conjunto de mensajes de formato TDS
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ad09255_