====== CREATE.FILE ======

==== Purpose ====

Used to establish a new file.

==== Arguments ====

^Argument^Input/Output^Value^
|CODE|Input|12|
| |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|file creation options (BFS specific) passed as a dynamic array|
| |Output|unchanged|
|RECORD|Input|null|
| |Output|unchanged|
|STATUS|Input|1|
| |Output|TRUE$ if the file is successfully created|

==== Note ====

This call can be trapped by an MFS only if the MFS is installed on the volume being accessed.  File creation options are passed as a dynamic array.  The first field contains the options, and the second field contains the literal "D" if a dictionary file is being created.

==== Called by ====

BASIC+ [[create_table|CREATE_TABLE statement]]