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