Propiedades CWF para tipos de fecha y hora de referencia de elemento y elemento local

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 uno de los siguientes en la lista desplegable:
  • Serie de caracteres de longitud fija. La longitud del elemento la determinan otras propiedades de longitud que se indican más abajo.
  • Serie de longitud codificada 1. El primer byte del elemento contiene la longitud de la serie de caracteres 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 dos primeros bytes del elemento contienen la longitud de la serie que sigue a los 2 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 de caracteres terminada por nulo. La serie de caracteres 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 de caracteres (consulte el apartado Formatos de fecha y hora para encontrar información detallada).
  • Segundos de hora. Este valor soporta los objetos de fecha y hora de Java y time_t de C. 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 de fecha y hora de Java y time_t de C. Sólo es válido si la propiedad Formato de fecha y hora representa datos sólo numéricos.

El valor por omisión es serie de caracteres de longitud fija.

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

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

Si establece el Tipo físico en Binario, la plantilla se restringe a los componentes definidos en el apartado Fecha y hora como datos de serie de caracteres. Si establece el Tipo físico en Decimal empaquetado, Segundos de hora o Milisegundos de hora, la plantilla se restringe a los componentes que representan números. En estos casos, debe actualizar esta propiedad Formato de fecha y hora.

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

Cuenta de longitud Botón y entero Si ha seleccionado un Tipo físico de Serie de longitud fija, Decimal empaquetado o Binario y ha establecido Tipo de longitud en Cuenta, entre el número de unidades de longitud para el 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 por omisión 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 desplegable 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 Cómo reordenar los objetos.

Unidades de longitud Tipo enumerado En función del Tipo físico que se haya establecido, seleccione una de las opciones siguientes en la lista desplegable:
  • Bytes. Especifica que se procesan X bytes, donde X es el valor de Cuenta de longitud o del entero (INTEGER) especificado en Referencia de longitud.
  • Caracteres. El significado de esta opción depende del valor que haya establecido en el CCSID del mensaje o que haya establecido para la propiedad de conjunto de mensajes CCSID por omisión.
    • Si ha especificado un CCSID SBCS, se procesarán X bytes, donde X es el valor de Cuenta de longitud o del entero (INTEGER) especificado por Referencia de longitud.
    • Si ha especificado un CCSID DBCS, se procesarán Y bytes, donde Y es el valor de Cuenta de longitud o del entero (INTEGER) especificado en Referencia de longitud multiplicado por dos.
    • Si ha especificado un CCSID MBCS, el analizador lee 1 carácter a la vez y determina si el carácter consta de 1 o más bytes. El analizador realiza Z lecturas, donde Z es el valor de Cuenta de longitud o del entero (INTEGER) especificado en Referencia de longitud.
  • Unidades de carácter. Especifica que el tamaño de la unidad de carácter la determina el valor que se ha establecido en el CCSID del mensaje o para la propiedad de conjunto de mensajes CCSID por omisión. El número de bytes procesados es el tamaño de la unidad de carácter multiplicado por el valor de Cuenta de longitud o del entero (INTEGER) especificado en Referencia de longitud.
  • 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 Cuenta de longitud o Referencia de longitud.

El valor por omisión es bytes.

Con signo Booleano Si ha establecido la propiedad Tipo físico en Decimal empaquetado, Segundos de hora o Milisegundos de hora, seleccione (valor por omisión) o deseleccione Con signo. Si ha seleccionado otro valor para Tipo físico, esta propiedad no es válida.
Justificación de serie Tipo enumerado Si ha establecido la propiedad Tipo físico en Serie de caracteres de longitud fija, seleccione Justificado por la izquierda (valor por omisión) o Justificado por la derecha en la lista desplegable. Si ha seleccionado otro valor para Tipo físico, esta propiedad está inactiva.
Carácter de relleno Serie de caracteres

Si ha establecido la propiedad Tipo físico en Serie de caracteres de longitud fija y la propiedad Justificación de serie 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 de caracteres sea menor que la longitud indicada por la propiedad Cuenta de longitud o Referencia de longitud. La propiedad Justificación de serie controla si la serie de caracteres se rellena desde la izquierda o la derecha.

Al analizar un mensaje de entrada, el carácter de relleno se ajusta desde el final de la serie de caracteres. La propiedad Justificación de serie controla si la serie de caracteres se ajusta desde la izquierda o la derecha.

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

  • Seleccione NUL, '0' o SPACE en la lista desplegable.
  • 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 de caracteres 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, deberá asegurarse de que el valor convertido del carácter de relleno es 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. Esto ofrece la opción de especificar como carácter de relleno un valor absoluto que se inserta directamente en el mensaje de salida. Si se utiliza este formato, se deberá asegurar de todas formas de que este valor sea 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 desplegable. La opción que seleccione determinará el valor que debe establecer para la propiedad Valor de codificación de nulo:
  • NULLPadFill. Sólo es válido si Tipo físico es Serie de caracteres de longitud fija. El campo se rellena con el valor especificado por el Carácter de relleno. Éste es el valor por omisión.
  • 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 de caracteres. 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 de caracteres

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

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 Fecha y hora como datos de serie de caracteres. 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 desplegable
  • 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. Éste es el valor por omisión.
  • 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 por omisión 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 o 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 por omisión 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 o 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.

Repetición

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 desplegable 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.

Conceptos relacionados
Modelado de mensajes
El modelo de mensaje
Formato físico personalizado : Relación con el modelo lógico
Tareas relacionadas
Desarrollo de modelos de mensaje
Cómo trabajar con objetos de modelo de mensaje
Referencia relacionada
Información de referencia de modelo de mensaje
Propiedades de objeto de modelo de mensaje
Propiedades lógicas para objetos de modelo de mensaje
Propiedades físicas de formato físico personalizado para objetos de modelo de mensaje
Propiedades físicas de formato físico XML para objetos de modelo de mensaje
Propiedades físicas de formato TDS para objetos de modelo de mensaje
Propiedades de documentación para todos los objetos de conjunto de mensajes
Propiedades de objetos de modelo de mensaje por objeto
Información adicional de dominio MRM
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ad15370_