A função BITSTREAM é mantida apenas para retrocompatibilidade.
O ASBITSTREAM retorna um valor do tipo BLOB que contém uma representação de fluxo de bits do campo apontado por FieldReference e seus filhos
Dessa forma, o algoritmo para determinar estas propriedades é essencialmente igual ao utilizado para a função BITSTREAM.
Alguns analisadores também suportam outro modo, FolderBitStream, que gera um fluxo de bits significativo para qualquer subárvore, desde que o campo apontado represente uma pasta.
Em todos os casos, o fluxo de bits obtido possui a característica que pode ser fornecida a uma instrução CREATE com a cláusula PARSE, utilizando o mesmo DOMAIN e OPTIONS para reproduzir a subárvore original.
Quando a função for chamada, quaisquer expressões de cláusula serão avaliadas. Será emitida uma exceção se qualquer uma das expressões não resultar em um valor de tipo apropriado.
Se qualquer parâmetro for NULL, o resultado será NULL.
Cláusula | Type | Valor Padrão |
---|---|---|
Opções | integer | RootBitStream & ValidateNone |
Codificação | integer | 0 |
Ccsid | integer | 0 |
Conjunto de Mensagens | caractere | Cadeia de comprimento zero |
Tipo de Mensagem | caractere | Cadeia de comprimento zero |
Formato de Mensagem | caractere | Cadeia de comprimento zero |
Embora a cláusula OPTIONS aceite qualquer expressão que retorna um valor de tipo inteiro, ela apenas é significativa para gerar valores de opções da lista de constantes fornecidas, utilizando a função BITOR se mais de uma opção for requerida.
Validate master options... ValidateContentAndValue ValidateValue -- Pode ser utilizado com ValidateContent ValidateContent -- Pode ser utilizado com ValidateValue ValidateNone Validate failure action options... ValidateException ValidateExceptionList ValidateLocalError ValidateUserTrace Validate value constraints options... ValidateFullConstraints ValidateBasicConstraints Validate fix up options... ValidateFullFixUp ValidateNoFixUp
APIs Equivalentes a C e Java
Apenas uma opção de cada grupo pode ser especificada, com exceção de ValidateValue e ValidateContent, que podem ser utilizados juntos para obter a validação de conteúdo e valor. Se você não especificar uma opção em um grupo, a opção em negrito será utilizada.
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 a codificação do gerenciador de filas.
Os valores utilizados para a cláusula CCSID seguem o sistema de numeração normal. Por exemplo, 1200 = UCS-2, 1208 = UTF-8.
0 -10 utiliza o CCSID do gerenciador de filas e -1 utiliza os CCSID's conforme determinado pelo próprio analisador. Este valor está reservado.
Para cláusulas ausentes, são utilizados os valores padrão especificados. Utilize o CCSID e os valores padrão de codificação, porque eles utilizam seus valores a partir da codificação e das definições de CCSID do gerenciador de filas.
Da mesma forma, utilize os valores padrão para cada uma das opções de conjunto de mensagens, tipo e formato, pois muitos analisadores não requerem informações sobre conjunto de mensagens, tipo ou formato; portanto, qualquer valor válido é suficiente.
ENCODING -> CCSID -> SET -> TYPE -> FORMAT -> OPTIONS
A lista pode ser truncada em qualquer ponto e uma expressão totalmente vazia pode ser utilizada para quaisquer cláusulas nas quais você não fornece um 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);