GET_MARKER

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