Append a record to the current logical file
|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
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)
