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 CWF para tipos de fecha y hora de elemento compuesto

Representación física, valores nulos, alineación de bytes y apariciones.

Las propiedades de formato físico personalizado descritas aquí se aplican a:

Representación física

Propiedad Tipo Significado
Tipo físico Tipo enumerado Seleccione un valor de la lista que se muestra:
  • Serie de longitud fija. La longitud del elemento la determinan otras propiedades de longitud, que se indican a continuación.
  • Serie de longitud codificada 1. El primer byte del elemento contiene la longitud de la serie que sigue al byte de longitud en unidades de longitud. La longitud máxima de un elemento Serie de longitud codificada 1 es de 255 unidades de longitud.
  • Serie de longitud codificada 2. Los 2 primeros bytes del elemento contienen la longitud de la serie que sigue a los dos bytes de longitud en unidades de longitud. La longitud máxima de un elemento Serie de longitud codificada 2 es de 65535 unidades de longitud. Los dos bytes de longitud están en el formato de la codificación del gestor de colas de WebSphere MQ.
  • Serie terminada por nulo. La serie termina con el carácter NULL hexadecimal, X'00'.
  • Decimal empaquetado. La fecha y hora se codifica como un número Decimal empaquetado. Sólo es válido si la propiedad Formato de fecha y hora representa datos sólo numéricos.
  • Binario. La fecha y hora se codifica como una secuencia binaria de bytes. Si selecciona esta opción, el rango de símbolos que puede especificar para la propiedad Serie de formato es menor que el rango de símbolos que puede especificar si selecciona una opción de serie (consulte el apartado Conjuntos de mensajes: formatos de fecha y hora para encontrar información detallada).
  • Segundos de hora. Este valor soporta los objetos C time_t y de fecha y hora Java™. Sólo es válido si la propiedad Formato de fecha y hora representa datos sólo numéricos.
  • Milisegundos de hora. Este valor soporta los objetos C time_t y de fecha y hora Java. Sólo es válido si la propiedad Formato de fecha y hora representa datos sólo numéricos.

El valor predeterminado es serie de longitud fija.

Formato de fecha y hora Serie Especifique una plantilla para la fecha y hora.

El formato de fecha y hora predeterminado depende del tipo lógico del objeto. Para más información sobre los valores predeterminados para el formato de fecha y hora de acuerdo con el tipo lógico, consulte el apartado Conjuntos de mensajes: valores predeterminados de fecha y hora por tipo lógico.

Consulte el apartado Conjuntos de mensajes: formatos de fecha y hora para encontrar información detallada de los formatos de fecha y hora.

Longitud Botón y entero Si ha seleccionado un Tipo físico de Serie de longitud fija, Decimal empaquetado o Binario y ha seleccionado la longitud para definirla con Longitud, escriba el número de unidades de longitud del elemento.

El valor mínimo que puede especificar es 1 para los tres tipos físicos.

El valor máximo que puede especificar es 256 para Serie de longitud fija, 10 para Decimal empaquetado y 2147483647 para Binario.

El valor predeterminado es 0 (cero).

Referencia de longitud Botón y tipo enumerado Si ha seleccionado que la longitud la definiera la Referencia de longitud, seleccione el nombre del objeto entero que especifica la longitud de este objeto. Realice la selección en la lista que se muestra de objetos enteros que están definidos como hermanos del objeto actual y aparecen antes que él en la estructura del mensaje.

Para más información sobre la reordenación de elementos, consulte el apartado Conjuntos de mensajes: reordenar objetos.

Unidades de longitud Tipo enumerado Seleccione la unidad de longitud para el elemento o atributo. Seleccione una de las opciones siguientes de la lista mostrada (algunos tipos físicos no ofrecen todas estas opciones):
  • Bytes. La longitud se proporciona en bytes.
  • Caracteres. Longitud se proporciona en caracteres. Esto significa que el número de bytes que se procesan en una corriente de bits depende de la página de códigos de los caracteres que se procesan.
    • Para una página de códigos de un solo byte (SBCS CCSID), por ejemplo, "latin-1" (CCSID 850), el número de bytes es igual al número de caracteres.
    • Para una página de códigos de doble byte (DBCS CCSID), por ejemplo, "UTF-16" (CCSID 1200), el número de bytes es exactamente el doble del número de caracteres.
    • Para una página de códigos de múltiples bytes (MBCS CCSID), por ejemplo, "UTF-8" (CCSID 1208), el número de bytes depende del contenido de la corriente de bits. El analizador lee un carácter a la vez y determina si el carácter consta de uno o más bytes.
  • Unidades de carácter. Esta opción especifica que el tamaño de cada carácter (en bytes) lo determina la página de códigos del mensaje.
    • Para las páginas de códigos de un solo byte y de doble byte, esta opción es idéntica a Caracteres.
    • Para una página de códigos de múltiples bytes, esta opción proporciona un mejor rendimiento del análisis ya que da por supuesto que cada carácter está codificado en la unidad de caracteres más pequeña que soporta la página de códigos. Sin embargo, esto significa que un mensaje debe contener sólo estos caracteres para que se procese correctamente. Por ejemplo, en la página de códigos "UTF-8" (CCSID 1208), la unidad mínima de caracteres es 1 byte; por tanto, el analizador puede efectuar una sola lectura (del número de bytes especificado por la propiedad Longitud) para buscar el mensaje entero. El mensaje sólo debe contener caracteres que estén codificados en unidades de 1 byte.
  • Fin de la corriente de bits. Se procesan todos los datos hasta el final de la corriente de bits. Esta opción sólo es válida si elemento es el último del mensaje. Si selecciona este valor, no es necesario que entre un valor en la propiedad Cuenta de longitud o Referencia de longitud.

