선택적 메타데이터

개발자는 TI(트랜잭션 통합자) 런타임 환경이 메인프레임 TP(트랜잭션 프로그램)와 주고받는 메타데이터를 보내고 받도록 선택할 수 있으며, 해당 메타데이터의 콘텐츠를 선택할 수 있습니다.

참고

메타데이터는 DPC(분산 프로그램 호출)에 대해 지원되지 않습니다.

다음을 보내거나 받을 수 있습니다.

• 메타데이터가 없습니다.

• 메서드 이름만 메타데이터로 지정합니다.

• 메서드 이름을 포함한 모든 메타데이터입니다.

  TI 런타임 환경은 지시에 따라 TP에 메타데이터를 보내거나 받습니다. 메타데이터는 다음에서 TP를 지원합니다.

• 메타데이터의 형식 식별(버전 정보).

• TP를 호출하는 데 사용되는 메서드의 이름을 식별합니다.

• 자세한 오류 정보를 클라이언트에 다시 보고합니다.

  메타데이터는 Automation 클라이언트에 표시되지 않습니다. 메타데이터는 TP에 전송된 요청 메시지(또는 수신된 응답 메시지)의 일부로 호스트 TP에 전달되거나 수신됩니다.

  메타데이터 집합에는 다음 데이터가 포함됩니다.

• TI 런타임 버전입니다.

  요청을 생성한 TI 런타임 환경 버전을 고유하게 식별하는 "Microsoft TI 버전 1.0.0"과 같은 문자 문자열입니다.

• 클라이언트 애플리케이션 코드에서 호출하는 메서드 이름(32자 문자열)입니다.

• 메타데이터 블록 ID입니다.

  이 예외 데이터 블록을 고유하게 식별하는 GUID(문자 형식)입니다. GUID는 나중에 추가 예외 형식을 갖는 기능을 지원하며 수신된 모든 데이터가 유효한지 확인하는 데 도움이 됩니다.

• 할당되지 않은 변수는 현재까지 사용(예약됨):

  • TP가 커밋할 준비가 되었는지 여부를 나타내는 부울 플래그입니다.

  • TP가 추가 작업을 수행할 준비가 되었는지 여부를 나타내는 부울 플래그입니다.

  • TI 런타임 환경 버전 번호의 일부를 저장할 짧은 정수 2개, 주 버전 번호를 보유할 Short 정수 1개, 부 버전 번호를 저장할 정수 1개.

• 예외 블록(회신에만 사용됨)

  예외 데이터의 이 블록을 고유하게 식별하는 이진 형식의 GUID입니다. GUID를 사용하면 나중에 추가 예외 형식을 지원할 수 있으며 수신된 데이터가 유효한지 확인할 수 있습니다.

  • TP가 커밋할 준비가 되었는지 여부를 나타내는 부울 플래그입니다.

  • TP가 추가 작업을 수행할 준비가 되었는지 여부를 나타내는 부울 플래그입니다.

  • 예외를 클라이언트 애플리케이션에 반환해야 하는지 여부를 나타내는 부울 플래그입니다. 이 플래그를 설정하면 트랜잭션이 종료됩니다.

  • 오류를 식별하는 16비트 정수입니다(이 항목의 뒷부분에 있는 참고 참조). TI 런타임 오류가 발생할 때 할당된 값이 반환되도록 서버에서 오류를 설명하는 256자 메시지와 함께 이 값을 할당할 수 있습니다.

  • TP 도움말 파일(있는 경우)에서 컨텍스트 ID를 식별하는 32비트 정수입니다.

  • 오류를 설명하는 256자 메시지입니다. TI 런타임 오류가 발생할 때 할당된 값이 반환되도록 서버에서 오류를 식별하는 16비트 정수와 함께 이 값을 할당할 수 있습니다.

  메타데이터는 항상 메시지의 시작 부분에 있습니다.

참고

TI 오류 메시지의 범위는 0에서 9999까지입니다. 메인프레임에서 반환된 메타데이터 오류 메시지 번호는 동일한 범위 내에 속할 수 있습니다. TI 오류 메시지를 메인프레임에서 반환된 메타데이터 메시지와 구분하기 위해 TI는 메인프레임에서 반환된 메타데이터 오류 메시지 수에 10000을 추가합니다.