GET_MARKER_INFO
Valid For
Extract (data pump only) and Replicat
Description
Use the GET_MARKER_INFO
function to retrieve marker information sent from a NonStop source system when Replicat is applying data. Use markers to trigger custom processing within a user exit.
If the character session of the user exit is set with SET_SESSION_CHARSET
to a value other than the default character set of the operating system, as defined in ULIB_CS_DEFAULT
in the ucharset.h
file, all of the returned marker data is interpreted in the session character set.
Syntax
#include "usrdecs.h" short result_code; marker_info_def marker_info; ERCALLBACK (GET_MARKER_INFO, &marker_info, &result_code);
Buffer
typedef struct { char *processed; char *added; char *text; char *group; char *program; char *node; } marker_info_def;
Input
-
processed
-
A pointer to a buffer to accept the
processed
return value. -
added
-
A pointer to a buffer to accept the
added
return value. -
text
-
A pointer to a buffer to accept the
text
return value. -
group
-
A pointer to a buffer to accept the
group
return value. -
program
-
A pointer to a buffer to accept the
program
return value. -
node
-
A pointer to a buffer to accept the
node
return value.
Output
-
processed
-
A null-terminated string in the format of
YYYY-MM-DD HH:MI:SS
indicating the local date and time that the marker was processed. -
added
-
A null-terminated string in the format of
YYYY-MM-DD HH:MI:SS
indicating the local date and time that the marker was added. -
text
-
A null-terminated string containing the text associated with the marker.
-
group
-
A null-terminated string indicating the Replicat group that processed the marker.
-
program
-
A null-terminated string indicating the program that processed the marker.
-
node
-
A null-terminated string representing the Himalaya node on which the marker was originated.
Return Values
EXIT_FN_RET_INVALID_CONTEXT EXIT_FN_RET_OK
Parent topic: User Exit Functions