El valor predeterminado esBytes.

Con signo Recuadro de selección Especifique si el valor tiene signo.

Esta propiedad sólo es aplicable si la propiedad Tipo físico es Decimal empaquetado. De forma predeterminada, este recuadro de selección no está seleccionado, lo que indica que el valor no tiene signo.

Justificación Tipo enumerado Si ha establecido la propiedad Tipo físico en Serie de longitud fija, seleccione Justificado por la izquierda (valor predeterminado) o Justificado por la derecha en la lista. Si ha seleccionado otro valor para Tipo físico, esta propiedad está inactiva.
Carácter de relleno Serie

Si ha establecido la propiedad Tipo físico en Serie de longitud fija y la propiedad Justificación es Justificado por la izquierda o Justificado por la derecha, esta propiedad es aplicable.

Al escribir un mensaje de salida, utilice el carácter de relleno para llenar las posiciones de carácter restantes cuando la longitud de serie sea menor que la longitud indicada por la propiedad Longitud o Referencia de longitud. El hecho de que la serie se rellene por la izquierda o por la derecha está regulado por la propiedad Justificación.

Al analizar un mensaje de entrada, el carácter de relleno se ajusta desde el final de la serie. El hecho de que la serie se ajuste por la izquierda o por la derecha está regulado por la propiedad Justificación.

Especifique este carácter de uno de los modos siguientes:

  • Seleccione NUL, '0' o SPACE en la lista que se muestra.
  • Entre un carácter entre comillas; por ejemplo, "c" o 'c', donde c es cualquier carácter alfanumérico.
  • Escriba un valor Unicode con el formato U+xxxx donde xxxx es un valor Unicode especificado en hexadecimales. La longitud máxima de la serie que puede entrar es 10.
  • Entre un carácter hexadecimal con el formato 0xYY donde YY es un valor hexadecimal.
  • Entre un valor de byte decimal (de 0 a 255).

La elección del formato de carácter de relleno que se utiliza para un elemento MRM depende del carácter de relleno que es necesario y de si el carácter de relleno debe estar sujeto a la conversión de datos. En la mayoría de los casos es suficiente especificar un carácter de relleno entre comillas y cuando este carácter de relleno se utiliza, se convierte a la página de códigos de destino del mensaje MRM de salida que se esté generando. Por ejemplo, en la conversión de ASCII a la página de códigos 500, si ha especificado U+0008 como carácter de relleno, éste se convierte de 0x08 a 0x15, las representaciones ASCII y EBCDIC de 'retroceso'.

Si se necesita un carácter de relleno que no se puede entrar fácilmente en el campo de caracteres de relleno, se puede utilizar el formato mnemotécnico Unicode para especificar el carácter necesario. Cuando se utiliza, este valor Unicode también se convierte a la página de códigos de destino del mensaje MRM que se está generando.

Si está convirtiendo un mensaje de una página de códigos a otra, asegúrese de que el valor convertido del carácter de relleno sea válido para esta página de códigos. Si el carácter de relleno no se puede representar en la página de códigos de destino, se reemplaza por un carácter de sustitución. El carácter de sustitución es fijo y el valor depende de la página de códigos de destino especificada.

Si se necesita un carácter de relleno que no esté sujeto a la conversión de datos, se puede utilizar el formato hexadecimal o decimal, y entonces tiene la opción de especificar un valor absoluto como un carácter de relleno que se inserta directamente en el mensaje de salida. Si se utiliza este formato, asegúrese de que este valor sea todavía válido para la página de códigos de los mensajes de salida que se creen utilizando estas definiciones MRM.

Representación de valores nulos

