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)
