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 enteros de tipo simple incorporado

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:
  • Entero. Esto equivale al tipo de datos SHORT o LONG en C o al tipo de datos numéricos COMP, COMP-4, COMP-5 o BINARY en COBOL.
  • Decimal empaquetado. Equivale al tipo de datos COMP-3 en COBOL.
  • Decimal externo. Equivale al tipo de datos PIC 9 USAGE DISPLAY en COBOL.

La representación de elementos numéricos puede verse afectada por los atributos de codificación (Encoding) y de ID de juego de caracteres codificado (CodedCharSetId) que se establecen para el gestor de colas de WebSphere MQ:

  • Los elementos que tienen Tipo físico establecido en Entero y Decimal empaquetado se representan en el valor de Codificación de WebSphere MQ apropiado.
  • Los elementos que tienen Tipo físico establecido en Decimal externo se representan en el valor de ID de juego de caracteres codificado (CodedCharSetId) de WebSphere MQ.
Longitud Entero Entre el número de bytes para especificar la longitud de elemento:
  • Si establece el Tipo físico en Entero, seleccione 1, 2 o 4 (el valor predeterminado) en la lista que se muestra.
  • Si ha establecido Tipo físico en Decimal empaquetado, entre un valor entre 1 y 6.
  • Si ha establecido Tipo físico en Decimal ampliado, entre un valor entre 1 y 11.
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.
  • 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.

El valor predeterminado esBytes.

Con signo Recuadro de selección Seleccione (valor predeterminado) o deseleccione esta propiedad. Esta propiedad se utiliza con Orientación del signo.
Signo EBCDIC personalizado superpuesto Recuadro de selección Si el Tipo físico se establece en Decimal externo y se establece la propiedad EBCDIC personalizado con signo, esto indica que la representación Signo EBCDIC personalizado superpuesto se utilizará en un entorno ASCII. Si esta recuadro de selección no está seleccionado (el valor predeterminado), se utiliza la representación de signo ASCII.

El valor del recuadro de selección Signo EBCDIC personalizado superpuesto sólo es apropiado si la propiedad Orientación del signo se establece en Inicial o Final (indicando que el elemento/atributo tiene una representación de signo intercalada).

El recuadro de selección no está disponible si el elemento/atributo no tiene signo (por ejemplo, si el recuadro de selección Con signo no está establecido).

Orientación del signo Tipo enumerado Si ha establecido Tipo físico en Decimal externo y ha seleccionado Con signo, elija entre las opciones siguientes que representan las opciones COBOL para visualizar datos numéricos:
  • Inicial superpuesto. Esta opción establece un bit en el primer byte si el número es negativo. No se establece nada si el número es positivo. Por ejemplo, la representación hexadecimal ASCII del número 22 es x'3232'. Si se utiliza esta opción, el número +22 será x'3232' y el número -22 será x'7232'. Valor predeterminado.
  • Inicial separado. Esta opción establece el primer byte del elemento en '+' si el número es positivo y en '-' si el número es negativo. Para esta opción, la longitud debe incluir el byte de signo.
  • Final superpuesto. Esta opción establece un bit en el último byte si el número es negativo. No se establece nada si el número es positivo. Si se utiliza esta opción, el número +22 será x'3232' y el número -22 será x'3272'.
  • Final separado. Esta opción establece el último byte del elemento en '+' si el número es positivo y en '-' si el número es negativo. Para esta opción, la longitud debe incluir el byte de signo.
Si ha establecido Tipo físico en cualquier otro valor, se establecerá automáticamente el valor No aplicable.
Justificación Tipo enumerado Si ha establecido la propiedad Tipo físico en Decimal externo, seleccione Justificado por la izquierda o Justificado por la derecha (valor predeterminado) en la lista. Si ha seleccionado otro valor para Tipo físico, esta propiedad está inactiva.
Carácter de relleno Serie El carácter de relleno se utiliza para rellenar las posiciones de carácter restantes cuando la longitud de serie es menor que el tamaño de serie especificado. Si ha establecido la propiedad Tipo físico en Decimal ampliado y la propiedad Justificación es Justificado por la izquierda o Justificado por la derecha, 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 mostrada:
  • NULLPadFill. Esta opción sólo es válida si Tipo físico es Decimal externo. 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 vacía.
  • NULLLogicalValue. El Valor de codificación de nulo se transforma para coincidir con el formato necesario para el campo. Valor predeterminado.
  • NULLLiteralValue. El Valor de codificación de nulo se sustituye directamente como si fuera una serie. Puede especificar un valor no numérico para Valor de codificación de nulo.
  • 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 La utilización de esta propiedad depende de la propiedad Codificación de nulo, con la excepción de NULLLiteralFill. El valor predeterminado es cero.
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 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:25


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