Propiedad Tipo Significado
Codificación de nulo Tipo enumerado Seleccione una de las opciones siguientes en la lista que se muestra. La opción que seleccione determinará el valor que debe establecer para la propiedad Valor de codificación de nulo:
  • NULLPadFill. Esta opción sólo es válida si Tipo físico es Serie de longitud fija. El campo se rellena con el valor especificado por el Carácter de relleno. Valor predeterminado.
  • NULLLogicalValue. La propiedad Valor de codificación de nulo se convierte primero en un valor real y se devuelve del modo especificado para el campo.
  • NULLLiteralValue. Especifica que Valor de codificación de nulo contiene un valor que se sustituye directamente como si fuera una serie. Utilice esta opción cuando el valor que ha establecido para Valor de codificación de nulo a fin de especificar una fecha nula no es un valor de fecha y hora o no se ajusta a las normas del formato de fecha y hora estándar aaaa-MM-dd'T'HH:mm:ss.
  • NULLLiteralFill. El campo se rellena con el valor especificado por el Valor de codificación de nulo. El Valor de codificación de nulo se debe convertir en un carácter individual.
Valor de codificación de nulo Serie

Si establece la propiedad Codificación de nulo en NULLPadFill, esta propiedad estará inhabilitada.

Si establece la propiedad Codificación de nulo en NULLLogicalValue, deberá establecer esta propiedad en un formato de fecha y hora ISO8601. Estos formatos se describen en Conjuntos de mensajes: Fecha y hora como datos de serie. Por ejemplo, especifique un valor que se ajuste a aaaa-MM-dd'T'HH:mm:ss, por ejemplo 1970-12-01.

Si establece la propiedad Codificación de nulo en NULLLiteralValue, podrá entrar cualquier valor que tenga la misma longitud que el campo.

Si establece la propiedad Codificación de nulo en NULLLiteralFill, el valor deberá convertirse en un carácter individual. Establezca el carácter de uno de los modos siguientes:
  • Seleccione SPACE, NUL, 0x00 o 0xFF en la lista que se muestra
  • Entre un carácter entre comillas, por ejemplo 'c' o "c", donde c es cualquier carácter alfanumérico.
  • Entre un código de carácter hexadecimal con el formato 0xYY donde YY es un valor hexadecimal.
  • Entre un código de carácter decimal con el formato YY, donde YY es un valor decimal.
  • Entre un valor Unicode con el formato U+xxxx donde xxxx es un valor Unicode especificado en formato hexadecimal.

Alineación de bytes

Propiedad Tipo Significado
Alineación de bytes Tipo enumerado Especifique cómo se alinea el objeto desde el principio del mensaje. Seleccione uno de los siguientes:
  • 1 byte. Valor predeterminado.
  • 2 bytes
  • 4 bytes
  • 8 bytes
  • 16 bytes
Cuenta de saltos de cabecera Entero Especifique el número de bytes que se deben saltar antes de leer o grabar este objeto. El valor predeterminado es 0, el valor mínimo es 0 y el valor máximo es 999999. Puede utilizar este valor para ignorar campos no deseados en una estructura o para modelar un campo definido por datos C o COBOL que necesite alinearse en un límite de 2, 4, 8 ó 16 bytes. Especifique el número de bytes que se deben saltar antes de leer o grabar este objeto. Cuando se graba un mensaje de salida, se asigna a los bytes de la Cuenta de saltos el valor de la propiedad Relleno de alineación de bytes del conjunto de mensajes.

Para objetos de repetición, sólo se aplica esta propiedad a la primera instancia.

Cuenta de saltos de cola Entero Especifique el número de bytes que se deben saltar después de leer o grabar este objeto. El valor predeterminado es 0, el valor mínimo es 0 y el valor máximo es 999999. Puede utilizar este valor para ignorar campos no deseados en una estructura o para modelar una estructura de repetición que contenga campos que necesiten alinearse en un límite de 2, 4, 8 ó 16 bytes. Cuando se graba un mensaje de salida, se asigna a los bytes de la Cuenta de saltos el valor de la propiedad Relleno de alineación de bytes del conjunto de mensajes.

Para objetos de repetición, se aplica esta propiedad a todas las instancias.

Apariciones

Propiedad Tipo Significado
Referencia de repeticiones Tipo enumerado Utilice esta propiedad si el objeto se repite varias veces y el número de apariciones se proporciona dinámicamente mediante un campo al principio del mensaje. Seleccione un objeto entero en la lista visualizada de objetos enteros que aparecen antes que el mismo en la estructura del mensaje. El valor del entero seleccionado especifica el número de apariciones de este objeto. Si no se listan objetos, no hay objetos enteros antes que éste en la estructura del mensaje.

Si se especifica una Referencia de repetición, se altera temporalmente cualquier valor para la propiedad lógica Máx. apariciones cuando se analice y grabe el mensaje, pero no para la validación del mensaje.

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:24


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