Propiedades CWF para tipos de serie de caracteres 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'.

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

Cuenta de longitud Botón y entero Si ha seleccionado un Tipo físico de Serie de longitud fija 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 0 (cero) y 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 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.

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:
  • 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. El Valor de codificación de nulo se debe establecer en una serie de caracteres vacía.
  • NULLLogicalValue. El Valor de codificación de nulo se transforma para coincidir con el formato necesario para el campo. Éste es el valor por omisión.
  • NULLLiteralValue. El Valor de codificación de nulo se sustituye directamente como si fuera una serie de caracteres.
  • 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 STRING La utilización de esta propiedad depende de la propiedad Codificación de nulo, descrita más arriba. Si se especifica, su longitud debe ser igual a la longitud del elemento de serie de caracteres, con la excepción de NULLLiteralFill.

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

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
ad15410_