FS_APPEND

Append a record to the current logical file

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall FS_APPEND(record, [channel][, error])

Arguments

record

The record to write. (a)

channel

(optional) The file‑stack channel. If not passed, the default file‑stack channel is used. (n)

error

(optional) Returned with one of the following error flags: (n)

0 = No error occurred.

1 = Not a file‑stack channel.

Discussion

FS_APPEND appends a record to the current logical file.

It is assumed that the size of the data transfer is the size of the accessed logical file’s record length, as specified in FS_OPEN.

This subroutine only accesses the current (highest) level of the file stack. The record number of the appended record will be one greater than the highest record number written to this level. A new EOF point will be set for the level.

If error is not passed, and an error occurs, a fatal program error is generated.

Examples

The following example appends the data in page to the end of the current (highest) level in the default file stack.

xcall fs_append(page,, sts)