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.
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 |
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 Opciones de validación de limitaciones de valores... ValidateFullConstraints ValidateBasicConstraints Opciones de validación de arreglos... ValidateFullFixUp ValidateNoFixUp
APIs 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_S3900 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);