La función del campo ASBITSTREAM genera una corriente de bits para el subárbol de un campo determinado según las normas del analizador que es el propietario del campo.
La función BITSTREAM sólo se conserva por compatibilidad con versiones anteriores.
Observe que cada cláusula puede aparece únicamente una vez.>>-ASBITSTREAM -( -ReferenciaCampo--+-----------------------------+--)->< | .-<<----------------------. | | V | | '---+-OPTIONS--expresión--+-+-' +-ENCODING--expresión-+ +-CCSID--expresión----+ +-SET--expresión------+ +-TYPE--expresión-----+ '-FORMAT--expresión---'
ASBITSTREAM rdevuelve un valor de tipo BLOB que contiene una representación de corriente de bits del campo al que apunta ReferenciaCampo y sus hijos.
De este modo, el algoritmo para determinar estas propiedades es esencialmente el mismo que se utiliza para la función BITSTREAM.
Algunos analizadores también dan soporte a otra modalidad, FolderBitStream, que genera una corriente de bits significativos para cualquier subárbol, siempre que el campo apuntado represente una carpeta.
En todos los casos, la corriente de bits obtenida puede proporcionarse a una sentencia CREATE con una cláusula PARSE, utilizando los mismos DOMAIN y OPTIONS para reproducir el subárbol original.
Cuando se llama a la función, se evalúa cualquier expresión de la cláusula. Se genera una excepción si cualquiera de las expresiones no dan como resultado un valor del tipo apropiado.
Si cualquier parámetro es NULL el resultado es NULL.
Cláusula | Tipo | Valor predeterminado |
---|---|---|
OPTIONS | Entero | RootBitStream & ValidateNone |
ENCODING | Entero | 0 |
CCSID | Entero | 0 |
SET | Carácter | Serie de caracteres de longitud cero |
TYPE | Carácter | Serie de caracteres de longitud cero |
FORMAT | Carácter | Serie de caracteres de longitud cero |
Para obtener detalles de la sintaxis de la cláusula TYPE, consulte Especificación de espacios de nombres en la propiedad Mensaje.
Aunque la cláusula OPTIONS acepta cualquier expresión que devuelve un valor de tipo entero, solo tiene sentido generar valores de opciones a partir de la lista de constantes suministradas, utilizando la función BITOR si se necesita más de una opción.
Opciones de validación maestras...
ValidateContentAndValue
ValidateValue -- Se puede utilizar con ValidateContent
ValidateContent -- Se puede utilizar con ValidateValue
ValidateNone
Opciones de validación de acciones de error...
ValidateException
ValidateExceptionList
ValidateLocalError
ValidateUserTrace
API equivalentes Java™ y C
Puede especificar solamente una opción de cada grupo, con la excepción ValidateValue y ValidateContent, que se pueden utilizar conjuntamente para obtener la validación de contenido y valor. Si no especifica una opción en un grupo, se utiliza la opción que está en negrita.
0
MQENC_INTEGER_NORMAL
MQENC_INTEGER_REVERSED
MQENC_DECIMAL_NORMAL
MQENC_DECIMAL_REVERSED
MQENC_FLOAT_IEEE_NORMAL
MQENC_FLOAT_IEEE_REVERSED
MQENC_FLOAT_S390
0 utiliza la codificación del gestor de colas.Los valores utilizados para la cláusula CCSID siguen el sistema de numeración normal. Por ejemplo, 1200 = UCS-2, 1208 = UTF-8.
Para cláusulas no presentes, se utilizan los valores predeterminados dados. Se le recomienda que utilice los valores predeterminados de codificación y CCSID debido a que toman los valores de los valores de codificación del gestor de colas y de CCSID.
Del mismo modo, utilice los valores predeterminados para cada una de las opciones de tipo, formato y conjunto de mensajes porque muchos analizadores no necesitan información acerca del tipo, formato o conjunto de mensajes; por lo que cualquier valor es suficiente.
ENCODING -> CCSID -> SET -> TYPE -> FORMAT -> OPTIONS
La lista se puede truncar en cualquier punto y se puede utilizar una expresión vacía para cualquier cláusula en la que no proporcione un valor.
DECLARE options INTEGER BITOR(FolderBitStream, ValidateContent,
ValidateValue);
SET result = ASBITSTREAM(cursor OPTIONS options CCSID 1208);
SET Result = ASBITSTREAM(Environment.Variables.MQRFH2.Data,,1208
,,,,options);