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.