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])



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


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


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.


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)