Propiedades CWF para tipos string 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'.

El valor por omisión es Serie de longitud fija.

Cuenta de longitud Botón e Integer Si ha seleccionado un Tipo físico de Fixed Length String o Binary y ha establecido Tipo de longitud en Count, entre el número de unidades de longitud para el elemento.

El valor mínimo que puede especificar es 0 (cero), el valor máximo que puede especificar es 2147483647

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.

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:
  • NULLPadFill. Esto sólo es válido si el Tipo físico es Fixed Length String. El campo se rellena con el valor especificado por el Carácter de relleno. El Valor de codificación de nulo debe establecerse en una serie de caracteres vacía.
  • NULLLogicalValue. El Valor de codificación de nulo se transforma para que coincida con el formato requerido para el campo. Este es el valor por omisión.
  • NULLLiteralValue. El Valor de codificación de nulo se sustituye directamente como si fuese una serie de caracteres.
Valor de codificación de nulo STRING El uso de esta propiedad depende de la propiedad Codificación de nulo , descrita anteriormente. Si se ha especificado, su longitud debe ser igual a la longitud del elemento de la serie de caracteres.

El valor por omisión es vacío (no establecido).

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