A função de campo ASBITSTREAM gera um fluxo de bits para a subárvore de um determinado campo de acordo com as regras do analisador que possui o campo.
A função BITSTREAM é mantida apenas para compatibilidade com versões anteriores.
Observe que cada cláusula pode ocorrer apenas uma vez.>>-ASBITSTREAM -( -FieldReference--+------------------------------+--)->< | .-<<-----------------------. | | V | | '---+-OPTIONS--expression--+-+-' +-ENCODING--expression-+ +-CCSID--expression----+ +-SET--expression------+ +-TYPE--expression-----+ '-FORMAT--expression---'
ASBITSTREAM retorna um valor de tipo BLOB que contém uma representação de fluxo de bits do campo que é 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 |
---|---|---|
OPTIONS | Número Inteiro | RootBitStream & ValidateNone |
ENCODING | Número Inteiro | 0 |
CCSID | Número Inteiro | 0 |
SET | Caractere | Cadeia de comprimento zero |
TYPE | Caractere | Cadeia de comprimento zero |
FORMAT | Caractere | Cadeia de comprimento zero |
Para obter detalhes da sintaxe da cláusula TYPE, consulte Especificando Namespaces na Propriedade Mensagem.
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
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_S390
0 utiliza
a codificação do gerenciador de filas.Os valores que são utilizados para a cláusula CCSID segue o sistema de numeração normal. Por exemplo, 1200 = UCS-2, 1208 = UTF-8.
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);