¸±¸®½º Á¤º¸
ÇöÀç ¿¬°áµÈ µ¥ÀÌÅͺ£À̽º¿¡ ´ëÇÑ ¸ðµç 2´Ü°è Ä¿¹ÌÆ® Áß ÀÌ»ó ½ÇÆÐ Æ®·£Àè¼ÇÀÇ ¸ñ·ÏÀ»
Á¦°øÇÕ´Ï´Ù.
¹üÀ§
ÀÌ API´Â ¹ßÇàµÈ ³ëµå¿¡¸¸ ¿µÇâÀ» ÁÝ´Ï´Ù.
±ÇÇÑ ºÎ¿©
´ÙÀ½ Áß ÇϳªÀÇ ±ÇÇÑÀ¸·Î ¼öÇàÇϽʽÿÀ.
Çʼö ¿¬°á
µ¥ÀÌÅͺ£À̽º
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
- Æ®·£Àè¼ÇÀÌ ÀÌ µ¥ÀÌÅͺ£À̽º¿¡¼ Á¾·áµÇ¾ú½À´Ï´Ù. ÀÌ Æ®·£Àè¼ÇÀº ³ªÁß¿¡
´Ù½Ã È°¼ºÈµÇ°Å³ª Ä¿¹ÌÆ® ¶Ç´Â ·Ñ¹éµË´Ï´Ù. Æ®·£Àè¼Ç °ü¸® ÇÁ·Î±×·¥¿¡
¿À·ù°¡ ¹ß»ýÇÏ¿© Æ®·£Àè¼ÇÀÌ ¿Ï·áµÇÁö ¾ÊÀ» °¡´É¼ºµµ
ÀÖ½À´Ï´Ù. ÀÌ¿Í °°Àº °æ¿ì, ÀÌ Æ®·£Àè¼Ç¿¡´Â °æÇèÀû Á¶Ä¡°¡ ÇÊ¿äÇѵ¥, Àá±ÝÀ»
º¸À¯ÇÏ°í ÀÖÀ¸¸ç ´Ù¸¥ ÀÀ¿ëÇÁ·Î±×·¥ÀÌ µ¥ÀÌÅÍ¿¡ ¾×¼¼½ºÇÏ´Â °ÍÀ» ¹æÁöÇÒ ¼ö ÀÖ±â
¶§¹®ÀÔ´Ï´Ù.
»ç¿ë Âü°í
ÀÏ¹Ý ÀÀ¿ëÇÁ·Î±×·¥Àº ÇöÀç ¿¬°áÀ» µ¥ÀÌÅͺ£À̽º ¶Ç´Â
ÆÄƼ¼Ç µ¥ÀÌÅͺ£À̽º Á¶Á¤ÀÚ ³ëµå·Î ¼³Á¤ÇÑ ÈÄ¿¡ ´ÙÀ½ÀÇ ´Ü°è¸¦
¼öÇàÇÕ´Ï´Ù.
- piIndoubtData¸¦ ³Î(NULL)·Î ¼³Á¤ÇÏ¿©
db2XaListIndTrans¸¦ È£ÃâÇϽʽÿÀ. ±×·¯¸é,
oReqBufferLen ¹× oNumIndoubtsTotal¿¡
°ªÀÌ ¸®Åϵ˴ϴÙ.
- oReqBufferLen¿¡ ¸®ÅÏµÈ °ªÀ» »ç¿ëÇÏ¿© ¹öÆÛ¸¦ ÇÒ´çÇϽʽÿÀ. ÀÌ APIÀÇ
Ãʱâ È£ÃâÀº oReqBufferLenÀ» È®º¸Çϱâ À§ÇÑ °ÍÀ̹ǷΠÃß°¡ 2´Ü°è Ä¿¹ÌÆ® Áß
ÀÌ»ó ½ÇÆÐ Æ®·£Àè¼ÇÀÌ ÀÖÀ¸¸é ÀÌ ¹öÆÛ´Â Å©±â°¡ ÃæºÐÇÏÁö ¾ÊÀ» ¼öµµ ÀÖ½À´Ï´Ù. ÀÀ¿ëÇÁ·Î±×·¥Àº
oReqBufferLenº¸´Ù Å« ¹öÆÛ¸¦ Á¦°øÇÕ´Ï´Ù.
- ¸ðµç 2´Ü°è Ä¿¹ÌÆ® Áß ÀÌ»ó ½ÇÆÐ Æ®·£Àè¼Ç ·¹Äڵ尡 È®º¸µÇ¾ú´ÂÁö ÆǺ°ÇϽʽÿÀ. ÀÌ
ÀÛ¾÷Àº oNumIndoubtsReturned¸¦ oNumIndoubtTotal°ú ºñ±³ÇÏ¿© ¼öÇàÇÒ ¼ö ÀÖ½À´Ï´Ù.
oNumIndoubtsTotalÀÌ oNumIndoubtsReturnedº¸´Ù Å©¸é, ÀÀ¿ëÇÁ·Î±×·¥Àº
À§ÀÇ ´Ü°è¸¦ ¹Ýº¹ÇÒ ¼ö ÀÖ½À´Ï´Ù.
ÂüÁ¶
Administrative API Reference¿¡¼ "sqlxhfrg - Forget Transaction Status",
"sqlxphcm - Commit an Indoubt Transaction" ¹× "sqlxphrl - Roll Back
an Indoubt Transaction"À» ÂüÁ¶ÇϽʽÿÀ.
[ ÆäÀÌÁöÀÇ ¸Ç À§ | ÀÌÀü ÆäÀÌÁö | ´ÙÀ½ ÆäÀÌÁö | ¸ñÂ÷ | »öÀÎ ]