rtecall("log") function

A RAD function that sends a message to the external sm.log file.

Function

rtecall("log")

Format

$L.success.flg=rtecall($L.fnc.name, $L.return.code, $L.message)

Parameters

The following parameters are valid for the rtecall("log") function:

Parameter	Data type	Description
$L.success.flg	Logical	Indicates whether or not the function was successful.
$L.fnc.name	String	The name of the sub-function to call, in this case "log".
$L.return.code	Number	Provides a more detailed return code.
$L.message	String	The message to be sent.

Factors

If the $L.success.flg is false, the function failed. If it is true, the function succeeded.

Example

$L.success.flg=rtecall("log", $L.return.code, "This is a new message")

Generates the following bold line in sm.log:

   137 04/12/2000 07:03:44 System background scheduler: event started at:
04/11/2000 23:02:48.
   137 04/12/2000 07:03:45 System background scheduler: availability started at:
04/11/2000 23:02:49.
   137 04/12/2000 07:03:45 System background scheduler: contract started at:
04/11/2000 23:02:50.
   137 04/12/2000 07:03:45 System background scheduler: ocm started at:
04/11/2000 23:02:51.
   137 04/12/2000 07:03:45 System startup completed successfully, elapsed time:
00:00:18.
   137 04/12/2000 07:32:48 24 records from location unloaded to: locations.save,
00:00:01 elapsed.
   306 04/12/2000 09:05:09 This is a new message