Propiedades CWF para tipos dateTime de tipo simple intercalado

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

Representación física

Propiedad Tipo Significado
Tipo físico Tipo enumerado Seleccione de la lista desplegable uno de los valores siguientes:
  • Fixed Length String. La longitud del elemento viene determinada por otras propiedades de longitud que figuran a continuación.
  • Length Encoded String 1. El primer byte del elemento contiene la longitud de la serie de caracteres que va después del byte de longitud en unidades de longitud. La longitud máxima de un elemento Length Encoded String 1 son unidades 255 unidades de longitud.
  • Length Encoded String 2. Los primeros dos bytes del elemento contienen la longitud del string que va después de los 2 bytes de longitud en unidades de longitud. La longitud máxima de un elemento Length Encoded String 2 son 65535 unidades de longitud. Los dos bytes de longitud tienen el formato de la Codificación del gestor de colas de WebSphere MQ.
  • Null Terminated String. Los extremos de la serie de caracteres con el carácter hexadecimal NULL, X'00'.
  • Packed Decimal. La fecha y hora se codifica como número decimal empaquetado. Sólo es válido si la propiedad Formato de DateTime representa sólo datos numéricos.
  • Binary. La fecha y hora se codifica como secuencia binaria de bytes. Si selecciona esta opción, el rango de símbolos que puede especificar para la propiedad Serie de caracteres de formato es menor que el rango de símbolo que puede especificar si selecciona una opción de string (para más información, consulte la sección Formatos de fecha y hora).
  • Time Seconds. Este valor soporta objetos de fecha y hora C time_t y Java. Sólo es válido si la propiedad Formato de DateTime representa sólo datos numéricos.
  • Time Milliseconds. Este valor soporta objetos de fecha y hora de Java time_t de C. Sólo es válido si la propiedad Formato de DateTime representa sólo datos numéricos.

El valor por omisión es fixed length string.

Formato de DateTime String Especifique una plantilla para la fecha y hora.

El formato de dateTime por omisión depende del tipo lógico del objeto. Si desea información sobre los valores por omisión para el formato de dateTime según el tipo lógico consulte la sección Valores por omisión de DateTime por tipo lógico.

Si establece el Tipo físico en Binary, la plantilla se limita a los componentes definidos en Fecha y hora como datos STRING. Si establece el Tipo físico en Packed Decimal, Time Seconds o Time Milliseconds, la plantilla se limita a los componentes que representan números. En estos casos, debe actualizar esta propiedad de Formato de DateTime.

Para obtener más información sobre formatos de fecha y hora, consulte la sección Formatos de fecha y hora.

Cuenta de longitud Botón e Integer Tipo físico de Fixed Length String, Packed Decimal o Binary y establece el Tipo de longitud en Count, 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 Fixed Length String, 10 para Packed Decimal y 2147483647 para Binary.

El valor por omisión es 0 (cero).

Referencia de longitud Botón y Tipo enumerado Si ha seleccionado que la longitud se defina por Referencia de longitud, seleccione el nombre del objeto entero que especifica la longitud de este objeto. Seleccione de la lista desplegable de objetos enteros que están definidos como iguales al objeto actual y aparecen antes que éste en la estructura del mensaje.

Para obtener información sobre reordenamiento de elementos, consulte la sección Reordenar objetos.

