====== OPEN.FILE ======

==== Purpose ====

Used to create a file handle for subsequent access by record-oriented calls such as [[read_record|READ.RECORD]], [[write_record|WRITE.RECORD]], etc.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           
==== Arguments ====

^Argument^Input/Output^Value^
|CODE|Input|11|
| |Output|unchanged|
|BFS|Input|BFS List|
| |Output|unchanged|
|HANDLE|Input|Media Map Handle|
| |Output|unchanged|
|NAME|Input|filename*account as read from @FILES<2> and @FILES<3>|
| |Output|unchanged|
|FMC|Input|null|
| |Output|unchanged|
|RECORD|Input|null|
| |Output|File Handle for file|
|STATUS|Input|1|
| |Output|true if the file handle is successfully constructed, false if the handle cannot be constructed and verified|

==== Note ====

Once an OPEN.FILE call has been made, the file handle for an opened file is stored as field five of the @FILES file entry. Subsequent BASIC+ OPEN statements do not make this OPEN.FILE call if a file handle for the file is already available.

==== Called by ====

BASIC+ [[open|OPEN statement]]