La función BITSTREAM se conserva solamente por motivos de compatibilidad con versiones anteriores.
ASBITSTREAM devuelve un valor de tipo BLOB que contiene una representación de corriente de bits del campo al que apuntaReferenciaCampo 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 por omisión |
---|---|---|
Opciones | integer | RootBitStream & ValidateNone |
Codificación | integer | o |
Ccsid | integer | o |
Conjunto de mensajes | character | Serie de caracteres de longitud cero |
Tipo de mensaje | character | Serie de caracteres de longitud cero |
Formato del mensaje | character | 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.
0 -10 utiliza el CCSID del gestor de colas y -1 utiliza el CCSID, según lo determina el propio analizador. Este valor está reservado.
Si faltan cláusulas, se utilizan los valores por omisión dados. Se le recomienda que utilice los valores por omisión 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 por omisión 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);