isCOBOL Evolve : Appendices : Library Routines : C$WRITELOG
C$WRITELOG
The C$WRITELOG library routine allows to add custom information to the isCOBOL log file. The iscobol.tracelevel property must be set to a value greater than 0 or the routine will have no effect.
Every call to this routine generates a new line in the log.
All the messages written to the log by this routine are messages of type INFO. If you wish to write messages of different type, consider using the Logger (com.iscobol.logger.Logger) internal object instead.
Syntax:
 CALL "C$WRITELOG" USING text-1 [, text-2] ... [, text-n]
                  GIVING returnCode
Parameters:
text-1
text-2
...
text-n
any data item or literal
Specifies the text to be written into the log file.
At least one parameter must be passed. The others are optional.
Multiple parameters values are combined together in the same log line.
Return code:
returnCode can be any numeric data item and provides additional information:
1
Operation successful
0
Operation failed, probably iscobol.tracelevel is set to 0
Examples:
Example - Write some custom information to the log
*> define trace-text as pic x(n)
initialize trace-text
string "Customer in debt "
        cust-code
        ". Debt Amount : "
        cust-amount-ed
        into trace-text
end-string
call "c$writelog" using trace-text