ASBITSTREAM 함수

ASBITSTREAM 필드 함수는 필드를 소유하는 구문 분석기의 규칙에 따라 그리고 다음에 대해 호출자가 제공한 매개변수를 사용하여 제공된 필드의 하위 트리에 대한 비트스트림을 생성합니다.
  • 인코딩
  • CCSID
  • Message set
  • Message type
  • 메시지 형식
  • Options
이 함수는 입력 노드에 속한 구문 분석기에 의해 생성된 트리에서만 사용할 수 있는 기존의 BITSTREAM 함수에 대한 제한사항을 효과적으로 제거합니다.

BITSTREAM 함수는 역호환성을 위해서만 보유됩니다.

구문

주:
  1. 각 절은 한 번만 나타날 수 있습니다.

ASBITSTREAM은 FieldReference 및 그 하위에 의해 지정된 필드의 비트스트림 표현을 포함하는 BLOB 유형의 값을 리턴합니다.

이를 수행하기 위한 알고리즘은 구문 분석기마다 다르고 지정된 옵션에 따라 다릅니다. 모든 구문 분석기는 다음 모드를 지원합니다.
  • RootBitStream, 이 모드에서 비트스트림 생성 알고리즘은 출력 노드에 사용되는 알고리즘과 같습니다. 이 모드에서는 지정된 필드가 적절한 구조를 가진 하위 트리의 헤드 부분에 있는 경우에만 의미있는 결과를 얻습니다.
  • EmbeddedBitStream을 지원하며 이 모드에서 비트스트림 생성 알고리즘이 출력 노드에서 사용하는 것과 동일할 뿐만 아니라,
    • 인코딩
    • CCSID
    • Message set
    • Message type
    • 메시지 형식
    위의 정보를 명시적으로 지정하지 않은 경우 출력 노드와 같은 방식으로 판별됩니다. 즉, 이러한 등록 정보가 헤더를 나타낸다고 가정할 경우, FieldReference의 이전 동위 항목을 검색하여 이를 판별할 수 있습니다.

    이렇게 하여 이러한 등록 정보를 판별하는 알고리즘은 기본적으로 BITSTREAM 함수에 사용되는 알고리즘과 동일합니다.

일부 구문 분석기는 다른 모드인 FolderBitStream도 지원하며 이 모드에서는 가리키는 필드가 폴더를 나타낸다는 전제 하에 하위 트리에 대해 의미있는 비트스트림이 생성됩니다.

확보된 비트스트림은, 모든 경우에서 동일한 DOMAIN 및 OPTIONS를 사용하여 원래의 하위 트리를 재생성함으로써 PARSE절을 가진 CREATE문에 제공될 수 있습니다.

함수가 호출되면 절 표현식이 평가됩니다. 표현식으로 인해 적절한 유형의 값이 나타나지 않을 경우 예외가 발생합니다.

매개변수가 널(null)인 경우 결과는 널(null)입니다.

유형 디폴트 값
옵션 integer RootBitStream & ValidateNone
인코딩 integer 0
Ccsid integer 0
메시지 세트 character 0 길이 문자열
메시지 유형 character 0 길이 문자열
메시지 형식 character 0 길이 문자열

OPTIONS절이 integer 유형의 값을 리턴하는 표현식을 승인하기는 하지만 이는 둘 이상의 옵션이 필요한 경우 BITOR 함수를 사용하여 제공된 상수의 목록에서 옵션 값을 생성하는 경우에만 의미가 있습니다.

생성된 값은 정수가 되므로 변수에 저장하거나 함수에 대한 매개변수로 전달할 수 있으며 ASBITSTREAM 호출에서 직접 사용할 수 있습니다. 전역으로 정의된 상수의 목록은 다음과 같습니다.
        마스터 유효성 검증 옵션...
        ValidateContentAndValue
                ValidateValue		  -- Can be used with ValidateContent
                ValidateContent		-- Can be used with ValidateValue
        ValidateNone

        실패 조치 유효성 검증 옵션...
                ValidateException
        ValidateExceptionList
                ValidateLocalError
        ValidateUserTrace

       값 제한조건 유효성 검증 옵션...
                ValidateFullConstraints
        ValidateBasicConstraints

       수정사항 유효성 검증 옵션...
                ValidateFullFixUp
       ValidateNoFixUp
