Synopsis:

        sys_fhputline(file_handle,string)

Arguments:

       file_handle       -   The file handle to write to

      string                -    The string to write to the file

      

Description:    This function appends the given string to the file specified by file_handle and automatically writes a Carriage-return/Line-Feed cobination to terminate the line.    Before writing the text the function will seek to the end of the file before writing the text line.      

If you are appending to a log file that might be written to across a network by several machines it is advisable to use file locks to make sure that only one machine is appending at any one time (otherwise garbled data can occasionally appear in the file).

Return Value

The function will return 0 in sucess or an negative error code.