SET_TABLE_NAME

有效對象

擷取和資料汲取

說明

使用 SET_TABLE_NAME 函數來變更與資料記錄相關聯的表格名稱。例如，可以將指定表格上的刪除變更為插入歷史記錄表格。您只能在擷取處理期間變更表格名稱。

如果資料庫區分大小寫，則必須以與主控資料庫中定義的相同字母大小寫來指定物件名稱；否則，大小寫並不重要。指定完整的兩部分或三部分的表格名稱。

語法

#include "usrdecs.h"
short result_code;
record_def record;
ERCALLBACK (SET_TABLE_NAME, &record_def, &result_code);

緩衝區

typedef struct
{
char *table_name;
char *buffer;
long length;
char before_after_ind;
short io_type;
short record_type;
short transaction_ind;
int64_t timestamp;
exit_ts_str io_datetime;
short mapped;
short source_or_target;
/* Version 2 CALLBACK_STRUCT_VERSION   */
char requesting_before_after_ind;
} record_def;

輸入

<table_name>

指定要與資料記錄關聯之新表格名稱的空值終止字串。

如果使用者結束程式的字元階段作業使用 SET_SESSION_CHARSET 設定為作業系統預設字元集以外的值 (如 ucharset.h 檔案中的 ULIB_CS_DEFAULT 所定義)，則表格名稱會在階段作業字元集中解譯。

輸出

無

傳回值

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK