FS_OPEN

Add a logical file to the top of the stack

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

Arguments

record_size

The size of the fixed‑length records to be stored in the new logical file. (n)

channel

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

Discussion

FS_OPEN pushes the current logical file on the file stack and opens a new one.

When a new logical file is opened on the stack, all I/O at that stack level will use data of the size specified in the FS_OPEN call, regardless of the size of the field that is passed. If a shorter field is used, subsequent data will be accessed.

If channel is not passed and there is no default file stack, or if channel is zero, Toolkit automatically calls FS_INIT to activate a new file stack.

Examples

The following example will add a new logical file to the file stack whose channel is stored in pgchn. The size of the records for this new logical file will be 512 bytes.

xcall fs_open(512, pgchn)