8.27 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