Unidades de longitud Tipo enumerado En función del Tipo físico que se ha establecido, seleccione uno de los valores siguientes de la lista desplegable:
  • Bytes. Especifica que se procesen X bytes, donde X es el valor de Cuenta de longitud o del INTEGER especificado en Referencia de longitud.
  • Characters. El significado de esta opción depende del valor que ha establecido en el CCSID del mensaje o que ha establecido para la propiedad del conjunto de mensajes CCSID por omisión.
    • Si ha especificado un CCSID de SBCS, se procesan X bytes, donde X es el valor de Cuenta de longitud o del INTEGER especificado por Referencia de longitud.
    • Si ha especificado un CCSID de DBCS, se procesan Y, donde Y es el valor de Cuenta de longitud o del INTEGER especificado en Referencia de longitud multiplicado por dos.
    • Si ha especificado un CCSID de MBCS, el analizador lee 1 carácter a la vez y determina si el carácter comprende 1 o más bytes. El analizador realiza Z lecturas, donde Z es el valor de Cuenta de longitud o del INTEGER especificado en Referencia de longitud.
  • Unidades de carácter. Esto especifica que el tamaño de la unidad de caracteres se determina por el valor que ha establecido en el CCSID del mensaje o para la propiedad del conjunto de mensajes CCSID por omisión. El número de bytes procesados es el tamaño de la unidad de caracteres multiplicado por el valor de Cuenta de longitud o del INTEGER especificado en Referencia de longitud.
  • Fin de la corriente de bits. Se procesan todos los datos hasta el fin de la corriente de bits. Esta opción sólo es válida si el elemento es el último del mensaje. Si selecciona este valor, no necesita especificar un valor en Cuenta de longitud o Referencia de longitud.

El valor por omisión es bytes.

Con signo Boolean Si ha establecido la propiedad del Tipo físico en Packed Decimal, Time Seconds o Time Milliseconds, 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 Fixed Length String, seleccione Left Justify (el valor por omisión) o Right Justify de la lista desplegable. Si ha seleccionado otro valor para Tipo físico, esta propiedad está inactiva.
Carácter de relleno String El carácter de relleno se utilizar para rellenar las posiciones de caracteres restantes cuando la longitud de la serie de caracteres es menor que el tamaño del string especificado. Si ha establecido la propiedad Tipo físico en Fixed Length Stringy la Justificación de serie está en Left Justify o Right Justify, establezca este carácter de una de las formas siguientes:
  • Seleccione NUL, '0' o SPACE de 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 en el formato 0xYY donde YY es un valor hexadecimal.

    La elección de cuál de estas formas de caracteres de relleno se utiliza para un elemento MRM dependerá del carácter de relleno necesario y si el carácter de relleno estará sometido a la conversión de datos. En la mayoría de los casos, la justificación de un carácter de relleno será suficiente y cuando se utilice este carácter de relleno, se convertirá a la página de códigos de destino del mensaje MRM de salida que se esté generando. Si es necesario un carácter de relleno que no se puede indicar fácilmente en el campo de carácter de relleno, en este caso puede utilizarse el formato mnemotécnico Unicode para especificar el carácter necesario. Cuando se utilice, este valor Unicode también se convertirá a la página de códigos de destino del mensaje MRM que se está generando. Si es necesario un carácter de relleno que no depende de la conversión de datos, entonces se puede utilizar el formato hexadecimal. Esto brinda la posibilidad de especificar un carácter de relleno que se inserte directamente en el mensaje de salida. Si se utiliza este formato, entonces asegúrese de que este hexadecimal sea válido para la página de códigos de cualquier mensaje de salida que se cree utilizando estas definiciones de MRM.

    Si está convirtiendo un mensajes de una página de códigos a otra, entonces asegúrese de que el valor convertido del carácter de relleno sea válido para esta página de códigos. Por ejemplo, al convertir de ASCII a la página de códigos 500, si ha especificado el numérico 8 como carácter de relleno, este se convierte de 0x08 a 0x15, las representaciones ASCII y EBCDIC de 'retroceso'.

    Existe actualmente la limitación de que el valor del carácter de relleno no debe ser mayor que U+007F. Tenga presente que si especifica un mnemotécnico Unicode o un valor numérico, éste se considera el carácter representado por dicho número en UTF-8.

  • Entre un valor Unicode en el formato U+xxxxxx donde xxxxxx es un valor Unicode especificado en hexadecimal. La longitud máxima de la serie de caracteres que puede especificar es 10.
  • Seleccione el valor por omisión de una serie de caracteres vacía.

