릴리스 정보

37.7 db2XaListIndTrans(sqlxphqr을 대신하는 새 API)

db2XaListIndTrans - 2단계 확약 중 이상 실패 트랜잭션 목록

현재 연결된 데이터베이스에 대한 모든 2단계 확약 중 이상 실패 트랜잭션의 목록을 제공합니다.

범위

이 API는 발행된 노드에만 영향을 줍니다.

권한 부여

다음 중 하나입니다.

• sysadm
• dbadm

필수 연결

데이터베이스

API 포함 파일

db2ApiDf.h

C API 구문

   /* File: db2ApiDf.h */
   /* API: List Indoubt Transactions */
   /* ... */
   SQL_API_RC SQL_API_FN
   db2XaListIndTrans (
      db2Uint32 versionNumber,
      void * pParmStruct,
      struct sqlca * pSqlca);
 
   typedef SQL_STRUCTURE db2XaListIndTransStruct
   {
     db2XaRecoverStruct * piIndoubtData;
     db2Uint32            iIndoubtDataLen;
     db2Uint32            oNumIndoubtsReturned;
     db2Uint32            oNumIndoubtsTotal;
     db2Uint32            oReqBufferLen;
   } db2XaListIndTransStruct;
 
   typedef SQL_STRUCTURE db2XaRecoverStruct
   {
     sqluint32      timestamp;
     SQLXA_XID      xid;
     char           dbalias[SQLXA_DBNAME_SZ];
     char           applid[SQLXA_APPLID_SZ];
     char           sequence_no[SQLXA_SEQ_SZ];
     char           auth_id[SQL_USERID_SZ];
     char           log_full;
     char           connected;
     char           indoubt_status;
     char           originator;
     char           reserved[8];
   } db2XaRecoverStruct;

API 매개변수

versionNumber

입력. 두 번째 매개변수 pParmStruct로 전달되는 구조의 버전 및 릴리스 레벨을 지정합니다.

pParmStruct

입력. db2XaListIndTransStruct 구조를 가리키는 포인터.

pSqlca

출력. sqlca 구조를 가리키는 포인터. Administrative API Reference에서 이 구조에 대한 자세한 내용을 참조하십시오.

piIndoubtData

입력. 2단계 확약 중 이상 실패 데이터가 리턴될 응용프로그램 제공 버퍼를 가리키는 포인터. 2단계 확약 중 이상 실패의 형식은 db2XaRecoverStruct입니다. 응용프로그램은 이 매개변수가 제공한 주소에서 시작하는 db2XaRecoverStruct 구조의 크기를 사용하여 2단계 확약 중 이상 실패 트랜잭션의 목록을 통과할 수 있습니다.

값이 널(NULL)이면, DB2는 필요한 버퍼의 크기를 계산하여 이 값을 oReqBufferLen에 리턴합니다. oNumIndoubtsTotal에는 2단계 확약 중 이상 실패 트랜잭션의 총 수가 포함됩니다. 응용프로그램은 필요한 버퍼 크기를 할당하고 API를 다시 발행할 수 있습니다.

oNumIndoubtsReturned

출력. pIndoubtData에 의해 지정된 버퍼에 리턴된 2단계 확약 중 이상 실패 트랜잭션 레코드의 수.

oNumIndoubtsTotal

출력. API 호출 시에 사용 가능한 총 2단계 확약 중 이상 실패 트랜잭션 레코드의 수. piIndoubtData 버퍼가 모든 레코드를 수용하기에 너무 작은 경우, oNumIndoubtsTotal은 oNumIndoubtsReturned에 대한 총계보다 커집니다. 응용프로그램은 모든 레코드를 확보하기 위해 API를 다시 발행할 수 있습니다.

주:

이 수는 자동 또는 경험적 2단계 확약 중 이상 실패 트랜잭션 재동기화의 결과나 2단계 확약 중 이상 실패 상태에 들어가는 다른 트랜잭션의 결과로 API 호출 간에 변경될 수 있습니다.

oReqBufferLen

출력. API 호출 시에 모든 2단계 확약 중 이상 실패 트랜잭션 레코드를 보유할 필수 버퍼 길이. 응용프로그램은 pIndoubtData를 널(NULL)로 설정하여 API를 호출함으로써 필수 버퍼 크기를 판별하는 데 이 값을 사용할 수 있습니다. 그런 다음, 이 값은 필수 버퍼를 할당하는 데 사용할 수 있으며 API는 pIndoubtData를 할당된 버퍼의 주소로 설정하여 발행할 수 있습니다.

주:

필수 버퍼 크기는 자동 또는 경험적 2단계 확약 중 이상 실패 트랜잭션 재동기화의 결과나 2단계 확약 중 이상 실패 상태에 들어가는 다른 트랜잭션의 결과로 API 호출들 간에 변경될 수 있습니다. 응용프로그램은 이 점을 고려하여 보다 큰 버퍼를 할당할 수 있습니다.

