CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-45
CRE_Log_GetPrefix_
CRE_Log_GetPrefix_
CRE_Log_GetPrefix_ returns to its caller the default prefix text that precedes each line
of error or warning information written to standard log.
buffer : buffer_bytes
if present, specifies the address and size of the buffer that CRE_Log_GetPrefix_
fills with the default prefix text. CRE_Log_GetPrefix_ stores the prefix text only if
both
buffer and buffer_bytes are present.
prefix_bytes
if present, is the actual number of bytes in the prefix text.
Return Value
CRE_Log_GetPrefix_ returns 0 if buffer:buffer_bytes contains prefix text.
Otherwise, CRE_Log_GetPrefix_ returns the value returned to it by the
PROCESS_GETINFO_ system procedure.
Considerations
If either buffer or buffer_bytes is not passed, CRE_Log_GetPrefix_ returns 0 in
prefix_bytes and leaves buffer unchanged.
CRE_Stacktrace_
CRE_Stacktrace_ writes a stack trace to a standard file.
Table 6-8. Exception-Handling Functions
Function Name Function Action
CRE_Log_GetPrefix_
on page 6-45
Returns to its caller the text that precedes each message in
standard log.
CRE_Stacktrace_
on
page 6-45
Writes a stack trace to either a standard file or to an operating
system file.
INT PROC CRE_Log_GetPrefix_(buffer:buffer_bytes,
prefix_bytes) EXTENSIBLE;
STRING .EXT buffer; ! in/out, optional
INT buffer_bytes; ! in, optional
INT .EXT prefix_bytes; ! out, optional TNS,native