Representación de valores nulos

Propiedad Tipo Significado
Codificación de nulo Tipo enumerado Seleccione una de las opciones siguientes de la lista desplegable. La opción que seleccione determina el valor que debe establecer para la propiedad Valor de codificación de nulo:
  • NULLPadFill. Esto sólo es válido si el Tipo físico es Serie de longitud fija. El campo se rellena con el valor especificado por el Carácter de relleno. Este es el valor por omisión.
  • NULLLogicalValue. La propiedad Valor de codificación de nulo se convierte primero a un valor real y se devuelve en el formato especificada para el campo.
  • NULLLiteralValue. Esto especifica que el Valor de codificación de nulo contiene un valor que se sustituye directamente como si fuese una serie de caracteres. Utilice esta opción cuando el valor que ha establecido en Valor de codificación de nulo para especificar una fecha nula no es un valor de dateTime o no cumple el formato de DateTime estándar yyyy-MM-dd 'T'HH:mm:ss.
Valor de codificación de nulo String

Si establece la propiedad de Codificación de nulo en NULLPadFill, esta propiedad se inhabilita (inactiva).

Si establece la propiedad de Codificación de nulo en NULLLogicalValue, debe establecer esta propiedad en un formato de dateTime ISO8601. Estos formatos se describen en la sección Fecha y hora como datos STRING. Por ejemplo, especifique un valor que se ajuste a yyyy-MM-dd'T'HH:mm:ss como por ejemplo 1970-12-01.

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

Alineación de bytes

Propiedad Tipo Significado
Alineación de bytes Tipo enumerado Especifique cómo se alinea este objeto desde el inicio del mensaje. Seleccione uno de los valores siguientes:
  • 1 Bytes. Este es el valor por omisión.
  • 2 Bytes
  • 4 Bytes
  • 8 Bytes
  • 16 Bytes
Cuenta de saltos de cabecera Integer Especifique el número de bytes que desea omitir antes de leer o escribir 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 requieren alineación en un límite de 2, 4, 8 ó 16 bytes. Especifique el número de bytes que desea omitir al leer o escribir este objeto. Cuando se escribe un mensaje de salida, se asigna a los bytes de cuenta de saltos el valor de la propiedad Relleno de alineación de bytes del conjunto de mensajes.

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

Cuenta de saltos de cola Integer Especifique el número de bytes que desea omitir después de leer o escribir 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 requiere alineación en un límite de 2, 4, 8 ó 16 bytes. Cuando se escribe un mensaje de salida, se asigna a los bytes de cuenta de saltos el valor del mensaje establecido en la propiedad Relleno de alineación de bytes.

Para objetos que se repiten, esta propiedad se aplica a la primera instancia solamente.

Repetición

Propiedad Tipo Significado
Cuenta de repeticiones Botón e Integer Si ha seleccionado la propiedad Cuenta de repeticionesm, especifique el número de apariciones de este objeto. El valor mínimo es 0 (cero y uno significan que se espera una sola aparición), el valor máximo es 2147483647.
Referencia de repeticiones Botón y tipo enumerado Si ha seleccionado la propiedad Referencia de repeticiones, seleccione el nombre del objeto entero cuyo valor especifica el número de apariciones de dicho objeto en la lista desplegable de objetos enteros que están definidos como iguales al objeto actual y que se producen antes que éste en la estructura del mensaje.

Para obtener información sobre reordenamiento de elementos, consulte la sección Reordenar objetos.

Conceptos relacionados
Diseño de mensajes
El modelo de mensaje

Tareas relacionadas
Desarrollo de modelos de mensajes
Trabajo con los objetos del modelo de mensajes

Referencia relacionada
Información de referencia del modelo de mensaje
Propiedades del objeto del modelo de mensaje
Propiedades de objetos de modelo de mensaje no utilizados
propiedades de tipo simple intercalado
Propiedades CWF propiedades de tipo simple intercalado