GGS_EMSMESSAGE allows a user exit to write a message to the EMS log file. The message will have the Oracle GoldenGate subsystem ID.

Syntax

For C:

#include "usrdecs"
short result;
int   evtnum;
int   severity;
char  *text;
result = GGS_EMSMESSAGE(int evtnum, text, severity);

For TAL:

?source usrdect
int    result;
int    evtnum;
string .ext text;
int    severity;
result := GGS_EMSMESSAGE(evtnum, text, severity);

For COBOL:

?CONSULT =EXTRACT (or =REPLICAT)
01 evtnum        PIC S(4) COMP.
01 result        PIC S(4) COMP.
01 text          PIC X(132).
01 severity      PIC S(4) COMP.
ENTER C "GGS_EMSMESSAGE" using evtnum, text, severity giving result.

evtnum

An arbitrary number used to identify a message.

text

The text of the message.

severity

A value that identifies how severe the message is, as in:

• MSG_INFO 1 — normal EMS message.

• MSG_CRITICAL 2 — EMS message with emphasis set to ON.

• MSG_FATAL 3 — abends the process after writing the message.

result

A code indicating whether the call was successful or not.