CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-25
CRE_Log_Message_
Return Value
CRE_Hometerm_Open_ returns one of the following:
•
0 if the open operation is successful
•
A positive number, which is a file system error number
•
A negative number, which is the negation of a CRE error number from the following
table:
Considerations
•
CRE_Hometerm_Open_ opens your process’s home terminal and returns its file
number in
file_number.
•
If the CRE receives an EXECUTION-LOG PARAM at process initialization,
CRE_Hometerm_Open_ does not store a value in
file_number and returns error
20, “Cannot utilize file name.”
•
CRE_Hometerm_Open_ does not retry operations that return an error.
CRE_Log_Message_
The CRE_Log_Message_ function writes a message to standard log. Although you
should use standard constructs in your programming language, you can directly invoke
CRE_Log_Message_ from your application program to log a message.
buffer:message_bytes
defines the address and length of the message to transmit.
indent_bytes
if present, specifies formatting of the message.
read_count
if present, specifies the number of bytes to read in response to the message.
Error Code Cause
20 Cannot utilize file name
INT PROC CRE_Log_Message_( buffer:message_bytes,
indent_bytes,
read_count, count_read )
EXTENSIBLE;
STRING .EXT buffer; ! in/out, required
INT message_bytes; ! in, required
INT indent_bytes; ! in, optional
INT read_count; ! in, optional
INT .EXT count_read; ! out, optional TNS, native