timestamp

출력. 트랜잭션이 2단계 확약 중 이상 실패 상태에 들어간 시간을 지정합니다.

xid

출력. 전역 트랜잭션을 고유 식별하기 위해 트랜잭션 관리 프로그램이 지정하는 XA 식별자를 지정합니다.

dbalias

출력. 2단계 확약 중 이상 실패 트랜잭션이 발견된 데이터베이스의 별명을 지정합니다.

applid

출력. 데이터베이스 관리 프로그램이 이 트랜잭션에 지정한 응용프로그램 식별자를 지정합니다.

sequence_no

출력. 데이터베이스 관리 프로그램이 확장자로서 applid에 지정한 순차 번호를 지정합니다.

auth_id

출력. 트랜잭션을 수행한 사용자의 권한 부여 ID를 지정합니다.

log_full

출력. 이 트랜잭션으로 인해 로그가 가득 찼는지 여부를 나타냅니다. 유효한 값은 다음과 같습니다.

SQLXA_TRUE

이 2단계 확약 중 이상 실패 트랜잭션으로 인해 로그가 가득 찼습니다.

SQLXA_FALSE

이 2단계 확약 중 이상 실패 트랜잭션으로 인해 로그가 가득 차지는 않았습니다.

connected

출력. 응용프로그램의 연결 여부를 나타냅니다. 유효한 값은 다음과 같습니다.

SQLXA_TRUE

트랜잭션이 정상 동기 지점 처리 중이며, 2단계 확약 중 두 번째 단계를 기다리는 중입니다.

SQLXA_FALSE

이전 실패에 의해 트랜잭션이 2단계 확약 중 이상 실패 상태로 남았으며 이제 트랜잭션 관리 프로그램으로부터의 재동기화를 기다리고 있습니다.

indoubt_status

출력. 이 2단계 확약 중 이상 실패 트랜잭션의 상태를 나타냅니다. 유효한 값은 다음과 같습니다.

SQLXA_TS_PREP

트랜잭션이 준비되었습니다. 연결된 매개변수는 트랜잭션이 정상 확약 처리의 두 번째 단계를 기다리고 있는지 또는 오류가 발생하여 트랜잭션 관리 프로그램과의 재동기화가 필요한 지를 판별하는 데 사용할 수 있습니다.

SQLXA_TS_HCOM

트랜잭션이 경험적으로 확약되었습니다.

SQLXA_TS_HROL

트랜잭션이 경험적으로 구간 복원되었습니다.

SQLXA_TS_MACK

트랜잭션에서 파티션 데이터베이스의 노드로부터 확약 승인이 누락되었습니다.

SQLXA_TS_END

트랜잭션이 이 데이터베이스에서 종료되었습니다. 이 트랜잭션은 나중에 다시 활성화되거나 확약 또는 구간 복원됩니다. 트랜잭션 관리 프로그램에 오류가 발생하여 트랜잭션이 완료되지 않을 가능성도 있습니다. 이와 같은 경우, 이 트랜잭션에는 경험적 조치가 필요한데, 잠금을 보유하고 있으며 다른 응용프로그램이 데이터에 액세스하는 것을 방지할 수 있기 때문입니다.

사용 참고

일반 응용프로그램은 현재 연결을 데이터베이스 또는 파티션 데이터베이스 조정자 노드로 설정한 후에 다음의 단계를 수행합니다.

1. piIndoubtData를 널(NULL)로 설정하여 db2XaListIndTrans를 호출하십시오. 그러면, oReqBufferLen 및 oNumIndoubtsTotal에 값이 리턴됩니다.
2. oReqBufferLen에 리턴된 값을 사용하여 버퍼를 할당하십시오. 이 API의 초기 호출은 oReqBufferLen을 확보하기 위한 것이므로 추가 2단계 확약 중 이상 실패 트랜잭션이 있으면 이 버퍼는 크기가 충분하지 않을 수도 있습니다. 응용프로그램은 oReqBufferLen보다 큰 버퍼를 제공합니다.
3. 모든 2단계 확약 중 이상 실패 트랜잭션 레코드가 확보되었는지 판별하십시오. 이 작업은 oNumIndoubtsReturned를 oNumIndoubtTotal과 비교하여 수행할 수 있습니다. oNumIndoubtsTotal이 oNumIndoubtsReturned보다 크면, 응용프로그램은 위의 단계를 반복할 수 있습니다.

참조

Administrative API Reference에서 "sqlxhfrg - Forget Transaction Status", "sqlxphcm - Commit an Indoubt Transaction" 및 "sqlxphrl - Roll Back an Indoubt Transaction"을 참조하십시오.