GET_MARKER_INFO

有效對象

擷取 (僅限資料汲取) 和 Replicat

說明

當 Replicat 套用資料時，請使用 GET_MARKER_INFO 函數擷取從 NonStop 來源系統傳送的標記資訊。使用標記在使用者結束程式內觸發自訂處理。

如果使用者結束程式的字元階段作業使用 SET_SESSION_CHARSET 設定為作業系統預設字元集以外的值 (如 ucharset.h 檔案中的 ULIB_CS_DEFAULT 所定義)，則所有傳回的標記資料都會解譯為階段作業字元集。

語法

#include "usrdecs.h"
short result_code;
marker_info_def marker_info;
ERCALLBACK (GET_MARKER_INFO, &marker_info, &result_code);

緩衝區

typedef struct
{
char *processed;
char *added;
char *text;
char *group;
char *program;
char *node;
} marker_info_def;

輸入

<processed>

接受 processed 傳回值的緩衝區指標。

<added>

接受 added 傳回值的緩衝區指標。

<text>

接受 text 傳回值的緩衝區指標。

<group>

接受 group 傳回值的緩衝區指標。

<program>

接受 program 傳回值的緩衝區指標。

<node>

接受 node 傳回值的緩衝區指標。

輸出

<processed>

格式為 YYYY-MM-DD HH:MI:SS 的空值終止字串，表示處理標記的本機日期與時間。

<added>

格式為 YYYY-MM-DD HH:MI:SS 的空值終止字串，表示新增標記的本機日期與時間。

<text>

包含標記相關文字的空值終止字串。

<group>

代表處理標記之 Replicat 群組的空值終止字串。

<program>

空的終止字串，指示處理標記的程式。

<node>

代表起始標記之 Himalaya 節點的空值終止字串。

傳回值

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_OK