주:
  1. validateFullFixUp 옵션은 나중에 사용하기 위해 예약되어 있습니다. validateFullFixUp을 선택하면 validateNoFixUp과 동일한 작동이 제공됩니다.
  2. validateFullConstraints 옵션은 나중에 사용하기 위해 예약되어 있습니다. validateFullConstraints를 선택하면 validateBasicConstraints과 동일한 작동이 제공됩니다.
  3. 유효성 검증 옵션에 대한 자세한 내용은 MRM 도메인에서 메시지의 유효성 검증 등록 정보를 참조하십시오.

C 및 Java 동등 API

다음에서는 동등한 옵션이 사용 불가능하다는 점을 참고하십시오.
  • Java 플러그인 노드 API MBElement 메소드 createElementAsLastChildFromBitstream()toBitstream()
  • C 플러그인 노드 API 메소드 cniCreateElementAsLastChildFromBitstream()cniElementAsBitstream.

각 그룹에서 하나의 옵션만을 지정할 수 있지만 내용 및 값 유효성 검증을 확보하기 위해 함께 사용할 수 있는 ValidateValue 및 ValidateContent의 경우는 예외입니다. 그룹 내의 옵션을 지정하지 않으면 굵은체의 옵션이 사용됩니다.

ENCODING절은 유형 integer의 값을 리턴하는 모든 표현식을 승인합니다. 그러나 제공된 상수의 목록에서 인코딩 값을 생성하는 경우에만 의미가 있습니다.
       0       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은 큐 관리자의 인코딩을 사용합니다.

CCSID절에 대해 사용된 값은 정상 번호 지정 시스템을 따릅니다. 예를 들면, 1200 = UCS-2, 1208 = UTF-8과 같습니다.

그리고, 다음과 같은 특수 값이 지원됩니다.
       0       -1
0은 큐 관리자의 CCSID 사용하고, -1은 구문 분석기에 의해 결정된 CCSID를 사용합니다. 이 값은 예약 되어 있습니다.

비어 있는 절의 경우 제공된 디폴트 값이 사용됩니다. CCSID 및 인코딩 디폴트값은 큐 관리자의 인코딩 및 CCSID 설정에서 값을 가져오므로 이 디폴트값을 사용하십시오.

마찬가지로 많은 구문 분석기가 메시지 세트, 유형 또는 형식 정보를 필요로 하지 않기 때문에(따라서 올바른 값이면 충분함) 각 메시지 세트, 유형 및 형식 옵션에 대해 디폴트 값을 사용하는 것이 유용합니다.

표현식이 평가된 다음에는 적절한 비트스트림이 생성됩니다.
주: 이 함수에는 많은 절이 있기 때문에 이름 지정된 절이 아닌 쉼표로 구분된 목록으로 매개변수가 제공되는 대체 구문이 지원됩니다. 이 경우, 표현식은 다음 순서와 같아야 합니다.
ENCODING -> CCSID -> SET -> TYPE -> FORMAT -> OPTIONS

목록은 어느 지점에서나 자를 수 있으며 값을 제공하지 않은 절에 대해 완전히 비어 있는 표현식을 사용할 수 있습니다.

            DECLARE options INTEGER BITOR(FolderBitStream, ValidateContent, ValidateValue);
            SET result = ASBITSTREAM(cursor OPTIONS options CCSID 1208);
            SET Result = ASBITSTREAM(Environment.Variables.MQRFH2.Data,,1208,,,,options);
관련 개념
ESQL 개요
관련 태스크
ESQL 개발
큰 XML 메시지 핸들링
XML 메시지 및 비트스트림에 대한 작업
관련 참조
구문 다이어그램: 사용 가능한 유형
ESQL 필드 함수
BITSTREAM 함수(사용되지 않음)
지원되는 코드 페이지
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
ak05510_